Skip to main content

Test your projects packaging friendlyness

Project description


Pyroma rhymes with aroma, and is a product aimed at giving a rating of how well a Python project complies with the best practices of the Python packaging ecosystem, primarily PyPI, pip, Distribute etc, as well as a list of issues that could be improved.

The aim of this is both to help people make a project that is nice and usable, but also to improve the quality of Python third-party software, making it easier and more enjoyable to use the vast array of available modules for Python.

It’s written so that there are a library with methods to call from Python, as well as a script, also called pyroma.

It can be run on a project directory before making a release:

$ pyroma .

On a distribution before uploading it to the CheeseShop:

$ pyroma pyroma-1.0.tar.gz

Or you can give it a package name on CheeseShop:

$ pyroma pyroma

In all cases the output is similar:

Checking .
Found pyroma
Did you forget to declare the following dependencies?: setup
Final rating: 9/10
Cottage Cheese


  • Figure out why the long_description doesn’t render to HTML properly.
  • Add a test for that.
  • Figure out how to stop ast from failing on perfectly valid code.
  • Discuss whether to check for missing imports at all, since so many packages seem to break this.
  • More verification tests?
  • More unit tests! Many more unit tests!!! And mock PyPI instead of using it.


The project was created by Lennart Regebro, The name “Pyroma” was coined by Wichert Akkerman,


0.9.2 (2011-03-13)

  • Commented out the dependency test, it was too unreliable.
  • Fixed the ReST.
  • Python 3 support.

0.9.1 (2011-03-08)

  • Initial release

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
pyroma-0.9.2.tar.gz (23.2 kB) Copy SHA256 hash SHA256 Source None

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