Metadata-Version: 1.0
Name: nimp
Version: 0.9.1
Summary: Nested Imports for Python
Home-page: http://github.com/tomerfiliba/nimp
Author: Tomer Filiba
Author-email: tomerfiliba@gmail.com
License: MIT
Description: Allows nested imports, a la Java. It installs a harmless meta import-hook that 
        adds support for *nested packages*, i.e., multiple packages that "live" under a 
        common namespace. This is the idiom in Java, where you have packages like 
        ``com.foo.bar.spam`` and ``com.foo.bar.eggs``, as well as in Haskell. 
        Nimp basically allows packages to "inject" themselves into shared namespaces.
        
        Compatible with Python 2.3 and up and 3.0 and up
        
        Usage::
        
          import nimp
          nimp.install()
        
        Example Layout
        --------------
        Assume the following directory structure, say, in your ``site-packages``::
        
          com.ibm.storage/
            files...
          com.ibm.storage.plugins/
            files...
          com.ibm.pythontools/
            files...
        
        Using Nimp, the following imports will work as expected::
          
          import com                              # a namespace package (empty)
          import com.ibm                          # a namespace package (empty)
          import com.ibm.pythontools              # a real package
          com.ibm.pythontools.myfunc(1,2,3)
          
          # and of course using `from` works too
          from com.ibm.storage import ScsiDisk    
          
          # note how the `plugins` package was "injected" into `storage`
          from com.ibm.storage.plugins import MySQLPlugin
        
Keywords: import hook,nested packages,namespace packages,java-like packages
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
