nox.py

# Copyright 2017, PyPA
# The Python Packaging User Guide is licensed under a Creative Commons
# Attribution-ShareAlike license:
#   http://creativecommons.org/licenses/by-sa/3.0.

import shutil
import nox


@nox.session
def build(session, autobuild=False):
    session.interpreter = 'python3.6'
    session.install('-r', 'requirements.txt')
    # Treat warnings as errors.
    session.env['SPHINXOPTS'] = '-W'
    session.run(shutil.rmtree, 'build', ignore_errors=True)

    if autobuild:
        command = 'sphinx-autobuild'
    else:
        command = 'sphinx-build'

    session.run(command, '-W', '-b', 'html', 'source', 'build')


@nox.session
def preview(session):
    session.reuse_existing_virtualenv = True
    session.install("sphinx-autobuild")
    build(session, autobuild=True)