mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
63 lines
2.2 KiB
Python
63 lines
2.2 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""
|
|
test_ext_viewcode
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
Test sphinx.ext.viewcode extension.
|
|
|
|
:copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS.
|
|
:license: BSD, see LICENSE for details.
|
|
"""
|
|
|
|
import re
|
|
|
|
import pytest
|
|
|
|
|
|
@pytest.mark.sphinx(testroot='ext-viewcode')
|
|
def test_viewcode(app, status, warning):
|
|
app.builder.build_all()
|
|
|
|
warnings = re.sub(r'\\+', '/', warning.getvalue())
|
|
assert re.findall(
|
|
r"index.rst:\d+: WARNING: Object named 'func1' not found in include " +
|
|
r"file .*/spam/__init__.py'",
|
|
warnings
|
|
)
|
|
|
|
result = (app.outdir / 'index.html').text(encoding='utf-8')
|
|
assert result.count('href="_modules/spam/mod1.html#func1"') == 2
|
|
assert result.count('href="_modules/spam/mod2.html#func2"') == 2
|
|
assert result.count('href="_modules/spam/mod1.html#Class1"') == 2
|
|
assert result.count('href="_modules/spam/mod2.html#Class2"') == 2
|
|
assert result.count('@decorator') == 1
|
|
|
|
# test that the class attribute is correctly documented
|
|
assert result.count('this is Class3') == 2
|
|
assert 'this is the class attribute class_attr' in result
|
|
# the next assert fails, until the autodoc bug gets fixed
|
|
assert result.count('this is the class attribute class_attr') == 2
|
|
|
|
result = (app.outdir / '_modules/spam/mod1.html').text(encoding='utf-8')
|
|
result = re.sub('<span class=".*?">', '<span>', result) # filter pygments classes
|
|
assert ('<div class="viewcode-block" id="Class1"><a class="viewcode-back" '
|
|
'href="../../index.html#spam.Class1">[docs]</a>'
|
|
'<span>@decorator</span>\n'
|
|
'<span>class</span> <span>Class1</span>'
|
|
'<span>(</span><span>object</span><span>):</span>\n'
|
|
' <span>"""</span>\n'
|
|
'<span> this is Class1</span>\n'
|
|
'<span> """</span></div>\n') in result
|
|
|
|
|
|
@pytest.mark.sphinx(testroot='ext-viewcode', tags=['test_linkcode'])
|
|
def test_linkcode(app, status, warning):
|
|
app.builder.build(['objects'])
|
|
|
|
stuff = (app.outdir / 'objects.html').text(encoding='utf-8')
|
|
|
|
assert 'http://foobar/source/foolib.py' in stuff
|
|
assert 'http://foobar/js/' in stuff
|
|
assert 'http://foobar/c/' in stuff
|
|
assert 'http://foobar/cpp/' in stuff
|