{"categories":[{"label":"Database","url":"https://skillfed.io/packages/category/database/4"}],"enrichment":{"capability":"Watches a local directory, indexes structured files into an in-memory SQLite database, and exposes a SQL query interface with real-time change tracking.","skillfed_tags":["filesystem-indexing","sqlite","async-io"],"use_cases":["Query a blog directory (posts and authors as JSON files) with SQL joins across tables","Monitor a config directory for changes and react to inserts/updates/deletes via async events","Index structured logs or data files and run ad-hoc SQL analysis without a separate database","Load SQLite extensions and use them in queries over filesystem data","Expose filesystem data over HTTP via the built-in server for remote SQL access"],"what_it_does":"dirsql is a Python SDK that creates an ephemeral SQL interface over a filesystem directory. It watches for file changes, ingests structured files (JSON, etc.) into an in-memory SQLite database according to user-defined schemas and glob patterns, and exposes standard SQL queries. The filesystem remains the source of truth; the database is rebuilt from files on startup and kept in sync via background file watching.\n\nYou define tables by specifying DDL, a glob pattern to select files, and an extraction function that converts matched files into row dicts. dirsql handles the scanning and indexing asynchronously; you await db.ready() before querying. It supports multiple tables, joins, SQLite extensions, and an async iterator for row-level change events (insert, update, delete). A CLI tool is also included for one-off queries and an HTTP server mode.","worth_installing":"Yes, if you need to query structured files in a directory with SQL and want real-time change tracking. The native extension adds medium install friction but provides prebuilt wheels for common platforms. MIT license and active maintenance are favorable. No known vulnerabilities. Suitable for development, data analysis, and small-to-medium workloads."},"id":"dirsql","links":{"html":"https://skillfed.io/packages/dirsql","md":"https://skillfed.io/packages/dirsql.md","pypi":"https://pypi.org/project/dirsql/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-08-12","license_spdx":"MIT","license_treatment":"permissive","name":"dirsql","python_support":"supports_current","summary":"Ephemeral SQL index over a local directory"},"popularity":{"monthly_downloads":176965,"position":10228,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.4.20"}