duckdb-sqlalchemy 0.19.2__tar.gz → 0.19.3__tar.gz

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/.github/workflows/lint.yml

@@ -2,6 +2,13 @@ name: Lint
 
 on:
   pull_request:
+    paths:
+      - "duckdb_sqlalchemy/**"
+      - "examples/**"
+      - "pyproject.toml"
+      - "noxfile.py"
+      - "test.cfg"
+      - ".github/workflows/lint.yml"
 
 jobs:
   pre-commit:

duckdb_sqlalchemy-0.19.3/.github/workflows/pages.yml

@@ -0,0 +1,42 @@
+name: Docs (GitHub Pages)
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - ".github/workflows/pages.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/configure-pages@v5
+      - uses: actions/jekyll-build-pages@v1
+        with:
+          source: docs
+          destination: _site
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: _site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/.github/workflows/publish.yaml

@@ -1,13 +1,5 @@
 name: Publish Python package
 on:
-  workflow_dispatch:
-    inputs:
-      target:
-        description: "Where to publish"
-        required: true
-        type: choice
-        options:
-          - testpypi
   release:
     types: [published]
 
@@ -58,28 +50,3 @@ jobs:
         path: dist/
     - name: Publish to PyPI
       uses: pypa/gh-action-pypi-publish@release/v1
-
-  publish-to-testpypi:
-    name: Publish to TestPyPI
-    if: github.event_name == 'workflow_dispatch' && inputs.target == 'testpypi'
-    needs: build
-    runs-on: ubuntu-latest
-
-    environment:
-      name: testpypi
-      url: https://test.pypi.org/p/duckdb-sqlalchemy
-
-    permissions:
-      contents: read
-      id-token: write
-
-    steps:
-    - name: Download all the dists
-      uses: actions/download-artifact@v4
-      with:
-        name: python-package-distributions
-        path: dist/
-    - name: Publish to TestPyPI
-      uses: pypa/gh-action-pypi-publish@release/v1
-      with:
-        repository-url: https://test.pypi.org/legacy/

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/.github/workflows/pythonapp.yaml

@@ -1,6 +1,15 @@
 name: Python application
 
-on: [pull_request, workflow_dispatch]
+on:
+  pull_request:
+    paths:
+      - "duckdb_sqlalchemy/**"
+      - "examples/**"
+      - "pyproject.toml"
+      - "noxfile.py"
+      - "test.cfg"
+      - ".github/workflows/pythonapp.yaml"
+  workflow_dispatch:
 permissions:
   checks: write
 

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/CHANGELOG.md

@@ -6,6 +6,18 @@ preserved from the upstream project for historical context.
 
 ## Maintained in this fork
 
+## [0.19.3](https://github.com/leonardovida/duckdb-sqlalchemy/compare/v0.19.2...v0.19.3) (2025-12-28)
+
+### Documentation
+
+* publish GitHub Pages docs site with Jekyll config and navigation
+* add overview, getting started, migration guide, and SEO checklist
+* add llms.txt and strengthen README/docs discoverability links
+
+### Metadata
+
+* expand PyPI metadata (keywords, classifiers, documentation URL)
+
 ## [0.19.2](https://github.com/leonardovida/duckdb-sqlalchemy/compare/v0.19.0...v0.19.2) (2025-12-28)
 
 ### Documentation

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/PKG-INFO

@@ -1,14 +1,29 @@
 Metadata-Version: 2.4
 Name: duckdb-sqlalchemy
-Version: 0.19.2
-Summary: SQLAlchemy driver for duckdb
+Version: 0.19.3
+Summary: DuckDB SQLAlchemy dialect for DuckDB and MotherDuck
 Project-URL: Bug Tracker, https://github.com/leonardovida/duckdb-sqlalchemy/issues
 Project-URL: Changelog, https://github.com/leonardovida/duckdb-sqlalchemy/releases
+Project-URL: Documentation, https://leonardovida.github.io/duckdb-sqlalchemy/
 Project-URL: repository, https://github.com/leonardovida/duckdb-sqlalchemy
 Project-URL: Upstream, https://github.com/Mause/duckdb_engine
