mirror of
https://github.com/paperless-ngx/paperless-ngx.git
synced 2026-09-02 16:07:15 +00:00
stumpylog
2197781b39
All 4 hits in documents/validators.py were f-strings inside gettext
_() calls, which resolves the string before translation and breaks
extraction (confirmed: locale .po files literally contain the raw
"{value}" placeholder as msgid text). Fixed by using %(name)s-style
placeholders with Django ValidationError's existing params= kwarg,
which was already being passed but silently unused.
65 lines
2.0 KiB
Python
65 lines
2.0 KiB
Python
from urllib.parse import urlparse
|
|
|
|
from django.core.exceptions import ValidationError
|
|
from django.utils.translation import gettext_lazy as _
|
|
|
|
|
|
def uri_validator(value: str, allowed_schemes: set[str] | None = None) -> None:
|
|
"""
|
|
Validates that the given value parses as a URI with required components
|
|
and optionally restricts to specific schemes.
|
|
|
|
Args:
|
|
value: The URI string to validate
|
|
allowed_schemes: Optional set/list of allowed schemes (e.g. {'http', 'https'}).
|
|
If None, all schemes are allowed.
|
|
|
|
Raises:
|
|
ValidationError: If the URI is invalid or uses a disallowed scheme
|
|
"""
|
|
try:
|
|
parts = urlparse(value)
|
|
if not parts.scheme:
|
|
raise ValidationError(
|
|
_("Unable to parse URI %(value)s, missing scheme"),
|
|
params={"value": value},
|
|
)
|
|
elif not parts.netloc and not parts.path:
|
|
raise ValidationError(
|
|
_("Unable to parse URI %(value)s, missing net location or path"),
|
|
params={"value": value},
|
|
)
|
|
|
|
if allowed_schemes and parts.scheme not in allowed_schemes:
|
|
raise ValidationError(
|
|
_(
|
|
"URI scheme '%(scheme)s' is not allowed. Allowed schemes: %(allowed_schemes)s",
|
|
),
|
|
params={
|
|
"value": value,
|
|
"scheme": parts.scheme,
|
|
"allowed_schemes": ", ".join(allowed_schemes),
|
|
},
|
|
)
|
|
|
|
except ValidationError:
|
|
raise
|
|
except Exception as e:
|
|
raise ValidationError(
|
|
_("Unable to parse URI %(value)s"),
|
|
params={"value": value},
|
|
) from e
|
|
|
|
|
|
def url_validator(value) -> None:
|
|
"""
|
|
Validates that the given value is a valid HTTP or HTTPS URL.
|
|
|
|
Args:
|
|
value: The URL string to validate
|
|
|
|
Raises:
|
|
ValidationError: If the URL is invalid or not using http/https scheme
|
|
"""
|
|
uri_validator(value, allowed_schemes={"http", "https"})
|