+ THimra0t$Rt^RIHt^RIt^RIHt^RIHt^RIH t H t H t H t H t HtHt^RIHt^RIHt] 'd^RIHtHt^R IHt^R IHtHt^R IHt^R IHt^R I H!t!^RI"H#t#H$t$H%t%^RI&H't'RR.t(])!4t*Rt+Rt,Rt-Rt.R]/R&Rt0R]/R&] !R4t1] 'd-]]2] R,]33,]2] R,]13,3,t4MRt4!RR] ]1,4t5]6!4t7R]/R&R t8]8!4t9R!t:]:!4t;!R"R]5]3,4t<!R#R]5]2]3]33,,4t=R#)$zApache password support) annotationsN)BytesIO)PathLike) TYPE_CHECKINGAnyGenericLiteralTypeVarUnioncast)warn)logger)IterableIterator)Self)excregistry) CryptContext)ExpectedStringError)htdigest)is_ascii_codec render_bytesto_bytes) join_bytes HtpasswdFile HtdigestFile:#s: skippedzLiteral['skipped']_SKIPPEDrecordzLiteral['record']_RECORD _TRecordKeycr]tRt^6tRtR/RRllt]RRl4t]RRl4tR R lt ] R R l4t ] PR Rl4t ] RRl4t RRltR0RRlltRRltRRltRRltRRltRRltR0RR lltR!R"ltR#R$ltR%tR&R'ltR(R)ltR1R*R+lltR,R-ltR.tR#)2 _CommonFilez0Common framework for HtpasswdFile & HtdigestFileNc 0V^8dQhRRRRRRRRRRR R /#) pathPathLike | Nonenewboolautosaveencodingstrreturn_unicodereturnNone)formats"0/usr/lib/python3/dist-packages/passlib/apache.py __annotate___CommonFile.__annotate__9sF"""" "  "  " "c V'g \R4h\V4'g \R4hW@nWPnW0nWn^Vn/Vn.Vn V'dV'gVP4R#R#R#)z'encoding' is requiredz'encoding must be 7-bit ascii compatibleN) TypeErrorr ValueErrorr,r.r+_path_mtime_records_sourceload)selfr'r)r+r,r.s&&&&&&r3__init___CommonFile.__init__9ss45 5h''FG G! ,   13 ,.   IIK4r6c$V^8dQhRRRRRR/#)r&data str | byteskwargsrr/rr1)r2s"r3r4r5^s!{cdr6c \RV9d \R4hV!R/VBpVPV4V#)zcreate new object from raw string. :type data: str or bytes :arg data: database to load, as single string. :param \*\*kwds: all other keywords are the same as in the class constructor r'z$'path' not accepted by from_string()r1)r8 load_string)clsrCrEinstances&&, r3 from_string_CommonFile.from_string]s6 V BC C==T"r6c$V^8dQhRRRRRR/#)r&r'rkwdsrr/rr1)r2s"r3r4r5os!  X s t r6c 8V!R/VBpVPV4V#)zcreate new object from file, without binding object to file. :type path: str :arg path: local filepath to load from :param \*\*kwds: all other keywords are the same as in the class constructor r1)r>)rHr'rMr?s&&, r3 from_path_CommonFile.from_pathns{T{ $ r6cV^8dQhRR/#)r&r/r-r1)r2s"r3r4r5sDD#Dr6c 0RpVP'd VR, pVP'dVRVP: 2, pVPR8wdVRVP: 2, pRVPP R\ V4R V R2#) z autosave=Truez path=utf-8z encoding=)r+r:r, __class____name__id)r?tails& r3__repr___CommonFile.__repr__s === $ $D ::: fTZZN+ +D ==G # j 12 2D4>>**+3r$xmD6CCr6cV^8dQhRR/#)r&r/r(r1)r2s"r3r4r5sor6c VP#N)r:r?s&r3r'_CommonFile.paths zzr6c V^8dQhRRRR/#)r&valuer(r/r0r1)r2s"r3r4r5s/dr6c @WP8wd^VnWnR#)N)r:r;r?rds&&r3r'rbs JJ DK r6cV^8dQhRR/#)r&r/floatr1)r2s"r3r4r5sur6c VP#)z7modify time when last loaded (if bound to a local file))r;ras&r3mtime_CommonFile.mtimes{{r6cV^8dQhRR/#)r&r/r*r1)r2s"r3r4r5sr6c VP'g\V: R24hVP'd;VP\PP VP48XdR#VP 4R#)zBReload from ``self.path`` only if file has changed since last loadz is not bound to a local fileFT)r: RuntimeErrorr;osr'getmtimer>ras&r3load_if_changed_CommonFile.load_if_changedsTzzz$)FGH H ;;;4;;"''*:*:4::*FF r6c V^8dQhRRRR/#)r&r'r(r/r*r1)r2s"r3r4r5sDr6c Ve8\VR4;_uu_4p^VnVPV4RRR4R#VP'di\VPR4;_uu_4p\P P VP4VnVPV4RRR4R#\VPP R24h +'giR#;i +'giR#;i)zLoad state from local file. If no path is specified, attempts to load from ``self.path``. :type path: str :arg path: local file to load from Nrbz0().path is not set, an explicit path is requiredT) openr; _load_linesr:rpr'rqrorXrYr?r'fhs&& r3r>_CommonFile.loads  dD!!R   $"ZZZdjj$''2 gg..tzz:   $(>>**++[\ "!('sC,AC, C) , C= c V^8dQhRRRR/#)r&rCrDr/r0r1)r2s"r3r4r5sII IIr6c  p^VnVP\\WPR444R#)z@Load state from unicode or bytes string, replacing current staterCN)r;rxrrr,)r?rCs&&r3rG_CommonFile.load_strings'  $ v!FGHr6c V^8dQhRRRR/#)r&lineszIterable[bytes]r/r0r1)r2s"r3r4r5s***T*r6c /p.pRp\V4FwrVVP4pV'dVP\4'd WF, pKBVP We^,4wrW9d"\ P !RV4WF, pKV'dVP\V34RpWV&VP\V34K VP4'dVP\V34W n W0n R#)zload from sequence of listsr6z1username occurs multiple times in source file: %rN) enumeratelstrip startswith_BHASH _parse_recordr warningappendrr!rstripr<r=) r?rrecordssourceridxlinetmpkeyrds && r3rx_CommonFile._load_liness%'"5)IC++-C#..00++D':JC~G x12!CL MM7C. );*@ >>   MM8W- .  r6c$V^8dQhRRRRRR/#)r&r byteslinenointr/ztuple[_TRecordKey, Any]r1)r2s"r3r4r5s)GGG%(G Gr6c \R4h)z)parse line of file into (key, value) pair!should be implemented in subclassNotImplementedError)r?r rs&&&r3r_CommonFile._parse_records""EFFr6c$V^8dQhRRRRRR/#)r&rr"rdrr/r*r1)r2s"r3r4r5s!  { 3 4 r6c WP9pW PV&V'g"VPP\V34V#)z{ helper for setting record which takes care of inserting source line if needed; :returns: bool if key already present )r<r=rr!)r?rrdexistings&&& r3 _set_record_CommonFile._set_records:--'" c LL  # /r6cV^8dQhRR/#)r&r/r0r1)r2s"r3r4r5s4r6c vVP'd'VP'dVP4R#R#R#)z0subclass helper to call save() after any changesN)r+r:saveras&r3 _autosave_CommonFile._autosaves# ===TZZZ IIK(=r6c V^8dQhRRRR/#)r&r'r(r/r0r1)r2s"r3r4r5s   D r6c Ve?\VR4;_uu_4pVPVP44RRR4R#VP'dLVP VP4\ P PVP4VnR#\VPP R24h +'giR#;i)zXSave current state to file. If no path is specified, attempts to save to ``self.path``. Nwbz#().path is not set, cannot autosave) rw writelines _iter_linesr:rrpr'rqr;rorXrYrys&& r3r_CommonFile.saves  dD!!R d..01"! ZZZ IIdjj !''**4::6DK>>**++NO  "!!s C C cV^8dQhRR/#)r&r/rr1)r2s"r3r4r5s..5.r6c 4\VP44#)z)Export current state as a string of bytes)rrras&r3 to_string_CommonFile.to_strings$**,--r6cV^8dQhRR/#)r&r/z Iterator[Any]r1)r2s"r3r4r5sTT]Tr6c# L"VPp\V4pVPFcwr4V\8XdVxKV\8XgQh\ RV4pWA9dK7VP WAV,4xVPV4Ke V'd QRV: 24hR#5i)z#iterator yielding lines of databaser"z%failed to write all records: missing=N)r<setr=rr!r _render_recordremove)r?rpendingactioncontents& r3r_CommonFile._iter_liness-- 'lG#||OF! (((!7 )))'73CDDNN7+% ,&  S"G{ S S;ws BB$ B$c \R4h)z,given key/value pair, encode as line of filerr)r?rrds&&&r3r_CommonFile._render_record;s!"EFFr6c V^8dQhRRRR/#)r&userrDr/rr1)r2s"r3r4r5?s0000r6c &VPVR4#)z)user-specific wrapper for _encode_field()r _encode_fieldr?rs&&r3 _encode_user_CommonFile._encode_user?s!!$//r6c V^8dQhRRRR/#)r&realmrDr/rr1)r2s"r3r4r5Cs22 2 2r6c &VPVR4#)z*realm-specific wrapper for _encode_field()rrr?rs&&r3 _encode_realm_CommonFile._encode_realmCs!!%11r6c V^8dQhRRRR/#)r&rdrDr/rr1)r2s"r3r4r5Is;%r6c \V\4'dVPVP4pM!\V\4'g \ W4h\ V4^8d\V RV: 24h\;QJdRV4F 'gK RM RM !RV44'd\V RV: 24hV#)aconvert field to internal representation. internal representation is always bytes. byte strings are left as-is, unicode strings encoding using file's default encoding (or ``utf-8`` if no encoding has been specified). :raises UnicodeEncodeError: if unicode value cannot be encoded using default encoding. :raises ValueError: if resulting byte string contains a forbidden character, or is too long (>255 bytes). :returns: encoded identifer as bytes z! must be at most 255 characters: c32"TF q\9xK R#5ir`)_INVALID_FIELD_CHARS).0cs& r3 ,_CommonFile._encode_field..as8%Q((%TFz contains invalid characters: ) isinstancer-encoder,rrlenr9any)r?rdparams&&&r3r_CommonFile._encode_fieldIs" eS ! !LL/EE5))%e3 3 u: w&GyQR R 38%83338%8 8 8w&DUINO O r6c V^8dQhRRRR/#)r&rdrr/z bytes | strr1)r2s"r3r4r5es5[r6c \V\4'gQR4hVP'dVPVP4#V#)adecode field from internal representation to format returns by users() method, etc. :raises UnicodeDecodeError: if unicode value cannot be decoded using default encoding. (usually indicates wrong encoding set for file). :returns: field as str or bytes, as appropriate. zexpected value to be bytes)rrr.decoder,rgs&&r3 _decode_field_CommonFile._decode_fieldesA%''E)EE'    << . . r6)r;r:r<r=r+r,r.)NFFrTTr`)field)rY __module__ __qualname____firstlineno____doc__r@ classmethodrJrOr\propertyr'setterrkrrr>rGrxrrrrrrrrrrr__static_attributes__r1r6r3r$r$6s:"H    D [[ *I *XG  .T>G02 8r6r$zset[str]_warn_no_bcryptc RpRF#p\P!V4'gK!TpM \P!R4'dRMRp\P 4V'g\P .R O4\ T;'gRRT;'g T;'gRT;'gRT;'gRRR7pVP VR,VR,R7V#) Nbcrypt sha256_cryptportable_apache_24host_apache_24 apr_md5_crypt)rportable_apache_22rhost_apache_22linux_apache_24linux_apache_22)portablehost)rr)rrrrr)rhas_os_crypt_support has_backendrclearupdatedict) host_bestnamerdefaultss r3_init_default_schemesrsI*  ( ( . .I +"--h77XTF   !44_*====o 33O00.& H OO./ & ' Or6c.ROpVP\P!44VR,R.,V,p\\ V4VP R7p\ V\R,RR7#)rr:NN)rr2y)schemesdefault bcrypt__ident)rr sha512_crypt des_cryptr ldap_sha1 plaintext)extendrget_supported_os_crypt_schemessortedrindexrhtpasswd_defaults)r preferreds r3_init_htpasswd_contextr sjG( NN8::<= //'9IS\y7G !"67  r6cla]tRtRtRtRR]3V3RlltRtRtRRlt R t R t R t R t R tRtV;t#)ria]class for reading & writing Htpasswd files. The class constructor accepts the following arguments: :type path: filepath :param path: Specifies path to htpasswd file, use to implicitly load from and save to. This class has two modes of operation: 1. It can be "bound" to a local file by passing a ``path`` to the class constructor. In this case it will load the contents of the file when created, and the :meth:`load` and :meth:`save` methods will automatically load from and save to that file if they are called without arguments. 2. Alternately, it can exist as an independant object, in which case :meth:`load` and :meth:`save` will require an explicit path to be provided whenever they are called. As well, ``autosave`` behavior will not be available. This feature is new in Passlib 1.6, and is the default if no ``path`` value is provided to the constructor. This is also exposed as a readonly instance attribute. :type new: bool :param new: Normally, if *path* is specified, :class:`HtpasswdFile` will immediately load the contents of the file. However, when creating a new htpasswd file, applications can set ``new=True`` so that the existing file (if any) will not be loaded. .. versionadded:: 1.6 This feature was previously enabled by setting ``autoload=False``. That alias was removed in Passlib 1.8 :type autosave: bool :param autosave: Normally, any changes made to an :class:`HtpasswdFile` instance will not be saved until :meth:`save` is explicitly called. However, if ``autosave=True`` is specified, any changes made will be saved to disk immediately (assuming *path* has been set). This is also exposed as a writeable instance attribute. :type encoding: str :param encoding: Optionally specify character encoding used to read/write file and hash passwords. Defaults to ``utf-8``, though ``latin-1`` is the only other commonly encountered encoding. This is also exposed as a readonly instance attribute. :type default_scheme: str :param default_scheme: Optionally specify default scheme to use when encoding new passwords. This can be any of the schemes with builtin Apache support, OR natively supported by the host OS's :func:`crypt.crypt` function. * Builtin schemes include ``"bcrypt"`` (apache 2.4+), ``"apr_md5_crypt"`, and ``"des_crypt"``. * Schemes commonly supported by Unix hosts include ``"bcrypt"``, ``"sha256_crypt"``, and ``"des_crypt"``. In order to not have to sort out what you should use, passlib offers a number of aliases, that will resolve to the most appropriate scheme based on your needs: * ``"portable"``, ``"portable_apache_24"`` -- pick scheme that's portable across hosts running apache >= 2.4. **This will be the default as of Passlib 2.0**. * ``"portable_apache_22"`` -- pick scheme that's portable across hosts running apache >= 2.4. **This is the default up to Passlib 1.9**. * ``"host"``, ``"host_apache_24"`` -- pick strongest scheme supported by apache >= 2.4 and/or host OS. * ``"host_apache_22"`` -- pick strongest scheme supported by apache >= 2.2 and/or host OS. .. versionadded:: 1.6 This keyword was previously named ``default``. That alias was removed in Passlib 1.8. .. versionchanged:: 1.6.3 Added support for ``"bcrypt"``, ``"sha256_crypt"``, and ``"portable"`` alias. .. versionchanged:: 1.7 Added apache 2.4 semantics, and additional aliases. :type context: :class:`~passlib.context.CryptContext` :param context: :class:`!CryptContext` instance used to create and verify the hashes found in the htpasswd file. The default value is a pre-built context which supports all of the hashes officially allowed in an htpasswd file. This is also exposed as a readonly instance attribute. .. warning:: This option may be used to add support for non-standard hash formats to an htpasswd file. However, the resulting file will probably not be usable by another application, and particularly not by Apache. Loading & Saving ================ .. automethod:: load .. automethod:: load_if_changed .. automethod:: load_string .. automethod:: save .. automethod:: to_string Inspection ================ .. automethod:: users .. automethod:: check_password .. automethod:: get_hash Modification ================ .. automethod:: set_password .. automethod:: delete Alternate Constructors ====================== .. automethod:: from_string Attributes ========== .. attribute:: path Path to local file that will be used as the default for all :meth:`load` and :meth:`save` operations. May be written to, initialized by the *path* constructor keyword. .. attribute:: autosave Writeable flag indicating whether changes will be automatically written to *path*. Errors ====== :raises ValueError: All of the methods in this class will raise a :exc:`ValueError` if any user name contains a forbidden character (one of ``:\r\n\t\x00``), or is longer than 255 characters. Nc <V'dQV\9d\RV: 2\P4\P W"4pVP VR7pW0n\SV`$!V3/VBR#)zNHtpasswdFile: no bcrypt backends available, using fallback for default scheme )rN) rr rPasslibSecurityWarningrgetcopycontextsuperr@)r?r'default_schemerrMrXs&&&&,r3r@HtpasswdFile.__init__sk 099G8JL.. /22>RNll>l:G  &&r6c VP4P\4p\V4^8wd\ RV,4hV#)r&z/malformed htpasswd file (error reading line %d)rsplit_BCOLONrr9)r?r rresults&&& r3rHtpasswdFile._parse_records;&&w/ v;! NQWWX X r6c \RW4#)z%s:%s r)r?rhashs&&&r3rHtpasswdFile._render_recordsIt22r6cV^8dQhRR/#)r&r/zlist[bytes | str]r1)r2s"r3r4HtpasswdFile.__annotate__sDD(Dr6c `VPUu.uFqPV4NK up#uupi)z& Return list of all users in database )r<rrs& r3usersHtpasswdFile.userss)6:]]C]T""4(]CCCs+c ZVPPV4pVPW4#)aLSet password for user; adds user if needed. :returns: * ``True`` if existing user was updated. * ``False`` if user account was added. .. versionchanged:: 1.6 This method was previously called ``update``, it was renamed to prevent ambiguity with the dictionary method. The old alias was removed in Passlib 1.8. )rrset_hash)r?rpasswordrs&&& r3 set_passwordHtpasswdFile.set_passwords'||  *}}T((r6c lVPVPV4,# \dR#i;i)zReturn hash stored for user, or ``None`` if user not found. .. versionchanged:: 1.6 This method was previously named ``find``, it was renamed for clarity. The old name was removed in Passlib 1.8. N)r<rKeyErrorrs&&r3get_hashHtpasswdFile.get_hashs3 ==!2!24!89 9  s !$ 33c \V\4'dVPVP4pVP V4pVP W4pVP 4V#)z semi-private helper which allows writing a hash directly; adds user if needed. .. warning:: does not (currently) do any validation of the hash string .. versionadded:: 1.7 )rr-rr,rrr)r?rrrs&&& r3r$HtpasswdFile.set_hashsR dC ;;t}}-D  &##D/ r6c VPVPV4TP4R# \dR#i;i)zcDelete user's entry. :returns: * ``True`` if user deleted. * ``False`` if user not found. FT)r<rr)rrs&&r3deleteHtpasswdFile.deletesA  d//56   s 0 ??c ~VPV4pVPPV4pVfR#\V\4'dVP VP 4pVPPW#4wrEV'd5Ve1WP9gQhWPPV&VP4V#)a Verify password for specified user. If algorithm marked as deprecated by CryptContext, will automatically be re-hashed. :returns: * ``None`` if user not found. * ``False`` if user found, but password does not match. * ``True`` if user found and password matches. .. versionchanged:: 1.6 This method was previously called ``verify``, it was renamed to prevent ambiguity with the :class:`!CryptContext` method. The old alias was removed in Passlib 1.8. N) rr<rrr-rr,rverify_and_updater)r?rr%roknew_hashs&&& r3check_passwordHtpasswdFile.check_passwords  &}}  & < h $ $ t}}5H||55hE  (&==( (("*MM$  NN  r6)r)rYrrrrhtpasswd_contextr@rrr!r&r*r$r/r5r __classcell__rXs@r3rrsG\B6F '3D$ ) & r6ca]tRtRtRtRtRV3RlltRtRtRt Rt R t R t RR lt R]3R ltRR ltR]3RltRRltRtR]3RltRtV;t#)riaclass for reading & writing Htdigest files. The class constructor accepts the following arguments: :type path: filepath :param path: Specifies path to htdigest file, use to implicitly load from and save to. This class has two modes of operation: 1. It can be "bound" to a local file by passing a ``path`` to the class constructor. In this case it will load the contents of the file when created, and the :meth:`load` and :meth:`save` methods will automatically load from and save to that file if they are called without arguments. 2. Alternately, it can exist as an independant object, in which case :meth:`load` and :meth:`save` will require an explicit path to be provided whenever they are called. As well, ``autosave`` behavior will not be available. This feature is new in Passlib 1.6, and is the default if no ``path`` value is provided to the constructor. This is also exposed as a readonly instance attribute. :type default_realm: str :param default_realm: If ``default_realm`` is set, all the :class:`HtdigestFile` methods that require a realm will use this value if one is not provided explicitly. If unset, they will raise an error stating that an explicit realm is required. This is also exposed as a writeable instance attribute. .. versionadded:: 1.6 :type new: bool :param new: Normally, if *path* is specified, :class:`HtdigestFile` will immediately load the contents of the file. However, when creating a new htpasswd file, applications can set ``new=True`` so that the existing file (if any) will not be loaded. .. versionadded:: 1.6 This feature was previously enabled by setting ``autoload=False``. That alias was removed in Passlib 1.8 :type autosave: bool :param autosave: Normally, any changes made to an :class:`HtdigestFile` instance will not be saved until :meth:`save` is explicitly called. However, if ``autosave=True`` is specified, any changes made will be saved to disk immediately (assuming *path* has been set). This is also exposed as a writeable instance attribute. :type encoding: str :param encoding: Optionally specify character encoding used to read/write file and hash passwords. Defaults to ``utf-8``, though ``latin-1`` is the only other commonly encountered encoding. This is also exposed as a readonly instance attribute. Loading & Saving ================ .. automethod:: load .. automethod:: load_if_changed .. automethod:: load_string .. automethod:: save .. automethod:: to_string Inspection ========== .. automethod:: realms .. automethod:: users .. automethod:: check_password(user[, realm], password) .. automethod:: get_hash Modification ============ .. automethod:: set_password(user[, realm], password) .. automethod:: delete .. automethod:: delete_realm Alternate Constructors ====================== .. automethod:: from_string Attributes ========== .. attribute:: default_realm The default realm that will be used if one is not provided to methods that require it. By default this is ``None``, in which case an explicit realm must be provided for every method call. Can be written to. .. attribute:: path Path to local file that will be used as the default for all :meth:`load` and :meth:`save` operations. May be written to, initialized by the *path* constructor keyword. .. attribute:: autosave Writeable flag indicating whether changes will be automatically written to *path*. Errors ====== :raises ValueError: All of the methods in this class will raise a :exc:`ValueError` if any user name or realm contains a forbidden character (one of ``:\r\n\t\x00``), or is longer than 255 characters. Nc 6<W n\SV`!V3/VBR#r`) default_realmrr@)r?r'r<rMrXs&&&,r3r@HtdigestFile.__init__s* &&r6c VP4P\4p\V4^8wd\ RV,4hVwrEpWE3V3#)rz/malformed htdigest file (error reading line %d)r)r?r rrrrrs&&& r3rHtdigestFile._parse_recordsM&&w/ v;! NQWWX X"T}d""r6c $Vwr4\RW4V4#)z %s:%s:%s r)r?rrrrs&&& r3rHtdigestFile._render_records L$t<.s5}VV}r)rr<r)r?realmsrs& r3rNHtdigestFile.realmss75t}}557=>ve""5)v>>>s=c VPV4pVPUu.uF*q"^,V8XgKVPV^,4NK, up#uupi)zReturn list of all users in specified realm. * uses ``self.default_realm`` if no realm explicitly provided. * returns empty list if realm not found. )rr<r)r?rrs&& r3r!HtdigestFile.userssK ""5)6:mmWms1vQV*""3q6*mWWWs AAc V\JdRTr2VPV4p\P!W1W PR7pVP WV4#)a_Set password for user; adds user & realm if needed. If ``self.default_realm`` has been set, this may be called with the syntax ``set_password(user, password)``, otherwise it must be called with all three arguments: ``set_password(user, realm, password)``. :returns: * ``True`` if existing user was updated * ``False`` if user account added. Nr,)_UNSETrCrrr,r$r?rrr%rs&&&& r3r&HtdigestFile.set_passwordsH v "E8##E*}}XU]]K}}T$//r6c VPW4pVPPV4pVfR#VPVP4#)a=Return :class:`~passlib.hash.htdigest` hash stored for user. * uses ``self.default_realm`` if no realm explicitly provided. * returns ``None`` if user or realm not found. .. versionchanged:: 1.6 This method was previously named ``find``, it was renamed for clarity. The old name is was removed Passlib 1.8. N)rHr<rrr,)r?rrrrs&&& r3r*HtdigestFile.get_hashsCt+}}  % <{{4==))r6c V\JdRTr2\V\4'dVPVP4pVP W4pVP WC4pVP4V#)ax semi-private helper which allows writing a hash directly; adds user & realm if needed. If ``self.default_realm`` has been set, this may be called with the syntax ``set_hash(user, hash)``, otherwise it must be called with all three arguments: ``set_hash(user, realm, hash)``. .. warning:: does not (currently) do any validation of the hash string .. versionadded:: 1.7 N)rTrr-rr,rHrr)r?rrrrrs&&&& r3r$HtdigestFile.set_hashs` 6>4 dC ;;t}}-Dt+##C. r6c VPW4pVPVTP4R# \dR#i;i)zDelete user's entry for specified realm. if realm is not specified, uses ``self.default_realm``. :returns: * ``True`` if user deleted, * ``False`` if user not found in realm. FT)rHr<r)r)r?rrrs&&& r3r/HtdigestFile.deletesHt+  c"   s 2 AAc VPV4pVPpVUu.uFq3^,V8XgKVNK ppVFpW#K VP4\V4#uupi)zDelete all users for specified realm. if realm is not specified, uses ``self.default_realm``. :returns: number of users deleted (0 if realm not found) )rr<rr)r?rrrkeyss&& r3 delete_realmHtdigestFile.delete_realm+sc""5)--&:wa&E/w:C  4y ;s A$A$c V\JdRTr2VPV4pVPV4pVPP W34pVfR#\ P !W4WVPR7#)akVerify password for specified user + realm. If ``self.default_realm`` has been set, this may be called with the syntax ``check_password(user, password)``, otherwise it must be called with all three arguments: ``check_password(user, realm, password)``. :returns: * ``None`` if user or realm not found. * ``False`` if user found, but password does not match. * ``True`` if user found and password matches. .. versionchanged:: 1.6 This method was previously called ``verify``, it was renamed to prevent ambiguity with the :class:`!CryptContext` method. The old alias was removed in Passlib 1.8. NrS)rTrrr<rrverifyr,rUs&&&& r3r5HtdigestFile.check_password:sh$ v "E8  &""5)}}  $/ <xtT]]SSr6)r<)NNr`)rYrrrrr<r@rrrCrrHrNr!rTr&r*r$r/r_r5rr8r9s@r3rrsvxDM'#=2B? XB(,f0&* $(f6" *.TTr6)>__conditional_annotations__r __future__rrpiorrtypingrrrrr r r warningsr passlib._loggingr collections.abcrrtyping_extensionsrpasslibrrpasslib.contextr passlib.excr passlib.hashr passlib.utilsrrrpasslib.utils.compatr__all__objectrTrrrr__annotations__r!r"tupler _SourceTypesr$rrrrr r7rr)rds@r3rwsC# MMM#2&!(+!@@+    & ) (% %m$  gi %'( gh,- /L L}'+&}j  E!*\*+#N*+e;u%eP CT;uUE\23CTr6