I’m working on a Django project that contains a single application. The application will be released under the GPL so I want to develop it separately from the project – a personal site using the app. I’m attempting to use a package structure based on my domain name for both the project and the app, and that’s where I’m running into problems.
Here’s my file structure (with __init__.py files where appropriate):
$HOME/django-sites/mydomain
$HOME/django-apps/mydomain/cms
And my PYTHONPATH:
$HOME/django-sites:$HOME/django-apps
If I fire up a Python interpreter (from any directory on the filesystem) I can import classes from the site, but not the application. If I reverse the order of the two entries in the PYTHONPATH (apps first, then sites) I can import from the app but not the site.
It looks like Python’s only attempting to import from the first entry in the PYTHONPATH that contains the first portion of the package name. Is that correct? Is this expected behavior? If so, I can only stick modules in package structures like domain/app1, domain/app2 if they live in the same directory structure – regardless of the PYTHONPATH.
It’s not show-stopper because I can rename the site, but it’s much different than I was expecting. The Python tutorial mentions __path__, but I have no idea how to use it:
Packages support one more special attribute, __path__. This is initialized to be a list containing the name of the directory holding the package’s __init__.py before the code in that file is executed. This variable can be modified; doing so affects future searches for modules and subpackages contained in the package.
While this feature is not often needed, it can be used to extend the set of modules found in a package.
Has anyone else come across this? Is there something I can do with __path__ to make this function as expected?
Your analysis seems about right. The python path is used to locate modules to import; python imports the first one it finds. I’m not sure what you could do to work around this other than name your modules different things or put them in the same location in the search path.