Repository navigation
Releases
Releases · b-j-karl/api-squash
api-squash v0.2.0
What's new
Added
- Module-level
UPPER_CASEconstants included in output by default; opt out with--no-constants(#20) - Decorator preservation for
@property,@classmethod,@staticmethod, and@overload(#16) - Smarter
--no-private: private items referenced by public signatures are kept (#16) --wrapflag to wrap long signatures at a given width, one parameter per line (#14)- Type alias support — PEP 613 (
TypeAlias) and PEP 695 (type X = ...) (#21) --public-onlyflag to filter output to names listed in__all__(#19)--dry-runflag to estimate output size without producing full output (#23)--versionflag to print the installed package version (#41)- Benchmark table comparing output across large Python packages (#26)
- Pre-commit hooks for Ruff lint and format
- Agent skills updated with
--dry-run,--public-only,--wrap, token compression guidance, and--public-onlyvs--no-privatedecision guide (#56)
Fixed
SyntaxWarningnoise fromast.parse()on files with invalid escape sequences- Backslash-escaped quotes handled correctly in
--wrapparameter splitting ast.TypeAliasguarded for Python < 3.12 compatibility
Changed
--no-privateCLI help aligned across README and--helpoutput- Codecov upload step hardened with token and explicit file path
Installation
pip install api-squash==0.2.0api-squash v0.1.0
api-squash v0.1.0
Initial release -- a CLI tool for extracting Python API surfaces in a compact, token-efficient format.
Features
- api-squash file -- summarize a single Python file
- api-squash project -- summarize all Python files in a directory
- AST-based extraction of classes, functions, and signatures
- Options: --no-docstrings, --no-private, --max-depth, --exclude
- Smart directory scanning with default exclusions
Install
pip install api-squash