========
restview
========
|buildstatus|_ |appveyor|_ |coverage|_
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
--version show program's version number and exit
-l PORT, --listen=PORT
listen on a given port (or interface:port, e.g.
\*:8080) [default: random port on localhost]
--allowed-hosts HOSTS
allowed values for the Host header (default: localhost
only, unless you specify -l \*:port, in which case any
Host: is accepted by default)
-b, --browser open a web browser [default: only if -l was not
specified]
-B, --no-browser don't open a web browser
-e COMMAND, --execute=COMMAND
run a command to produce ReStructuredText on stdout
-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]
--report-level REPORT_LEVEL
set the "report_level" option of docutils; restview
will report system messages at or above this level
(1=info, 2=warnings, 3=errors, 4=severe)
--halt-level HALT_LEVEL
set the "halt_level" option of docutils; restview will
stop processing the document when a system message at
or above this level (1=info, 2=warnings, 3=errors,
4=severe) is logged
--strict halt at the slightest problem; equivalent to --halt-
level=2
--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
.. |buildstatus| image:: https://github.com/mgedmin/restview/workflows/build/badge.svg?branch=master
.. _buildstatus: https://github.com/mgedmin/restview/actions
.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/github/mgedmin/restview?branch=master&svg=true
.. _appveyor: https://ci.appveyor.com/project/mgedmin/restview
.. |coverage| image:: https://coveralls.io/repos/mgedmin/restview/badge.svg?branch=master
.. _coverage: https://coveralls.io/r/mgedmin/restview
Changelog
=========
3.0.2 (2024-10-09)
------------------
- Add support for Python 3.12 and 3.13.
3.0.1 (2023-01-10)
------------------
- Add support for Python 3.11.
- Drop support for Python 3.6.
- Restrict readme-renderer to < 37.0, because it switched to a different
docutils writer (html5_polyglot instead of html4css1), which causes issues
(`issue 65 <https://github.com/mgedmin/restview/issues/65>`_). This will
be fixed properly in a newer release.
3.0.0 (2022-01-12)
------------------
- Drop support for Python 2.7.
2.9.3 (2021-11-29)
------------------
- Fix incompatibility with docutils 0.18.1 that resulted in "Cannot embed
stylesheet" errors (`issue 61 <https://github.com/mgedmin/restview/pull/61>`_,
contributed by Sébastien Besson).
- Add support for Python 3.8, 3.9, and 3.10.
- Drop support for Python 3.5.
2.9.2 (2019-04-23)
------------------
- Claim Python 3.7 support.
- Drop Python 3.4 support.
2.9.1 (2018-05-18)
------------------
- Ignore stderr from external commands that successfully produce stdout
(like warnings printed by setup.py --long-description).
Fixes `#55 <https://github.com/mgedmin/restview/issues/55>`_.
- Cope with readme_renderer.clean.clean() returning None on failure.
2.9.0 (2018-05-03)
------------------
- Added ``__main__.py`` module to allow package to be executable with
``python -m restview``. - SimplyKnownAsG
2.8.1 (2018-01-28)
------------------
- Protect against DNS rebinding attacks. See `#51
<https://github.com/mgedmin/restview/issues/51>`_.
2.8.0 (2017-12-07)
------------------
- Claim Python 3.6 support.
- Drop Python 3.3 support.
- New option ``--report-level`` that defaults to 2 (previously this was
hardcoded to 0). See `#49 <https://github.com/mgedmin/restview/issues/49>`_.
- Relax ``--strict`` to mean ``--halt-level=2`` (previously it meant
``--halt-level=1``). See `#49`_.
2.7.0 (2016-09-15)
------------------
- New option ``--halt-level`` (`#44
<https://github.com/mgedmin/restview/pull/44>`_), contributed by Kunshan
Wang.
- New option ``-B``/``--no-browser`` (`#46
<https://github.com/mgedmin/restview/issues/46>`_).
2.6.1 (2016-01-05)
------------------
- The ``readme`` dependency was renamed ``readme_renderer`` (fixes
`#30 <https://github.com/mgedmin/restview/issues/30>`_,
`#41 <https://github.com/mgedmin/restview/issues/41>`_).
2.6.0 (2015-12-31)
------------------
- Implement ``restview --version`` (`#37
<https://github.com/mgedmin/restview/issues/37>`_).
- Highlight the bad source line when rendering fails completely due to an
error, e.g. in ``--strict`` mode (`#40
<https://github.com/mgedmin/restview/issues/40>`_).
2.5.2 (2015-11-20)
------------------
- Use the right content type for SVG images (`#36
<https://github.com/mgedmin/restview/issues/36>`_).
2.5.1 (2015-11-17)
------------------
- Support SVG images (`#36 <https://github.com/mgedmin/restview/issues/36>`_).
2.5.0 (2015-10-27)
------------------
- Fix HTML cleaning code in --pypi-strict mode (`#33
<https://github.com/mgedmin/restview/issues/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)
------------------
- Follow PyPI's lead and rely on `readme
<https://pypi.python.org/pypi/readme>`__ for rendering in --pypi-strict mode.
Fixes https://github.com/mgedmin/restview/issues/28.
2.2.1 (2015-01-06)
------------------
- Fix style loss on autoreloading.
Fixes https://github.com/mgedmin/restview/issues/25.
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)
------------------
- Fix TypeError on Python 3 when reporting ReST errors (typically in strict
mode).
Fixes https://github.com/mgedmin/restview/issues/21.
- Fix TypeError on Python 3 when using ``--pypi-strict``.
2.1.0 (2014-09-02)
------------------
- ``--pypi-strict`` mode to catch additional problems that break rendering
on the Python Packaging Index. ``--long-description`` enables this
automatically.
Fixes https://github.com/mgedmin/restview/issues/18.
- Added installation section to the README.
Fixes https://github.com/mgedmin/restview/issues/19.
2.0.5 (2014-06-09)
------------------
- Avoid Unicode errors on Python 3 when the ReStructuredText file is in an
encoding that doesn't match the locale.
Fixes https://github.com/mgedmin/restview/issues/16.
- Avoid Unicode errors on Python 3when there are filenames in an encoding that
doesn't match the locale.
Fixes https://github.com/mgedmin/restview/issues/17.
2.0.4 (2014-04-28)
------------------
- Show a clear error when external command fails.
Fixes https://github.com/mgedmin/restview/issues/14.
- Stop mangling document titles.
Fixes https://github.com/mgedmin/restview/issues/15.
2.0.3 (2014-02-01)
------------------
- Distinguish document title from section titles with a larger font.
Fixes https://github.com/mgedmin/restview/issues/12.
- Minor tweaks and fixes to make restview work better on Windows (e.g. all
tests now pass).
2.0.2 (2013-10-02)
------------------
- Suppress errors when file disappears while restview is polling for changes.
Fixes https://github.com/mgedmin/restview/issues/11.
- Added a favicon. Fixes https://github.com/mgedmin/restview/issues/8.
2.0.1 (2013-05-01)
------------------
- Always require Pygments. Fixes https://github.com/mgedmin/restview/issues/9.
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.
Raw data
{
"_id": null,
"home_page": "https://mg.pov.lt/restview/",
"name": "restview",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "rst restructuredtext preview",
"author": "Marius Gedminas",
"author_email": "marius@gedmin.as",
"download_url": "https://files.pythonhosted.org/packages/3d/d4/36ed06051e9702d3dae5f7bb0296b79b18621ff5a1bf43247509cbfeff8d/restview-3.0.2.tar.gz",
"platform": null,
"description": "========\nrestview\n========\n\n|buildstatus|_ |appveyor|_ |coverage|_\n\nA viewer for ReStructuredText documents that renders them on the fly.\n\nPass the name of a ReStructuredText document to ``restview``, and it will\nlaunch a web server on localhost:random-port and open a web browser.\nEvery time you reload the page, restview will reload the document from\ndisk and render it. This is very convenient for previewing a document\nwhile you're editing it.\n\nYou can also pass the name of a directory, and restview will recursively\nlook for files that end in .txt or .rst and present you with a list.\n\nFinally, you can make sure your Python package has valid ReStructuredText\nin the long_description field by using ::\n\n restview --long-description\n\n\nSynopsis\n========\n\nUsage: ``restview [options] filename-or-directory [...]``\n\n-h, --help show this help message and exit\n--version show program's version number and exit\n-l PORT, --listen=PORT\n listen on a given port (or interface:port, e.g.\n \\*:8080) [default: random port on localhost]\n--allowed-hosts HOSTS\n allowed values for the Host header (default: localhost\n only, unless you specify -l \\*:port, in which case any\n Host: is accepted by default)\n-b, --browser open a web browser [default: only if -l was not\n specified]\n-B, --no-browser don't open a web browser\n-e COMMAND, --execute=COMMAND\n run a command to produce ReStructuredText on stdout\n-w FILENAME, --watch=FILENAME\n reload the page when a file changes (use with\n --execute); can be specified multiple times\n--long-description run \"python setup.py --long-description\" to produce\n ReStructuredText; also enables --pypi-strict and watches\n the usual long description sources (setup.py, README.rst,\n CHANGES.rst)\n--css=URL-or-FILENAME\n use the specified stylesheet; can be specified multiple\n times [default: html4css1.css,restview.css]\n--report-level REPORT_LEVEL\n set the \"report_level\" option of docutils; restview\n will report system messages at or above this level\n (1=info, 2=warnings, 3=errors, 4=severe)\n--halt-level HALT_LEVEL\n set the \"halt_level\" option of docutils; restview will\n stop processing the document when a system message at\n or above this level (1=info, 2=warnings, 3=errors,\n 4=severe) is logged\n--strict halt at the slightest problem; equivalent to --halt-\n level=2\n--pypi-strict enable additional restrictions that PyPI performs\n\n\nInstallation\n============\n\nOn .deb based systems (e.g. Ubuntu) ::\n\n sudo apt-get install python-pip\n sudo pip install restview\n\nOn .rpm based systems (e.g. Fedora) ::\n\n su\n yum install python-pip\n pip install restview\n\n\n.. |buildstatus| image:: https://github.com/mgedmin/restview/workflows/build/badge.svg?branch=master\n.. _buildstatus: https://github.com/mgedmin/restview/actions\n\n.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/github/mgedmin/restview?branch=master&svg=true\n.. _appveyor: https://ci.appveyor.com/project/mgedmin/restview\n\n.. |coverage| image:: https://coveralls.io/repos/mgedmin/restview/badge.svg?branch=master\n.. _coverage: https://coveralls.io/r/mgedmin/restview\n\n\nChangelog\n=========\n\n3.0.2 (2024-10-09)\n------------------\n\n- Add support for Python 3.12 and 3.13.\n\n\n3.0.1 (2023-01-10)\n------------------\n\n- Add support for Python 3.11.\n\n- Drop support for Python 3.6.\n\n- Restrict readme-renderer to < 37.0, because it switched to a different\n docutils writer (html5_polyglot instead of html4css1), which causes issues\n (`issue 65 <https://github.com/mgedmin/restview/issues/65>`_). This will\n be fixed properly in a newer release.\n\n\n3.0.0 (2022-01-12)\n------------------\n\n- Drop support for Python 2.7.\n\n\n2.9.3 (2021-11-29)\n------------------\n\n- Fix incompatibility with docutils 0.18.1 that resulted in \"Cannot embed\n stylesheet\" errors (`issue 61 <https://github.com/mgedmin/restview/pull/61>`_,\n contributed by S\u00e9bastien Besson).\n\n- Add support for Python 3.8, 3.9, and 3.10.\n\n- Drop support for Python 3.5.\n\n\n2.9.2 (2019-04-23)\n------------------\n\n- Claim Python 3.7 support.\n\n- Drop Python 3.4 support.\n\n\n2.9.1 (2018-05-18)\n------------------\n\n- Ignore stderr from external commands that successfully produce stdout\n (like warnings printed by setup.py --long-description).\n Fixes `#55 <https://github.com/mgedmin/restview/issues/55>`_.\n\n- Cope with readme_renderer.clean.clean() returning None on failure.\n\n\n2.9.0 (2018-05-03)\n------------------\n\n- Added ``__main__.py`` module to allow package to be executable with\n ``python -m restview``. - SimplyKnownAsG\n\n\n2.8.1 (2018-01-28)\n------------------\n\n- Protect against DNS rebinding attacks. See `#51\n <https://github.com/mgedmin/restview/issues/51>`_.\n\n\n2.8.0 (2017-12-07)\n------------------\n\n- Claim Python 3.6 support.\n\n- Drop Python 3.3 support.\n\n- New option ``--report-level`` that defaults to 2 (previously this was\n hardcoded to 0). See `#49 <https://github.com/mgedmin/restview/issues/49>`_.\n\n- Relax ``--strict`` to mean ``--halt-level=2`` (previously it meant\n ``--halt-level=1``). See `#49`_.\n\n\n2.7.0 (2016-09-15)\n------------------\n\n- New option ``--halt-level`` (`#44\n <https://github.com/mgedmin/restview/pull/44>`_), contributed by Kunshan\n Wang.\n\n- New option ``-B``/``--no-browser`` (`#46\n <https://github.com/mgedmin/restview/issues/46>`_).\n\n\n2.6.1 (2016-01-05)\n------------------\n\n- The ``readme`` dependency was renamed ``readme_renderer`` (fixes\n `#30 <https://github.com/mgedmin/restview/issues/30>`_,\n `#41 <https://github.com/mgedmin/restview/issues/41>`_).\n\n\n2.6.0 (2015-12-31)\n------------------\n\n- Implement ``restview --version`` (`#37\n <https://github.com/mgedmin/restview/issues/37>`_).\n\n- Highlight the bad source line when rendering fails completely due to an\n error, e.g. in ``--strict`` mode (`#40\n <https://github.com/mgedmin/restview/issues/40>`_).\n\n\n2.5.2 (2015-11-20)\n------------------\n\n- Use the right content type for SVG images (`#36\n <https://github.com/mgedmin/restview/issues/36>`_).\n\n\n2.5.1 (2015-11-17)\n------------------\n\n- Support SVG images (`#36 <https://github.com/mgedmin/restview/issues/36>`_).\n\n\n2.5.0 (2015-10-27)\n------------------\n\n- Fix HTML cleaning code in --pypi-strict mode (`#33\n <https://github.com/mgedmin/restview/issues/33>`_).\n\n- Drop Python 2.6 support.\n\n- Claim Python 3.5 support.\n\n\n2.4.0 (2015-05-27)\n------------------\n\n- Drop Python 3.2 support.\n\n- Stop dynamic computation of install_requires in setup.py, this doesn't work\n well in the presence of the pip 7 wheel cache.\n\n\n2.3.0 (2015-01-26)\n------------------\n\n- Follow PyPI's lead and rely on `readme\n <https://pypi.python.org/pypi/readme>`__ for rendering in --pypi-strict mode.\n Fixes https://github.com/mgedmin/restview/issues/28.\n\n\n2.2.1 (2015-01-06)\n------------------\n\n- Fix style loss on autoreloading.\n Fixes https://github.com/mgedmin/restview/issues/25.\n\n\n2.2.0 (2014-12-10)\n------------------\n\n- Reload the page using AJAX to preserve scroll position.\n Fixes https://github.com/mgedmin/restview/issues/22.\n\n- Use the default docutils CSS instead of replacing it wholesale.\n Drop some of our styles, including:\n\n - left-aligned document title\n - sans-serif font override for document text\n - fully-justified text\n - bold terms in definition lists\n - custom table rendering with just horizontal rules (issue #23)\n\n Keep other custom style overrides:\n\n - custom footnote rendering (I really like it)\n - white background for code blocks\n - prettier system error messages\n - unified alignment of code blocks, block quotes and doctests\n\n Fixes https://github.com/mgedmin/restview/issues/23.\n\n- The ``--css`` option can be provided multiple times and can refer to\n standard stylesheets (the ones provided by docutils as well as the ones\n provided by restview) without specifying the full path.\n\n For example, if you want to go back to the style used by restview before\n version 2.2.0, you can use ::\n\n restview --css oldrestview.css ...\n\n If you want your own custom style on top of the standard docutils\n styles, use ::\n\n restview --css html4css1.css --css ./path/to/my.css\n\n And if you want to completely override the stylesheet, use ::\n\n restview --css ./path/to/my.css\n\n- New option: ``--watch``. Reloads pages when a given file changes. Mostly\n useful with ``-e``, but can also come in handy when you're developing your\n CSS. Can be specified multiple times, e.g. ::\n\n restview --css my.css -e 'cat one.rst two.rst' -w my.css -w one.rst -w two.rst\n\n- ``restview --long-description`` watches setup.py, README.rst and CHANGES.rst\n for updates and reloads the description automatically.\n\n- Error pages will also reload automatically if the source file changes.\n\n- Error pages in strict mode will mention the filename instead of ``<string>``.\n\n- File watching now pays attention to fractional seconds.\n\n\n2.1.1 (2014-09-28)\n------------------\n\n- Fix TypeError on Python 3 when reporting ReST errors (typically in strict\n mode).\n Fixes https://github.com/mgedmin/restview/issues/21.\n\n- Fix TypeError on Python 3 when using ``--pypi-strict``.\n\n\n2.1.0 (2014-09-02)\n------------------\n\n- ``--pypi-strict`` mode to catch additional problems that break rendering\n on the Python Packaging Index. ``--long-description`` enables this\n automatically.\n Fixes https://github.com/mgedmin/restview/issues/18.\n\n- Added installation section to the README.\n Fixes https://github.com/mgedmin/restview/issues/19.\n\n\n2.0.5 (2014-06-09)\n------------------\n\n- Avoid Unicode errors on Python 3 when the ReStructuredText file is in an\n encoding that doesn't match the locale.\n Fixes https://github.com/mgedmin/restview/issues/16.\n\n- Avoid Unicode errors on Python 3when there are filenames in an encoding that\n doesn't match the locale.\n Fixes https://github.com/mgedmin/restview/issues/17.\n\n\n2.0.4 (2014-04-28)\n------------------\n\n- Show a clear error when external command fails.\n Fixes https://github.com/mgedmin/restview/issues/14.\n\n- Stop mangling document titles.\n Fixes https://github.com/mgedmin/restview/issues/15.\n\n\n2.0.3 (2014-02-01)\n------------------\n\n- Distinguish document title from section titles with a larger font.\n Fixes https://github.com/mgedmin/restview/issues/12.\n\n- Minor tweaks and fixes to make restview work better on Windows (e.g. all\n tests now pass).\n\n\n2.0.2 (2013-10-02)\n------------------\n\n- Suppress errors when file disappears while restview is polling for changes.\n Fixes https://github.com/mgedmin/restview/issues/11.\n\n- Added a favicon. Fixes https://github.com/mgedmin/restview/issues/8.\n\n\n2.0.1 (2013-05-01)\n------------------\n\n- Always require Pygments. Fixes https://github.com/mgedmin/restview/issues/9.\n\n\n2.0 (2013-04-04)\n----------------\n\n- Python 3 support (LP#1093098). Patch by Steven Myint (git@stevenmyint.com).\n\n- Moved to Github.\n\n- 100% test coverage.\n\n- Automatically reload the web page when the source file changes (LP#965746).\n Patch by speq (sp@bsdx.org), with modifications by Eric Knibbe and Marius\n Gedminas.\n\n- New option: restview --long-description (shows the output of python setup.py\n --long-description).\n\n- New option: restview --strict. Patch by Steven Myint (git@stevenmyint.com).\n\n- Improve auto-linkification of local file names:\n\n * allow subdirectories\n * recognize .rst extensions\n\n- Many improvements by Eric Knibbe:\n\n * ``restview dirname`` now ignores hidden subdirectories.\n * files in directory listings are sorted case-insensitively.\n * allow serving gif and jpg images.\n * CSS rules for rubric, sidebars, and many other things.\n * syntax highlighting for code blocks.\n * improved HTTP error messages.\n * HTTP headers to prevent browser caching of dynamic content.\n\n\n1.2.2 (2010-09-14)\n------------------\n\n- setup.py no longer requires docutils (LP#637423).\n\n\n1.2.1 (2010-09-12)\n------------------\n\n- Handle spaces and other special characters in URLs (LP#616335).\n\n- Don't linkify filenames inside external references (LP#634827).\n\n\n1.2 (2010-08-06)\n----------------\n\n- \"SEVERE\" docutils errors now display a message and unformatted file in\n the browser, instead of a traceback on the console.\n- New command-line option, -e COMMAND.\n- Added styles for admonitions; many other important styles are still missing.\n\n\n1.1.3 (2009-10-25)\n------------------\n\n- Spell 'extras_require' correctly in setup.py (LP#459840).\n- Add a MANIFEST.in for complete source distributions (LP#459845).\n\n\n1.1.2 (2009-10-14)\n------------------\n\n- Fix for 'localhost' name resolution error on Mac OS X.\n\n\n1.1.1 (2009-07-13)\n------------------\n\n- Launches the web server in the background.\n\n\n1.1.0 (2008-08-26)\n------------------\n\n- Accepts any number of files and directories on the command line.\n\n\n1.0.1 (2008-07-26)\n------------------\n\n- New option: --css. Accepts a filename or an HTTP/HTTPS URL.\n\n\n1.0.0 (2008-07-26)\n------------------\n\n- Bumped version number to reflect the stability.\n- Minor CSS tweaks.\n\n\n0.0.5 (2007-09-29)\n------------------\n\n- Create links to other local files referenced by name.\n- Use pygments (if available) to syntax-highlight doctest blocks.\n- Handle JPEG images.\n\n\n0.0.4 (2007-09-28)\n------------------\n\n- Remove the unstable Gtk+ version.\n\n\n0.0.3 (2007-09-28)\n------------------\n\n- Use setuptools for packaging.\n\n\n0.0.2 (2007-01-21)\n------------------\n\n- Browser-based version.\n- Command line options -l, -b (thanks to Charlie Shepherd).\n- CSS tweaks.\n- Unicode bugfix.\n- Can browse directory trees.\n- Can serve images.\n\n\n0.0.1 (2005-12-06)\n------------------\n\n- PyGtk+ version with GtkMozEmbed. Not very stable.\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "ReStructuredText viewer",
"version": "3.0.2",
"project_urls": {
"Homepage": "https://mg.pov.lt/restview/",
"Source": "https://github.com/mgedmin/restview"
},
"split_keywords": [
"rst",
"restructuredtext",
"preview"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "11694046cbec75d4574e84fa3b2be53487ae9054129527211961555631805849",
"md5": "518a2fe176009d1435aa40b8d754c693",
"sha256": "9fbd26507f6ddc436a49d0ffced5bc8102a898f289fe53c1234a17be46eb660d"
},
"downloads": -1,
"filename": "restview-3.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "518a2fe176009d1435aa40b8d754c693",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 38020,
"upload_time": "2024-10-09T15:34:46",
"upload_time_iso_8601": "2024-10-09T15:34:46.019550Z",
"url": "https://files.pythonhosted.org/packages/11/69/4046cbec75d4574e84fa3b2be53487ae9054129527211961555631805849/restview-3.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3dd436ed06051e9702d3dae5f7bb0296b79b18621ff5a1bf43247509cbfeff8d",
"md5": "2c3544489223a99dc91e384b5b34c893",
"sha256": "8b4d75a0bed76b67b456ef7011f4eb6c98a556c9f837642df2202c7312fccc1a"
},
"downloads": -1,
"filename": "restview-3.0.2.tar.gz",
"has_sig": false,
"md5_digest": "2c3544489223a99dc91e384b5b34c893",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 50048,
"upload_time": "2024-10-09T15:34:48",
"upload_time_iso_8601": "2024-10-09T15:34:48.378092Z",
"url": "https://files.pythonhosted.org/packages/3d/d4/36ed06051e9702d3dae5f7bb0296b79b18621ff5a1bf43247509cbfeff8d/restview-3.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-09 15:34:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mgedmin",
"github_project": "restview",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"appveyor": true,
"tox": true,
"lcname": "restview"
}
JSON
