Skip to content

hashes

validators.hashes.md5(value)

Return whether or not given value is a valid MD5 hash.

Examples:

>>> md5('d41d8cd98f00b204e9800998ecf8427e')
True
>>> md5('900zz11')
ValidationError(func=md5, args={'value': '900zz11'})

Parameters:

Name Type Description Default
value str

MD5 string to validate.

 required

Returns:

Type Description
Literal[True]

If value is a valid MD5 hash.
ValidationError

If value is an invalid MD5 hash.
Source code in src/validators/hashes.py 
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
@validator
def md5(value: str, /):
    """Return whether or not given value is a valid MD5 hash.

    Examples:
        >>> md5('d41d8cd98f00b204e9800998ecf8427e')
        True
        >>> md5('900zz11')
        ValidationError(func=md5, args={'value': '900zz11'})

    Args:
        value:
            MD5 string to validate.

    Returns:
        (Literal[True]): If `value` is a valid MD5 hash.
        (ValidationError): If `value` is an invalid MD5 hash.
    """
    return re.match(r"^[0-9a-f]{32}$", value, re.IGNORECASE) if value else False

validators.hashes.sha1(value)

Return whether or not given value is a valid SHA1 hash.

Examples:

>>> sha1('da39a3ee5e6b4b0d3255bfef95601890afd80709')
True
>>> sha1('900zz11')
ValidationError(func=sha1, args={'value': '900zz11'})

Parameters:

Name Type Description Default
value str

SHA1 string to validate.

 required

Returns:

Type Description
Literal[True]

If value is a valid SHA1 hash.
ValidationError

If value is an invalid SHA1 hash.
Source code in src/validators/hashes.py 
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
@validator
def sha1(value: str, /):
    """Return whether or not given value is a valid SHA1 hash.

    Examples:
        >>> sha1('da39a3ee5e6b4b0d3255bfef95601890afd80709')
        True
        >>> sha1('900zz11')
        ValidationError(func=sha1, args={'value': '900zz11'})

    Args:
        value:
            SHA1 string to validate.

    Returns:
        (Literal[True]): If `value` is a valid SHA1 hash.
        (ValidationError): If `value` is an invalid SHA1 hash.
    """
    return re.match(r"^[0-9a-f]{40}$", value, re.IGNORECASE) if value else False

validators.hashes.sha224(value)

Return whether or not given value is a valid SHA224 hash.

Examples:

>>> sha224('d14a028c2a3a2bc9476102bb288234c415a2b01f828ea62ac5b3e42f')
True
>>> sha224('900zz11')
ValidationError(func=sha224, args={'value': '900zz11'})

Parameters:

Name Type Description Default
value str

SHA224 string to validate.

 required

Returns:

Type Description
Literal[True]

If value is a valid SHA224 hash.
ValidationError

If value is an invalid SHA224 hash.
Source code in src/validators/hashes.py 
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
@validator
def sha224(value: str, /):
    """Return whether or not given value is a valid SHA224 hash.

    Examples:
        >>> sha224('d14a028c2a3a2bc9476102bb288234c415a2b01f828ea62ac5b3e42f')
        True
        >>> sha224('900zz11')
        ValidationError(func=sha224, args={'value': '900zz11'})

    Args:
        value:
            SHA224 string to validate.

    Returns:
        (Literal[True]): If `value` is a valid SHA224 hash.
        (ValidationError): If `value` is an invalid SHA224 hash.
    """
    return re.match(r"^[0-9a-f]{56}$", value, re.IGNORECASE) if value else False

validators.hashes.sha256(value)

Return whether or not given value is a valid SHA256 hash.

Examples:

>>> sha256(
...     'e3b0c44298fc1c149afbf4c8996fb924'
...     '27ae41e4649b934ca495991b7852b855'
... )
True
>>> sha256('900zz11')
ValidationError(func=sha256, args={'value': '900zz11'})

Parameters:

Name Type Description Default
value str

SHA256 string to validate.

 required

Returns:

Type Description
Literal[True]

If value is a valid SHA256 hash.
ValidationError

If value is an invalid SHA256 hash.
Source code in src/validators/hashes.py 
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
@validator
def sha256(value: str, /):
    """Return whether or not given value is a valid SHA256 hash.

    Examples:
        >>> sha256(
        ...     'e3b0c44298fc1c149afbf4c8996fb924'
        ...     '27ae41e4649b934ca495991b7852b855'
        ... )
        True
        >>> sha256('900zz11')
        ValidationError(func=sha256, args={'value': '900zz11'})

    Args:
        value:
            SHA256 string to validate.

    Returns:
        (Literal[True]): If `value` is a valid SHA256 hash.
        (ValidationError): If `value` is an invalid SHA256 hash.
    """
    return re.match(r"^[0-9a-f]{64}$", value, re.IGNORECASE) if value else False

validators.hashes.sha384(value)

Return whether or not given value is a valid SHA384 hash.

Examples:

>>> sha384(
...     'cb00753f45a35e8bb5a03d699ac65007272c32ab0eded163'
...     '1a8b605a43ff5bed8086072ba1e7cc2358baeca134c825a7'
... )
True
>>> sha384('900zz11')
ValidationError(func=sha384, args={'value': '900zz11'})

Parameters:

Name Type Description Default
value str

SHA384 string to validate.

 required

Returns:

Type Description
Literal[True]

If value is a valid SHA384 hash.
ValidationError

If value is an invalid SHA384 hash.
Source code in src/validators/hashes.py 
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
@validator
def sha384(value: str, /):
    """Return whether or not given value is a valid SHA384 hash.

    Examples:
        >>> sha384(
        ...     'cb00753f45a35e8bb5a03d699ac65007272c32ab0eded163'
        ...     '1a8b605a43ff5bed8086072ba1e7cc2358baeca134c825a7'
        ... )
        True
        >>> sha384('900zz11')
        ValidationError(func=sha384, args={'value': '900zz11'})

    Args:
        value:
            SHA384 string to validate.

    Returns:
        (Literal[True]): If `value` is a valid SHA384 hash.
        (ValidationError): If `value` is an invalid SHA384 hash.
    """
    return re.match(r"^[0-9a-f]{96}$", value, re.IGNORECASE) if value else False

validators.hashes.sha512(value)

Return whether or not given value is a valid SHA512 hash.

Examples:

>>> sha512(
...     'cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce'
...     '9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af9'
...     '27da3e'
... )
True
>>> sha512('900zz11')
ValidationError(func=sha512, args={'value': '900zz11'})

Parameters:

Name Type Description Default
value str

SHA512 string to validate.

 required

Returns:

Type Description
Literal[True]

If value is a valid SHA512 hash.
ValidationError

If value is an invalid SHA512 hash.
Source code in src/validators/hashes.py 
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
@validator
def sha512(value: str, /):
    """Return whether or not given value is a valid SHA512 hash.

    Examples:
        >>> sha512(
        ...     'cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce'
        ...     '9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af9'
        ...     '27da3e'
        ... )
        True
        >>> sha512('900zz11')
        ValidationError(func=sha512, args={'value': '900zz11'})

    Args:
        value:
            SHA512 string to validate.

    Returns:
        (Literal[True]): If `value` is a valid SHA512 hash.
        (ValidationError): If `value` is an invalid SHA512 hash.
    """
    return re.match(r"^[0-9a-f]{128}$", value, re.IGNORECASE) if value else False