forked from pypa/packaging.python.org
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathnoxfile.py
More file actions
43 lines (34 loc) · 1.22 KB
/
noxfile.py
File metadata and controls
43 lines (34 loc) · 1.22 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
# 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(py="3")
def build(session, autobuild=False):
session.install("-r", "requirements.txt")
target_build_dir = "build"
shutil.rmtree(target_build_dir, ignore_errors=True)
if autobuild:
command = "sphinx-autobuild"
extra_args = "-H", "0.0.0.0"
else:
# NOTE: This branch adds options that are unsupported by autobuild
command = "sphinx-build"
extra_args = (
"--color", # colorize the output
"--keep-going", # don't interrupt the build on the first warning
)
session.run(
command, *extra_args,
"-j", "auto", # parallelize the build
"-b", "html", # use HTML builder
"-n", # nitpicky warn about all missing references
"-W", # Treat warnings as errors.
"source", # where the rst files are located
target_build_dir, # where to put the html output
)
@nox.session(py="3")
def preview(session):
session.install("sphinx-autobuild")
build(session, autobuild=True)