Skip to main content

python-package-template (pypack)

Provides a command to easily create a standard Python package layout (i.e. README, package directory, etc.), following the Hitchhiker’s Guide to Packaging.

Features

  • Creates a complete Python package template, ready for creating distribution files and uploading to the Python package index (PyPI).

  • Uses Distribute by default.

  • MANIFEST.in template, with inclusion of README and other standard files, as well as ignoring of dist/ directory that gets created when building the the package’s distribution files.

  • No external dependencies, only relies on Python standard library.

Quickstart

  1. Run pypack, specifying the name of your new package (optionally, use command line options to provide additional information, see pypack -h).

    1. If you want to create a new Python package in an existing directory, just specify the desired Python package name:

      pypack mynewpackage
    2. If you want to specify different directory, you may optionally use the -t (or --target) option to specify a target, non-existent directory:

      pypack mynewpackage -t /new/path
  2. Review/edit the generated files

  3. Add your code, documentation, etc.

  4. Create distribution tarball:

    cd mynewpackage
    python setup.py sdist
  5. Register project on PyPI:

    python setup.py register
  6. Upload to PyPI:

    python setup.py sdist upload

Download

TODO

  • Sphinx documentation layout, or at least an option to create a docs directory.

  • Support for a license file, allowing selection from a list of common open-source license templates

  • GitHub and Bitbucket compatibility for displaying readme file

  • git/hg ignore files

  • Allow use of config file to specify default options for author, license, etc.

  • An interactive option that prompts for needed info.

Similar Projects

http://pypi.python.org/pypi/modern-package-template/

Metadata

Release files for python-package-template 0.8.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-package-template 0.8.1
File Size Uploaded
python-package-template-0.8.1.tar.gz 15.2 kB Details

Release files / python-package-template-0.8.1.tar.gz

Download URL python-package-template-0.8.1.tar.gz
Size 15.2 kB
Tags Source
SHA-256 checksum
How to use checksums
9955b62746d36c5c326c19fd551bdb8c6086dc2450f318c0d1688f237a10a1e9
BLAKE2b-256 checksum
How to use checksums
22171c4c42b94e00c3c57460f41f9df0927a0fb8a6cb3a97600e84fa11d1cacb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.8.1 This release

1 release file

0.8

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page