Create ASDF tags with pydantic models
Project description
asdf-pydantic
Create ASDF tags with pydantic models.
from asdf_pydantic import AsdfPydanticModel
class Rectangle(AsdfPydanticModel):
_tag = "asdf://asdf-pydantic/examples/tags/rectangle-1.0.0"
width: float
height: float
# After creating extension and install ...
af = asdf.AsdfFile()
af["rect"] = Rectangle(width=1, height=1)
#ASDF 1.0.0
#ASDF_STANDARD 1.5.0
%YAML 1.1
%TAG ! tag:stsci.edu:asdf/
--- !core/asdf-1.1.0
asdf_library: !core/software-1.0.0 {
author: The ASDF Developers,
homepage: 'http://github.com/asdf-format/asdf',
name: asdf,
version: 2.14.3}
history:
extensions:
- !core/extension_metadata-1.0.0
extension_class: asdf.extension.BuiltinExtension
software: !core/software-1.0.0 {
name: asdf,
version: 2.14.3}
- !core/extension_metadata-1.0.0 {
extension_class: mypackage.shapes.ShapesExtension,
extension_uri: 'asdf://asdf-pydantic/shapes/extensions/shapes-1.0.0'}
rect: !<asdf://asdf-pydantic/shapes/tags/rectangle-1.0.0> {
height: 1.0,
width: 1.0}
...
Features
- Create ASDF tag from your pydantic models with batteries (converters) included.
- Validates data models as you create them and not only when reading and writing ASDF files.
- Preserve Python types when deserializing ASDF files.
- All the cool things that comes with pydantic (e.g., JSON encoder, JSON schema, Pydantic types)
- Comes with schemas.
Installation
pip install asdf-pydantic
Usage
Define your data model
# mypackage/shapes.py
from asdf_pydantic import AsdfPydanticModel
class Rectangle(AsdfPydanticModel):
_tag = "asdf://asdf-pydantic/examples/tags/rectangle-1.0.0"
width: float
height: float
Then create an extension with the converter included with asdf-pydantic:
# mypackage/extensions.py
from asdf.extension import Extension
from asdf_pydantic.converter import AsdfPydanticConverter
from mypackage.shapes import Rectangle
AsdfPydanticConverter.add_models(Rectangle)
class ShapesExtension(Extension):
extension_uri = "asdf://asdf-pydantic/examples/extensions/shapes-1.0.0"
converters = [AsdfPydanticConverter()]
tags = [*AsdfPydanticConverter().tags]
Install the extension either by entry point specification or add it to
asdf.get_config()
:
import asdf
from mypackage.extensions import ShapeExtension
asdf.get_config().add_extension(ShapesExtension())
af = asdf.AsdfFile()
af["rect"] = Rectangle(width=1, height=1)
with open("shapes.asdf", "wb") as fp:
af.write_to(fp)
:maxdepth: 1
autoapi
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
asdf_pydantic-1.0.2.tar.gz
(11.3 kB
view hashes)
Built Distribution
Close
Hashes for asdf_pydantic-1.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7020bcc3f652b6da4bf0ff9f1fccde61a59bdce20b89fe3410d445af849b56a6 |
|
MD5 | 635fe0e36f15c1aa34e8a5a684e25999 |
|
BLAKE2b-256 | c0af5619f2b571739a35a19e40a106f8b848543cf42b229a6be1b597fef2384c |