team-10/venv/Lib/site-packages/validators/encoding.py
2025-08-02 02:00:33 +02:00

95 lines
2.3 KiB
Python

"""Encoding."""
# standard
import re
# local
from .utils import validator
@validator
def base16(value: str, /):
"""Return whether or not given value is a valid base16 encoding.
Examples:
>>> base16('a3f4b2')
True
>>> base16('a3f4Z1')
ValidationError(func=base16, args={'value': 'a3f4Z1'})
Args:
value:
base16 string to validate.
Returns:
(Literal[True]): If `value` is a valid base16 encoding.
(ValidationError): If `value` is an invalid base16 encoding.
"""
return re.match(r"^[0-9A-Fa-f]+$", value) if value else False
@validator
def base32(value: str, /):
"""Return whether or not given value is a valid base32 encoding.
Examples:
>>> base32('MFZWIZLTOQ======')
True
>>> base32('MfZW3zLT9Q======')
ValidationError(func=base32, args={'value': 'MfZW3zLT9Q======'})
Args:
value:
base32 string to validate.
Returns:
(Literal[True]): If `value` is a valid base32 encoding.
(ValidationError): If `value` is an invalid base32 encoding.
"""
return re.match(r"^[A-Z2-7]+=*$", value) if value else False
@validator
def base58(value: str, /):
"""Return whether or not given value is a valid base58 encoding.
Examples:
>>> base58('14pq6y9H2DLGahPsM4s7ugsNSD2uxpHsJx')
True
>>> base58('cUSECm5YzcXJwP')
True
Args:
value:
base58 string to validate.
Returns:
(Literal[True]): If `value` is a valid base58 encoding.
(ValidationError): If `value` is an invalid base58 encoding.
"""
return re.match(r"^[1-9A-HJ-NP-Za-km-z]+$", value) if value else False
@validator
def base64(value: str, /):
"""Return whether or not given value is a valid base64 encoding.
Examples:
>>> base64('Y2hhcmFjdGVyIHNldA==')
True
>>> base64('cUSECm5YzcXJwP')
ValidationError(func=base64, args={'value': 'cUSECm5YzcXJwP'})
Args:
value:
base64 string to validate.
Returns:
(Literal[True]): If `value` is a valid base64 encoding.
(ValidationError): If `value` is an invalid base64 encoding.
"""
return (
re.match(r"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", value)
if value
else False
)