ducpy

SQLite-backed project-state format for physical-engineering work before execution

Python

The ducpy package is the official Python implementation of the .duc project-state format. It is built on top of the duc Rust crate, exposed as the ducpy_native extension. A .duc file is a gzip-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

pip install ducpy

or with uv:

uv add ducpy

Quick start

import ducpy as duc

API overview

ducpy is organised around four conceptual entry points, matching the structure of the full API reference:

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 — building rectangles, ellipses, polygons, lines, arrows, text, frames and plots with the fluent builder DSL.
Mutating elements — updating element properties in place and observing version changes.
Document elements and model elements — for the higher-level container / model element types.

SQL Builder (Low-level)

A .duc file is a gzip-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 — 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 — parse_duc / list_external_files / streaming revision helpers.
Serialization — serialize_duc from builder-created elements.
External files — 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
Source-level reference: docs/
Full example index: docs/examples.rst

Tools

Playground: Experiment with the duc format in a live environment.

Contributing

Feel free to open an issue or contact us at Ducflair Support.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Download files

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

Source Distribution

ducpy-4.0.3.tar.gz (412.0 kB view details)

Uploaded Sep 6, 2026 Source

File details

Details for the file ducpy-4.0.3.tar.gz.

File metadata

Download URL: ducpy-4.0.3.tar.gz
Upload date: Sep 6, 2026
Size: 412.0 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ducpy-4.0.3.tar.gz
Algorithm	Hash digest
SHA256	`04459e3552863ebff9ecdcb541e0d81b99c69687ae2b63154cfcff7d1496ef84`
MD5	`30a1d67648b6e035e2d3e57b2f87c1c3`
BLAKE2b-256	`42f5644ecd379c65ae1f8246de2a1e6d3ffcbcaede4e5a716ed39a889d774d1c`