pydantypes 0.1.0

The missing types for Pydantic — cloud, DevOps, web, and data engineering.

pydantypes

The missing types for Pydantic — cloud, DevOps, web, and data engineering.

pydantypes provides validated, constrained Pydantic types for identifiers, ARNs, URIs, and resource names that appear everywhere in modern infrastructure code. Catch invalid values at parse time, not at deploy time.

Installation

pip install pydantypes

Quick Example

from pydantic import BaseModel
from pydantypes.cloud.aws import S3Uri, IamRoleArn

class PipelineConfig(BaseModel):
    source: S3Uri
    execution_role: IamRoleArn

config = PipelineConfig(
    source="s3://my-bucket/data/input.parquet",
    execution_role="arn:aws:iam::123456789012:role/pipeline-role",
)
# Invalid values are rejected immediately:
# PipelineConfig(source="not-an-s3-uri", ...)  -> ValidationError

Domains

Domain	Package	Examples
AWS	pydantypes.cloud.aws	S3 URIs, IAM ARNs, Lambda function names, EC2 instance IDs
Azure	pydantypes.cloud.azure	Blob Storage URIs, resource IDs, Key Vault names
GCP	pydantypes.cloud.gcp	GCS URIs, project IDs, Cloud Run service names
DevOps	pydantypes.devops	Docker image refs, semver strings, cron expressions
Web	pydantypes.web	Endpoint paths, header names, MIME types
Data	pydantypes.data	SQL identifiers, connection strings, column names

Compatibility

pydantypes is designed as a complement to pydantic-extra-types. While pydantic-extra-types covers general-purpose types (colors, phone numbers, payment cards), pydantypes focuses on infrastructure and engineering identifiers.

• Requires Pydantic v2.5.2+
• Supports Python 3.10–3.13

Development

# Clone and set up
git clone https://github.com/oborchers/pydantypes.git
cd pydantypes
make init

# Run checks
make check        # lint + typecheck + test
make format       # auto-format code
make test-cov     # tests with coverage report

License

MIT