Skip to main content

tigrbl_model

Pydantic-independent model validation, schema generation, and JSON, YAML, and TOML serialization for Tigrbl.

PyPI version for tigrbl_model Discord community for tigrbl_model Apache 2.0 license Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl_model

What is tigrbl_model?

tigrbl_model is Tigrbl's Pydantic-independent model engine. It owns field metadata, validation, serialization, dynamic model construction, forward-reference rebuilding, and JSON Schema generation.

Why use tigrbl_model?

Use it when code needs the Pydantic v2 surface validated by the package tests for Tigrbl without taking a runtime dependency on Pydantic.

When should I install tigrbl_model?

Install it when building Tigrbl extensions, reusable schema models, or applications that need the same model contract as Tigrbl.

Who is tigrbl_model for?

Tigrbl maintainers, extension authors, and application developers who need validated models and portable serialization.

Where does tigrbl_model fit?

It is a foundational package under pkgs/02_model, below Tigrbl packages that consume models, validation, and JSON Schema.

How does tigrbl_model work?

Type annotations and Field metadata are compiled into an internal field graph. The graph drives validation, dumping, JSON Schema, and the JSON, YAML, and TOML mixins.

Install

uv add tigrbl-model
pip install tigrbl-model

Surface Coverage

Surface Value
PyPI package tigrbl-model
Repository path pkgs/02_model/tigrbl_model
Python import root tigrbl_model
Console scripts none
Public mixins JsonMixin, YamlMixin, TomlMixin, SerdeMixin
Runtime Pydantic dependency none
Legal files LICENSE, NOTICE
Supported Python `3.10

What It Owns

  • Runtime model construction and field metadata.
  • Annotation-driven validation and structured errors.
  • Dictionary and JSON serialization.
  • JSON Schema generation.
  • Independently composable JSON, YAML, and TOML mixins.
  • SerdeMixin, which aggregates all three format mixins.

Public API and Import Surface

The primary imports are Model/BaseModel, RootModel, Field, ConfigDict, ValidationError, create_model, field_validator, model_validator, and the four serialization mixins. See tigrbl_model.__all__ for the complete supported surface.

Usage Examples

from tigrbl_model import Field, Model

class Widget(Model):
    name: str
    quantity: int = Field(default=0, ge=0)

widget = Widget.model_validate_json('{"name":"bolt","quantity":2}')
assert widget.model_dump() == {"name": "bolt", "quantity": 2}
assert Widget.model_validate_yaml(widget.model_dump_yaml()) == widget
assert Widget.model_validate_toml(widget.model_dump_toml()) == widget

Plain dataclasses can inherit SerdeMixin when validation and schema-model behavior are unnecessary.

How To Choose This Package

Choose tigrbl_model for the focused model and serialization boundary. Choose the tigrbl facade when building a complete API application. Keep Pydantic installed only when independently comparing behavior during development.

  • tigrbl
  • tigrbl-core
  • tigrbl-base
  • tigrbl-runtime

Support

Certification Status

The package's automated suite compares the supported contract with Pydantic v2 and scans first-party Tigrbl runtime usage. PARITY.md records intentional boundaries; Pydantic is a development-only parity oracle and is not a runtime dependency.

License

Licensed under the Apache License, Version 2.0. See LICENSE and NOTICE.

Workspace documentation

This README is the package-local distribution entry point. See workspace documentation, current conformance target, package catalog, package layout, and SSOT registry.

Metadata

Release files for tigrbl_model 0.4.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tigrbl_model 0.4.5
File Size Uploaded Provenance Actions
tigrbl_model-0.4.5.tar.gz 20.2 kB Without provenance Details for tigrbl_model-0.4.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tigrbl_model 0.4.5
File Interpreter ABI Platform Actions
tigrbl_model-0.4.5-py3-none-any.whl Python 3 none any Details for tigrbl_model-0.4.5-py3-none-any.whl

Total release size: 46.3 kB

Release files / tigrbl_model-0.4.5.tar.gz

Download URL tigrbl_model-0.4.5.tar.gz
Size 20.2 kB
Tags Source
SHA-256 checksum
How to use checksums
72c033012276fabdf81dd8944373bdb48c77cbca1a726b1d2af1716d486048b5
BLAKE2b-256 checksum
How to use checksums
7e3fce950dcdac5f44e2fa9867718d19d27e5c9c90c16c59e71808b09a5a18f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / tigrbl_model-0.4.5-py3-none-any.whl

Download URL tigrbl_model-0.4.5-py3-none-any.whl
Size 26.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c9acd111a62527223659adfa09ddd3f7dff6340931ca1df211ddd12d14ba2cad
BLAKE2b-256 checksum
How to use checksums
15b26d5c9f5a552fc9550273fa012f12ce12be841f062c720f61503e9b789af7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for tigrbl_model 0.4.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.4.5 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page