Skip to main content

PyPi template repository.

Project description

PyPi Template

My take at a template repository that I can fork for every Python project I want to push to PyPi

Latest Version on PyPI Build Status Documentation Status Coverage Status Built with PyPi Template

Howto, the executive summary

  1. fork it
  2. rename it
  3. edit it
  4. extend it
  5. use it

Getting Started

Forking and renaming are the two first steps when using this repository. They are both actions you perform at GitHub, but...

Fork without forking...

You don't have to go through the GitHub concept of forking and do everything from the command line...

$ git clone
$ mv pypi-template your-new-project
$ cd your-new-project
$ git remote remove origin
$ git remote add origin
$ git push -u master origin

Use the Command Line

The repository also includes a small script that copies the files from a clone of the repository. If you install the module, the script gets registered in your PATH, and allows for

$ pip install pypi-template

$ mkdir my-new-project
$ cd my-new-project

$ pypi-template

$ ls -la
total 40
drwxr-xr-x  11 xtof  staff   352 Nov 11 21:34 .
drwxr-xr-x  46 xtof  staff  1472 Nov 11 21:10 ..
drwxr-xr-x   3 xtof  staff    96 Nov 11 21:35 .github
-rw-r--r--   1 xtof  staff   144 Nov 11 21:31 .travis.yml
-rw-r--r--   1 xtof  staff  1067 Nov 11 21:34 LICENSE.txt
-rw-r--r--   1 xtof  staff   443 Nov 11 21:34 Makefile
drwxr-xr-x   6 xtof  staff   192 Nov 11 21:35 docs
drwxr-xr-x   3 xtof  staff    96 Nov 11 21:35 pypi_template
-rw-r--r--   1 xtof  staff  1830 Nov 11 21:34
drwxr-xr-x   3 xtof  staff    96 Nov 11 21:35 tests
-rw-r--r--   1 xtof  staff   167 Nov 11 21:34 tox.ini

The script only copies files that don't exist yet, so it can also be used to upgrade to a new version of PyPi Template, and import new features based on added folders. For changes to existing files, a more elaborate copying function will be added later, probably ;-)

Things to edit

  1. module top-level folder

There is a placeholder top-level module folder. You'll probably want to rename that.

$ mv pypi_template your_new_project
  1. LICENSE.txt

Change the license to whatever you feel is (more) appropriate.

  1. .github/

Replace this information with information regarding your project.


Replace the Python package configuration with one appropriate to your project.

  1. docs/

The docs/ contains a copy of this README as a placeholder for additional documentation, that can be published to ReadTheDocs.

Things to do


A basic testing setup has been prepared. To run it locally, issue...

$ make test
___________________________________ summary ____________________________________
  py27: commands succeeded
  congratulations :)

Head over to and register your project. A basic CI configuration is also provided.

Head over to and register your project to consult your code coverage reporting.

Publishing to PyPi

Head over to and register for an account. Next simply issue...

$ make publish-test

to publish your module to the test instance of PyPi.


$ make publish

to publish your module to the main instance of PyPi.

If you want to publish your documentation (from the docs/ folder) to e.g. ReadTheDocs, import the repository over there also.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pypi-template-0.0.5.tar.gz (4.1 kB view hashes)

Uploaded Source

Built Distribution

pypi_template-0.0.5-py2-none-any.whl (4.6 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page