Skip to main content

Fancy PyPI READMEs with Hatch

Project description


Because your ✨fancy project✨ deserves a ✨fancy PyPI landing page✨.

PyPI - Version PyPI - Python Version License: MIT

hatch-fancy-pypi-readme is a Hatch metadata plugin for everyone who cares about the first impression of their project’s PyPI landing page. It allows you to define your PyPI project description in terms of concatenated fragments that are based on static strings, files, and most importantly: parts of files defined using cut-off points or regular expressions.

You want your PyPI readme to be the project readme, but without badges, followed by the license file, and the changelog section for only the last release? You’ve come to the right place!

Note PyPI project description, PyPI landing page, and PyPI readme all refer to the same thing. In setuptools it’s called long_description and is the text shown on a project’s PyPI page. We refer to it as “readme” because that’s how it’s called in PEP 621-based pyproject.toml files.


In the olden days of files, I’ve taken advantage of the fact that I can write Python to have compelling PyPI readmes.

For example this is the code that gave me the PyPI readme for attrs 22.1.0. Especially having a summary of the latest changes is something I’ve found users to appreciate.

The move away from dynamic files to static pyproject.toml configurations is great, but it robbed me of being able to provide this service to my users. I’ve been able to add some dynamism using the wonderful Cog, but it’s a bit awkward and shouldn’t be the long-term solution.

The goal of this plugin is to be able to switch away from without compromising on the user experience and without needing third-party tools for configuration-file templating.

With Hatch we got a standards-based packaging library that offers exactly the plugin interface I needed. Now you too can have fancy PyPI readmes – just by adding a few lines of configuration to your pyproject.toml.

Project Links

Release Information

22.2.0 - 2022-08-05


  • We can finally use hatch-fancy-pypi-readme for our own ✨fancy✨ PyPI readme!


  • Hopefully fixed readmes with emojis on Windows.

Of course, this PyPI readme has been created by hatch-fancy-pypi-readme. Isn’t it ✨fancy✨?

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

hatch_fancy_pypi_readme-22.2.0.tar.gz (23.4 kB view hashes)

Uploaded Source

Built Distribution

hatch_fancy_pypi_readme-22.2.0-py3-none-any.whl (10.2 kB view hashes)

Uploaded Python 3

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