Skip to main content

url_schema

Returns a schema that matches a URL value, e.g.:

from pydantic_core import SchemaValidator, core_schema

schema = core_schema.url_schema()
v = SchemaValidator(schema)
print(v.validate_python('https://example.com'))
# > https://example.com/
def url_schema(
max_length: int | None = None,
allowed_schemes: list[str] | None = None,
host_required: bool | None = None,
default_host: str | None = None,
default_port: int | None = None,
default_path: str | None = None,
preserve_empty_path: bool | None = None,
strict: bool | None = None,
ref: str | None = None,
metadata: dict[str, Any] | None = None,
serialization: SerSchema | None = None
) - > UrlSchema

Returns a schema that matches a URL value.

Parameters

NameTypeDescription
max_length`intNone` = None
allowed_schemes`list[str]None` = None
host_required`boolNone` = None
default_host`strNone` = None
default_port`intNone` = None
default_path`strNone` = None
preserve_empty_path`boolNone` = None
strict`boolNone` = None
ref`strNone` = None
metadata`dict[str, Any]None` = None
serialization`SerSchemaNone` = None

Returns

TypeDescription
UrlSchemaA dictionary-based schema configuration used by pydantic-core to validate and parse URL strings.