4
Summary: readme_renderer is a library for rendering "readme" descriptions for Warehouse
5
Home-page: https://github.com/pypa/readme_renderer
6
Author: The Python Packaging Authority
7
Author-email: admin@mail.pypi.org
8
License: Apache License, Version 2.0
9
Description-Content-Type: UNKNOWN
10
Description: Readme Renderer
13
Readme Renderer is a library that will safely render arbitrary
14
``README`` files into HTML. It is designed to be used in Warehouse_ to
15
render the ``long_description`` for packages. It can handle Markdown,
16
reStructuredText (``.rst``), and plain text.
18
.. _Warehouse: https://github.com/pypa/warehouse
21
Check Description Locally
22
-------------------------
27
To locally check whether your reStructuredText long descriptions will render on
28
PyPI, simply install the ``readme_renderer`` library using:
30
.. code-block:: console
32
$ pip install readme_renderer
33
$ python setup.py check -r -s
36
If there's a problem rendering your ``long_description``, the check
37
will tell you. If your ``long_description`` is fine, you'll get no
44
Checking your Markdown long descriptions is unecessary, because unlike rST,
45
where a properly rendered description is all-or-nothing, PyPI will still render
46
your Markdown description as Markdown if it has some invalid or incorrect
53
Everyone interacting in the readme_renderer project's codebases, issue trackers,
54
chat rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_.
56
.. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/
59
Classifier: Intended Audience :: Developers
60
Classifier: License :: OSI Approved :: Apache Software License
61
Classifier: Natural Language :: English
62
Classifier: Operating System :: MacOS :: MacOS X
63
Classifier: Operating System :: POSIX
64
Classifier: Operating System :: POSIX :: BSD
65
Classifier: Operating System :: POSIX :: Linux
66
Classifier: Operating System :: Microsoft :: Windows
67
Classifier: Programming Language :: Python
68
Classifier: Programming Language :: Python :: 2
69
Classifier: Programming Language :: Python :: 2.7
70
Classifier: Programming Language :: Python :: 3
71
Classifier: Programming Language :: Python :: 3.4
72
Classifier: Programming Language :: Python :: 3.5
73
Classifier: Programming Language :: Python :: 3.6
74
Classifier: Programming Language :: Python :: Implementation :: CPython
75
Classifier: Programming Language :: Python :: Implementation :: PyPy