Version 1.8.0 Python 3.8+ GPL 3 License PyPI Ready
LLM Ready TOON Optimized Smart Parsing
DeepBase Γ¨ un tool CLI che analizza una directory di progetto, estrae la struttura delle cartelle e il contenuto dei file di codice significativi, consolidandoli in un unico file di contesto per LLM.
| Feature | Descrizione |
|---|---|
| π Project Structure | Genera una tree view della struttura di cartelle e file |
| π§ Smart Filtering | Ignora automaticamente directory comuni (.git, venv, node_modules) |
| β‘ Token Optimization (TOON) | Genera "Semantic Skeletons" (classi, firme, docstring) per risparmiare fino al 90% dei token |
| π‘ Light Mode | ModalitΓ ultra-leggera con solo firme di metodi e commenti iniziali |
| π Hybrid Focus Mode | Combina contesto leggero per l'intero progetto con contenuto completo per file/folder specifici |
| ποΈ Database Support | Estrae schema da database SQLite (tabelle, colonne, relazioni) |
| π Multi-Language Parsing | Supporto nativo per Python, JavaScript, TypeScript, React (JSX/TSX), Markdown, LaTeX |
| π§ Plugin System | Architettura a plugin per parser personalizzati |
| βοΈ Configurable | Personalizza via file .deepbase.toml |
| π Unified Output | Tutto in un unico file, facile da copiare e incollare per gli LLM |
pip install deepbase
git clone https://github.com/follen99/deepbase.git cd deepbase pip install -e ".[dev]"
Structure Only (Default)
Genera rapidamente una tree view della struttura del progetto:
deepbase .Include All Content
Per generare il contesto completo con tutto il codice:
deepbase . --allPer progetti grandi, inviare tutto il codice a un LLM Γ¨ costoso. TOON estrae solo lo "scheletro" semantico:
deepbase . --toon # oppure deepbase . -t
Risultato: Gli LLM capiscono l'architettura usando token minimi.
ModalitΓ ancora piΓΉ leggera di TOON, include solo firme di metodi/funzioni e commenti iniziali:
deepbase . --light # oppure deepbase . -l
Combina TOON per l'intero progetto con contenuto completo per file specifici.
Focus via CLI:
deepbase . --toon --focus "server/controllers/*" --focus "client/src/login.js"
Focus via File:
Crea un file (es. context_task.txt):
server/routes/auth.js
server/models/User.js
client/src/components/LoginForm.jsx
Esegui:
deepbase . --toon --focus-file context_task.txtDeepBase puΓ² analizzare database SQLite estraendo schema e relazioni:
# Schema completo deepbase database.db --all # Schema in modalitΓ TOON (solo struttura) deepbase database.db --toon # Focus su tabelle specifiche deepbase database.db --toon --focus "users" --focus "orders"
Analisi di un singolo file:
# Solo struttura (default) deepbase README.md # Struttura + contenuto completo deepbase README.md --all # ModalitΓ TOON deepbase script.py --toon
| Linguaggio | Estensioni | Parser |
|---|---|---|
| Python | .py |
β Nativo - Classi, funzioni, async, type hints, docstring |
| JavaScript | .js, .jsx |
β Nativo - Funzioni, classi, componenti React |
| TypeScript | .ts, .tsx |
β Nativo - Tipi, interfacce, generics |
| Markdown | .md |
β Nativo - Headers, struttura documento |
| LaTeX | .tex |
β Nativo - Sezioni, comandi |
| JSON | .json |
β Legacy - Struttura dati |
| SQLite | .db, .sqlite |
β Database - Schema, tabelle, colonne |
| Altri | * |
Crea un file .deepbase.toml nella root del progetto:
# Directory aggiuntive da ignorare ignore_dirs = ["my_assets", "experimental", "logs"] # Estensioni/filename aggiuntivi da includere significant_extensions = [".cfg", "Makefile", ".tsx", ".prisma"] # Directory sempre incluse (anche se matchano ignore_dirs) force_include_dirs = ["important_logs"]
# Project Context: MyProject > Total Size (raw): 15.28 KB | Est. Tokens (light): ~3,912 π MyProject/ βββ π README.md (1.9% | ~73t) βββ π src/ (65.0% | ~2.5k t) β βββ π main.py (25.0% | ~980t) β βββ π utils.py (40.0% | ~1.5k t) βββ π tests/ (33.1% | ~1.3k t) βββ π test_main.py (33.1% | ~1.3k t) ### FILE CONTENTS (LIGHT β signatures only) > FILE: src/main.py def main() -> None: ... class Application: def __init__(self, config: dict): ... def run(self) -> int: ...
# Install in editable mode pip install -e ".[dev]" # Run tests pytest # Run specific test pytest tests/test_suite_python.py -v
La documentazione completa Γ¨ disponibile su GitHub Pages:
- β Parser JavaScript/TypeScript/React (JSX/TSX)
- β Parser Markdown e LaTeX
- β Supporto database SQLite
- β Sistema plugin per parser
- β ModalitΓ Light avanzata
- β Focus mode per tabelle database
- β Miglioramenti al parser Python (async, type hints)
- β Supporto file focus da file esterno
- β Stima token piΓΉ accurata
Contributi sono benvenuti! Per favore:
- Fork il repository
- Crea un branch (
git checkout -b feature/amazing-feature) - Commit le modifiche (
git commit -m 'Add amazing feature') - Push al branch (
git push origin feature/amazing-feature) - Apri una Pull Request
Questo progetto Γ¨ rilasciato sotto licenza GPL 3. Vedi il file LICENSE per i dettagli.
Built with β€οΈ by Giuliano Ranauro