blob: 019295177908c11752744125916f7b208b357813 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
"""passlib.exc -- exceptions & warnings raised by passlib"""
#==========================================================================
# exceptions
#==========================================================================
class MissingBackendError(RuntimeError):
"""Error raised if multi-backend handler has no available backends;
or if specifically requested backend is not available.
:exc:`!MissingBackendError` derives
from :exc:`RuntimeError`, since this usually indicates
lack of an external library or OS feature.
This is primarily used by handlers which derive
from :class:`~passlib.utils.handlers.HasManyBackends`.
"""
#==========================================================================
# warnings
#==========================================================================
class PasslibWarning(UserWarning):
"""base class for Passlib's user warnings"""
class PasslibConfigWarning(PasslibWarning):
"""Warning issued when non-fatal issue is found related to the configuration
of a :class:`~passlib.context.CryptContext` instance.
This occurs primarily in one of two cases:
* the policy contains rounds limits which exceed the hard limits
imposed by the underlying algorithm.
* an explicit rounds value was provided which exceeds the limits
imposed by the policy.
In both of these cases, the code will perform correctly & securely;
but the warning is issued as a sign the configuration may need updating.
"""
class PasslibHashWarning(PasslibWarning):
"""Warning issued when non-fatal issue is found with parameters
or hash string passed to a passlib hash class.
This occurs primarily in one of two cases:
* a rounds value or other setting was explicitly provided which
exceeded the handler's limits (and has been clamped).
* a hash malformed hash string was encountered, which while parsable,
should be re-encoded.
"""
class PasslibRuntimeWarning(PasslibWarning):
"""Warning issued when something unexpected happens during runtime.
The fact that it's a warning instead of an error means Passlib
was able to correct for the issue, but that it's anonmalous enough
that the developers would love to hear under what conditions it occurred.
"""
#==========================================================================
# eof
#==========================================================================
|