File: //lib/python3.9/site-packages/passlib/__pycache__/ifc.cpython-39.opt-1.pyc
a
f�Wct7 � @ sx d Z ddlZe�e�ZddlZddlmZ dgZdd� Z ddl
m Z m Z m
Z
e e �G dd� de��ZG d d
� d
e�ZdS ) z1passlib.ifc - abstract interfaces used by Passlib� N)�deprecated_method� PasswordHashc s � fdd�}|S )z5class decorator that re-creates class using metaclassc s& � t | �u r| S � | j| j| j�� �S )N)�type�__name__� __bases__�__dict__�copy)�cls��meta� �//usr/lib/python3.9/site-packages/passlib/ifc.py�builder s z(recreate_with_metaclass.<locals>.builderr )r r r r
r
�recreate_with_metaclass s r )�ABCMeta�abstractmethod�abstractpropertyc @ s� e Zd ZdZdZdZdZdZee dd� ��Z
e ddd d
�ed d � ��Z ee d
d� ��Z
ee ddd���Zeddd��Zee dd� ��Ze ddd�edd� ��Ze ddd�edd� ��ZdZdS ) r z�This class describes an abstract interface which all password hashes
in Passlib adhere to. Under Python 2.6 and up, this is an actual
Abstract Base Class built using the :mod:`!abc` module.
See the Passlib docs for full documentation.
FNTc K s t d��dS )a
Hash secret, returning result.
Should handle generating salt, etc, and should return string
containing identifier, salt & other configuration, as well as digest.
:param \\*\\*settings_kwds:
Pass in settings to customize configuration of resulting hash.
.. deprecated:: 1.7
Starting with Passlib 1.7, callers should no longer pass settings keywords
(e.g. ``rounds`` or ``salt`` directly to :meth:`!hash`); should use
``.using(**settings).hash(secret)`` construction instead.
Support will be removed in Passlib 2.0.
:param \\*\\*context_kwds:
Specific algorithms may require context-specific information (such as the user login).
� must be implemented by subclassN��NotImplementedError)r �secretZsetting_and_context_kwdsr r r
�hashr s zPasswordHash.hashz1.7z2.0z.hash())�
deprecated�removedZ replacementc O s | j |i |��S )a
Legacy alias for :meth:`hash`.
.. deprecated:: 1.7
This method was renamed to :meth:`!hash` in version 1.7.
This alias will be removed in version 2.0, and should only
be used for compatibility with Passlib 1.3 - 1.6.
�r )r �args�kwdsr r r
�encrypt� s zPasswordHash.encryptc K s t d��dS )z.verify secret against hash, returns True/Falser Nr )r r r � context_kwdsr r r
�verify� s zPasswordHash.verifyc K s t d��dS )a�
Return another hasher object (typically a subclass of the current one),
which integrates the configuration options specified by ``kwds``.
This should *always* return a new object, even if no configuration options are changed.
.. todo::
document which options are accepted.
:returns:
typically returns a subclass for most hasher implementations.
.. todo::
add this method to main documentation.
r Nr )r Zrelaxedr r r r
�using� s zPasswordHash.usingc C s dS )a�
check if hash's configuration is outside desired bounds,
or contains some other internal option which requires
updating the password hash.
:param hash:
hash string to examine
:param secret:
optional secret known to have verified against the provided hash.
(this is used by some hashes to detect legacy algorithm mistakes).
:return:
whether secret needs re-hashing.
.. versionadded:: 1.7
Fr )r r r r r r
� needs_update� s zPasswordHash.needs_updatec C s t d��dS )z8check if hash belongs to this scheme, returns True/Falser Nr �r r r r r
�identify� s zPasswordHash.identify)r r c K s$ | j rtd��| jf i |���d�S )a�
compile settings into a configuration string for genhash()
.. deprecated:: 1.7
As of 1.7, this method is deprecated, and slated for complete removal in Passlib 2.0.
For all known real-world uses, hashing a constant string
should provide equivalent functionality.
This deprecation may be reversed if a use-case presents itself in the mean time.
r � )r r r r )r Z setting_kwdsr r r
� genconfig� s zPasswordHash.genconfigc K s t d��dS )a1
generated hash for secret, using settings from config/hash string
.. deprecated:: 1.7
As of 1.7, this method is deprecated, and slated for complete removal in Passlib 2.0.
This deprecation may be reversed if a use-case presents itself in the mean time.
r Nr )r r Zconfig�contextr r r
�genhash� s
zPasswordHash.genhash)F)N)r �
__module__� __qualname__�__doc__� is_disabledZ
truncate_sizeZtruncate_errorZtruncate_verify_reject� classmethodr r r r r r r! r# r% r' r r r r r
r % s:
c @ s. e Zd ZdZdZeddd��Zedd� �ZdS ) � DisabledHashzR
extended disabled-hash methods; only need be present if .disabled = True
TNc C s
| � d�S )z�
return string representing a 'disabled' hash;
optionally including previously enabled hash
(this is up to the individual scheme).
r$ r r" r r r
�disableK s zDisabledHash.disablec C s t d��dS )z�
given a disabled-hash string,
extract previously-enabled hash if one is present,
otherwise raises ValueError
z cannot restore original hashN)�
ValueErrorr" r r r
�enableU s zDisabledHash.enable)N)r r( r) r* r+ r, r. r0 r r r r
r- D s r- )r* ZloggingZ getLoggerr �log�sysZpasslib.utils.decorr �__all__r �abcr r r �objectr r- r r r r
�<module> s �