This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

A viewer for ReStructuredText documents that renders them on the fly.

Pass the name of a ReStructuredText document to restview, and it will launch a web server on localhost:random-port and open a web browser. Every time you reload the page, restview will reload the document from disk and render it. This is very convenient for previewing a document while you’re editing it.

You can also pass the name of a directory, and restview will recursively look for files that end in .txt or .rst and present you with a list.

Finally, you can make sure your Python package has valid ReStructuredText in the long_description field by using

restview --long-description

Synopsis

Usage: restview [options] filename-or-directory [...]

-h, --help show this help message and exit
-l PORT, --listen=PORT
 listen on a given port (or interface:port, e.g. *:8080) [default: random port on localhost]
-b, --browser open a web browser [default: only if -l was not specified]
-e COMMAND, --execute=COMMAND
 run a command to produce ReStructuredText
-w FILENAME, --watch=FILENAME
 reload the page when a file changes (use with –execute); can be specified multiple times
--long-description
 run “python setup.py –long-description” to produce ReStructuredText; also enables –pypi-strict and watches the usual long description sources (setup.py, README.rst, CHANGES.rst)
--css=URL-or-FILENAME
 use the specified stylesheet; can be specified multiple times [default: html4css1.css,restview.css]
--strict halt at the slightest problem
--pypi-strict enable additional restrictions that PyPI performs

Installation

On .deb based systems (e.g. Ubuntu)

sudo apt-get install python-pip
sudo pip install restview

On .rpm based systems (e.g. Fedora)

su
yum install python-pip
pip install restview

Changelog

