Skip to main content

Provides a command to easily create a standard Python package layout (i.e. package directory, README file, setup.py, etc.).

Project description

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
    

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.

Project details


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
python-package-template-0.8.1.tar.gz (15.2 kB) Copy SHA256 hash SHA256 Source None Jul 8, 2011

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page