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 setup.py file, which gets name and description for the PyPI from the docstrings in itself as well as in the main file (babtools_EXAMPLE.py).

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 setup.py 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 babtools_EXAMPLE.py).

  • 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 babtools_EXAMPLE.py) and then run “python setup.py register” (no file release) or “python setup.py register sdist upload” to include a file release (sources).

Usage:
  • babscript.py

    for default usage, or

  • babscript.py –help

    for getting help

Examples:
  • babscript.py

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

Plans:
  • None. At the moment I’m happy with this structure.

Ideas:
  • 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{http://freehg.org/u/ArneBab/babtools_EXAMPLE/}

PyPI URL: U{http://pypi.python.org/pypi/babtools_EXAMPLE}

Changelog:

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.

Source Distribution

babtools_EXAMPLE-0.9.tar.gz (3.6 kB view hashes)

Uploaded Source

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