{"adoption": {"forks": 65, "observed_at": "2026-08-28T04:04:38.687172+00:00", "stars": 1409}, "canonical_url": "https://ross.abutalabs.com/products/aiosql", "card": {"archived": false, "artifact_type": "library", "description": "Simple SQL in Python", "domain": ["databases", "developer-tools", "backend"], "enriched": true, "function": ["database", "database-driver", "orm"], "health_score": 95, "homepage": "https://nackjicholson.github.io/aiosql", "language": "Python", "license": "NOASSERTION", "license_family": "other", "maturity": "active", "member_repos": ["nackjicholson/aiosql"], "name": "nackjicholson/aiosql", "platform": ["python", "cross-platform"], "pushed_at": "2026-08-15T09:31:36+00:00", "repo": "nackjicholson/aiosql", "stars": 1409, "tags": ["sql", "yesql", "asyncio", "sql-files", "query-loading", "pep-249"], "topics": [], "urls": [], "use_cases": ["load sql queries from files in python", "keep sql out of python string literals", "use asyncpg or aiosqlite with named queries", "version control sql alongside application code", "reuse sql files in psql and python", "yesql for python"], "what_it_is": "aiosql is a Python library that lets you write SQL queries in plain .sql files and load them into your application as callable methods, a port of Clojure's yesql. It supports both sync and asyncio drivers for SQLite, PostgreSQL, MySQL, DuckDB, and other PEP 249-compatible databases.", "when_to_avoid": ["you prefer an ORM with models and migrations", "you need dynamic query building rather than predefined statements", "your database driver lacks a PEP 249-compatible adapter"], "when_to_choose": ["you want raw SQL as first-class code files instead of an ORM", "you use asyncio database drivers and want named query methods", "you want to run the same SQL in CLI tools and your Python app"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/aiosql", "repo": "nackjicholson/aiosql", "role": "main", "score": 82}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:04:38.687172+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T04:38:33.062987+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4eec6cec5f6fab1548b85433ea8ca81315ae165db4b7f84019f287df9015699f", "fetched_at": "2026-08-28T04:04:38.687172+00:00", "kind": "readme", "missing": false, "url": "https://github.com/nackjicholson/aiosql"}, {"content_hash": "c927c88acbaa53c42ff3834c0d4bd562200ed21faa9a7fb1394b4fb86630f9cb", "fetched_at": "2026-08-29T11:52:10.142036+00:00", "kind": "homepage", "missing": false, "url": "https://nackjicholson.github.io/aiosql"}, {"content_hash": "dcefbe6fd203b33c82b70bdab00b9f83544f9a09eebd4f5438c9d432da2ef9bb", "fetched_at": "2026-08-29T11:52:10.144586+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/aiosql/json"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:04:38.687172+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T04:38:33.062987+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4eec6cec5f6fab1548b85433ea8ca81315ae165db4b7f84019f287df9015699f", "fetched_at": "2026-08-28T04:04:38.687172+00:00", "kind": "readme", "missing": false, "url": "https://github.com/nackjicholson/aiosql"}, {"content_hash": "c927c88acbaa53c42ff3834c0d4bd562200ed21faa9a7fb1394b4fb86630f9cb", "fetched_at": "2026-08-29T11:52:10.142036+00:00", "kind": "homepage", "missing": false, "url": "https://nackjicholson.github.io/aiosql"}, {"content_hash": "dcefbe6fd203b33c82b70bdab00b9f83544f9a09eebd4f5438c9d432da2ef9bb", "fetched_at": "2026-08-29T11:52:10.144586+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/aiosql/json"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T04:38:33.062987+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4eec6cec5f6fab1548b85433ea8ca81315ae165db4b7f84019f287df9015699f", "fetched_at": "2026-08-28T04:04:38.687172+00:00", "kind": "readme", "missing": false, "url": "https://github.com/nackjicholson/aiosql"}, {"content_hash": "c927c88acbaa53c42ff3834c0d4bd562200ed21faa9a7fb1394b4fb86630f9cb", "fetched_at": "2026-08-29T11:52:10.142036+00:00", "kind": "homepage", "missing": false, "url": "https://nackjicholson.github.io/aiosql"}, {"content_hash": "dcefbe6fd203b33c82b70bdab00b9f83544f9a09eebd4f5438c9d432da2ef9bb", "fetched_at": "2026-08-29T11:52:10.144586+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/aiosql/json"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:04:38.687172+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:04:38.687172+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:04:38.687172+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T04:38:33.062987+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4eec6cec5f6fab1548b85433ea8ca81315ae165db4b7f84019f287df9015699f", "fetched_at": "2026-08-28T04:04:38.687172+00:00", "kind": "readme", "missing": false, "url": "https://github.com/nackjicholson/aiosql"}, {"content_hash": "c927c88acbaa53c42ff3834c0d4bd562200ed21faa9a7fb1394b4fb86630f9cb", "fetched_at": "2026-08-29T11:52:10.142036+00:00", "kind": "homepage", "missing": false, "url": "https://nackjicholson.github.io/aiosql"}, {"content_hash": "dcefbe6fd203b33c82b70bdab00b9f83544f9a09eebd4f5438c9d432da2ef9bb", "fetched_at": "2026-08-29T11:52:10.144586+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/aiosql/json"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:04:38.687172+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:04:38.687172+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T04:38:33.062987+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4eec6cec5f6fab1548b85433ea8ca81315ae165db4b7f84019f287df9015699f", "fetched_at": "2026-08-28T04:04:38.687172+00:00", "kind": "readme", "missing": false, "url": "https://github.com/nackjicholson/aiosql"}, {"content_hash": "c927c88acbaa53c42ff3834c0d4bd562200ed21faa9a7fb1394b4fb86630f9cb", "fetched_at": "2026-08-29T11:52:10.142036+00:00", "kind": "homepage", "missing": false, "url": "https://nackjicholson.github.io/aiosql"}, {"content_hash": "dcefbe6fd203b33c82b70bdab00b9f83544f9a09eebd4f5438c9d432da2ef9bb", "fetched_at": "2026-08-29T11:52:10.144586+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/aiosql/json"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:04:38.687172+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:04:38.687172+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:04:38.687172+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T04:38:33.062987+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4eec6cec5f6fab1548b85433ea8ca81315ae165db4b7f84019f287df9015699f", "fetched_at": "2026-08-28T04:04:38.687172+00:00", "kind": "readme", "missing": false, "url": "https://github.com/nackjicholson/aiosql"}, {"content_hash": "c927c88acbaa53c42ff3834c0d4bd562200ed21faa9a7fb1394b4fb86630f9cb", "fetched_at": "2026-08-29T11:52:10.142036+00:00", "kind": "homepage", "missing": false, "url": "https://nackjicholson.github.io/aiosql"}, {"content_hash": "dcefbe6fd203b33c82b70bdab00b9f83544f9a09eebd4f5438c9d432da2ef9bb", "fetched_at": "2026-08-29T11:52:10.144586+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/aiosql/json"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:04:38.687172+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:04:38.687172+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T04:38:33.062987+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4eec6cec5f6fab1548b85433ea8ca81315ae165db4b7f84019f287df9015699f", "fetched_at": "2026-08-28T04:04:38.687172+00:00", "kind": "readme", "missing": false, "url": "https://github.com/nackjicholson/aiosql"}, {"content_hash": "c927c88acbaa53c42ff3834c0d4bd562200ed21faa9a7fb1394b4fb86630f9cb", "fetched_at": "2026-08-29T11:52:10.142036+00:00", "kind": "homepage", "missing": false, "url": "https://nackjicholson.github.io/aiosql"}, {"content_hash": "dcefbe6fd203b33c82b70bdab00b9f83544f9a09eebd4f5438c9d432da2ef9bb", "fetched_at": "2026-08-29T11:52:10.144586+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/aiosql/json"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T04:38:33.062987+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4eec6cec5f6fab1548b85433ea8ca81315ae165db4b7f84019f287df9015699f", "fetched_at": "2026-08-28T04:04:38.687172+00:00", "kind": "readme", "missing": false, "url": "https://github.com/nackjicholson/aiosql"}, {"content_hash": "c927c88acbaa53c42ff3834c0d4bd562200ed21faa9a7fb1394b4fb86630f9cb", "fetched_at": "2026-08-29T11:52:10.142036+00:00", "kind": "homepage", "missing": false, "url": "https://nackjicholson.github.io/aiosql"}, {"content_hash": "dcefbe6fd203b33c82b70bdab00b9f83544f9a09eebd4f5438c9d432da2ef9bb", "fetched_at": "2026-08-29T11:52:10.144586+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/aiosql/json"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T04:38:33.062987+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4eec6cec5f6fab1548b85433ea8ca81315ae165db4b7f84019f287df9015699f", "fetched_at": "2026-08-28T04:04:38.687172+00:00", "kind": "readme", "missing": false, "url": "https://github.com/nackjicholson/aiosql"}, {"content_hash": "c927c88acbaa53c42ff3834c0d4bd562200ed21faa9a7fb1394b4fb86630f9cb", "fetched_at": "2026-08-29T11:52:10.142036+00:00", "kind": "homepage", "missing": false, "url": "https://nackjicholson.github.io/aiosql"}, {"content_hash": "dcefbe6fd203b33c82b70bdab00b9f83544f9a09eebd4f5438c9d432da2ef9bb", "fetched_at": "2026-08-29T11:52:10.144586+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/aiosql/json"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T04:38:33.062987+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4eec6cec5f6fab1548b85433ea8ca81315ae165db4b7f84019f287df9015699f", "fetched_at": "2026-08-28T04:04:38.687172+00:00", "kind": "readme", "missing": false, "url": "https://github.com/nackjicholson/aiosql"}, {"content_hash": "c927c88acbaa53c42ff3834c0d4bd562200ed21faa9a7fb1394b4fb86630f9cb", "fetched_at": "2026-08-29T11:52:10.142036+00:00", "kind": "homepage", "missing": false, "url": "https://nackjicholson.github.io/aiosql"}, {"content_hash": "dcefbe6fd203b33c82b70bdab00b9f83544f9a09eebd4f5438c9d432da2ef9bb", "fetched_at": "2026-08-29T11:52:10.144586+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/aiosql/json"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 97, "longevity": 100, "rhythm": 52}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": ["no_license"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 2831, "days_push": 18, "days_rel": 241, "gap_med": 34.5, "n_releases_24m": 11}, "score": 82, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}