Back to index

lightning-sunbird  0.9+nobinonly
__init__.py
Go to the documentation of this file.
00001 # ***** BEGIN LICENSE BLOCK *****
00002 # Version: MPL 1.1/GPL 2.0/LGPL 2.1
00003 #
00004 # The contents of this file are subject to the Mozilla Public License Version
00005 # 1.1 (the "License"); you may not use this file except in compliance with
00006 # the License. You may obtain a copy of the License at
00007 # http://www.mozilla.org/MPL/
00008 #
00009 # Software distributed under the License is distributed on an "AS IS" basis,
00010 # WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
00011 # for the specific language governing rights and limitations under the
00012 # License.
00013 #
00014 # The Original Code is the Python XPCOM language bindings.
00015 #
00016 # The Initial Developer of the Original Code is
00017 # Activestate Tool Corp.
00018 # Portions created by the Initial Developer are Copyright (C) 2000
00019 # the Initial Developer. All Rights Reserved.
00020 #
00021 # Contributor(s):
00022 #    Mark Hammond <MarkH@ActiveState.com>
00023 #
00024 # Alternatively, the contents of this file may be used under the terms of
00025 # either the GNU General Public License Version 2 or later (the "GPL"), or
00026 # the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
00027 # in which case the provisions of the GPL or the LGPL are applicable instead
00028 # of those above. If you wish to allow use of your version of this file only
00029 # under the terms of either the GPL or the LGPL, and not to allow others to
00030 # use your version of this file under the terms of the MPL, indicate your
00031 # decision by deleting the provisions above and replace them with the notice
00032 # and other provisions required by the GPL or the LGPL. If you do not delete
00033 # the provisions above, a recipient may use your version of this file under
00034 # the terms of any one of the MPL, the GPL or the LGPL.
00035 #
00036 # ***** END LICENSE BLOCK *****
00037 
00038 # The xpcom.server package.
00039 
00040 from policy import DefaultPolicy
00041 from xpcom import _xpcom
00042 
00043 # We define the concept of a single "tracer" object - similar to the single
00044 # Python "trace hook" for debugging.  Someone can set
00045 # xpcom.server.tracer to some class/function, and it will be used in place
00046 # of the real xpcom object.  Presumably this "trace" object will delegate
00047 # to the real object, but presumably also taking some other action, such
00048 # as calling a profiler or debugger.
00049 # tracer_unwrap is a function used to "unwrap" the tracer object.
00050 # If is expected that tracer_unwrap will be called with an object
00051 # previously returned by "tracer()".
00052 tracer = tracer_unwrap = None
00053 
00054 # Wrap an instance in an interface (via a policy)
00055 def WrapObject(ob, iid, policy = None, bWrapClient = 1):
00056     """Called by the framework to attempt to wrap
00057     an object in a policy.
00058     If iid is None, it will use the first interface the object indicates it supports.
00059     """
00060     if policy is None:
00061         policy = DefaultPolicy
00062     if tracer is not None:
00063         ob = tracer(ob)
00064     return _xpcom.WrapObject(policy( ob, iid ), iid, bWrapClient)
00065 
00066 # Unwrap a Python object back into the Python object
00067 def UnwrapObject(ob):
00068     if ob is None:
00069         return None
00070     ret = _xpcom.UnwrapObject(ob)._obj_
00071     if tracer_unwrap is not None:
00072         ret = tracer_unwrap(ret)
00073     return ret
00074 
00075 # Create the main module for the Python loader.
00076 # This is a once only init process, and the returned object
00077 # if used to load all other Python components.
00078 
00079 # This means that we keep all factories, modules etc implemented in
00080 # Python!
00081 def NS_GetModule( serviceManager, nsIFile ):
00082     import loader
00083     iid = _xpcom.IID_nsIModule
00084     return WrapObject(loader.MakePythonComponentLoaderModule(serviceManager, nsIFile), iid, bWrapClient = 0)
00085 
00086 def _shutdown():
00087     from policy import _shutdown
00088     _shutdown()