validators/src/validators/mac_address.py at master · python-validators/validators · GitHub

Repository navigation

36 lines (26 loc) · 996 Bytes

"""MAC Address."""

# standard

import re

# local

from .utils import validator

@validator

def mac_address(value: str, /):

"""Return whether or not given value is a valid MAC address.

This validator is based on [WTForms MacAddress validator][1].

[1]: https://github.com/wtforms/wtforms/blob/master/src/wtforms/validators.py#L482

Examples:

>>> mac_address('01:23:45:67:ab:CD')

True

>>> mac_address('00:00:00:00:00')

ValidationError(func=mac_address, args={'value': '00:00:00:00:00'})

Args:

value:

MAC address string to validate.

Returns:

(Literal[True]): If `value` is a valid MAC address.

(ValidationError): If `value` is an invalid MAC address.

"""

# Check for mixed separators: MAC addresses cannot use both ':' and '-' simultaneously

if ":" in value and "-" in value:

return False

return re.match(r"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$", value) if value else False