Custom validators¶
A list of validators that can be overridden in Salesman.
Address validator¶
During the checkout process, both the shipping and billing addresses can be specified.
The default address validator is set to salesman.checkout.utils.validate_address()
that simply makes both address fields required to be entered by the customer.
This behavior can be overridden by providing a dotted path in SALESMAN_ADDRESS_VALIDATOR
setting that points to your custom validator function.
Tip
To validate a specific address format split the text by \n
character and validate each line.
def validate_address(value: str, context: dict) -> str:
"""
Default address validator function. Can be overriden by providing a
dotted path to a function in ``SALESMAN_ADDRESS_VALIDATOR`` setting.
Args:
value (str): Address text to be validated
context (dict, optional): Validator context data.
Raises:
ValidationError: In case address is not valid
Returns:
str: Validated value
"""
if not value:
raise ValidationError(_("Address is required."))
return value
Your custom validator should accept a text value
and return the validated version.
It also receives a context
dictionary with additional context data like request
,
a basket
object and address
type (set to either shipping or billing).
Extra validator¶
Both the basket and basket item objects have an extra
JSON field to store additional
information that can be changed or updated via the API. By default no validation is enforced
through a placeholder salesman.basket.utils.validate_extra()
function.
You can add custom validation by providing a dotted path in SALESMAN_EXTRA_VALIDATOR
setting that points to your custom validator function.
def validate_extra(value: dict, context: dict) -> dict:
"""
Default extra validator function. Can be overriden by providing a
dotted path to a function in ``SALESMAN_EXTRA_VALIDATOR`` setting.
Args:
value (str): Extra dict to be validated
context (dict, optional): Validator context data.
Raises:
ValidationError: In case data is not valid
Returns:
dict: Validated value
"""
return value
Your custom validator should accept a dictionary value
and return the validated version.
It also receives a context
dictionary with additional context data like request
,
a basket
object and basket_item
in case validation is happening on the basket item.