apcore-toolkit¶
apcore-toolkit is a shared scanner, schema extraction, and output toolkit for the apcore ecosystem. It provides framework-agnostic logic to extract metadata from existing code and make it "AI-Perceivable".
Key Features¶
- 🔍 Smart Scanning: Abstract base classes for framework scanners with filtering and deduplication.
- 📄 Output Generation: Writers for YAML bindings, Python wrappers, and direct Registry registration.
- 🛠️ Schema Utilities: Tools for Pydantic model flattening and OpenAPI schema extraction.
- 🤖 AI Enhancement: Metadata enrichment using local SLMs (Small Language Models).
- 📝 Markdown Formatting: Convert arbitrary data structures to structured Markdown.
Installation¶
Python
pip install apcore-toolkit
Core Modules¶
| Module | Description |
|---|---|
ScannedModule |
Canonical dataclass representing a scanned endpoint |
BaseScanner |
Abstract base class for framework scanners |
YAMLWriter |
Generates .binding.yaml files for apcore.BindingLoader |
PythonWriter |
Generates @module-decorated Python wrapper files |
RegistryWriter |
Registers modules directly into an apcore.Registry |
to_markdown |
Converts arbitrary dicts to Markdown with depth control |
Documentation¶
- Getting Started Guide — Installation and core usage
- Features Overview — Detailed look at toolkit capabilities
- AI Enhancement Guide — Metadata enrichment strategy
- Changelog
License¶
Apache-2.0