mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
56 lines
1.4 KiB
Python
56 lines
1.4 KiB
Python
"""Test the Builder class."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import sys
|
|
|
|
import pytest
|
|
|
|
|
|
@pytest.mark.sphinx(
|
|
'dummy',
|
|
testroot='root',
|
|
srcdir='test_builder',
|
|
freshenv=True,
|
|
)
|
|
def test_incremental_reading(app):
|
|
# first reading
|
|
updated = app.builder.read()
|
|
assert set(updated) == app.env.found_docs == set(app.env.all_docs)
|
|
assert updated == sorted(updated) # sorted by alphanumeric
|
|
|
|
# test if exclude_patterns works ok
|
|
assert 'subdir/excluded' not in app.env.found_docs
|
|
|
|
# before second reading, add, modify and remove source files
|
|
(app.srcdir / 'new.txt').write_text('New file\n========\n', encoding='utf8')
|
|
app.env.all_docs['index'] = 0 # mark as modified
|
|
(app.srcdir / 'autodoc.txt').unlink()
|
|
|
|
# second reading
|
|
updated = app.builder.read()
|
|
|
|
assert set(updated) == {'index', 'new'}
|
|
assert 'autodoc' not in app.env.all_docs
|
|
assert 'autodoc' not in app.env.found_docs
|
|
|
|
|
|
@pytest.mark.sphinx(
|
|
'dummy',
|
|
testroot='warnings',
|
|
freshenv=True,
|
|
)
|
|
def test_incremental_reading_for_missing_files(app):
|
|
# first reading
|
|
updated = app.builder.read()
|
|
assert set(updated) == app.env.found_docs == set(app.env.all_docs)
|
|
|
|
# second reading
|
|
updated = app.builder.read()
|
|
|
|
# "index" is listed up to updated because it contains references
|
|
# to nonexisting downloadable or image files
|
|
assert set(updated) == {'index'}
|
|
|
|
sys.modules.pop('autodoc_fodder', None)
|