2.7.0 (2016-09-15)

  • New option --halt-level (#44), contributed by Kunshan Wang.
  • New option -B/--no-browser (#46).

2.6.1 (2016-01-05)

  • The readme dependency was renamed readme_renderer (fixes #30, #41).

2.6.0 (2015-12-31)

  • Implement restview --version (#37).
  • Highlight the bad source line when rendering fails completely due to an error, e.g. in --strict mode (#40).

2.5.2 (2015-11-20)

  • Use the right content type for SVG images (#36).

2.5.1 (2015-11-17)

  • Support SVG images (#36).

2.5.0 (2015-10-27)

  • Fix HTML cleaning code in –pypi-strict mode (#33).
  • Drop Python 2.6 support.
  • Claim Python 3.5 support.

2.4.0 (2015-05-27)

  • Drop Python 3.2 support.
  • Stop dynamic computation of install_requires in setup.py, this doesn’t work well in the presence of the pip 7 wheel cache.

2.3.0 (2015-01-26)

2.2.1 (2015-01-06)

2.2.0 (2014-12-10)

  • Reload the page using AJAX to preserve scroll position. Fixes https://github.com/mgedmin/restview/issues/22.

  • Use the default docutils CSS instead of replacing it wholesale. Drop some of our styles, including:

    • left-aligned document title
    • sans-serif font override for document text
    • fully-justified text
    • bold terms in definition lists
    • custom table rendering with just horizontal rules (issue #23)

    Keep other custom style overrides:

    • custom footnote rendering (I really like it)
    • white background for code blocks
    • prettier system error messages
    • unified alignment of code blocks, block quotes and doctests

    Fixes https://github.com/mgedmin/restview/issues/23.

  • The --css option can be provided multiple times and can refer to standard stylesheets (the ones provided by docutils as well as the ones provided by restview) without specifying the full path.

    For example, if you want to go back to the style used by restview before version 2.2.0, you can use

    restview --css oldrestview.css ...
    

    If you want your own custom style on top of the standard docutils styles, use

    restview --css html4css1.css --css ./path/to/my.css
    

    And if you want to completely override the stylesheet, use

    restview --css ./path/to/my.css
    
  • New option: --watch. Reloads pages when a given file changes. Mostly useful with -e, but can also come in handy when you’re developing your CSS. Can be specified multiple times, e.g.

    restview --css my.css -e 'cat one.rst two.rst' -w my.css -w one.rst -w two.rst
    
  • restview --long-description watches setup.py, README.rst and CHANGES.rst for updates and reloads the description automatically.

  • Error pages will also reload automatically if the source file changes.

  • Error pages in strict mode will mention the filename instead of <string>.

  • File watching now pays attention to fractional seconds.

2.1.1 (2014-09-28)

2.1.0 (2014-09-02)

2.0.5 (2014-06-09)

2.0.4 (2014-04-28)

2.0.3 (2014-02-01)

2.0.2 (2013-10-02)

2.0.1 (2013-05-01)

2.0 (2013-04-04)

  • Python 3 support (LP#1093098). Patch by Steven Myint (git@stevenmyint.com).
  • Moved to Github.
  • 100% test coverage.
  • Automatically reload the web page when the source file changes (LP#965746). Patch by speq (sp@bsdx.org), with modifications by Eric Knibbe and Marius Gedminas.
  • New option: restview –long-description (shows the output of python setup.py –long-description).
  • New option: restview –strict. Patch by Steven Myint (git@stevenmyint.com).
  • Improve auto-linkification of local file names:
    • allow subdirectories
    • recognize .rst extensions
  • Many improvements by Eric Knibbe:
    • restview dirname now ignores hidden subdirectories.
    • files in directory listings are sorted case-insensitively.
    • allow serving gif and jpg images.
    • CSS rules for rubric, sidebars, and many other things.
    • syntax highlighting for code blocks.
    • improved HTTP error messages.
    • HTTP headers to prevent browser caching of dynamic content.

1.2.2 (2010-09-14)

  • setup.py no longer requires docutils (LP#637423).

1.2.1 (2010-09-12)

  • Handle spaces and other special characters in URLs (LP#616335).
  • Don’t linkify filenames inside external references (LP#634827).

1.2 (2010-08-06)

  • “SEVERE” docutils errors now display a message and unformatted file in the browser, instead of a traceback on the console.
  • New command-line option, -e COMMAND.
  • Added styles for admonitions; many other important styles are still missing.

1.1.3 (2009-10-25)

  • Spell ‘extras_require’ correctly in setup.py (LP#459840).
  • Add a MANIFEST.in for complete source distributions (LP#459845).

1.1.2 (2009-10-14)

  • Fix for ‘localhost’ name resolution error on Mac OS X.

1.1.1 (2009-07-13)

  • Launches the web server in the background.

1.1.0 (2008-08-26)

  • Accepts any number of files and directories on the command line.

1.0.1 (2008-07-26)

  • New option: –css. Accepts a filename or an HTTP/HTTPS URL.

1.0.0 (2008-07-26)

  • Bumped version number to reflect the stability.
  • Minor CSS tweaks.

0.0.5 (2007-09-29)

  • Create links to other local files referenced by name.
  • Use pygments (if available) to syntax-highlight doctest blocks.
  • Handle JPEG images.

0.0.4 (2007-09-28)

  • Remove the unstable Gtk+ version.

0.0.3 (2007-09-28)

  • Use setuptools for packaging.

0.0.2 (2007-01-21)

  • Browser-based version.
  • Command line options -l, -b (thanks to Charlie Shepherd).
  • CSS tweaks.
  • Unicode bugfix.
  • Can browse directory trees.
  • Can serve images.

0.0.1 (2005-12-06)

  • PyGtk+ version with GtkMozEmbed. Not very stable.
Release History

Release History

2.7.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.6.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.6.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.5.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.5.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.5.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.4.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.3.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.2.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.2.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.1.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0.5

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0.4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.2.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.2.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.1.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.1.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.1.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.5

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
restview-2.7.0-py2.py3-none-any.whl (29.2 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Sep 15, 2016
restview-2.7.0.tar.gz (29.4 kB) Copy SHA256 Checksum SHA256 Source Sep 15, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting