nl2sql-adapter-sdk

The contracts a database adapter for the nl2sql engine implements. It depends on pydantic and the standard library only, so an adapter built against it inherits nothing else.

DatasourceAdapterProtocol: capabilities(), connect(), fetch_schema_snapshot(), execute(request) and get_dialect(), which returns a sqlglot dialect name such as postgres or tsql.
AdapterRequest, ResultFrame and ResultError: what the engine sends an adapter and what it gets back.
SchemaSnapshot and the table, column and foreign-key contracts an adapter describes its schema with.

An adapter is published as an nl2sql.adapters entry point, and the engine finds it there; it never imports an adapter by name.

pip install nl2sql-adapter-sdk

Writing an adapter: Adapter development. Try the engine without installing anything: https://nl2sql.codewithnk.com.

Development Status
- 3 - Alpha
Intended Audience
- Developers
Operating System
- OS Independent
Programming Language
Topic
- Database
- Software Development :: Libraries

Metadata

Development Status
- 3 - Alpha
Intended Audience
- Developers
Operating System
- OS Independent
Programming Language
Topic
- Database
- Software Development :: Libraries

Release files for nl2sql-adapter-sdk 0.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nl2sql-adapter-sdk 0.2.3
File	Size	Uploaded
nl2sql_adapter_sdk-0.2.3.tar.gz	5.1 kB	Oct 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for nl2sql-adapter-sdk 0.2.3
File	Interpreter	ABI	Platform	Reset
nl2sql_adapter_sdk-0.2.3-py3-none-any.whl 6.0 kB Oct 12, 2026	Python 3	none	any	Details

Total release size: 11.1 kB

Release files / nl2sql_adapter_sdk-0.2.3.tar.gz

Download URL	nl2sql_adapter_sdk-0.2.3.tar.gz
Size	5.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`f0d6529b51785a67a5bf6d8209dfba60d73da815f3e3d5e45659e2ebc87def66`
BLAKE2b-256 checksum How to use checksums	`27a303698236e2dea6c7d87e4dd0358a7cbf8b46ea8d353c4f4a793c4292af75`
Upload date	Oct 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / nl2sql_adapter_sdk-0.2.3-py3-none-any.whl

Download URL	nl2sql_adapter_sdk-0.2.3-py3-none-any.whl
Size	6.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`42bbb3d0fe2e82bc2564fea656c358a7f690132367ecdfd8022d6fc9c065bf68`
BLAKE2b-256 checksum How to use checksums	`045566a5c6871d883cb7f48a44b7525d0691af93ac4f0c605f22a82500f57144`
Upload date	Oct 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`