Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Python documentation viewer

Project description

viewdoc is a Python package documentation viewer. It converts reST-formatted text to HTML and displays it in a browser window.

viewdoc is typically used to check a package’s long description before uploading it to PyPI.

Installation

viewdoc works with Python 2.6 - 3.6 and all released versions of setuptools and distribute.

Use pip install jarn.viewdoc to install the viewdoc script.

Usage

viewdoc [options] [rst-file | egg-dir]

Options

-s style, --style=style, or --style
Select the custom style added to the HTML output.
-b browser, --browser=browser
Select the browser used for display. For a list of names see the webbrowser module.
-c config-file, --config-file=config-file
Use config-file instead of the default ~/.viewdoc.
-l, --list-styles
List available styles and exit.
-h, --help
Print the help message and exit.
-v, --version
Print the version string and exit.
rst-file
The reST file to view.
egg-dir
The Python package whose long description to view. Defaults to the current working directory.

Configuration

viewdoc reads style information from its configuration file ~/.viewdoc. Edit this file to add your own styles.

Known Bugs

If you are on macOS Sierra be aware of https://bugs.python.org/issue30392. As a workaround specify the browser on the command line:

$ viewdoc -b safari src/my.package

or use the configuration file:

[viewdoc]
browser = safari

Changelog

2.1 - 2017-10-06

  • Add MANIFEST.in. [stefan]

2.0 - 2017-07-20

  • Update pypi stylesheet (grey code blocks). [stefan]
  • Automatically upgrade stylesheet information. [stefan]
  • Add -b option to specify the browser to use. [stefan]
  • Protect against bad or incomplete locale settings. [stefan]

1.8 - 2017-01-30

  • Support Python 2.6 - 3.6 without 2to3. [stefan]

1.7 - 2014-03-22

  • Update PyPI stylesheet links in the face of new python.org. [stefan]
  • Add new pypi style and rename previous one to classic. [stefan]

1.6 - 2013-11-21

  • Support Python 3.x. [stefan]

1.5 - 2012-07-11

  • Restore Python 2.5 compatibility. [stefan]

1.4 - 2011-11-25

  • Warn if ~/.viewdoc has errors instead of raising an exception. [stefan]

1.3 - 2011-10-31

  • Be more careful with what we put on the PYTHONPATH. [stefan]
  • Add small style to the default config. [stefan]

1.2 - 2011-07-19

  • Pass the PYTHONPATH to subprocesses. [stefan]
  • Avoid temp file when extracting the long description. [stefan]
  • Add -l option to list available styles. [stefan]
  • Add –style shortcut for -s style. [stefan]

1.1 - 2011-02-08

  • Add -s option to select styles on the command line. [stefan]
  • In pypi style, only underline reference links. [stefan]

1.0 - 2010-12-30

  • Initial release [stefan]

Project details


Release history Release notifications

This version
History Node

2.1

History Node

2.0

History Node

1.8

History Node

1.7

History Node

1.6

History Node

1.5

History Node

1.4

History Node

1.3

History Node

1.2

History Node

1.1

History Node

1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
jarn.viewdoc-2.1-py2.py3-none-any.whl (15.3 kB) Copy SHA256 hash SHA256 Wheel 3.6 Oct 6, 2017
jarn.viewdoc-2.1.zip (19.3 kB) Copy SHA256 hash SHA256 Source None Oct 6, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page