Skip to main content

Cookiecutter template for a Python namespace package

Project description

Cookiecutter Namespace Template for a Python package.

Features

  • Testing setup with unittest and python setup.py test or py.test

  • Tox testing: Setup to easily test for Python 2.7, 3.4, 3.5, 3.6

  • Sphinx docs: Documentation ready for generation with, for example, ReadTheDocs

  • Bumpversion: Pre-configured version bumping with a single command

  • Optional auto-release to PyPI when you push a new tag to master (optional)

  • Optional command line interface using Click

Quickstart

  1. Install the latest Cookiecutter if you haven’t installed it yet (this requires Cookiecutter 1.4.0 or higher):

    $ pip install -U cookiecutter
  2. Generate a Python package project:

    $ cookiecutter https://github.com/veit/cookiecutter-namespace-template.git
  3. Create a repo and put it there.

  4. Register your project with PyPI.

  5. Add the repo to your ReadTheDocs account and turn on the ReadTheDocs service hook.

  6. Release your package by pushing a new tag to master.

Pull requests

If you have differences in your preferred setup, I encourage you to fork this to create your own version. I also accept pull requests on this, if they’re small, atomic, and if they make my own packaging experience better.

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

File details

Details for the file cookiecutter-namespace-template-0.1.3.tar.gz.

File metadata

  • Download URL: cookiecutter-namespace-template-0.1.3.tar.gz
  • Upload date:
  • Size: 2.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.7.0

File hashes

Hashes for cookiecutter-namespace-template-0.1.3.tar.gz
Algorithm Hash digest
SHA256 180d1e7a48cdaae1b4add3e014460003352d17d171e7b7058f39f7c0988ade60
MD5 dfca39fc6a0d93a9f86c41d2e6d930c4
BLAKE2b-256 4b5eb97a8f266494a1a0b99e291e72e84e76d0e2dd5a42122e12eedca8a8a911

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 Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page