Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

RTD Failing Build #621

Open
jvanderaa opened this issue Feb 10, 2025 · 0 comments
Open

RTD Failing Build #621

jvanderaa opened this issue Feb 10, 2025 · 0 comments

Comments

@jvanderaa
Copy link

Environment

RTD

Expected Behavior

Successful build

Observed Behavior

Seeing a failure that is repeatable in the local dev environment.

Steps to Reproduce

  1. Set up the local dev environment
  2. Get the error

python -m mkdocs build --clean --site-dir $READTHEDOCS_OUTPUT/html --config-file mkdocs.yml 3s Exit: 1
--
1 | INFO    -  Cleaning site directory
2 | INFO    -  Building documentation to directory: /home/docs/checkouts/readthedocs.org/user_builds/netutils/checkouts/latest/_readthedocs/html
3 | INFO    -  The following pages exist in the docs directory, but are not included in the "nav" configuration:
4 | - dev/include_parser_list.md
5 | - user/include_jinja_list.md
6 | - user/lib_use_cases_nist.md
7 | - user/lib_use_cases_os_version.md
8 | - user/lib_mapper/aerleon.md
9 | - user/lib_mapper/aerleon_reverse.md
10 | - user/lib_mapper/ansible.md
11 | - user/lib_mapper/ansible_reverse.md
12 | - user/lib_mapper/capirca.md
13 | - user/lib_mapper/capirca_reverse.md
14 | - user/lib_mapper/dna_center.md
15 | - user/lib_mapper/dna_center_reverse.md
16 | - user/lib_mapper/forwardnetworks.md
17 | - user/lib_mapper/forwardnetworks_reverse.md
18 | - user/lib_mapper/hierconfig.md
19 | - user/lib_mapper/hierconfig_reverse.md
20 | - user/lib_mapper/napalm.md
21 | - user/lib_mapper/napalm_reverse.md
22 | - user/lib_mapper/netmiko.md
23 | - user/lib_mapper/netmiko_reverse.md
24 | - user/lib_mapper/netutilsparser.md
25 | - user/lib_mapper/netutilsparser_reverse.md
26 | - user/lib_mapper/nist.md
27 | - user/lib_mapper/nist_reverse.md
28 | - user/lib_mapper/ntctemplates.md
29 | - user/lib_mapper/ntctemplates_reverse.md
30 | - user/lib_mapper/pyats.md
31 | - user/lib_mapper/pyats_reverse.md
32 | - user/lib_mapper/pyntc.md
33 | - user/lib_mapper/pyntc_reverse.md
34 | - user/lib_mapper/scrapli.md
35 | - user/lib_mapper/scrapli_reverse.md
36 | ERROR   -  Error reading page 'dev/code_reference/acl.md': No module named 'mkdocstrings.handlers.python'
37 | Traceback (most recent call last):
38 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocstrings/handlers/base.py", line 610, in get_handler
39 | module = importlib.import_module(f"mkdocstrings_handlers.{name}")
40 | File "/home/docs/.asdf/installs/python/3.10.15/lib/python3.10/importlib/__init__.py", line 126, in import_module
41 | return _bootstrap._gcd_import(name[level:], package, level)
42 | File "<frozen importlib._bootstrap>", line 1050, in _gcd_import
43 | File "<frozen importlib._bootstrap>", line 1027, in _find_and_load
44 | File "<frozen importlib._bootstrap>", line 1006, in _find_and_load_unlocked
45 | File "<frozen importlib._bootstrap>", line 688, in _load_unlocked
46 | File "<frozen importlib._bootstrap_external>", line 883, in exec_module
47 | File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
48 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocstrings_handlers/python/__init__.py", line 3, in <module>
49 | from mkdocstrings_handlers.python.handler import get_handler
50 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocstrings_handlers/python/handler.py", line 15, in <module>
51 | from griffe.collections import LinesCollection, ModulesCollection
52 | ModuleNotFoundError: No module named 'griffe.collections'
53 |  
54 | During handling of the above exception, another exception occurred:
55 |  
56 | Traceback (most recent call last):
57 | File "/home/docs/.asdf/installs/python/3.10.15/lib/python3.10/runpy.py", line 196, in _run_module_as_main
58 | return _run_code(code, main_globals, None,
59 | File "/home/docs/.asdf/installs/python/3.10.15/lib/python3.10/runpy.py", line 86, in _run_code
60 | exec(code, run_globals)
61 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocs/__main__.py", line 361, in <module>
62 | cli()
63 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/click/core.py", line 1161, in __call__
64 | return self.main(*args, **kwargs)
65 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/click/core.py", line 1082, in main
66 | rv = self.invoke(ctx)
67 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/click/core.py", line 1697, in invoke
68 | return _process_result(sub_ctx.command.invoke(sub_ctx))
69 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/click/core.py", line 1443, in invoke
70 | return ctx.invoke(self.callback, **ctx.params)
71 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/click/core.py", line 788, in invoke
72 | return __callback(*args, **kwargs)
73 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocs/__main__.py", line 286, in build_command
74 | build.build(cfg, dirty=not clean)
75 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocs/commands/build.py", line 322, in build
76 | _populate_page(file.page, config, files, dirty)
77 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocs/commands/build.py", line 175, in _populate_page
78 | page.render(config, files)
79 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocs/structure/pages.py", line 271, in render
80 | self.content = md.convert(self.markdown)
81 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/markdown/core.py", line 357, in convert
82 | root = self.parser.parseDocument(self.lines).getroot()
83 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/markdown/blockparser.py", line 117, in parseDocument
84 | self.parseChunk(self.root, '\n'.join(lines))
85 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/markdown/blockparser.py", line 136, in parseChunk
86 | self.parseBlocks(parent, text.split('\n\n'))
87 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/markdown/blockparser.py", line 158, in parseBlocks
88 | if processor.run(parent, blocks) is not False:
89 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocstrings/extension.py", line 127, in run
90 | html, handler, data = self._process_block(identifier, block, heading_level)
91 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocstrings/extension.py", line 182, in _process_block
92 | handler = self._handlers.get_handler(handler_name, handler_config)
93 | File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocstrings/handlers/base.py", line 612, in get_handler
94 | module = importlib.import_module(f"mkdocstrings.handlers.{name}")
95 | File "/home/docs/.asdf/installs/python/3.10.15/lib/python3.10/importlib/__init__.py", line 126, in import_module
96 | return _bootstrap._gcd_import(name[level:], package, level)
97 | File "<frozen importlib._bootstrap>", line 1050, in _gcd_import
98 | File "<frozen importlib._bootstrap>", line 1027, in _find_and_load
99 | File "<frozen importlib._bootstrap>", line 1004, in _find_and_load_unlocked
100 | ModuleNotFoundError: No module named 'mkdocstrings.handlers.python'

python -m mkdocs build --clean --site-dir $READTHEDOCS_OUTPUT/html --config-file mkdocs.yml  
INFO    -  Cleaning site directory
INFO    -  Building documentation to directory: /home/docs/checkouts/readthedocs.org/user_builds/netutils/checkouts/latest/_readthedocs/html
INFO    -  The following pages exist in the docs directory, but are not included in the "nav" configuration:
  - dev/include_parser_list.md
  - user/include_jinja_list.md
  - user/lib_use_cases_nist.md
  - user/lib_use_cases_os_version.md
  - user/lib_mapper/aerleon.md
  - user/lib_mapper/aerleon_reverse.md
  - user/lib_mapper/ansible.md
  - user/lib_mapper/ansible_reverse.md
  - user/lib_mapper/capirca.md
  - user/lib_mapper/capirca_reverse.md
  - user/lib_mapper/dna_center.md
  - user/lib_mapper/dna_center_reverse.md
  - user/lib_mapper/forwardnetworks.md
  - user/lib_mapper/forwardnetworks_reverse.md
  - user/lib_mapper/hierconfig.md
  - user/lib_mapper/hierconfig_reverse.md
  - user/lib_mapper/napalm.md
  - user/lib_mapper/napalm_reverse.md
  - user/lib_mapper/netmiko.md
  - user/lib_mapper/netmiko_reverse.md
  - user/lib_mapper/netutilsparser.md
  - user/lib_mapper/netutilsparser_reverse.md
  - user/lib_mapper/nist.md
  - user/lib_mapper/nist_reverse.md
  - user/lib_mapper/ntctemplates.md
  - user/lib_mapper/ntctemplates_reverse.md
  - user/lib_mapper/pyats.md
  - user/lib_mapper/pyats_reverse.md
  - user/lib_mapper/pyntc.md
  - user/lib_mapper/pyntc_reverse.md
  - user/lib_mapper/scrapli.md
  - user/lib_mapper/scrapli_reverse.md
ERROR   -  Error reading page 'dev/code_reference/acl.md': No module named 'mkdocstrings.handlers.python'
Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.[1](https://app.readthedocs.org/projects/netutils/builds/26814758/#256503032--1)0/site-packages/mkdocstrings/handlers/base.py", line 610, in get_handler
    module = importlib.import_module(f"mkdocstrings_handlers.{name}")
  File "/home/docs/.asdf/installs/python/3.10.15/lib/python3.10/importlib/__init__.py", line 1[2](https://app.readthedocs.org/projects/netutils/builds/26814758/#256503032--2)6, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1050, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1027, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1006, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 688, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 88[3](https://app.readthedocs.org/projects/netutils/builds/26814758/#256503032--3), in exec_module
  File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocstrings_handlers/python/__init__.py", line 3, in <module>
    from mkdocstrings_handlers.python.handler import get_handler
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocstrings_handlers/python/handler.py", line 15, in <module>
    from griffe.collections import LinesCollection, ModulesCollection
ModuleNotFoundError: No module named 'griffe.collections'
During handling of the above exception, another exception occurred:
Traceback (most recent call last):
  File "/home/docs/.asdf/installs/python/3.10.15/lib/python3.10/runpy.py", line 196, in _run_module_as_main
    return _run_code(code, main_globals, None,
  File "/home/docs/.asdf/installs/python/3.10.15/lib/python3.10/runpy.py", line 86, in _run_code
    exec(code, run_globals)
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocs/__main__.py", line 361, in <module>
    cli()
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/click/core.py", line 1161, in __call__
    return self.main(*args, **kwargs)
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/click/core.py", line 1082, in main
    rv = self.invoke(ctx)
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/click/core.py", line 1697, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/click/core.py", line 1[4](https://app.readthedocs.org/projects/netutils/builds/26814758/#256503032--4)43, in invoke
    return ctx.invoke(self.callback, **ctx.params)
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/click/core.py", line 788, in invoke
    return __callback(*args, **kwargs)
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocs/__main__.py", line 286, in build_command
    build.build(cfg, dirty=not clean)
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocs/commands/build.py", line 322, in build
    _populate_page(file.page, config, files, dirty)
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocs/commands/build.py", line 17[5](https://app.readthedocs.org/projects/netutils/builds/26814758/#256503032--5), in _populate_page
    page.render(config, files)
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocs/structure/pages.py", line 271, in render
    self.content = md.convert(self.markdown)
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/markdown/core.py", line 357, in convert
    root = self.parser.parseDocument(self.lines).getroot()
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/markdown/blockparser.py", line 117, in parseDocument
    self.parseChunk(self.root, '\n'.join(lines))
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/markdown/blockparser.py", line 13[6](https://app.readthedocs.org/projects/netutils/builds/26814758/#256503032--6), in parseChunk
    self.parseBlocks(parent, text.split('\n\n'))
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/markdown/blockparser.py", line 158, in parseBlocks
    if processor.run(parent, blocks) is not False:
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocstrings/extension.py", line 12[7](https://app.readthedocs.org/projects/netutils/builds/26814758/#256503032--7), in run
    html, handler, data = self._process_block(identifier, block, heading_level)
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.10/site-packages/mkdocstrings/extension.py", line 1[8](https://app.readthedocs.org/projects/netutils/builds/26814758/#256503032--8)2, in _process_block
    handler = self._handlers.get_handler(handler_name, handler_config)
  File "/home/docs/checkouts/readthedocs.org/user_builds/netutils/envs/latest/lib/python3.[10](https://app.readthedocs.org/projects/netutils/builds/26814758/#256503032--10)/site-packages/mkdocstrings/handlers/base.py", line 612, in get_handler
    module = importlib.import_module(f"mkdocstrings.handlers.{name}")
  File "/home/docs/.asdf/installs/python/3.10.15/lib/python3.10/importlib/__init__.py", line [12](https://app.readthedocs.org/projects/netutils/builds/26814758/#256503032--12)6, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1050, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1027, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1004, in _find_and_load_unlocked
ModuleNotFoundError: No module named 'mkdocstrings.handlers.python'
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant