ducpy 3.3.8__tar.gz → 3.5.0__tar.gz

{ducpy-3.3.8 → ducpy-3.5.0}/Cargo.lock

@@ -412,7 +412,7 @@ dependencies = [
 
 [[package]]
 name = "ducpy-native"
-version = "3.3.8"
+version = "3.5.0"
 dependencies = [
  "duc",
  "pyo3",

ducpy-3.5.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: ducpy
+Version: 3.5.0
+Classifier: License :: OSI Approved :: MIT License
+Requires-Dist: nanoid>=2.0.0
+Requires-Dist: pypdf>=4.2.0
+Requires-Dist: rapidocr-onnxruntime>=1.3.24 ; extra == 'ocr'
+Requires-Dist: numpy>=1.20.0 ; extra == 'ocr'
+Provides-Extra: ocr
+License-File: LICENSE
+Summary: The library for the Duc 2D CAD file format
+Author: Jorge Soares
+Author-email: Ducflair <support@ducflair.com>
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Documentation, https://ducflair.github.io/duc/reference/python/
+Project-URL: Homepage, https://duc.ducflair.com
+Project-URL: Package Index, https://ducflair.github.io/duc/simple/ducpy/
+Project-URL: Source, https://github.com/ducflair/duc/tree/main/packages/ducpy
+
+# ducpy
+
+<p align="center">
+  <br/>
+  <a href="https://duc.ducflair.com" target="_blank"><img width="256px" src="https://cdn.jsdelivr.net/gh/ducflair/assets@main/src/duc/duc-extended.png" /></a>
+  <p align="center">2D CAD File Format</p>
+  <p align="center" style="align: center;">
+    <a href="https://pypi.org/project/ducpy/"><img src="https://shields.io/badge/Pip-blue?logo=Pypi&logoColor=white&style=round-square" alt="Pip" /></a>
+    <a href="https://github.com/ducflair/duc/releases"><img src="https://img.shields.io/pypi/v/ducpy?style=round-square&label=latest%20stable" alt="PyPI ducpy@latest release" /></a>
+    <a href="https://pypi.org/project/ducpy/"><img src="https://img.shields.io/pypi/dm/ducpy?style=round-square&color=salmon" alt="Downloads" /></a>
+    <img src="https://shields.io/badge/Python-ffde57?logo=Python&logoColor=646464&style=round-square" alt="Python" />
+  </p>
+</p>
+
+The `ducpy` package is the official Python implementation of the `.duc` 2D CAD file format. It is built on top of the [`duc`](../ducrs) Rust crate, exposed as the `ducpy_native` extension. A `.duc` file is a zlib-compressed SQLite database — `ducpy` gives you both a high-level builder DSL and direct low-level access to that schema, plus parsing, serialization, and search helpers.
+
+## Installation
+
+```bash
+pip install ducpy
+```
+
+or with [`uv`](https://docs.astral.sh/uv/):
+
+```bash
+uv add ducpy
+```
+
+## Quick start
+
+```python
+import ducpy as duc
+```
+
+## API overview
+
+`ducpy` is organised around four conceptual entry points, matching the structure of the full [API reference](https://duc.ducflair.com):
+
+### Builders API (High-level)
+
+The easy way to build and manage `.duc` files. Construct elements, apply styles, manage layers, build blocks, and handle document state through the `duc.builders` module.
+
+See the worked examples:
+
+- [Element creation](src/examples/element_creation_demo.py) — building rectangles, ellipses, polygons, lines, arrows, text, frames and plots with the fluent builder DSL.
+- [Mutating elements](src/examples/mutation_demo.py) — updating element properties in place and observing version changes.
+- [Document elements](src/examples/document_element_demo.py) and [model elements](src/examples/model_element_demo.py) — for the higher-level container / model element types.
+
+### SQL Builder (Low-level)
+
+A `.duc` file is a zlib-compressed SQLite database. Use `duc.builders.sql_builder` (`DucSQL`) for direct schema access, bulk queries, and low-level manipulation.
+
+See the worked example: [SQL Builder](src/examples/sql_builder_demo.py) — `DucSQL.new()` to create a `.duc` from scratch, `DucSQL(path)` to query an existing one.
+
+### Search
+
+Query and search elements and files programmatically through the `duc.search` API.
+
+### File I/O
+
+Read and write `.duc` files using the `duc.parse` and `duc.serialize` modules.
+
+See the worked examples:
+
+- [Parsing](src/examples/parsing_demo.py) — `parse_duc` / `parse_duc_lazy` / `get_external_file` / `list_external_files`.
+- [Serialization](src/examples/serialization_demo.py) — `serialize_duc` from builder-created elements.
+- [External files](src/examples/external_files_demo.py) — attaching binary blobs (images, PDFs) to a `.duc` document.
+
+## Documentation
+
+For detailed documentation, including the full API reference, schema specification, and end-to-end examples, see:
+
+- API reference & guides: [duc.ducflair.com](https://duc.ducflair.com)
+- Source-level reference: [docs/](docs/index.rst)
+- Full example index: [docs/examples.rst](docs/examples.rst)
+
+## Tools
+
+- [Playground](https://scopture.com): Experiment with the `duc` format in a live environment.
+
+## Contributing
+
+Feel free to open an issue or contact us at [Ducflair Support](https://www.ducflair.com/support).
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for more details.

ducpy-3.5.0/README.md

@@ -0,0 +1,87 @@
+# ducpy
+
+<p align="center">
+  <br/>
+  <a href="https://duc.ducflair.com" target="_blank"><img width="256px" src="https://cdn.jsdelivr.net/gh/ducflair/assets@main/src/duc/duc-extended.png" /></a>
+  <p align="center">2D CAD File Format</p>
+  <p align="center" style="align: center;">
+    <a href="https://pypi.org/project/ducpy/"><img src="https://shields.io/badge/Pip-blue?logo=Pypi&logoColor=white&style=round-square" alt="Pip" /></a>
+    <a href="https://github.com/ducflair/duc/releases"><img src="https://img.shields.io/pypi/v/ducpy?style=round-square&label=latest%20stable" alt="PyPI ducpy@latest release" /></a>
+    <a href="https://pypi.org/project/ducpy/"><img src="https://img.shields.io/pypi/dm/ducpy?style=round-square&color=salmon" alt="Downloads" /></a>
+    <img src="https://shields.io/badge/Python-ffde57?logo=Python&logoColor=646464&style=round-square" alt="Python" />
+  </p>
+</p>
+
+The `ducpy` package is the official Python implementation of the `.duc` 2D CAD file format. It is built on top of the [`duc`](../ducrs) Rust crate, exposed as the `ducpy_native` extension. A `.duc` file is a zlib-compressed SQLite database — `ducpy` gives you both a high-level builder DSL and direct low-level access to that schema, plus parsing, serialization, and search helpers.
+
+## Installation
+
+```bash
+pip install ducpy
+```
+
+or with [`uv`](https://docs.astral.sh/uv/):
+
+```bash
+uv add ducpy
+```
+
+## Quick start
+
+```python
+import ducpy as duc
+```
+
+## API overview
+
+`ducpy` is organised around four conceptual entry points, matching the structure of the full [API reference](https://duc.ducflair.com):
+
+### Builders API (High-level)
+
+The easy way to build and manage `.duc` files. Construct elements, apply styles, manage layers, build blocks, and handle document state through the `duc.builders` module.
+
+See the worked examples:
+
+- [Element creation](src/examples/element_creation_demo.py) — building rectangles, ellipses, polygons, lines, arrows, text, frames and plots with the fluent builder DSL.
+- [Mutating elements](src/examples/mutation_demo.py) — updating element properties in place and observing version changes.
+- [Document elements](src/examples/document_element_demo.py) and [model elements](src/examples/model_element_demo.py) — for the higher-level container / model element types.
+
+### SQL Builder (Low-level)
+
+A `.duc` file is a zlib-compressed SQLite database. Use `duc.builders.sql_builder` (`DucSQL`) for direct schema access, bulk queries, and low-level manipulation.
+
+See the worked example: [SQL Builder](src/examples/sql_builder_demo.py) — `DucSQL.new()` to create a `.duc` from scratch, `DucSQL(path)` to query an existing one.
+
+### Search
+
+Query and search elements and files programmatically through the `duc.search` API.
+
+### File I/O
+
+Read and write `.duc` files using the `duc.parse` and `duc.serialize` modules.
+
+See the worked examples:
+
+- [Parsing](src/examples/parsing_demo.py) — `parse_duc` / `parse_duc_lazy` / `get_external_file` / `list_external_files`.
+- [Serialization](src/examples/serialization_demo.py) — `serialize_duc` from builder-created elements.
+- [External files](src/examples/external_files_demo.py) — attaching binary blobs (images, PDFs) to a `.duc` document.
+
+## Documentation
+
+For detailed documentation, including the full API reference, schema specification, and end-to-end examples, see:
+
+- API reference & guides: [duc.ducflair.com](https://duc.ducflair.com)
+- Source-level reference: [docs/](docs/index.rst)
+- Full example index: [docs/examples.rst](docs/examples.rst)
+
+## Tools
+
+- [Playground](https://scopture.com): Experiment with the `duc` format in a live environment.
+
+## Contributing
+
+Feel free to open an issue or contact us at [Ducflair Support](https://www.ducflair.com/support).
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for more details.

{ducpy-3.3.8 → ducpy-3.5.0}/packages/ducpy/crate/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "ducpy-native"
-version = "3.3.8"
+version = "3.5.0"
 edition = "2021"
 description = "Python native extension for the duc file format (used by ducpy)"
 publish = false

ducpy-3.5.0/packages/ducrs/README.md

@@ -0,0 +1,54 @@
+# duc (Rust)
+
+<p align="center">
+  <br/>
+  <a href="https://duc.ducflair.com" target="_blank"><img width="256px" src="https://cdn.jsdelivr.net/gh/ducflair/assets@main/src/duc/duc-extended.png" /></a>
+  <p align="center">2D CAD File Format</p>
+  <p align="center" style="align: center;">
+    <a href="https://crates.io/crates/duc"><img src="https://shields.io/badge/Crates-FFC933?logo=Rust&logoColor=646464&style=round-square" alt="Crates" /></a>
+    <a href="https://github.com/ducflair/duc/releases"><img src="https://img.shields.io/crates/v/duc?style=round-square&label=latest%20stable" alt="crates.io duc@latest release" /></a>
+    <a href="https://crates.io/crates/duc"><img src="https://img.shields.io/crates/d/duc?style=round-square&color=salmon" alt="Downloads" /></a>
+    <img src="https://shields.io/badge/Rust-CE412B?logo=Rust&logoColor=fff&style=round-square" alt="Rust" />
+  </p>
+</p>
+
+The `duc` crate is the canonical Rust implementation of the `.duc` 2D CAD file format and the **root of the entire Duc ecosystem**. [`ducpy`](https://pypi.org/project/ducpy/), [`ducjs`](https://www.npmjs.com/package/ducjs), and the rest of the toolchain are all built on top of the types, parsers and storage layer defined here.
+
+A `.duc` file is a standard zlib compressed **SQLite database file** following the schema in `schema/duc.sql`. This crate wraps that database in a strongly-typed Rust API for reading, writing and manipulating `.duc` documents.
+
+
+----
+<br/>
+<br/>
+<br/>
+
+## Schema and migrations
+
+The canonical SQL lives at `schema/duc.sql` (plus `schema/version_control.sql` and `schema/search.sql`) and is **embedded at compile time** by [`build.rs`](build.rs)
+
+Migrations are ran and handled **automatically** upon usage of the library. Each migration is a SQL file named `<from>_to_<to>.sql` in `schema/migrations/`. `build.rs` scans that directory, sorts by `from_version` and emits a static `MIGRATIONS` array. Adding a new migration requires **no Rust changes** — drop the file in and rebuild.
+
+## Features
+
+| Feature | Default | Description |
+|---------|---------|-------------|
+| `default` | ✅ | Native build with bundled SQLite |
+| `opfs` | ❌ | OPFS SAH-pool VFS for `wasm32-unknown-unknown` (browser persistence) |
+
+
+## Documentation
+
+- Full API reference: [docs.rs/duc](https://docs.rs/duc)
+- Format specification, concepts and guides: [duc.ducflair.com](https://duc.ducflair.com)
+
+## Tools
+
+- [Playground](https://ducflair.com/core): Experiment with the `.duc` format in the browser.
+
+## Contributing
+
+Feel free to open an issue or contact us at [Ducflair Support](https://www.ducflair.com/support).
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for more details.

{ducpy-3.3.8 → ducpy-3.5.0}/packages/ducrs/schema/duc.sql

@@ -1,7 +1,7 @@
 -- "DUC_" in ASCII
 -- Apply in order: duc.sql → version_control.sql → search.sql
 PRAGMA application_id = 1146569567;
-PRAGMA user_version = 3000004;
+PRAGMA user_version = 3000005;
 PRAGMA journal_mode = WAL;
 PRAGMA foreign_keys = ON;
 PRAGMA synchronous = NORMAL;

ducpy-3.5.0/packages/ducrs/schema/migrations/3000004_to_3000005.sql

@@ -0,0 +1,51 @@
+-- Migration: 3000003 → 3000004
+-- Add searchable index for extracted external-file text (PDF content search).
+
+CREATE TABLE IF NOT EXISTS external_file_text_index (
+    id             INTEGER PRIMARY KEY AUTOINCREMENT,
+    file_id        TEXT    NOT NULL,
+    revision_id    TEXT    NOT NULL,
+    mime_type      TEXT    NOT NULL,
+    extracted_text TEXT    NOT NULL DEFAULT '',
+    has_ocr        INTEGER NOT NULL DEFAULT 0,
+    updated        INTEGER NOT NULL,
+    UNIQUE (file_id, revision_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_external_file_text_index_file_id
+    ON external_file_text_index(file_id);
+
+CREATE INDEX IF NOT EXISTS idx_external_file_text_index_revision_id
+    ON external_file_text_index(revision_id);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS search_external_file_text USING fts5(
+    extracted_text,
+    content='external_file_text_index',
+    content_rowid='id',
+    tokenize='unicode61 remove_diacritics 2',
+    prefix='2 3 4 5 6 7 8 9 10'
+);
+
+CREATE TRIGGER IF NOT EXISTS trg_external_file_text_index_ai
+AFTER INSERT ON external_file_text_index BEGIN
+    INSERT INTO search_external_file_text(rowid, extracted_text)
+    VALUES (NEW.id, NEW.extracted_text);
+END;
+
+CREATE TRIGGER IF NOT EXISTS trg_external_file_text_index_ad
+AFTER DELETE ON external_file_text_index BEGIN
+    INSERT INTO search_external_file_text(search_external_file_text, rowid, extracted_text)
+    VALUES ('delete', OLD.id, OLD.extracted_text);
+END;
+
+CREATE TRIGGER IF NOT EXISTS trg_external_file_text_index_au
+AFTER UPDATE OF extracted_text ON external_file_text_index BEGIN
+    INSERT INTO search_external_file_text(search_external_file_text, rowid, extracted_text)
+    VALUES ('delete', OLD.id, OLD.extracted_text);
+    INSERT INTO search_external_file_text(rowid, extracted_text)
+    VALUES (NEW.id, NEW.extracted_text);
+END;
+
+INSERT INTO search_external_file_text(search_external_file_text) VALUES ('rebuild');
+
+PRAGMA user_version = 3000005;

{ducpy-3.3.8 → ducpy-3.5.0}/packages/ducrs/schema/search.sql

@@ -5,7 +5,8 @@
 -- Triggers keep the FTS index automatically in sync on every INSERT/UPDATE/DELETE.
 -- No application-level sync needed.
 --
--- Depends on: duc.sql (elements, element_text, element_doc, element_model, blocks)
+-- Depends on: duc.sql (elements, element_text, element_doc, element_model, blocks,
+--   external_files, external_file_revisions, external_file_revision_data, document_grid_config)
 --
 -- Query examples:
 --   SELECT rowid, rank FROM search_elements WHERE search_elements MATCH 'motor';
@@ -129,6 +130,52 @@ CREATE TRIGGER IF NOT EXISTS trg_blocks_ai AFTER INSERT ON blocks BEGIN
     INSERT INTO search_blocks(rowid, label, description)
     VALUES (NEW.rowid, NEW.label, NEW.description);
 END;
+
+-- Extracted text index for external file revisions (used for PDF content search).
+CREATE TABLE IF NOT EXISTS external_file_text_index (
+    id           INTEGER PRIMARY KEY AUTOINCREMENT,
+    file_id      TEXT    NOT NULL,
+    revision_id  TEXT    NOT NULL,
+    mime_type    TEXT    NOT NULL,
+    extracted_text TEXT  NOT NULL DEFAULT '',
+    has_ocr      INTEGER NOT NULL DEFAULT 0,
+    updated      INTEGER NOT NULL,
+    UNIQUE (file_id, revision_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_external_file_text_index_file_id
+    ON external_file_text_index(file_id);
+
+CREATE INDEX IF NOT EXISTS idx_external_file_text_index_revision_id
+    ON external_file_text_index(revision_id);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS search_external_file_text USING fts5(
+    extracted_text,
+    content='external_file_text_index',
+    content_rowid='id',
+    tokenize='unicode61 remove_diacritics 2',
+    prefix='2 3 4 5 6 7 8 9 10'
+);
+
+CREATE TRIGGER IF NOT EXISTS trg_external_file_text_index_ai
+AFTER INSERT ON external_file_text_index BEGIN
+    INSERT INTO search_external_file_text(rowid, extracted_text)
+    VALUES (NEW.id, NEW.extracted_text);
+END;
+
+CREATE TRIGGER IF NOT EXISTS trg_external_file_text_index_ad
+AFTER DELETE ON external_file_text_index BEGIN
+    INSERT INTO search_external_file_text(search_external_file_text, rowid, extracted_text)
+    VALUES ('delete', OLD.id, OLD.extracted_text);
+END;
+
+CREATE TRIGGER IF NOT EXISTS trg_external_file_text_index_au
+AFTER UPDATE OF extracted_text ON external_file_text_index BEGIN
+    INSERT INTO search_external_file_text(search_external_file_text, rowid, extracted_text)
+    VALUES ('delete', OLD.id, OLD.extracted_text);
+    INSERT INTO search_external_file_text(rowid, extracted_text)
+    VALUES (NEW.id, NEW.extracted_text);
+END;
 CREATE TRIGGER IF NOT EXISTS trg_blocks_ad AFTER DELETE ON blocks BEGIN
     INSERT INTO search_blocks(search_blocks, rowid, label, description)
     VALUES ('delete', OLD.rowid, OLD.label, OLD.description);
@@ -146,3 +193,4 @@ INSERT INTO search_element_text(search_element_text) VALUES ('rebuild');
 INSERT INTO search_element_doc(search_element_doc) VALUES ('rebuild');
 INSERT INTO search_element_model(search_element_model) VALUES ('rebuild');
 INSERT INTO search_blocks(search_blocks) VALUES ('rebuild');
+INSERT INTO search_external_file_text(search_external_file_text) VALUES ('rebuild');

{ducpy-3.3.8 → ducpy-3.5.0}/pyproject.toml

@@ -6,6 +6,7 @@ readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
     "nanoid>=2.0.0",
+    "pypdf>=4.2.0"
 ]
 
 license = { text = "MIT" }
@@ -19,6 +20,12 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
 ]
 
+[project.optional-dependencies]
+ocr = [
+    "rapidocr-onnxruntime>=1.3.24",
+    "numpy>=1.20.0",
+]
+
 [project.urls]
 "Homepage" = "https://duc.ducflair.com"
 "Source" = "https://github.com/ducflair/duc/tree/main/packages/ducpy"
@@ -44,11 +51,14 @@ where = ["src"]
 
 [dependency-groups]
 dev = [
+    "ducpy[ocr]",
+    "maturin>=1.0,<2.0",
     "furo>=2024.8.6",
     "sphinx>=8.1.3",
     "sphinx-autoapi>=3.6.0",
     "pytest>=8.3.5",
     "rich>=13.0.0",
+    "numpy>=1.20.0",
     "typst>=0.14.9",
     "build123d>=0.10.0",
     "ocp-vscode>=3.4.0",
@@ -60,3 +70,6 @@ dev = [
 testpaths = ["src/tests"]
 python_files = "test_*.py"
 addopts = "-vv"
+markers = [
+    "slow: marks tests as slow (OCR-heavy, etc.)",
+]

{ducpy-3.3.8 → ducpy-3.5.0}/src/ducpy/builders/sql_builder.py

@@ -31,12 +31,71 @@ from __future__ import annotations
 import os
 import sqlite3
 import tempfile
+import zlib
 from pathlib import Path
-from typing import Any, List, Optional, Union
+from typing import Any, List, Optional, Sequence, Union
 
 import ducpy_native
 
-__all__ = ["DucSQL"]
+__all__ = ["DucSQL", "quote_sql_identifier"]
+SQLITE_HEADER_MAGIC = b"SQLite format 3\x00"
+
+
+def quote_sql_identifier(value: str) -> str:
+    """Quote a SQLite identifier such as an attached database alias."""
+    if not value:
+        raise ValueError("SQLite identifier cannot be empty.")
+    return '"' + value.replace('"', '""') + '"'
+
+
+def _is_sqlite_bytes(data: bytes) -> bool:
+    return data.startswith(SQLITE_HEADER_MAGIC)
+
+
+def _normalize_sqlite_image(data: bytes) -> bytes:
+    image = bytearray(data)
+    if len(image) > 19:
+        if image[18] == 2:
+            image[18] = 1
+        if image[19] == 2:
+            image[19] = 1
+    return bytes(image)
+
+
+def _inflate_duc_bytes(data: bytes) -> bytes:
+    if _is_sqlite_bytes(data):
+        return _normalize_sqlite_image(data)
+    inflated = zlib.decompress(data, -zlib.MAX_WBITS)
+    if not _is_sqlite_bytes(inflated):
+        raise ValueError("decompressed .duc payload does not start with a SQLite header")
+    return _normalize_sqlite_image(inflated)
+
+
+def _deflate_duc_bytes(data: bytes) -> bytes:
+    compressor = zlib.compressobj(level=-1, wbits=-zlib.MAX_WBITS)
+    return compressor.compress(data) + compressor.flush()
+
+
+def _write_temp_sqlite(data: bytes) -> str:
+    tmp = tempfile.NamedTemporaryFile(suffix=".duc", delete=False)
+    try:
+        tmp.write(_inflate_duc_bytes(data))
+        tmp.close()
+        return tmp.name
+    except Exception:
+        tmp.close()
+        os.unlink(tmp.name)
+        raise
+
+
+def _sqlite_path_for_duc(path: Union[str, Path]) -> tuple[str, Optional[str]]:
+    path = str(path)
+    with open(path, "rb") as f:
+        data = f.read()
+    if _is_sqlite_bytes(data):
+        return path, None
+    temp_path = _write_temp_sqlite(data)
+    return temp_path, temp_path
 
 
 def _get_current_schema_version() -> int:
@@ -105,12 +164,14 @@ class DucSQL:
         path = str(path)
         if not os.path.exists(path):
             raise FileNotFoundError(f"File not found: {path}")
-        self.conn: sqlite3.Connection = sqlite3.connect(path)
+        sqlite_path, temp_path = _sqlite_path_for_duc(path)
+        self.conn: sqlite3.Connection = sqlite3.connect(sqlite_path)
         self.conn.row_factory = sqlite3.Row
         _apply_pragmas(self.conn)
         _apply_migrations(self.conn)
-        self._path: Optional[str] = path
-        self._temp: Optional[str] = None
+        self._path: Optional[str] = sqlite_path
+        self._temp: Optional[str] = temp_path
+        self._attached_temps: list[str] = []
         self._closed = False
 
     @classmethod
@@ -126,29 +187,68 @@ class DucSQL:
         inst.conn.executescript(_read_schema_sql())
         inst._path = target if path else None
         inst._temp = None
+        inst._attached_temps = []
         inst._closed = False
         return inst
 
     @classmethod
     def from_bytes(cls, data: bytes) -> DucSQL:
         """Open a ``.duc`` from raw bytes (temp file, cleaned up on close)."""
-        tmp = tempfile.NamedTemporaryFile(suffix=".duc", delete=False)
+        temp_path = _write_temp_sqlite(data)
         try:
-            tmp.write(data)
-            tmp.close()
             inst = object.__new__(cls)
-            inst.conn = sqlite3.connect(tmp.name)
+            inst.conn = sqlite3.connect(temp_path)
             inst.conn.row_factory = sqlite3.Row
             _apply_pragmas(inst.conn)
             _apply_migrations(inst.conn)
-            inst._path = tmp.name
-            inst._temp = tmp.name
+            inst._path = temp_path
+            inst._temp = temp_path
+            inst._attached_temps = []
             inst._closed = False
             return inst
         except Exception:
-            os.unlink(tmp.name)
+            os.unlink(temp_path)
             raise
 
+    @classmethod
+    def attach_many(
+        cls,
+        paths: Sequence[Union[str, Path]],
+        aliases: Optional[Sequence[str]] = None,
+        read_only: bool = True,
+    ) -> DucSQL:
+        """Open an in-memory SQLite connection with multiple ``.duc`` files attached.
+
+        This is useful for querying multiple drawings in one SQL statement. The
+        returned ``DucSQL`` owns only the in-memory connection; attached files are
+        not deleted on close.
+        """
+        if aliases is not None and len(aliases) != len(paths):
+            raise ValueError("aliases must have the same length as paths.")
+
+        inst = object.__new__(cls)
+        inst.conn = sqlite3.connect(":memory:")
+        inst.conn.row_factory = sqlite3.Row
+        inst._path = None
+        inst._temp = None
+        inst._attached_temps = []
+        inst._closed = False
+
+        for index, path in enumerate(paths):
+            alias = aliases[index] if aliases is not None else f"d{index}"
+            sqlite_path, temp_path = _sqlite_path_for_duc(path)
+            if temp_path:
+                inst._attached_temps.append(temp_path)
+            inst.conn.execute(
+                f"ATTACH DATABASE ? AS {quote_sql_identifier(alias)}",
+                (sqlite_path,),
+            )
+
+        if read_only:
+            inst.conn.execute("PRAGMA query_only = ON")
+
+        return inst
+
     # ------------------------------------------------------------------
     # SQL execution
     # ------------------------------------------------------------------
@@ -186,7 +286,7 @@ class DucSQL:
             finally:
                 dst.close()
 
-    def to_bytes(self) -> bytes:
+    def to_bytes(self, compressed: bool = False) -> bytes:
         """Export the database as raw bytes."""
         self.commit()
         tmp = tempfile.NamedTemporaryFile(suffix=".duc", delete=False)
@@ -196,7 +296,8 @@ class DucSQL:
             self.conn.backup(dst)
             dst.close()
             with open(tmp.name, "rb") as f:
-                return f.read()
+                data = f.read()
+            return _deflate_duc_bytes(data) if compressed else data
         finally:
             os.unlink(tmp.name)
 
@@ -210,6 +311,9 @@ class DucSQL:
             self._closed = True
             if self._temp and os.path.exists(self._temp):
                 os.unlink(self._temp)
+            for temp_path in getattr(self, "_attached_temps", []):
+                if os.path.exists(temp_path):
+                    os.unlink(temp_path)
 
     def __enter__(self) -> DucSQL:
         return self

ducpy-3.5.0/src/ducpy/search/__init__.py

@@ -0,0 +1,19 @@
+"""Search helpers for DUC SQLite databases."""
+
+from .search_elements import (
+    DucElementSearchResult,
+    DucFileSearchResult,
+    DucSearchResponse,
+    DucSearchResult,
+    ExternalFileSearchTarget,
+    search_duc_elements,
+)
+
+__all__ = [
+    "DucElementSearchResult",
+    "DucFileSearchResult",
+    "DucSearchResponse",
+    "DucSearchResult",
+    "ExternalFileSearchTarget",
+    "search_duc_elements",
+]