Skip to main content

readme_renderer is a library for rendering "readme" descriptions for Warehouse

Project description

Readme Renderer is a library that will safely render arbitrary README files into HTML. It is designed to be used in Warehouse to render the long_description for packages. It can handle Markdown, reStructuredText (.rst), and plain text.

Check Description Locally

To locally check whether your long descriptions will render on PyPI, first build your distributions, and then use the twine check command.

Render rST Description Locally

You can use readme_renderer on the command line to render an rST file as HTML like this:

python -m readme_renderer README.rst -o /tmp/README.html

Code of Conduct

Everyone interacting in the readme_renderer project’s codebases, issue trackers, chat rooms, and mailing lists is expected to follow the PSF Code of Conduct.

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

readme_renderer-30.0.tar.gz (27.1 kB view details)

Uploaded Source

Built Distribution

readme_renderer-30.0-py2.py3-none-any.whl (15.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file readme_renderer-30.0.tar.gz.

File metadata

  • Download URL: readme_renderer-30.0.tar.gz
  • Upload date:
  • Size: 27.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for readme_renderer-30.0.tar.gz
Algorithm Hash digest
SHA256 8299700d7a910c304072a7601eafada6712a5b011a20139417e1b1e9f04645d8
MD5 0664b27e2f3ed22ee210caddb5e0de95
BLAKE2b-256 cba59d2333bd020bb1979ba51ab5acf59d77559951405e024e49576b5bee1a90

See more details on using hashes here.

Provenance

File details

Details for the file readme_renderer-30.0-py2.py3-none-any.whl.

File metadata

  • Download URL: readme_renderer-30.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 15.8 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for readme_renderer-30.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 3286806450d9961d6e3b5f8a59f77e61503799aca5155c8d8d40359b4e1e1adc
MD5 9268cc82ad67fcf7e8604e678fae0500
BLAKE2b-256 d1dedbce4036189641c51d2114da1cbdfeceb81e406b29e7a4ecd260140f9be3

See more details on using hashes here.

Provenance

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