31 lines
730 B
Python
31 lines
730 B
Python
|
"""Slug."""
|
||
|
|
|
||
|
|
# standard
|
||
|
|
import re
|
||
|
|
|
||
|
|
# local
|
||
|
|
from .utils import validator
|
||
|
|
|
||
|
|
|
||
|
|
@validator
|
||
|
|
def slug(value: str, /):
|
||
|
|
"""Validate whether or not given value is valid slug.
|
||
|
|
|
||
|
|
Valid slug can contain only lowercase alphanumeric characters and hyphens.
|
||
|
|
It starts and ends with these lowercase alphanumeric characters.
|
||
|
|
|
||
|
|
Examples:
|
||
|
|
>>> slug('my-slug-2134')
|
||
|
|
True
|
||
|
|
>>> slug('my.slug')
|
||
|
|
ValidationError(func=slug, args={'value': 'my.slug'})
|
||
|
|
|
||
|
|
Args:
|
||
|
|
value: Slug string to validate.
|
||
|
|
|
||
|
|
Returns:
|
||
|
|
(Literal[True]): If `value` is a valid slug.
|
||
|
|
(ValidationError): If `value` is an invalid slug.
|
||
|
|
"""
|
||
|
|
return re.match(r"^[a-z0-9]+(?:-[a-z0-9]+)*$", value) if value else False
|