DistInfo-ReadMe is a Python library for postviewing the readme of installed Python projects in a Python environment. The DistInfo-ReadMe package must be installed in that Python environment. The readme, that is displayed on the project page on PyPI under the heading Project description, is provided by the Description field or by the message body in the METADATA file in the .dist-info directory. The .dist-info directory is located along-side the importable modules and packages from the distribution of the installed project in the site-packages directory.
DistInfo-ReadMe will render the readme to a temporary HTML file that will be displayed in a webbrowser. Before developers upload their distribution archives to the Python Package Index, they can install the .whl file (built distribution), for example, in a test virtual environment along-side the DistInfo-ReadMe package. With DistInfo-ReadMe you can preview your readme.
Installation
In any Python environment with pip:
> pip install DistInfo-ReadMe
Usage
from console:
> distinfo_readme --help
usage: distinfo_readme [-h] [-V] [-b BROWSER_TYPE] [-t TIMEOUT] package
A postviewing of the readme of installed Python projects
positional arguments:
package name of installed package
options:
-h, --help show this help message and exit
-V, --version show program's version number and exit
-b BROWSER_TYPE, --browser-type BROWSER_TYPE
-t TIMEOUT, --timeout TIMEOUT
wait for webbrowser to open temporary HTML file (default 2 s)
> distinfo_readme DistInfo-ReadMe
Creating HTML file /tmp/tmpo0ppotys.html
> python -m distinfo_readme setuptools
Creating HTML file /tmp/tmprbzj6rz6.html
>
from Python console:
Python 3.11.2 (main, Mar 22 2023, 14:25:44) [GCC 12.2.1 20230201] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from distinfo_readme import *
>>> post_view('cmarkgfm')
Creating HTML file /tmp/tmp2mcl_o6f.html
>>>1 maintainer
Metadata
1 maintainer
Release files for DistInfo-ReadMe 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| DistInfo-ReadMe-1.0.0.tar.gz | 22.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| DistInfo_ReadMe-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 45.4 kB
Release files / DistInfo-ReadMe-1.0.0.tar.gz
| Download URL | DistInfo-ReadMe-1.0.0.tar.gz |
|---|---|
| Size | 22.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
73889cb27b91db1f0d9430c5b6f643873414b9ceefe2f5d1d85ac258be651d44
|
|
BLAKE2b-256 checksum How to use checksums |
73ab8ce970a59969236d22bbf49519b15131c667d89a35953e99abc22188ae31
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.2
|
Release files / DistInfo_ReadMe-1.0.0-py3-none-any.whl
| Download URL | DistInfo_ReadMe-1.0.0-py3-none-any.whl |
|---|---|
| Size | 23.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7aa40b9f19e9ba526b4252c451caa266088aa2e01fdab9169c9bf3f6cbcf2a13
|
|
BLAKE2b-256 checksum How to use checksums |
79157f77b939f800e22fadcc9a38fe8e397121d43e6af670571218a97aa8e238
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.2
|
