Skip to main content

helps you manage a Python distribution

Project description


disthelper is a command line tool that helps you manage a Python distribution. You may want to create Python scripts to automate common maintenance tasks for your project. But where do you put them? How about the standard framework? You can think of as a “make” tool for Python, although it’s more like how Ian Bicking describes it and less like an actual make tool with targets and dependencies. For example, if you wrote a script to build your project docs and another to upload them, you could run these commands from your file:

python build_docs upload_docs

What it does

disthelper just automates the use of distutils so you don’t have to think about how to create a custom command. It sets up the module / submodule structure, edits your setup.cfg, and adds new command modules as you request them. disthelper doesn’t do anything you couldn’t do by hand.


You can easy_install it:

easy_install disthelper

Or grab the source

Create a command

disthelper is implemented as a Paste extension. Let’s say you want to create this build_docs command I mentioned. cd into your project directory and type:

$ paster distcmd build_docs
| Selected and implied templates:
|   disthelper#distcmd  A disthelper-based package for commands
| ** creating ./ (you'll probably need to edit this)
| Variables:
|   command:       build_docs
|   distcmds_mod:  distcmds
|   package:       foo
| Creating template distcmd
|   Recursing into +package+
|     Creating ./foo/
|     Recursing into +distcmds_mod+
|       Creating ./foo/distcmds/
|       Copying +command+.py_tmpl to ./foo/distcmds/
|       Copying to ./foo/distcmds/
|     Copying to ./foo/
| patching ./setup.cfg ...
| ./foo/distcmds/
| ready to edit
| run as:
|     python build_docs

If you don’t already have a Python package it will prompt you for its name. Assuming you named your package foo, you should see the following layout:

$ tree
| .
| |-- foo
| |   |--
| |   `-- distcmds
| |       |--
| |       `--
| |-- setup.cfg
| `--
| 2 directories, 5 files

Your command is ready to run:

$ python build_docs --help
| Global options:
|   --verbose (-v)  run verbosely (default)
|   --quiet (-q)    run quietly (turns verbosity off)
|   --dry-run (-n)  don't actually do anything
|   --help (-h)     show detailed help message
| Options for 'build_docs' command:
|   --long-option (-l)        <help>
|   --other-long-option (-o)  <help>
| usage: [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
|    or: --help [cmd1 cmd2 ...]
|    or: --help-commands
|    or: cmd --help

However, it doesn’t do anything useful yet so get to it!

My command disappeared, what do I do?

Unfortunately, distutils will completely ignore any ImportError in your command so one day your command might simply disappear. To check that your command is set up correctly, run:

$ paster distcmd build_docs --check
| Selected and implied templates:
|   disthelper#distcmd  A disthelper-based package for commands
| Variables:
|   command:       build_docs
|   distcmds_mod:  distcmds
|   package:       foo
| attempting to import foo.distcmds.build_docs
| OK
| checking vars in ./setup.cfg
| build_docs OK

Other make like tools

disthelper isn’t designed for complex builds, dependency management, etc, it just helps you create maintenance scripts. You may want to check out…

  • Vellum

    • Vellum is a simple build tool like make but written in Python using a simple yet flexible YAML based format.


    • A software construction tool

  • zc.buildout

    • System for managing development buildouts


  • 0.9.2

    • fixed another bug in generating files

    • added shelldoc support for functional tests (README examples)

  • 0.9.1

    • fixed handling of file when one doesn’t already exist

  • 0.9

    • first release, basic paster command working

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

disthelper-0.9.2.tar.gz (11.2 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page