Skip to main content

rstviewer is a simple program for editing a reStructuredText (RST) file. In fact, it’s being used to edit this file right now!

Usage

Executing

$ rstviewer file.rst

opens a new browser window containing an HTML representation of of file.rst. The browser window refreshes when file.rst is changed.

Options

By default, rstviewer runs in quiet mode – no logging messages are emitted, so as not to interfere with editing in the console. The option -v, which can be specified multiple times, increases the verbosity level.

Security

Practically nonexistent. The program creates an HTTP server which serves all files located in or beneath the directory containing file.rst. This is to facilitate the loading of images and other assets linked by the RST document. Although the server binds only to the local interface, this is still insecure. In short, do not use this program if you are concerned about security.

Requirements

Python 3.6+ and a browser which supports WebSockets. (The package has been tested only on Chrome and Safari, thus far.)

Author

Jonathan Terhorst <terhorst@gmail.com>

Inspiration

NPM package rst-live-preview, which I could not get running.

Metadata

Release files for rstviewer 0.0.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rstviewer 0.0.8
File Size Uploaded
rstviewer-0.0.8.tar.gz 18.4 kB Details

Release files / rstviewer-0.0.8.tar.gz

Download URL rstviewer-0.0.8.tar.gz
Size 18.4 kB
Tags Source
SHA-256 checksum
How to use checksums
f6e6588ecd3ffc92c948c3f5963d541bf1c9301ab6bbaac64c22fef745febd7a
BLAKE2b-256 checksum
How to use checksums
1c24464d03ac8b157a98013a2dbadaf9d43ca701a0364c2b92f9430062c17895
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.56.2 CPython/3.9.1

Release history Release notifications | RSS feed

This release

0.0.8 This release

1 release file

0.0.7

1 release file

0.0.6

1 release file

0.0.5

1 release file

0.0.4.1

1 release file

0.0.4

3 release files

0.0.2

1 release file

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page