- This project is a skeleton for any new project. It contains:
- a source folder:
src
- a unit test folder:
_unittests
, go to this folder and runrun_unittests.py
- a _doc folder:
_doc
, it will contains the documentation - a file
setup.py
to build and to install the module
- a source folder:
- All theses steps were only tested on Windows. Suppot for linux will be added later. To create your own project, you need to rename the folder
project_name
insrc
by your true module name. You also need to replaceproject_name
wherever it is found: project_var_name = 'project_name'
insetup.py
,make_help.py
and_doc/sphinxdoc/source/conf.py
from src.project_name.subproject.myexample import myclass
in_unittests/ut_example/test_example.py
- many places in
_doc/sphinxdoc/source/index.rst
- many places in
README.rst
The project is also hosted here where you can find a link to the generated documentation based on this template.
Any new module or subpackage should be added in src/project_name
. Every subfolder should contain a file __init__.py
. If the new file needs an existing submodule, you need to add something like the following:
import os,sys
from ..subproject.myexample import myclass
You should use relative imports as much as possible. To add a module at deeper level than the previous one, you should add relative imports in every __init__.py
along the way.
- 0.0 - 2014/??/??
- new: first version
- fix: the setup does not need the file
README.rst
anymore