# What is the convention for structuring Python modules?

PythonServer Side ProgrammingProgramming

Here is a sample project that shows a very good way to structure your projects: https://github.com/kennethreitz/samplemod. The project is about creating the "sample" module. The directory structure looks as follows:

README.rst
setup.py
requirements.txt
sample/__init__.py
sample/core.py
sample/helpers.py
docs/conf.py
docs/index.rst
tests/test_basic.py
tests/test_advanced.py

The README.rst file: This file is for giving a brief description of the module, how to set it up, how to use it, etc.