dcclib

A modular Python library for working with Digital Calibration Certificates (DCCs), complete with a CLI and REST API.

[Documentation](https://gitlab-pages.ptb.de/d-ptb/dcc/dcclib/) | [Releases](https://gitlab1.ptb.de/d-ptb/dcc/dcclib/-/releases) | [Issues](https://gitlab1.ptb.de/d-ptb/dcc/dcclib/-/issues)

[[TOC]]

Overview

dcclib is a comprehensive monorepo that houses:

• dcclib: Core library with essential tools for handling DCCs and other XML-based files.
• dcclib-cli: Command Line Interface for quick access to library features.
• dcclib-rest-api: RESTful API for integrating the library functionality into web services.

Whether you're converting, validating, or extracting information from DCCs, this library provides structured and reusable components to streamline your workflow.

Full documentation (architecture overview, CLI reference, REST API docs, and API reference) is available at the project documentation site.

Installation

Using pip

# Install the library in a virtual environment
pip install dcclib

# or install the CLI globally
pipx install "dcclib[cli]"
# with MCP support for AI agents
pipx install "dcclib[cli,mcp]"
# and with unit-aware quantities support using dccQuantities (requires .NET on Windows and libmono on Linux)
pipx install "dcclib[cli,quantities]"
# and everything for the full experience
pipx install "dcclib[cli,mcp,quantities]"

Using docker

# Run the CLI in the current directory, replacing <command> with the desired command
docker run --rm -v $(pwd):/app registry.gitlab1.ptb.de/d-ptb/dcc/dcclib/cli:latest <command>

# Run the REST API on port 8080
docker run --rm -p 8080:8080 registry.gitlab1.ptb.de/d-ptb/dcc/dcclib/rest-api:latest

Development Setup

Requirements

• Git
• mise (install via curl https://mise.run | sh), optional but recommended
• Python (via mise)
• uv (via mise)

Getting Started

# Clone the repository
git clone https://gitlab1.ptb.de/d-ptb/dcc/dcclib.git
cd dcclib

# Install all dependencies
mise run setup # or: uv sync --all-packages

Run mise tasks ls for the full list of available tasks. Common ones:

Publications and acknowledgments

This project was developed as part of the bachelor thesis of Jan Loewe at the Ostfalia University of Applied Sciences.
More information on dcclib itself can be found in the presentation by Jan Loewe and Justin Jagieniak at the 6th International DCC Conference in 2026.
The formula module is based on previous work conducted by Justin Jagieniak, Siegfried Hackel and Jan Loewe first presented at the 5th International DCC Conference in 2025.
Automatic uncertainty propagation is implemented using dccQuantities which internally relies on METAS UncLib.
dccQuantities was also presented at the 6th International DCC Conference by Jaime Gonzalez-Gomez, Benedikt Seeger and Vanessa Stehr.