-Author-email: Leonardo Vida <leonardo@motherduck.com>
+Author-email: Leonardo Vida <lleonardovida@gmail.com>
 License-Expression: MIT
 License-File: LICENSE.txt
+Keywords: analytics,database,dialect,duckdb,motherduck,olap,sqlalchemy
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Database
+Classifier: Topic :: Database :: Front-Ends
 Requires-Python: <4,>=3.9
 Requires-Dist: duckdb>=0.5.0
 Requires-Dist: packaging>=21
@@ -41,7 +56,7 @@ Description-Content-Type: text/markdown
 [![PyPI Downloads](https://img.shields.io/pypi/dm/duckdb-sqlalchemy.svg)](https://pypi.org/project/duckdb-sqlalchemy/)
 [![codecov](https://codecov.io/gh/leonardovida/duckdb-sqlalchemy/graph/badge.svg)](https://codecov.io/gh/leonardovida/duckdb-sqlalchemy)
 
-A production-ready SQLAlchemy dialect for DuckDB and MotherDuck. It supports SQLAlchemy Core and ORM APIs against DuckDB locally or in MotherDuck.
+duckdb-sqlalchemy is a DuckDB SQLAlchemy dialect for DuckDB and MotherDuck. It supports SQLAlchemy Core and ORM APIs for local DuckDB and MotherDuck connections.
 
 The dialect handles pooling defaults, bulk inserts, type mappings, and cloud-specific configuration.
 
@@ -127,7 +142,7 @@ Use the URL helpers to build connection strings safely:
 ```python
 from duckdb_sqlalchemy import URL, MotherDuckURL
 
-local_url = URL(database=":memory:", read_only=False)
+local_url = URL(database=":memory:", memory_limit="1GB")
 md_url = MotherDuckURL(database="md:my_db", attach_mode="single")
 ```
 
@@ -139,7 +154,11 @@ See `docs/configuration.md` and `docs/motherduck.md` for detailed guidance.
 
 ## Documentation
 
+- `docs/index.md` - GitHub Pages entrypoint
 - `docs/README.md` - Docs index
+- `docs/overview.md` - Overview and quick start
+- `docs/getting-started.md` - Minimal install + setup walkthrough
+- `docs/migration-from-duckdb-engine.md` - Migration guide from older dialects
 - `docs/connection-urls.md` - URL formats and helpers
 - `docs/motherduck.md` - MotherDuck setup and options
 - `docs/configuration.md` - Connection configuration, extensions, filesystems
@@ -148,6 +167,12 @@ See `docs/configuration.md` and `docs/motherduck.md` for detailed guidance.
 - `docs/types-and-caveats.md` - Type support and known caveats
 - `docs/alembic.md` - Alembic integration
 
+Docs site (GitHub Pages):
+
+```
+https://leonardovida.github.io/duckdb-sqlalchemy/
+```
+
 ## Examples
 
 - `examples/sqlalchemy_example.py` - end-to-end example

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/README.md

@@ -4,7 +4,7 @@
 [![PyPI Downloads](https://img.shields.io/pypi/dm/duckdb-sqlalchemy.svg)](https://pypi.org/project/duckdb-sqlalchemy/)
 [![codecov](https://codecov.io/gh/leonardovida/duckdb-sqlalchemy/graph/badge.svg)](https://codecov.io/gh/leonardovida/duckdb-sqlalchemy)
 
-A production-ready SQLAlchemy dialect for DuckDB and MotherDuck. It supports SQLAlchemy Core and ORM APIs against DuckDB locally or in MotherDuck.
+duckdb-sqlalchemy is a DuckDB SQLAlchemy dialect for DuckDB and MotherDuck. It supports SQLAlchemy Core and ORM APIs for local DuckDB and MotherDuck connections.
 
 The dialect handles pooling defaults, bulk inserts, type mappings, and cloud-specific configuration.
 
@@ -90,7 +90,7 @@ Use the URL helpers to build connection strings safely:
 ```python
 from duckdb_sqlalchemy import URL, MotherDuckURL
 
-local_url = URL(database=":memory:", read_only=False)
+local_url = URL(database=":memory:", memory_limit="1GB")
 md_url = MotherDuckURL(database="md:my_db", attach_mode="single")
 ```
 
@@ -102,7 +102,11 @@ See `docs/configuration.md` and `docs/motherduck.md` for detailed guidance.
 
 ## Documentation
 
+- `docs/index.md` - GitHub Pages entrypoint
 - `docs/README.md` - Docs index
+- `docs/overview.md` - Overview and quick start
+- `docs/getting-started.md` - Minimal install + setup walkthrough
+- `docs/migration-from-duckdb-engine.md` - Migration guide from older dialects
 - `docs/connection-urls.md` - URL formats and helpers
 - `docs/motherduck.md` - MotherDuck setup and options
 - `docs/configuration.md` - Connection configuration, extensions, filesystems
@@ -111,6 +115,12 @@ See `docs/configuration.md` and `docs/motherduck.md` for detailed guidance.
 - `docs/types-and-caveats.md` - Type support and known caveats
 - `docs/alembic.md` - Alembic integration
 
+Docs site (GitHub Pages):
+
+```
+https://leonardovida.github.io/duckdb-sqlalchemy/
+```
+
 ## Examples
 
 - `examples/sqlalchemy_example.py` - end-to-end example

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/docs/README.md

@@ -4,6 +4,9 @@ This folder contains focused, task-oriented guides that keep the main README sho
 
 ## Guides
 
+- `overview.md` - High-level overview and quick start
+- `getting-started.md` - Minimal install + setup walkthrough
+- `migration-from-duckdb-engine.md` - Migration guide from older dialects
 - `connection-urls.md` - URL formats, helpers, and manual escaping
 - `motherduck.md` - Connection patterns and MotherDuck-specific options
 - `configuration.md` - `connect_args`, extension preloads, and filesystem registration
@@ -11,6 +14,7 @@ This folder contains focused, task-oriented guides that keep the main README sho
 - `pandas-jupyter.md` - DataFrame registration and notebook usage
 - `types-and-caveats.md` - Supported types, parameter binding, and gotchas
 - `alembic.md` - Alembic integration notes
+- `seo-checklist.md` - Docs indexability checklist
 
 ## Project references
 

duckdb_sqlalchemy-0.19.3/docs/_config.yml

@@ -0,0 +1,6 @@
+title: duckdb-sqlalchemy
+description: DuckDB SQLAlchemy dialect for DuckDB and MotherDuck
+theme: jekyll-theme-cayman
+plugins:
+  - jekyll-seo-tag
+  - jekyll-sitemap

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/docs/alembic.md

@@ -1,3 +1,8 @@
+---
+layout: default
+title: Alembic integration
+---
+
 # Alembic integration
 
 SQLAlchemy's migration tool, Alembic, can be used with DuckDB by providing a dialect implementation class.

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/docs/configuration.md

@@ -1,3 +1,8 @@
+---
+layout: default
+title: Configuration
+---
+
 # Configuration
 
 DuckDB configuration can be supplied via `connect_args` or URL query params.

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/docs/connection-urls.md

@@ -1,3 +1,8 @@
+---
+layout: default
+title: Connection URLs
+---
+
 # Connection URLs
 
 DuckDB URLs follow the standard SQLAlchemy shape:

duckdb_sqlalchemy-0.19.3/docs/getting-started.md

@@ -0,0 +1,81 @@
+---
+layout: default
+title: Getting Started
+---
+
+# Getting Started
+
+This guide is a compact walkthrough for the DuckDB SQLAlchemy dialect. It focuses on the most common local and MotherDuck setups and points you to deeper docs when you need them.
+
+## Install
+
+```sh
+pip install duckdb-sqlalchemy
+```
+
+## Local DuckDB
+
+```python
+from sqlalchemy import Column, Integer, String, create_engine
+from sqlalchemy.orm import declarative_base, Session
+
+Base = declarative_base()
+
+class User(Base):
+    __tablename__ = "users"
+    id = Column(Integer, primary_key=True)
+    name = Column(String)
+
+engine = create_engine("duckdb:///local.duckdb")
+Base.metadata.create_all(engine)
+
+with Session(engine) as session:
+    session.add(User(name="Ada"))
+    session.commit()
+```
+
+## In-memory DuckDB
+
+```python
+from sqlalchemy import create_engine
+
+engine = create_engine("duckdb:///:memory:")
+```
+
+## MotherDuck
+
+```bash
+export MOTHERDUCK_TOKEN="..."
+```
+
+```python
+from sqlalchemy import create_engine
+
+engine = create_engine("duckdb:///md:my_db")
+```
+
+If your token includes special characters, URL-escape it or pass it via `connect_args`.
+
+## Connection URLs
+
+DuckDB URLs follow the SQLAlchemy pattern:
+
+```
+duckdb:///<database>?<config>
+```
+
+Examples:
+
+```
+duckdb:///:memory:
+duckdb:///analytics.db
+duckdb:////absolute/path/to/analytics.db
+duckdb:///md:my_db?attach_mode=single&access_mode=read_only&session_hint=team-a
+```
+
+## Next steps
+
+- Connection strings: `docs/connection-urls.md`
+- MotherDuck options: `docs/motherduck.md`
+- Configuration and pooling: `docs/configuration.md`
+- OLAP helpers: `docs/olap.md`

duckdb_sqlalchemy-0.19.3/docs/index.md

@@ -0,0 +1,26 @@
+---
+layout: default
+title: duckdb-sqlalchemy documentation
+---
+
+# duckdb-sqlalchemy documentation
+
+Production-ready DuckDB SQLAlchemy dialect for DuckDB and MotherDuck.
+
+## Start here
+
+- [Overview](overview)
+- [Getting started](getting-started)
+- [Migration from duckdb_engine](migration-from-duckdb-engine)
+- [Connection URLs](connection-urls)
+- [MotherDuck](motherduck)
+- [Configuration](configuration)
+- [OLAP workflows](olap)
+- [Pandas and Jupyter](pandas-jupyter)
+- [Types and caveats](types-and-caveats)
+- [Alembic integration](alembic)
+- [SEO checklist](seo-checklist)
+
+## Examples
+
+See `examples/` in the repository for runnable scripts.

duckdb_sqlalchemy-0.19.3/docs/migration-from-duckdb-engine.md

@@ -0,0 +1,30 @@
+---
+layout: default
+title: Migration from duckdb_engine
+---
+
+# Migration from duckdb_engine
+
+This project is the actively maintained DuckDB SQLAlchemy dialect. If you are coming from the older `duckdb_engine` package, migrate as follows:
+
+## Package and import rename
+
+Install the new package:
+
+```sh
+pip install duckdb-sqlalchemy
+```
+
+Update imports:
+
+```python
+from duckdb_sqlalchemy import Dialect, URL, MotherDuckURL
+```
+
+SQLAlchemy URLs use the `duckdb://` driver name in both packages. Existing URLs will continue to work.
+
+## Notes
+
+- The package name is now `duckdb-sqlalchemy` and the module is `duckdb_sqlalchemy`.
+- The dialect remains registered as `duckdb` for SQLAlchemy.
+- See `docs/motherduck.md` for MotherDuck-specific behavior.

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/docs/motherduck.md

@@ -1,3 +1,8 @@
+---
+layout: default
+title: MotherDuck
+---
+
 # MotherDuck
 
 MotherDuck connections use the `md:` database prefix.

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/docs/olap.md

@@ -1,3 +1,8 @@
+---
+layout: default
+title: OLAP workflows
+---
+
 # OLAP workflows
 
 DuckDB exposes analytics-friendly table functions like `read_parquet` and `read_csv_auto`. The helpers in `duckdb_sqlalchemy.olap` make these easy to use with SQLAlchemy.

duckdb_sqlalchemy-0.19.3/docs/overview.md

@@ -0,0 +1,43 @@
+---
+layout: default
+title: DuckDB SQLAlchemy dialect
+---
+
+# DuckDB SQLAlchemy dialect
+
+This project provides a production-ready SQLAlchemy dialect for DuckDB and MotherDuck. Use SQLAlchemy Core and ORM APIs with DuckDB locally or in MotherDuck without manual driver workarounds.
+
+## What you get
+
+- SQLAlchemy Core, ORM, Alembic, and reflection support.
+- MotherDuck helpers for attach modes, session hints, and read scaling.
+- Sensible pooling defaults and optional performance tuning.
+- Bulk insert helpers via Arrow or DataFrame registration.
+
+## Quick start
+
+```python
+from sqlalchemy import Column, Integer, String, create_engine
+from sqlalchemy.orm import declarative_base, Session
+
+Base = declarative_base()
+
+class User(Base):
+    __tablename__ = "users"
+    id = Column(Integer, primary_key=True)
+    name = Column(String)
+
+engine = create_engine("duckdb:///:memory:")
+Base.metadata.create_all(engine)
+
+with Session(engine) as session:
+    session.add(User(name="Ada"))
+    session.commit()
+```
+
+## Next steps
+
+- Connection strings: `docs/connection-urls.md`
+- MotherDuck usage: `docs/motherduck.md`
+- Configuration and pooling: `docs/configuration.md`
+- OLAP helpers: `docs/olap.md`

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/docs/pandas-jupyter.md

@@ -1,3 +1,8 @@
+---
+layout: default
+title: Pandas and Jupyter
+---
+
 # Pandas and Jupyter
 
 ## Register a DataFrame

duckdb_sqlalchemy-0.19.3/docs/robots.txt

@@ -0,0 +1,3 @@
+User-agent: *
+Allow: /
+Sitemap: https://leonardovida.github.io/duckdb-sqlalchemy/sitemap.xml

duckdb_sqlalchemy-0.19.3/docs/seo-checklist.md

@@ -0,0 +1,24 @@
+---
+layout: default
+title: SEO checklist
+---
+
+# SEO checklist
+
+Use this list to validate indexability after each docs update or release.
+
+## Pages build
+
+- GitHub Pages workflow completed successfully.
+- Site URL responds with HTTP 200.
+
+## Indexability
+
+- `robots.txt` is reachable and allows indexing.
+- `sitemap.xml` is reachable and lists key docs pages.
+- The docs homepage includes links to primary guides.
+
+## Consistency
+
+- Project name and description are consistent in README, docs, and PyPI metadata.
+- URLs in `pyproject.toml` match the docs site.

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/docs/types-and-caveats.md

@@ -1,3 +1,8 @@
+---
+layout: default
+title: Types and Caveats
+---
+
 # Types and Caveats
 
 ## Type support

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/duckdb_sqlalchemy/__init__.py

@@ -60,7 +60,7 @@ try:
 except ImportError:  # pragma: no cover - fallback for older SQLAlchemy
     PGExecutionContext = DefaultExecutionContext
 
-__version__ = "0.19.2"
+__version__ = "0.19.3"
 sqlalchemy_version = sqlalchemy.__version__
 SQLALCHEMY_VERSION = Version(sqlalchemy_version)
 SQLALCHEMY_2 = SQLALCHEMY_VERSION >= Version("2.0.0")

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/duckdb_sqlalchemy/tests/test_core_units.py

@@ -5,6 +5,7 @@ import duckdb
 import pytest
 from sqlalchemy import Integer, String, pool
 from sqlalchemy import exc as sa_exc
+from sqlalchemy.engine import URL as SAURL
 
 from duckdb_sqlalchemy import (
     URL,
@@ -13,14 +14,20 @@ from duckdb_sqlalchemy import (
     Dialect,
     MotherDuckURL,
     _apply_motherduck_defaults,
+    _is_idempotent_statement,
+    _is_transient_error,
     _looks_like_motherduck,
+    _normalize_execution_options,
     _normalize_motherduck_config,
+    _parse_register_params,
+    _pool_override_from_url,
     _supports,
     create_engine_from_paths,
     olap,
     stable_session_hint,
 )
 from duckdb_sqlalchemy import datatypes as dt
+from duckdb_sqlalchemy import motherduck as md
 from duckdb_sqlalchemy.config import TYPES, apply_config, get_core_config
 
 
@@ -472,3 +479,141 @@ def test_struct_or_union_requires_fields() -> None:
     assert rendered.startswith("(")
     assert rendered.endswith(")")
     assert '"first name"' in rendered
+
+
+def test_parse_register_params_dict_and_tuple() -> None:
+    view_name, df = _parse_register_params({"view_name": "v", "df": "data"})
+    assert view_name == "v"
+    assert df == "data"
+
+    view_name, df = _parse_register_params(("v2", "data2"))
+    assert view_name == "v2"
+    assert df == "data2"
+
+
+def test_parse_register_params_errors() -> None:
+    with pytest.raises(ValueError):
+        _parse_register_params(None)
+
+    with pytest.raises(ValueError):
+        _parse_register_params({"name": "v"})
+
+    with pytest.raises(ValueError):
+        _parse_register_params(("only-one",))
+
+
+def test_normalize_execution_options_insertmanyvalues() -> None:
+    original = {"duckdb_insertmanyvalues_page_size": 123}
+    normalized = _normalize_execution_options(original)
+    assert normalized["insertmanyvalues_page_size"] == 123
+    assert "insertmanyvalues_page_size" not in original
+
+    already = {
+        "duckdb_insertmanyvalues_page_size": 5,
+        "insertmanyvalues_page_size": 10,
+    }
+    normalized = _normalize_execution_options(already)
+    assert normalized["insertmanyvalues_page_size"] == 10
+
+
+def test_idempotent_statement_detection() -> None:
+    assert _is_idempotent_statement("SELECT 1")
+    assert _is_idempotent_statement("  show tables")
+    assert _is_idempotent_statement("pragma version")
+    assert not _is_idempotent_statement("insert into t values (1)")
+
+
+def test_transient_error_detection() -> None:
+    assert _is_transient_error(RuntimeError("HTTP Error: 503 Service Unavailable"))
+    assert not _is_transient_error(RuntimeError("connection reset by peer"))
+    assert not _is_transient_error(RuntimeError("HTTP Error: 503 connection reset"))
+
+
+def test_pool_override_from_url_and_env(monkeypatch: pytest.MonkeyPatch) -> None:
+    url = URL(database=":memory:", query={"duckdb_sqlalchemy_pool": ["Queue"]})
+    assert _pool_override_from_url(url) == "queue"
+
+    monkeypatch.setenv("DUCKDB_SQLALCHEMY_POOL", "Null")
+    url = URL(database=":memory:")
+    assert _pool_override_from_url(url) == "null"
+
+
+def test_pool_class_for_empty_database() -> None:
+    url = SAURL.create("duckdb")
+    assert Dialect.get_pool_class(url) is pool.SingletonThreadPool
+
+
+def test_apply_config_handles_none_path_decimal() -> None:
+    import decimal
+    from pathlib import Path
+
+    dialect = Dialect()
+
+    class DummyConn:
+        def __init__(self) -> None:
+            self.executed = []
+
+        def execute(self, statement: str) -> None:
+            self.executed.append(statement)
+
+    conn = DummyConn()
+    ext = {
+        "memory_limit": None,
+        "data_path": Path("/tmp/data"),
+        "ratio": decimal.Decimal("1.5"),
+    }
+
+    apply_config(
+        dialect,
+        conn,
+        cast(dict[str, str | int | bool | float | None], ext),
+    )
+
+    string_processor = String().literal_processor(dialect=dialect)
+    expected = [
+        "SET memory_limit = NULL",
+        f"SET data_path = {string_processor(str(Path('/tmp/data')))}",
+        f"SET ratio = {string_processor(str(decimal.Decimal('1.5')))}",
+    ]
+    assert conn.executed == expected
+
+
+def test_motherduck_helpers() -> None:
+    url = md.MotherDuckURL(
+        database="md:db",
+        query={"memory_limit": "1GB"},
+        path_query={"user": "alice", "session_hint": "team"},
+    )
+    assert url.database.startswith("md:db?")
+    assert url.query == {"memory_limit": "1GB"}
+
+    appended = md.append_query_to_database("md:db?user=alice", {"session_hint": "s"})
+    assert appended == "md:db?user=alice&session_hint=s"
+
+    normalized = md._normalize_path_item("duckdb:///tmp.db")
+    assert normalized.drivername == "duckdb"
+
+    normalized = md._normalize_path_item("md:db")
+    assert normalized.database == "md:db"
+
+
+def test_merge_and_copy_connect_args() -> None:
+    base = {"config": {"threads": 2}, "url_config": {"memory_limit": "1GB"}}
+    extra = {"config": {"threads": 4}, "url_config": {"s3_region": "us-east-1"}}
+    merged = md._merge_connect_args(base, extra)
+
+    assert merged["config"] == {"threads": 4}
+    assert merged["url_config"] == {"memory_limit": "1GB", "s3_region": "us-east-1"}
+
+    copied = md._copy_connect_params(merged)
+    copied["config"]["threads"] = 1
+    copied["url_config"]["memory_limit"] = "2GB"
+    assert merged["config"]["threads"] == 4
+    assert merged["url_config"]["memory_limit"] == "1GB"
+
+
+def test_create_engine_from_paths_driver_mismatch() -> None:
+    url1 = SAURL.create("duckdb", database=":memory:")
+    url2 = SAURL.create("sqlite", database=":memory:")
+    with pytest.raises(ValueError):
+        create_engine_from_paths([url1, url2])

duckdb_sqlalchemy-0.19.3/llms.txt

@@ -0,0 +1,24 @@
+Project: duckdb-sqlalchemy
+Summary: DuckDB SQLAlchemy dialect for DuckDB and MotherDuck. Supports SQLAlchemy Core and ORM APIs with pooling defaults, type mappings, and bulk insert helpers.
+
+Key entry points:
+- sqlalchemy.create_engine("duckdb://...")
+- duckdb_sqlalchemy.URL and duckdb_sqlalchemy.MotherDuckURL
+- duckdb_sqlalchemy.create_motherduck_engine
+- duckdb_sqlalchemy.olap helpers (read_parquet, read_csv_auto, table_function)
+
+Docs:
+- docs/README.md (index)
+- docs/connection-urls.md
+- docs/motherduck.md
+- docs/configuration.md
+- docs/olap.md
+- docs/pandas-jupyter.md
+- docs/types-and-caveats.md
+- docs/alembic.md
+- docs/migration-from-duckdb-engine.md
+
+Compatibility:
+- Python 3.9+
+- SQLAlchemy 1.3.22+ (2.x recommended)
+- DuckDB 1.3.0+ (1.4.3 recommended)

{duckdb_sqlalchemy-0.19.2 → duckdb_sqlalchemy-0.19.3}/pyproject.toml

@@ -1,14 +1,30 @@
 [project]
 name = "duckdb-sqlalchemy"
-version = "0.19.2"
-description = "SQLAlchemy driver for duckdb"
+version = "0.19.3"
+description = "DuckDB SQLAlchemy dialect for DuckDB and MotherDuck"
 authors = [
-    {name = "Leonardo Vida", email = "leonardo@motherduck.com"},
+    {name = "Leonardo Vida", email = "lleonardovida@gmail.com"},
 ]
 license = "MIT"
 license-files = ["LICENSE.txt"]
 requires-python = ">=3.9,<4"
 readme = "README.md"
+keywords = ["duckdb", "sqlalchemy", "motherduck", "database", "analytics", "olap", "dialect"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Database",
+    "Topic :: Database :: Front-Ends",
+]
 dependencies = [
     "duckdb>=0.5.0",
     "sqlalchemy>=1.3.22",
@@ -18,6 +34,7 @@ dependencies = [
 [project.urls]
 "Bug Tracker" = "https://github.com/leonardovida/duckdb-sqlalchemy/issues"
 Changelog = "https://github.com/leonardovida/duckdb-sqlalchemy/releases"
+Documentation = "https://leonardovida.github.io/duckdb-sqlalchemy/"
 repository = "https://github.com/leonardovida/duckdb-sqlalchemy"
 Upstream = "https://github.com/Mause/duckdb_engine"