mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
109 lines
3.2 KiB
Python
109 lines
3.2 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""
|
|
test_build
|
|
~~~~~~~~~~
|
|
|
|
Test all builders.
|
|
|
|
:copyright: Copyright 2007-2015 by the Sphinx team, see AUTHORS.
|
|
:license: BSD, see LICENSE for details.
|
|
"""
|
|
|
|
from six import BytesIO
|
|
|
|
from textwrap import dedent
|
|
from sphinx.errors import SphinxError
|
|
|
|
from util import with_app, rootdir, tempdir, SkipTest, TestApp
|
|
|
|
try:
|
|
from docutils.writers.manpage import Writer as ManWriter
|
|
except ImportError:
|
|
ManWriter = None
|
|
|
|
|
|
class MockOpener(object):
|
|
def open(self, req, **kwargs):
|
|
class result(BytesIO):
|
|
headers = None
|
|
url = req.url
|
|
return result()
|
|
|
|
import sphinx.builders.linkcheck
|
|
sphinx.builders.linkcheck.opener = MockOpener()
|
|
|
|
|
|
def verify_build(buildername, srcdir):
|
|
if buildername == 'man' and ManWriter is None:
|
|
raise SkipTest('man writer is not available')
|
|
app = TestApp(buildername=buildername, srcdir=srcdir)
|
|
try:
|
|
app.builder.build_all()
|
|
finally:
|
|
app.cleanup()
|
|
|
|
|
|
def test_build_all():
|
|
# If supported, build in a non-ASCII source dir
|
|
test_name = u'\u65e5\u672c\u8a9e'
|
|
try:
|
|
srcdir = tempdir / test_name
|
|
(rootdir / 'root').copytree(tempdir / test_name)
|
|
except UnicodeEncodeError:
|
|
srcdir = tempdir / 'all'
|
|
else:
|
|
# add a doc with a non-ASCII file name to the source dir
|
|
(srcdir / (test_name + '.txt')).write_text(dedent("""
|
|
nonascii file name page
|
|
=======================
|
|
"""))
|
|
|
|
master_doc = srcdir / 'contents.txt'
|
|
master_doc.write_text(master_doc.text() + dedent(u"""
|
|
.. toctree::
|
|
|
|
%(test_name)s/%(test_name)s
|
|
""" % {'test_name': test_name})
|
|
)
|
|
|
|
# note: no 'html' - if it's ok with dirhtml it's ok with html
|
|
for buildername in ['dirhtml', 'singlehtml', 'latex', 'texinfo', 'pickle',
|
|
'json', 'text', 'htmlhelp', 'qthelp', 'epub',
|
|
'applehelp', 'changes', 'xml', 'pseudoxml', 'man',
|
|
'linkcheck']:
|
|
yield verify_build, buildername, srcdir
|
|
|
|
|
|
@with_app(buildername='text')
|
|
def test_master_doc_not_found(app, status, warning):
|
|
(app.srcdir / 'contents.txt').unlink()
|
|
try:
|
|
app.builder.build_all()
|
|
assert False # SphinxError not raised
|
|
except Exception as exc:
|
|
assert isinstance(exc, SphinxError)
|
|
|
|
|
|
@with_app(buildername='text', testroot='circular')
|
|
def test_circular_toctree(app, status, warning):
|
|
app.builder.build_all()
|
|
warnings = warning.getvalue()
|
|
assert (
|
|
'circular toctree references detected, ignoring: '
|
|
'sub <- contents <- sub') in warnings
|
|
assert (
|
|
'circular toctree references detected, ignoring: '
|
|
'contents <- sub <- contents') in warnings
|
|
|
|
|
|
@with_app(buildername='text', testroot='numbered-circular')
|
|
def test_numbered_circular_toctree(app, status, warning):
|
|
app.builder.build_all()
|
|
warnings = warning.getvalue()
|
|
assert (
|
|
'circular toctree references detected, ignoring: '
|
|
'sub <- contents <- sub') in warnings
|
|
assert (
|
|
'circular toctree references detected, ignoring: '
|
|
'contents <- sub <- contents') in warnings
|