tigrbl_model
Pydantic-independent model validation, schema generation, and JSON, YAML, and TOML serialization for Tigrbl.
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.
Related Packages
tigrbltigrbl-coretigrbl-basetigrbl-runtime
Documentation Links
Support
- Community: Discord
- Issues: GitHub Issues
- Repository: tigrbl/tigrbl
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.