anyuri¶

Polymorphic URI types for Python. AnyUri auto-dispatches to the right subclass based on the input string, works as a plain str, and integrates with Pydantic v1/v2.

from anyuri import AnyUri
from anyuri.providers import GSUri, S3Uri  # registers cloud providers

AnyUri("https://example.com/1.jpg")    # → HttpUri
AnyUri("gs://bucket/key.jpg")          # → GSUri
AnyUri("s3://bucket/key.jpg")          # → S3Uri
AnyUri("/local/path.jpg")              # → FileUri

Installation¶

pip install anyuri                  # core only (HttpUri, FileUri)
pip install anyuri[gcs]             # + GSUri
pip install anyuri[s3]              # + S3Uri
pip install anyuri[azure]           # + AzureUri
pip install anyuri[all]             # all cloud providers
pip install anyuri[all,pydantic]    # + Pydantic integration

Supported URI Types¶

Class	Schemes accepted	`as_uri()`	`as_source()`
`HttpUri`	`http://`, `https://`	original URL	original URL
`FileUri`	`/path`, `file:///path`	`file://localhost/path`	`/path`
`GSUri`	`gs://`, `https://storage.googleapis.com/`	`gs://bucket/key`	`https://storage.googleapis.com/bucket/key`
`S3Uri`	`s3://`, virtual-hosted/path-style HTTPS	`s3://bucket/key`	`https://bucket.s3.amazonaws.com/key`
`AzureUri`	`abfs://`, `abfss://`, `https://*.blob.core.windows.net/`	`abfs://container@account/path`	`https://account.blob.core.windows.net/container/path`
`R2Uri`	`r2://`, `https://*.r2.cloudflarestorage.com/`	`r2://account/bucket/key`	`https://account.r2.cloudflarestorage.com/bucket/key`
`B2Uri`	`b2://`, `https://f*.backblazeb2.com/file/`	`b2://bucket/key`	`b2://bucket/key`