Skip to main content

Creates the skeleton of your Python project.

Project description

If you are like me, starting a new Python project from the scratch can be boring: create a setup.py, documentation, installation instructions, forget a file or two in the manifest, etc. This all is a time-consuming and error prone work, which gives no intellectual satisfaction. Yet, this is necessary to make your project a good citizen in the open source community.

Boilerplate produces beautiful skeletons for your Python projects so you can get up and running fast. It is influenced by this blog post: http://jeffknupp.com/blog/2013/08/16/open-sourcing-a-python-project-the-right-way/, although we do not follow these recommendations by the letter.

The filesystem structure

The boilerplate start <project> command will create the following tree under the current directory:

.
|- .gitignore
|- LICENSE
|- MANIFEST.in
|- INSTALL.rst
|- README.rst
|- VERSION
|- requirements.txt
|- requirements-dev.txt
|- setup.py
|- docs/
|   |- conf.py
|   |- index.rst
|   |- make.bat
|   |- Makefile
|   |- _static/*
|   \- _templates/*
\- src/
    \- <project>
        |- __init__.py
        |- __meta__.py
        |- <project>.py
        \- test/
            |- __init__.py
            \- test_<project>.py

setup.py

src/*

docs/*

README.rst and INSTALL.rst

VERSION

requirements.txt

MANIFEST.in

LICENSE

.gitignore

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

pyboilerplate-0.2.1.tar.gz (18.1 kB view details)

Uploaded Source

File details

Details for the file pyboilerplate-0.2.1.tar.gz.

File metadata

File hashes

Hashes for pyboilerplate-0.2.1.tar.gz
Algorithm Hash digest
SHA256 c067cb561aa6a86c483f0b5f00a5321b7746e805b4bde7a91af509840e5323f6
MD5 ad7f9a8f178edc3a72b9d32ecd4e5f82
BLAKE2b-256 baf4e456f95ca9d7fdbf139b651fff0c9315b75af4f31395223c53559a1b2f90

See more details on using hashes here.

Supported by

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