70 lines
2.4 KiB
Python
70 lines
2.4 KiB
Python
|
"""
|
||
|
|
apipkg: control the exported namespace of a python package.
|
||
|
|
|
||
|
|
see http://pypi.python.org/pypi/apipkg
|
||
|
|
|
||
|
|
(c) holger krekel, 2009 - MIT license
|
||
|
|
"""
|
||
|
|
import sys
|
||
|
|
from types import ModuleType
|
||
|
|
|
||
|
|
__version__ = "1.0b2"
|
||
|
|
|
||
|
|
def initpkg(pkgname, exportdefs):
|
||
|
|
""" initialize given package from the export definitions. """
|
||
|
|
mod = ApiModule(pkgname, exportdefs, implprefix=pkgname)
|
||
|
|
oldmod = sys.modules[pkgname]
|
||
|
|
mod.__file__ = getattr(oldmod, '__file__', None)
|
||
|
|
mod.__version__ = getattr(oldmod, '__version__', None)
|
||
|
|
mod.__path__ = getattr(oldmod, '__path__', None)
|
||
|
|
sys.modules[pkgname] = mod
|
||
|
|
|
||
|
|
def importobj(modpath, attrname):
|
||
|
|
module = __import__(modpath, None, None, ['__doc__'])
|
||
|
|
return getattr(module, attrname)
|
||
|
|
|
||
|
|
class ApiModule(ModuleType):
|
||
|
|
def __init__(self, name, importspec, implprefix=None):
|
||
|
|
self.__name__ = name
|
||
|
|
self.__all__ = list(importspec)
|
||
|
|
self.__map__ = {}
|
||
|
|
self.__implprefix__ = implprefix or name
|
||
|
|
for name, importspec in importspec.items():
|
||
|
|
if isinstance(importspec, dict):
|
||
|
|
subname = '%s.%s'%(self.__name__, name)
|
||
|
|
apimod = ApiModule(subname, importspec, implprefix)
|
||
|
|
sys.modules[subname] = apimod
|
||
|
|
setattr(self, name, apimod)
|
||
|
|
else:
|
||
|
|
modpath, attrname = importspec.split(':')
|
||
|
|
if modpath[0] == '.':
|
||
|
|
modpath = implprefix + modpath
|
||
|
|
if name == '__doc__':
|
||
|
|
self.__doc__ = importobj(modpath, attrname)
|
||
|
|
else:
|
||
|
|
self.__map__[name] = (modpath, attrname)
|
||
|
|
|
||
|
|
def __repr__(self):
|
||
|
|
return '<ApiModule %r>' % (self.__name__,)
|
||
|
|
|
||
|
|
def __getattr__(self, name):
|
||
|
|
try:
|
||
|
|
modpath, attrname = self.__map__[name]
|
||
|
|
except KeyError:
|
||
|
|
raise AttributeError(name)
|
||
|
|
else:
|
||
|
|
result = importobj(modpath, attrname)
|
||
|
|
setattr(self, name, result)
|
||
|
|
del self.__map__[name]
|
||
|
|
return result
|
||
|
|
|
||
|
|
def __dict__(self):
|
||
|
|
# force all the content of the module to be loaded when __dict__ is read
|
||
|
|
dictdescr = ModuleType.__dict__['__dict__']
|
||
|
|
dict = dictdescr.__get__(self)
|
||
|
|
if dict is not None:
|
||
|
|
for name in self.__all__:
|
||
|
|
hasattr(self, name) # force attribute load, ignore errors
|
||
|
|
return dict
|
||
|
|
__dict__ = property(__dict__)
|