cf-extractor 0.1.0

Python semantic data extractor for Context-Footprint (AST + Jedi)

cf-extractor

Python semantic data extractor for Context-Footprint. Outputs SemanticData JSON using Python AST + Jedi.

As a dependency

This package is a dependency of cftool. When you install cftool via uv or pip, cf-extractor is installed automatically:

uv tool install cftool   # includes cf-extractor

Standalone usage

You can also install and use cf-extractor directly:

# From PyPI (when published)
pip install cf-extractor

# From Git
uv pip install "cf-extractor @ git+https://github.com/context-footprint/context-footprint#subdirectory=extractors/python"

# Development
cd extractors/python
uv sync

Run the extractor:

cf-extract /path/to/python/project
# or
uv run cf-extract /path/to/python/project
# or
python -m cf_extractor.main /path/to/project

Without arguments, uses the current directory (.). Output is written to stdout (valid JSON for cftool).

Tests

uv run pytest tests/ -v

Requirements

• Python >= 3.9
• jedi, pydantic (installed automatically)