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

reStructuredText

To locally check whether your reStructuredText long descriptions will render on PyPI, simply install the readme_renderer library using:

$ pip install readme_renderer
$ python setup.py check -r -s
running check

If there’s a problem rendering your long_description, the check will tell you. If your long_description is fine, you’ll get no output.

Markdown

Checking your Markdown long descriptions is unecessary, because unlike rST, where a properly rendered description is all-or-nothing, PyPI will still render your Markdown description as Markdown if it has some invalid or incorrect syntax.

Code of Conduct

Everyone interacting in the readme_renderer project’s codebases, issue trackers, chat rooms, and mailing lists is expected to follow the PyPA 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-20.0.tar.gz (25.4 kB view details)

Uploaded Source

Built Distribution

readme_renderer-20.0-py2.py3-none-any.whl (12.9 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

File hashes

Hashes for readme_renderer-20.0.tar.gz
Algorithm Hash digest
SHA256 bde909eaa84d65b7942f7e6998c8b427b90b568b2630ff0306f4ca75f6d2a909
MD5 48b973c56329fc654452dae795dc818a
BLAKE2b-256 c8aa4b98370d8a5af38d2f9b75660e1240fa6f686fac4daae22a4172467d5574

See more details on using hashes here.

Provenance

File details

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

File metadata

File hashes

Hashes for readme_renderer-20.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 e7e43a7ba49f08c3cb660d0f2e25b561f6b10b36c63f029060230aab2dc2875e
MD5 5389195f8f4db74754656183580a2747
BLAKE2b-256 78776d76431e1692cecd4a751572aa6cf1337f4bd198ba2f6ede7410fa371c59

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