Skip to main content

Example structure with efficient PyPI usage: very small overhead for updating the PyPI entry.

Project description

This example covers a nice file, which gets name and description for the PyPI from the docstrings in itself as well as in the main file (

The changelog is automatically extracted from the file Changelog.txt and appended to the long description for the PyPI.

To customize it, you need to change the following:
  • The first line of this files docstring - it will be your name and description in PyPI. You must keep the dash (” - “) as seperator between name and description to make getting name and description work.
  • Every occurrence of “babtools_EXAMPLE” in this file to the name of your module
  • Author, author_email, etc. in setup() to your preferred settings.
    • A list of all classifiers can be found via python register –list-classifiers
  • This docstring to a mainly static description of your program.Things which may change at times should go into your main file (here it’s
  • Your main files docstring, which provides the second paragraph (its first line is ignored).

For updating your PyPI entry to a new version, you only need to change the __version__ parameter in your main file (here it is and then run “python register” (no file release) or “python register sdist upload” to include a file release (sources).


    for default usage, or

  • –help

    for getting help


    Print the help message, since we have nothing else to do right now.

  • None. At the moment I’m happy with this structure.
  • Adding information, how to use Mercurial to use this structure in your own project and keep it up to date while keeping your changes.

Source URL (Mercurial): U{}



babtools_EXAMPLe 0.9

  • Added plans and ideas to the main file.

babtools_EXAMPLE 0.8

  • Added customization instructions.

babtools_EXAMPLE 0.7

  • Removed the title in the batools_EXAMPLE file from the PyPI description.”

babtools_EXAMPLE 0.6

  • Improved code comments.

babtools_EXAMPLE 0.5

  • Some cleaning up.

babtools_EXAMPLE 0.4

  • Improved description on PyPI.

babtools_EXAMPLE 0.3

  • Better documentation.
  • Removed the name from the description for PyPI.

babtools_EXAMPLE 0.2

  • Now reading changes from Changelog.txt

babtools_EXAMPLE 0.1

  • Created working example structure.

Project details

Download files

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

Files for babtools_EXAMPLE, version 0.9
Filename, size File type Python version Upload date Hashes
Filename, size babtools_EXAMPLE-0.9.tar.gz (3.6 kB) File type Source Python version None Upload date Hashes View

Supported by

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