readthedocs-build icon indicating copy to clipboard operation
readthedocs-build copied to clipboard

Work in Progress builder

Read the Docs Builder

.. important::

This repo was moved to the Read the Docs code <https://github.com/rtfd/readthedocs.org/tree/master/readthedocs/config>__. Issues and pull requests should be done there.

.. warning:: This repo is only used as a configuration parser for readthedocs.org builds, and it's unsupported for other uses.

Install

Install with pip::

pip install readthedocs-build

Library Use

Example uses of this library is:

  • https://github.com/rtfd/readthedocs.org/blob/0e1112f96e3ba344271a44305028a811072fd10a/readthedocs/doc_builder/config.py#L8-L9
  • https://github.com/rtfd/readthedocs.org/blob/0e1112f96e3ba344271a44305028a811072fd10a/readthedocs/projects/tasks.py#L27

Development

Just run::

pip install -e .

This will install the project into your environment, and have it pick up changes as you edit them in the code.

To run the tests::

tox