Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
d503441
docs(sphinx): Replace sphinx-argparse with sphinx_argparse_neo
tony Jan 18, 2026
c4bf9e5
fix(mypy): Exclude docs/_ext from type checking
tony Jan 18, 2026
95450fa
docs(argparse): Add syntax highlighting CSS and strip ANSI codes
tony Jan 18, 2026
6f6b944
py(deps[dev]): Add types-docutils and types-Pygments to dev group
tony Jan 24, 2026
9a28b16
py(typing): Add py.typed marker to cihai_cli package
tony Jan 24, 2026
859d7f7
pyproject.toml(mypy): Enable type checking for docs/_ext/
tony Jan 24, 2026
2a2e5ca
fix(mypy): Add type annotation to regex pattern in utils.py
tony Jan 24, 2026
c0fcda7
fix(mypy): Fix type errors in directive.py
tony Jan 24, 2026
ad96eed
fix(mypy): Remove unused type ignore in argparse_exemplar.py
tony Jan 24, 2026
ab9a8c8
fix(mypy): Fix type annotations in test files
tony Jan 24, 2026
ff18560
cli.py(feat): Add CLI examples for help output
tony Jan 24, 2026
74c92d0
_colors(fix): Correct doctest escape sequence matching
tony Jan 24, 2026
57fcf70
cli.py(feat): Add colored help formatter for CLI examples
tony Jan 24, 2026
638dc42
CHANGES(docs): Document PR #337 features for 0.32.x release
tony Jan 24, 2026
ade42a8
test_cli.py(test): Add integration tests for CLI help examples
tony Jan 24, 2026
df62842
pyproject.toml(fix): Remove self-referential ignore_missing_imports
tony Jan 24, 2026
b55defc
docs/_ext(fix): Correct project reference in module docstring
tony Jan 24, 2026
7f71629
style(css): Match usage block styling to shell examples
tony Jan 24, 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
29 changes: 29 additions & 0 deletions CHANGES
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,35 @@ $ uvx --from 'cihai-cli' --prerelease allow cihai

_Add your latest changes from PRs here_

### What's new

#### Colored CLI help output (#337)

- Add syntax highlighting for CLI help examples
- New `_colors.py` module with ANSI color support respecting `NO_COLOR`/`FORCE_COLOR`
- New `_formatter.py` with custom argparse HelpFormatter for colored examples

#### Replace sphinx-argparse with sphinx_argparse_neo (#337)

- Port `sphinx_argparse_neo` extension from vcspull, replacing external `sphinx-argparse` dependency
- Add custom Pygments lexers for argparse and CLI usage syntax highlighting:
- `argparse_lexer.py` - Lexer for argparse help text
- `cli_usage_lexer.py` - Lexer for CLI usage patterns
- Add `argparse_exemplar.py` extension for transforming argparse epilog examples into documentation
- Add `argparse_roles.py` for custom Sphinx roles (`:opt:`, `:arg:`, `:prog:`)
- Add CSS styling for syntax-highlighted argparse output
- Add comprehensive test suite for all Sphinx extensions

#### Dev dependencies

- Add `types-docutils` and `types-Pygments` for type checking Sphinx extensions (#337)

### Packaging

- Add `py.typed` marker for [PEP 561] type checking support (#337)

[PEP 561]: https://peps.python.org/pep-0561/

## cihai-cli 0.31.1 (2026-01-24)

### Breaking changes
Expand Down
3 changes: 3 additions & 0 deletions docs/_ext/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
"""Sphinx extensions for cihai-cli documentation."""

from __future__ import annotations
Loading