Metadata-Version: 2.4
Name: dbapi-d1
Version: 0.1.1
Summary: Deprecated. DBAPI 2.0 driver for Cloudflare D1, superseded by sqlalchemy-cloudflare-d1
License-Expression: Apache-2.0
License-File: LICENSE
Author: Chad Rossouw
Author-email: chadrossouw7247@gmail.com
Requires-Python: >=3.11,<3.12
Classifier: Development Status :: 7 - Inactive
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Database
Requires-Dist: requests (>=2.32.5,<3.0.0)
Project-URL: Repository, https://github.com/sqlalchemy-cf-d1/dbapi-d1
Description-Content-Type: text/markdown

<div align="center">

# dbapi-d1

A **DBAPI 2.0 driver** for **Cloudflare D1**, written for `sqlalchemy-d1` 0.1.0 to connect D1 to **Apache Superset**.

[![PyPI](https://img.shields.io/pypi/v/dbapi-d1)](https://pypi.org/project/dbapi-d1/) [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](https://github.com/sqlalchemy-cf-d1/dbapi-d1/blob/main/LICENSE)

[PyPI](https://pypi.org/project/dbapi-d1/) · [sqlalchemy-d1](https://github.com/sqlalchemy-cf-d1/sqlalchemy-d1) · [sqlalchemy-cloudflare-d1](https://github.com/CollierKing/sqlalchemy-cloudflare-d1) · [Legacy setup guide](https://github.com/sqlalchemy-cf-d1/.github/blob/main/SETUP.md)

</div>

<br>

> **This package is deprecated.** It is superseded by the DBAPI driver built into [sqlalchemy-cloudflare-d1](https://github.com/CollierKing/sqlalchemy-cloudflare-d1). The final release is **0.1.1**, with the same code as 0.1.0. There will be no further changes.

## What to use instead

| Package | Description |
|---------|-------------|
| [sqlalchemy-cloudflare-d1](https://pypi.org/project/sqlalchemy-cloudflare-d1/) | The community SQLAlchemy dialect for D1. It has its own DBAPI driver built in. |
| [sqlalchemy-d1](https://pypi.org/project/sqlalchemy-d1/) | Keeps the `d1://` connection string working in Superset. Since version 0.2.0 it is a thin layer over `sqlalchemy-cloudflare-d1` and no longer uses this package. |

For a Superset on **SQLAlchemy 2.0**:

```bash
pip install "sqlalchemy-d1>=0.2.0"
```

On **SQLAlchemy 1.4** (Superset 6.1.0, for example), stay on `sqlalchemy-d1` 0.1.0 and keep this package. A plain `pip install sqlalchemy-d1` there would upgrade SQLAlchemy and break Superset.

For anything else, install `sqlalchemy-cloudflare-d1` directly.

The [sqlalchemy-d1 README](https://github.com/sqlalchemy-cf-d1/sqlalchemy-d1#readme) explains the change.

## Existing installs

* Versions **0.1.0** and **0.1.1** stay on PyPI. They have the same code.
* `sqlalchemy-d1` 0.1.0 still depends on it. Keep both if you are on **SQLAlchemy 1.4**.
* `sqlalchemy-d1` 0.2.0 and newer do not use it. After you upgrade, you can remove it.

```bash
pip uninstall dbapi-d1
```

## License

This package is licensed under the **Apache License 2.0**. See [LICENSE](https://github.com/sqlalchemy-cf-d1/dbapi-d1/blob/main/LICENSE).

