Skip to main content

Fancy PyPI READMEs with Hatch

Project description

Your ✨Fancy✨ Project Deserves a ✨Fancy✨ PyPI Readme! 🧐

PyPI - Version PyPI - Python Version Hatch project 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.

Once you’ve assembled your readme, you can additionally run regular-expression substitutions over it. For instance to make relative links absolute or to linkify users and issue numbers in your changelog.

Do 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.


Project Links


hatch-fancy-pypi-readme is written and maintained by Hynek Schlawack and released under the MIT license.

The development is kindly supported by Variomedia AG and all my amazing GitHub Sponsors.

A full list of contributors can be found on GitHub’s overview.

Release Information for 22.4.0 - 2022-09-10


  • It is now possible to run regular expression-based substitutions over the final readme. #9 #11

Full changelog can be found here.

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.4.0.tar.gz (28.6 kB view hashes)

Uploaded Source

Built Distribution

hatch_fancy_pypi_readme-22.4.0-py3-none-any.whl (14.0 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