Skip to main content

Creates a diff highlighting changes between two reStructuredText inputs

Project description


rstdiff takes two reStructuredText documents as input, does a structural comaprison on them and produces an annotated result highlighting the changes. rstdiff “understands” reStructuredText and therefore is able to care for the subtleties of such a comparison the result is usually much more useful than a plain source diff.

The result is then written by a Docutils writer. Use the –writer option to select a writer for the result.


rstdiff uses the standard Distutils package. Thus the installation is done with something like:

python install


SYNOPSIS [options]… old-reST [new-reST [diff-output]]


Generates a structural diff from two reStructuredText input documents and produces an annotated result.


--writer=WRITER         Select writer to write output with (default "xml").
--old                   Following options apply to the old input document
                        (default: both input documents).
--new                   Following options apply to the new input document
                        (default: both input documents).
--both                  Following options apply to both input documents
                        Compare sections by comparing their names (default);
                        useful when section titles are stable but sections
                        Compare sections normally; useful when section titles




Original Source


rstdiff is available from

Project details

Download files

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

Source Distribution

rstdiff-0.5.2.tar.gz (24.6 kB view hashes)

Uploaded source

Built Distribution

rstdiff-0.5.2-py3-none-any.whl (24.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page