Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Create composite namespace packages.

Project Description

In a nutshell, allows you to create composite namespace packages without altering any submodule.

>>> import namespace
>>> ns = namespace.Namespace()
>>> ns.proxy("ns.path", "os.path")
>>> import ns.path
>>> import sys
>>> ns.path == sys.modules["os.path"]

The general idea here is that you’d create a PyPI package for the namespace and then attach the individual subpackages to the namespace.

Something like:

import namespace
ns = namespace.Namespace()
ns.proxy("mynamespace.web", "django")

And then client packages could use this namespace package as:

import mynamespace.web.forms as forms

That’s perhaps not the best example, but hopefully it gets the idea across.

Other caveats is that this doesn’t allow for magical addition to the namespace if a package elects to be in it. I’m not feeling creative enough to think of a good solution to this. I’m pretty sure it could be done with a hook in setuptools though.

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(1.8 kB) Copy SHA256 Hash SHA256
Source None Jul 5, 2009

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers