sinoroc / rst2sh5

Docutils writer outputting semantic HTML5

Contents

• 1   Hacking
  • 1.1   Development environment
  • 1.2   Run test suite
  • 1.3   Build and package

1   Hacking

This project makes extensive use of tox, pytest, and GNU Make.

1.1   Development environment

Use following command to create a Python virtual environment with all necessary dependencies:

tox --recreate -e develop

This creates a Python virtual environment in the .tox/develop directory. It can be activated with the following command:

. .tox/develop/bin/activate

1.2   Run test suite

In a Python virtual environment run the following command:

make review

Outside of a Python virtual environment run the following command:

tox --recreate

1.3   Build and package

In a Python virtual environment run the following command:

make package

Outside of a Python virtual environment run the following command:

tox --recreate -e package