Tooth.paste: Shiny new Python packages!

Tooth.paste creates shiny new Python packages. Start your new packages with a prepared Sphinx documentation section, a test folder for your unit tests and a Makefile containing all the tools needed to keep your Python code clean.

Get started

Create a virtualenv and activate it:

$ virtualenv --no-site-packages trytoothpaste
$ cd trytoothpaste
$ source ./bin/activate

Install tooth.paste in your virtualenv:

$ pip install tooth.paste

Creating a new package

Create a shiny new Python package:

$ ./bin/templer package myproject

Create a shiny new Python package with one dot in the name:

$ ./bin/templer dotpackage my.project

Create a shiny new Python package with two dots in the name:

$ ./bin/templer dotdotpackage

Get started with the new package

Prepare everything for development by running make build:

$ cd my.project
$ make build

Document your package

Once you have created your new package, you can directly write some documentation in the following reStructuredText document:


Consult The Quick reStructuredText reference to get started with reStructuredText.

Build the html Sphinx documentation

Run make docs to generate the Sphinx documentation in HTML:

$ make docs

Open the HTML documentation in your browser and verify that the layout looks good:


Write some code

You can start adding code:

cd my/project

Write some tests

You can start writing test code:


Run the tests

Run the unit tests:

$ make test

Run the coverage

Run the coverage tool:

$ make coverage

You can then have a look at the coverage in the generated HTML pages:


Run pylint

Run the pylint tool:

$ make pylint

Run flake8

Runt the flake8 tool:

$ make flake8

Run pep8:

Run the pep8 tool:

$ make pep8

Read the docs:

Add a web hook for Read the docs


Indices and tables