codemap-sql

A SQL indexer for CodeMap, shipped as an independent PyPI package.

Indexes DDL (schema) statements so AI agents can answer "which table has column X" and similar structural questions without scanning every migration file. Query (SELECT/INSERT/...) statements are ignored — they are not durable schema artefacts.

What it captures

Backed by tree-sitter-sql:

AST node	Symbol kind
`create_table`	`class` (with `extra.sql_kind=table`)
`create_view`	`class` (with `extra.sql_kind=view`)
`create_index`	`variable` (with `extra.sql_kind=index`)
`column_definition` inside `create_table`	`field` (attached to the table)

Asset-style scheme: this plugin uses scip-sql so a downstream http_route / orm_mapping bridge can cross-reference these symbols against application code that talks to them.

SymbolID encoding

scip-sql . . . db/migrations/0001_init.sql/users#
scip-sql . . . db/migrations/0001_init.sql/users#email.
scip-sql . . . db/migrations/0001_init.sql/idx_users_email.

Install

pip install codemap-sql

Limits

Only DDL is indexed; SELECT / INSERT / UPDATE / DELETE are walked past silently.
CREATE PROCEDURE / CREATE FUNCTION / CREATE TRIGGER are not yet captured — the grammar reports them under generic statement nodes.
Dialect-specific features (e.g. PostgreSQL extensions) may not be parsed.
ALTER TABLE statements that add columns are not tracked.

License

MIT.

Development Status
- 3 - Alpha
Programming Language
- Python :: 3
- SQL
Topic
- Database
- Software Development

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

codemap_sql-0.4.10.tar.gz (5.3 kB view details)

Uploaded Aug 17, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

codemap_sql-0.4.10-py3-none-any.whl (5.0 kB view details)

Uploaded Aug 17, 2026 Python 3

File details

Details for the file codemap_sql-0.4.10.tar.gz.

File metadata

Download URL: codemap_sql-0.4.10.tar.gz
Upload date: Aug 17, 2026
Size: 5.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for codemap_sql-0.4.10.tar.gz
Algorithm	Hash digest
SHA256	`19d685517ac7b22aac21274944f0ac24e55e02af3f2fd4e4403b3f8de4a53a49`
MD5	`3610de09a367b4c0f205cacb20826f33`
BLAKE2b-256	`5ea827fd1ea1300420fb98ab7ce93204cf93eba165947f5ffb1eecd1e1574dde`

See more details on using hashes here.

Provenance

The following attestation bundles were made for codemap_sql-0.4.10.tar.gz:

Publisher: publish.yml on qxbyte/codemap

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: codemap_sql-0.4.10.tar.gz
- Subject digest: 19d685517ac7b22aac21274944f0ac24e55e02af3f2fd4e4403b3f8de4a53a49
- Sigstore transparency entry: 2496863792
- Sigstore integration time: Aug 17, 2026
Source repository:
- Permalink: qxbyte/codemap@13709c99dfe26f42eb7185d8b7de695e2df81c37
- Branch / Tag: refs/tags/v0.4.10
- Owner: https://github.com/qxbyte
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@13709c99dfe26f42eb7185d8b7de695e2df81c37
- Trigger Event: push