Skip to content

Commit

Permalink
Exclude rather than mock Bio.Alphabet etc
Browse files Browse the repository at this point in the history
See suggestion here:
sphinx-doc/sphinx#9631
  • Loading branch information
peterjc committed Sep 14, 2021
1 parent cb4f6ed commit 10a05d7
Showing 1 changed file with 14 additions and 4 deletions.
18 changes: 14 additions & 4 deletions Doc/api/conf.py
Expand Up @@ -114,9 +114,7 @@
autodoc_preserve_defaults = True

# To avoid import errors.
autodoc_mock_imports = ["MySQLdb", "Bio.Restriction.Restriction"]
if version > "1.77":
autodoc_mock_imports.append("Bio.Alphabet")
autodoc_mock_imports = ["MySQLdb"]

# -- Options for HTML output ----------------------------------------------

Expand Down Expand Up @@ -305,7 +303,19 @@ def run_apidoc(_):
# $ sphinx-apidoc -e -F -o /tmp/api/Bio Bio
tmp_path = tempfile.mkdtemp()
apidoc_main(["-e", "-F", "-o", tmp_path, "../../BioSQL"])
apidoc_main(["-e", "-F", "-o", tmp_path, "../../Bio"])
apidoc_main(
[
"-e",
"-F",
"-o",
tmp_path,
# The input path:
"../../Bio",
# These are patterns to exclude:
"../../Bio/Alphabet/",
"../../Bio/Restriction/Restriction.py",
]
)
os.remove(os.path.join(tmp_path, "index.rst")) # Using our own
for filename in os.listdir(tmp_path):
if filename.endswith(".rst"):
Expand Down

0 comments on commit 10a05d7

Please sign in to comment.