kanne 1.0.0

a context-aware si-unit registry manager built on pint and pydantic

kanne

kanne

Kanne is a small utility package to help manage unit-aware quantities and a simple registry/context pattern for parsing and validating units using Pint. It provides convenience helpers, validators, and a minimal context manager (Kanne) to make working with Pint registries explicit and testable.

Key ideas:

• Keep unit parsing and validation ergonomic.
• Provide a lightweight context aware registry (Kanne) for libraries.
• Export commonly-used units and small helpers for convenience.

📦 Installation

uv add kanne

⚡ Quick Start

Kanne provides a context manager to manage Pint registries easily.

# Global Pattern
from kanne import Kanne, Millisecond, Millimeter, define_unit
from pydantic import BaseModel


class Event(BaseModel):
    duration: Millisecond

class OtherEvent(BaseModel):
    length: Millimeter


Event(duration="1500 ms")  # works fine
OtherEvent(length="1500 mm")  # raises a validation error
event = Event(duration="1500 ms")  # works fine
other = OtherEvent(length="1500 mm")  # raises a validation error


event.duration + other.length  # raises an error since they are not compatible