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.13.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.13.0
File	Size	Uploaded
pydantic_avro-0.13.0.tar.gz	10.8 kB	Sep 5, 2026	Details

Built distribution (wheel)

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

Total release size: 23.6 kB

Release files / pydantic_avro-0.13.0.tar.gz

Download URL	pydantic_avro-0.13.0.tar.gz
Size	10.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`31f837292d986740798acff73ebca3416175ad53c77d71ee034138f468faac32`
BLAKE2b-256 checksum How to use checksums	`a625ba4221f4800c3e1ec73380766773ba1a689de4939fa7fc5f5a793eecc876`
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.13.0-py3-none-any.whl

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