urlstd.parse.URLValidator

class urlstd.parse.URLValidator

Bases: object

Validates a URL string.

Examples

>>> URL.can_parse('https://user:password@example.org/')
True
>>> URLValidator.is_valid('https://user:password@example.org/')
False
>>> URL.can_parse('file:///C|/demo')
True
>>> URLValidator.is_valid('file:///C|/demo')
False

>>> validity = ValidityState()
>>> URLValidator.is_valid('https://user:password@example.org/', validity=validity)
False
>>> validity
ValidityState(valid=False, error_types=['invalid-credentials'],
descriptions=["invalid-credentials: input includes credentials: 'https://user:password@example.org/' at position 21"],
validation_errors=1, disable_logging=True)

>>> URLValidator.is_valid('file:///C|/demo', validity=validity)
False
>>> validity
ValidityState(valid=False, error_types=['invalid-URL-unit'],
descriptions=["invalid-URL-unit: code point is found that is not a URL unit: U+007C (|) in 'file:///C|/demo' at position 9"],
validation_errors=1, disable_logging=True)

Methods:

is_valid(urlstring[, base, encoding])	Returns True if urlstring against a base URL base is a valid URL.
is_valid_url_scheme(value, **kwargs)	Returns True if value is a valid URL-scheme that is registered in the IANA URI Schemes registry.