I created a project in python, and I'm curious about how packages work in python.

Here is my directory layout:

top-level dir
  \ tests
    __init__.py 
  \ examples
    __init__.py
    example.py
module.py

How would I go about including module.py in my example.py module. I know I could set PYTHONPATH to the top-level directory, but that doesn't seem like a good solution. This is how pydev gets around this problem, but I'd like a solution that didn't require updating environment variables.

I could put something at the top of the example.py to update sys.path like this:

from os import path
import sys

sys.path.append( path.dirname(path.abspath(path.dirname(__file__))) )

I don't think this is an appropriate solution either.

I feel like I'm missing some basic part of python packages. I'm testing this on python 2.6. If any further clarification is needed, please let me know.

python package
Edit
Report