pydantic-avro

This library can convert a pydantic class to a avro schema or generate python code from a avro schema.

Install

pip install pydantic-avro

Pydantic class to avro schema

import json
from typing import Optional

from pydantic_avro.base import AvroBase


class TestModel(AvroBase):
    key1: str
    key2: int
    key2: Optional[str]


schema_dict: dict = TestModel.avro_schema()
print(json.dumps(schema_dict))

Avro schema to pydantic

# Print to stdout
pydantic-avro avro_to_pydantic --asvc /path/to/schema.asvc

# Save it to a file
pydantic-avro avro_to_pydantic --asvc /path/to/schema.asvc --output /path/to/output.py

Specify expected Avro type

from datetime import datetime
from pydantic import Field
from pydantic_avro.base import AvroBase 

class ExampleModel(AvroBase):
    field1: int = Field(..., avro_type="long")  # Explicitly set Avro type to "long"
    field2: datetime = Field(..., avro_type="timestamp-millis")  # Explicitly set Avro type to "timestamp-millis"

Install for developers

Install package

Requirement: Poetry 1.*

poetry install

Run unit tests

pytest
coverage run -m pytest  # with coverage
# or (depends on your local env) 
poetry run pytest
poetry run coverage run -m pytest  # with coverage

Run linting

The linting is checked in the github workflow. To fix and review issues run this:

black .   # Auto fix all issues
isort .   # Auto fix all issues
pflake .  # Only display issues, fixing is manual

Metadata

Release files for pydantic-avro 0.12.0

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

Source distribution (sdist)

Source distribution for pydantic-avro 0.12.0
File	Size	Uploaded
pydantic_avro-0.12.0.tar.gz	10.2 kB	Sep 5, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pydantic-avro 0.12.0
File	Interpreter	ABI	Platform	Reset
pydantic_avro-0.12.0-py3-none-any.whl 12.3 kB Sep 5, 2026	Python 3	none	any	Details

Total release size: 22.6 kB

Release files / pydantic_avro-0.12.0.tar.gz

Download URL	pydantic_avro-0.12.0.tar.gz
Size	10.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`9feccb351e71426466dddea6bb8839c5d223737e45237a60e2bbeeb36870cc55`
BLAKE2b-256 checksum How to use checksums	`86835bebea7353a5940eba5377fc26a960fa737627359a3dc7561aa0a23487be`
Upload date	Sep 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / pydantic_avro-0.12.0-py3-none-any.whl

Download URL	pydantic_avro-0.12.0-py3-none-any.whl
Size	12.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d014b9f90dad46d000640582aeb24bf4f95de45c2badaa44154351d23c531cd1`
BLAKE2b-256 checksum How to use checksums	`59bb19f7cb61d22a20ff8ab69c97bba8156123717dcc3fccff150d19464a8314`
Upload date	Sep 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`