Skip to content

docs(feat[api-style]): Enable API badge styling from gp-sphinx#658

Draft
tony wants to merge 4 commits intomasterfrom
api-styling
Draft

docs(feat[api-style]): Enable API badge styling from gp-sphinx#658
tony wants to merge 4 commits intomasterfrom
api-styling

Conversation

@tony
Copy link
Copy Markdown
Member

@tony tony commented Apr 6, 2026

Summary

  • Enables the new gp_sphinx.api_style extension from git-pull/gp-sphinx#10, which adds type and modifier badges to standard Python API entries
  • Points gp-sphinx and sphinx-autodoc-pytest-fixtures at the api-styling branch via [tool.uv.sources]
  • Relaxes version pins from ==0.0.1a1 to >=0.0.1a5

What it looks like

Every autodoc entry gets a colored badge pill:

  • class (indigo), method (cyan), property (teal), attribute (slate), data (grey), exception (rose)
  • Modifier badges: async, classmethod, staticmethod, abstract, final, deprecated

Matches the visual language already established by sphinx-autodoc-pytest-fixtures fixture badges.

Depends on

Test plan

  • Local docs build succeeds with badges rendering on all API pages
  • CI passes with git-sourced gp-sphinx packages
  • Visual review of badge rendering

@codecov
Copy link
Copy Markdown

codecov bot commented Apr 6, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 46.55%. Comparing base (fd2b607) to head (19b6b0c).

Additional details and impacted files
@@            Coverage Diff             @@
##           master     #658      +/-   ##
==========================================
- Coverage   46.63%   46.55%   -0.09%     
==========================================
  Files          22       22              
  Lines        2363     2363              
  Branches      389      389              
==========================================
- Hits         1102     1100       -2     
- Misses       1093     1094       +1     
- Partials      168      169       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

why: The sphinx-autodoc-api-style extension adds type and modifier badges
to autodoc entries, matching the visual language of
sphinx-autodoc-pytest-fixtures.

what:
- Add sphinx_autodoc_api_style to extra_extensions in docs/conf.py
tony added 2 commits April 6, 2026 12:48
…to 0.0.1a5

why: Wire in the standalone api-style package next to gp-sphinx; align dev/docs
pins and the lockfile with the latest gp-sphinx workspace releases.

what:
- Add sphinx-autodoc-api-style to dev and docs groups
- Add uv.sources path overrides for gp-sphinx, sphinx-autodoc-api-style,
  and sphinx-autodoc-pytest-fixtures
- Pin gp-sphinx, sphinx-autodoc-api-style, and sphinx-autodoc-pytest-fixtures
  to 0.0.1a5; regenerate uv.lock
why: Preview published docs from the feature branch before merge.
what:
- Add api-styling to docs workflow push branches
why: Align dev docs dependencies with gp-sphinx 0.0.1a6 on PyPI.
what:
- Bump gp-sphinx ecosystem pins in pyproject.toml
- Regenerate uv.lock
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

Successfully merging this pull request may close these issues.

1 participant