Skip to content

feat(apidoc.cpp): conditionally add space between certain AST tokens #483

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.

Sign up for GitHub

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

Merged
jbms merged 17 commits into from
Feb 4, 2026
Merged

feat(apidoc.cpp): conditionally add space between certain AST tokens #483

Changes from 2 commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
0b31212
In get_extent_spelling, remove extra whitespace around namespace sepa…
laramiel Feb 1, 2026
212fed5
Add substitute names
laramiel Feb 1, 2026
955d8b1
Add space handling between specific token kinds
laramiel Feb 2, 2026
20488a9
Update cpp_api_parser_test.py
laramiel Feb 2, 2026
1969deb
Update cpp_api_parser_test.py type replacement test
laramiel Feb 2, 2026
32e6d91
Update tests/cpp_api_parser_test.py
laramiel Feb 3, 2026
48f267d
Update tests/cpp_api_parser_test.py
laramiel Feb 3, 2026
e888482
format nox
laramiel Feb 3, 2026
599e261
Update sphinx_immaterial/apidoc/cpp/api_parser.py
laramiel Feb 3, 2026
5c3cfe2
Update sphinx_immaterial/apidoc/cpp/api_parser.py
laramiel Feb 3, 2026
d3c18c6
Update api_parser.py
laramiel Feb 3, 2026
c7e8f29
use raw string notation in regex pattern
laramiel Feb 3, 2026
abccece
Rework condition for emitting spaces in get_extent_spelling
laramiel Feb 3, 2026
1d8caa1
Fix indentation issue in api_parser.py
laramiel Feb 3, 2026
5dab7f5
Remove stale comment
laramiel Feb 3, 2026
d3fbecf
Update api_parser.py
laramiel Feb 3, 2026
0ca9125
Reformat
laramiel Feb 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion sphinx_immaterial/apidoc/cpp/api_parser.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -962,7 +962,7 @@ def get_spellings():
else:
yield spelling

return " ".join(get_spellings())
return " ".join(get_spellings()).replace(" :: ", "::")


def get_related_comments(decl: Cursor):
Expand Down Expand Up @@ -2344,6 +2344,7 @@ def _normalize_entity_requires(entity: CppApiEntity):
if _is_function(entity):
func_entity = cast(FunctionEntity, entity)
declaration = func_entity["declaration"]
declaration = _substitute_internal_type_names(config, declaration)
if replacements:
declaration = _apply_identifier_replacements(declaration, replacements)
if (
Expand Down