o ٭h@s2ddlZddlmZddlmZGdddZdS)N) exceptions)HasherProtocolc @seZdZdZdejeddfddZedddZ dd d ej e e fd ej e dfde fd d Z d ej e e fdej e e fdefddZd ej e e fdej e e fdejeej e dfffddZdS) PasswordHashz0 Represents a password hashing utility. hashersreturnNcCs(t|dks Jd||_|d|_dS)z Args: hashers: A sequence of hashers to be used for password hashing. Raises: AssertionError: If no hashers are specified. rz%You must specify at least one hasher.N)lenrcurrent_hasher)selfrr Q/var/www/html/stock_analysis/be/venv/lib/python3.10/site-packages/pwdlib/_hash.py__init__ szPasswordHash.__init__cCsddlm}||fS)ag Returns a PasswordHash instance with recommended hashers. Currently, the hasher is Argon2 with default parameters. Examples: >>> password_hash = PasswordHash.recommended() >>> hash = password_hash.hash("herminetincture") >>> password_hash.verify(hash, "herminetincture") True r) Argon2Hasher)hashers.argon2r)clsrr r r recommendeds zPasswordHash.recommendedsaltpasswordrcCs|jj||dS)aE Hashes a password using the current hasher. Args: password: The password to be hashed. salt: The salt to be used for hashing. Defaults to None. Returns: The hashed password. Examples: >>> hash = password_hash.hash("herminetincture") r)r hash)r rrr r r r)szPasswordHash.hashrcCs0|jD]}||r|||Sqt|)a# Verifies if a password matches a given hash. Args: password: The password to be checked. hash: The hash to be verified. Returns: True if the password matches the hash, False otherwise. Raises: exceptions.UnknownHashError: If the hash is not recognized by any of the hashers. Examples: >>> password_hash.verify("herminetincture", hash) True >>> password_hash.verify("INVALID_PASSWORD", hash) False )ridentifyverifyrUnknownHashError)r rrhasherr r r r>s   zPasswordHash.verifycCsb|jD](}||r+|||sdSd}||jks||r%|j|}d|fSqt|)aw Verifies if a password matches a given hash and updates the hash if necessary. Args: password: The password to be checked. hash: The hash to be verified. Returns: A tuple containing a boolean indicating if the password matches the hash, and an updated hash if the current hasher or the hash itself needs to be updated. Raises: exceptions.UnknownHashError: If the hash is not recognized by any of the hashers. Examples: >>> valid, updated_hash = password_hash.verify_and_update("herminetincture", hash) )FNNT)rrrr check_needs_rehashrrr)r rrr updated_hashr r r verify_and_updateZs      zPasswordHash.verify_and_update)rr)__name__ __module__ __qualname____doc__typingSequencerr classmethodrUnionstrbytesrboolrTuplerr r r r rs6         r)r!rrrrr r r r s