Tryag File Manager
Home
-
Turbo Force
Current Path :
/
usr
/
lib
/
python2.4
/
lib-old
/
Upload File :
New :
File
Dir
//usr/lib/python2.4/lib-old/ni.pyc
m๒ =5Dc @ sศ d Z d k Z d k Z d k Z d k Z d k l Z l Z d e f d YZ d e f d YZ d d Z d Z d d Z d Z d Z d Z e d j o e n e d S( sฯ New import scheme with package support. Quick Reference --------------- - To enable package support, execute "import ni" before importing any packages. Importing this module automatically installs the relevant import hooks. - To create a package named spam containing sub-modules ham, bacon and eggs, create a directory spam somewhere on Python's module search path (i.e. spam's parent directory must be one of the directories in sys.path or $PYTHONPATH); then create files ham.py, bacon.py and eggs.py inside spam. - To import module ham from package spam and use function hamneggs() from that module, you can either do import spam.ham # *not* "import spam" !!! spam.ham.hamneggs() or from spam import ham ham.hamneggs() or from spam.ham import hamneggs hamneggs() - Importing just "spam" does not do what you expect: it creates an empty package named spam if one does not already exist, but it does not import spam's submodules. The only submodule that is guaranteed to be imported is spam.__init__, if it exists. Note that spam.__init__ is a submodule of package spam. It can reference to spam's namespace via the '__.' prefix, for instance __.spam_inited = 1 # Set a package-level variable Theory of Operation ------------------- A Package is a module that can contain other modules. Packages can be nested. Package introduce dotted names for modules, like P.Q.M, which could correspond to a file P/Q/M.py found somewhere on sys.path. It is possible to import a package itself, though this makes little sense unless the package contains a module called __init__. A package has two variables that control the namespace used for packages and modules, both initialized to sensible defaults the first time the package is referenced. (1) A package's *module search path*, contained in the per-package variable __path__, defines a list of *directories* where submodules or subpackages of the package are searched. It is initialized to the directory containing the package. Setting this variable to None makes the module search path default to sys.path (this is not quite the same as setting it to sys.path, since the latter won't track later assignments to sys.path). (2) A package's *import domain*, contained in the per-package variable __domain__, defines a list of *packages* that are searched (using their respective module search paths) to satisfy imports. It is initialized to the list consisting of the package itself, its parent package, its parent's parent, and so on, ending with the root package (the nameless package containing all top-level packages and modules, whose module search path is None, implying sys.path). The default domain implements a search algorithm called "expanding search". An alternative search algorithm called "explicit search" fixes the import search path to contain only the root package, requiring the modules in the package to name all imported modules by their full name. The convention of using '__' to refer to the current package (both as a per-module variable and in module names) can be used by packages using explicit search to refer to modules in the same package; this combination is known as "explicit-relative search". The PackageImporter and PackageLoader classes together implement the following policies: - There is a root package, whose name is ''. It cannot be imported directly but may be referenced, e.g. by using '__' from a top-level module. - In each module or package, the variable '__' contains a reference to the parent package; in the root package, '__' points to itself. - In the name for imported modules (e.g. M in "import M" or "from M import ..."), a leading '__' refers to the current package (i.e. the package containing the current module); leading '__.__' and so on refer to the current package's parent, and so on. The use of '__' elsewhere in the module name is not supported. - Modules are searched using the "expanding search" algorithm by virtue of the default value for __domain__. - If A.B.C is imported, A is searched using __domain__; then subpackage B is searched in A using its __path__, and so on. - Built-in modules have priority: even if a file sys.py exists in a package, "import sys" imports the built-in sys module. - The same holds for frozen modules, for better or for worse. - Submodules and subpackages are not automatically loaded when their parent packages is loaded. - The construct "from package import *" is illegal. (It can still be used to import names from a module.) - When "from package import module1, module2, ..." is used, those modules are explicitly loaded. - When a package is loaded, if it has a submodule __init__, that module is loaded. This is the place where required submodules can be loaded, the __path__ variable extended, etc. The __init__ module is loaded even if the package was loaded only in order to create a stub for a sub-package: if "import P.Q.R" is the first reference to P, and P has a submodule __init__, P.__init__ is loaded before P.Q is even searched. Caveats: - It is possible to import a package that has no __init__ submodule; this is not particularly useful but there may be useful applications for it (e.g. to manipulate its search paths from the outside!). - There are no special provisions for os.chdir(). If you plan to use os.chdir() before you have imported all your modules, it is better not to have relative pathnames in sys.path. (This could actually be fixed by changing the implementation of path_join() in the hook to absolutize paths.) - Packages and modules are introduced in sys.modules as soon as their loading is started. When the loading is terminated by an exception, the sys.modules entries remain around. - There are no special measures to support mutually recursive modules, but it will work under the same conditions where it works in the flat module space system. - Sometimes dummy entries (whose value is None) are entered in sys.modules, to indicate that a particular module does not exist -- this is done to speed up the expanding search algorithm when a module residing at a higher level is repeatedly imported (Python promises that importing a previously imported module is cheap!) - Although dynamically loaded extensions are allowed inside packages, the current implementation (hardcoded in the interpreter) of their initialization may cause problems if an extension invokes the interpreter during its initialization. - reload() may find another version of the module only if it occurs on the package search path. Thus, it keeps the connection to the package to which the module belongs, but may find a different file. XXX Need to have an explicit name for '', e.g. '__root__'. N( s ModuleLoaders ModuleImportert PackageLoaderc B sV t Z d Z d Z d Z d Z d Z d Z d Z d Z d Z RS( s๎ A subclass of ModuleLoader with package support. find_module_in_dir() will succeed if there's a subdirectory with the given name; load_module() will create a stub for a package and load its __init__ module if it exists. c C s] | d j o= | i i | | } | i i | o d | d f SqJ n t i | | | S( Nt t PACKAGE( R R R ( t dirt Nonet selft hookst path_joint namet dirnamet path_isdirt ModuleLoadert find_module_in_dir( R R R R ( ( t /usr/lib/python2.4/lib-old/ni.pyR ท s c C sา | \ } } } | \ } } } | d j o | i | | Sn t i i | o t i | } n t i | t i | <} | i | | t i j o! d | j o | i | | Sn t i | | | Sd S( NR t .( t stufft filet filenamet infot sufft modet typeR t load_packageR t syst modulest has_keyt mt impt new_modulet set_parentt C_EXTENSIONt load_dynamicR t load_module( R R R R R R R R R R ( ( R R พ s c C sล | \ } } \ } } } | i d } | | d } t i i | o t i | } n d } t i | t i | <z t i | | | } Wd | o | t i | <n t i | =X| t i | <| S( NR i ( R R R R R R R t rfindt it tailR R R t saveR R R R R ( R R R R R" R R R# R R R$ R ( ( R R อ s c C sj | \ } } } t i i | o t i | } n t i | t i | <} | g | _ | i | | S( N( R R R R R R R R t packageR R t __path__R t init_package( R R R R R% R R ( ( R R แ s c C s+ | i | | i | | i | d S( N( R R R% t set_domaint call_init_module( R R% ( ( R R' ๋ s c C sG | i } d | j o | | i d } n d } t i | | _ d S( NR R ( R t __name__R R! R R t __( R R R ( ( R R ๐ s c C sj | i } | g | _ } x2 d | j o$ | | i d } | i | q W| o | i d n d S( NR R ( R% R* R t __domain__t domainR! t append( R R% R R- ( ( R R( ๘ s c C sF | i d | i } | o& | i | i d | } | | _ n d S( Nt __init__s .__init__( R t find_moduleR% R& R R R* R R/ ( R R% R R ( ( R R) s ( R* t __module__t __doc__R R R R R' R R( R) ( ( ( R R ญ s t PackageImporterc B sn t Z d Z e d d Z h h g d Z d Z d Z d Z d Z d Z d Z d Z RS( s, Importer that understands packages and '__'.i c C s' t i | | p t d | | d S( N( t ModuleImporterR/ R t loaderR R t verbose( R R5 R6 ( ( R R/ s c C sศ | i d o | d } n t i d } | d d j oใ | } | d } x) | d d j o | i } | d } qO W| p | i | | d | Sn d | j o( | i d } | | | | } } n d } | i o | i d | p | } | i | } | i | | | | Sn d | j o( | i d } | | | | } } n d } xU | i D]= } | o | d | p | } | i | } | o PqdqdWt d | | i | | | | S( NR+ R i s __.R s No such module %s( s __.s __( s __.s __( t globalsR R% R R R t pR+ R t finisht fromlistt findR" R# R* t mnamet get1R R, t pnamet get0t ImportError( R R R7 t localsR: R% R" R< R R8 R# R> ( ( R t import_module s> " c C sZ | i } | o; t i i | | o$ | | d } } | i | } n xj | ob | i d d } | d j o | | | | } } n | d } } | | } | i | } qN W| p | Sn d | j o t d n t | d p | Sn d | j o t d n x@ | D]8 } t | | o qn | d | } | i | qW| S( NR R i i R+ s Can't import __ from anywhereR& t *s Can't import * from a package( R R* t ynameR# R R R R R= R; R" t headR: t moduleR@ t hasattrt ft fname( R RF R R# R: RE RH R" RD RI ( ( R R9 3 s6 c C s+ | i | } | p t d | n | S( Ns No module named %s( R t getR R R@ ( R R R ( ( R R= P s c C s+ | i | } | p d t i | <n | S( N( R RJ R R R R R ( R R R ( ( R R? V s c C sโ t i i | o t i | Sn d | j o, | i d } | | | | d } } n d | } } t i | i } | i i | | } | p d Sn | i i | | t i | <} | o t t i | | | n | S( NR i R ( R R R R R! R" RE R# R& t pathR R5 R0 R R R R t setattr( R R RE R" R R# R RK ( ( R RJ \ s c C sจ | i } d | j o< | i d } | | | | d } } t i | i } n | } t i d i } | i i | | } | p t d | n | i i | | S( NR i R s No module named %s( RF R* R R! R" RE R# R R R& RK R R5 R0 R R@ R ( R RF RE R R" R# R RK ( ( R t reloadn s c C s1 t | d o t d n t i | | d S( NR& s% don't know how to unload packages yet( RG RF R@ R3 t unloadR ( R RF ( ( R RN | s c C sง t i i d p t i d t i d <} d | _ | i i | xM t i i D]8 } | p qV n t | d p | i i | qV qV Wn t i | d S( NR R+ ( R R R R R R% R R& R R5 R' t valuesR RG R R4 t install( R R% R ( ( R RP s ( R* R1 R2 R R/ RB R9 R= R? RJ RM RN RP ( ( ( R R3 s # i c C s t i t d | d S( N( t ihooksRP R3 R t v( RR ( ( R RP s c C s t i d S( N( RQ t uninstall( ( ( R RS s c C s t | d S( N( RP RR ( RR ( ( R t ni s c C s t d S( N( RS ( ( ( R t no s c C s_ d k } y t WnD t i \ t _ t _ t _ Ht i Gd Gt i GHH| i n Xd S( Nt :( t pdbt testproperR t exc_infot last_typet last_valuet last_tracebackt pm( RW ( ( R t test s c C s; t d z" d k } t | GHt d Wd t Xd S( Ni s OK?( RP t mactestR t raw_inputRS ( R_ ( ( R RX ค s t __main__( R2 R R t __builtin__RQ R R4 R R3 RP RS RT RU R^ RX R* ( RX RT R RQ RU Rb R R R3 RP R^ R4 R RS ( ( R t ?ข s [