def test_title_from_content_scenarios(test_app):
# Somehow the xml-tree in extract_needs_from_html() works not correctly with py37 and specific
# extracts, which are needed for sphinx >3.0 only.
# Everything with Py3.8 is fine again and also Py3.7 with sphinx<3 works here.
if sys.version_info[0] == 3 and sys.version_info[
1] == 7 and sphinx.version_info[0] >= 3:
return True
app = test_app
app.build()
html = Path(app.outdir, "index.html").read_text()
needs = extract_needs_from_html(html)
assert needs[0].id == "R_12345"
assert needs[0].title == "Scenario 1 Title"
assert needs[1].id is not None
assert needs[1].title == "Scenario 2 Title"
assert needs[2].id == "R_12346"
assert needs[2].title == "Scenario 3 Title"
assert needs[3].id is not None
assert needs[3].title == "Scenario 4 Title"
assert needs[4].id == "R_12347"
assert needs[4].title == "Title is first sentence"
assert needs[5].id is not None
assert needs[5].title == "Title should be first sentence"
# The handling of the ellipses character varies between Sphinx versions
# so we're ignoring it in our comparisons.
assert needs[6].id is not None
assert needs[
6].title == "First sentence will be title, but elided since ..."
assert needs[7].id == "R_12348"
assert needs[
7].title == "First sentence will be title, but elided since ..."
assert needs[8].id == "R_12349"
assert needs[8].title == "Title matches this"
assert needs[9].id is not None
assert needs[9].title == "Title should match this"
assert needs[10].id == "R_12350"
assert needs[
10].title == "First sentence is really long so this should be..."
assert needs[11].id is not None
assert needs[
11].title == "First sentence is really long so this should be..."
def test_title_optional_scenarios(app, status, warning):
# Somehow the xml-tree in extract_needs_from_html() works not correctly with py37 and specific
# extracts, which are needed for sphinx >3.0 only.
# Everything with Py3.8 is fine again and also Py3.7 with sphinx<3 works here.
if sys.version_info[0] == 3 and sys.version_info[
1] == 7 and sphinx.version_info[0] >= 3:
return True
app.build()
html = Path(app.outdir, "index.html").read_text()
needs = extract_needs_from_html(html)
assert needs[0].id == "R_12345"
assert needs[0].title == "Scenario 1 Title"
assert needs[1].id is not None
assert needs[1].title == "Scenario 2 Title"
assert needs[2].id == "R_12346"
assert needs[2].title == "Scenario 3 Title"
assert needs[3].id is not None
assert needs[3].title == "Scenario 4 Title"
assert needs[4].id == "R_12347"
assert needs[4].title is None
assert needs[5].id is not None
assert needs[5].title is None
assert needs[6].id == "R_12348"
assert needs[6].title == "Title matches this"
assert needs[7].id is not None
assert needs[7].title == "Title should match this"
assert needs[8].id == "R_12349"
assert needs[
8].title == "First sentence is really long so this should be..."
assert needs[9].id is not None
assert needs[
9].title == "First sentence is really long so this should be..."
def test_doc_build_html(app, status, warning):
# Somehow the xml-tree in extract_needs_from_html() works not correctly with py37 and specific
# extracts, which are needed for sphinx >3.0 only.
# Everything with Py3.8 is fine again and also Py3.7 with sphinx<3 works here.
if sys.version_info[0] == 3 and sys.version_info[1] == 7 and sphinx.version_info[0] >= 3:
return True
app.build()
html = (app.outdir / 'index.html').read_text()
assert 'title_clean_layout' in html
assert 'title_complete_layout' in html
assert 'title_focus_layout' not in html
assert 'title_example_layout' in html
needs = extract_needs_from_html(html)
assert len(needs) == 4
assert '<tr class="footer row-even"><td class="footer_left" colspan="2">' in html