+ THi6]aR!t10t^RIt^RIt^RIt^RIHt^RIHtHt^RI H t ^RI H t H t ^RIHt^RIHt^RIHtHtHt^R IHt.R"Ot]!^ ^^$^0^"_self_info_rate..LsDVEDK//Vs )len TypeErrorrintvaluessumr)sourcesizecountscharr(s& r_self_info_rater.+s 6{ F   |6{  :DVDDtK KK s B B,+B,c|V'd&\P!V4!\V44#\PP V4'd \ VR4#VPR4wr#pV'g\RV: 24h\P!V4PV4P R4#)z :param asset_path: string containing absolute path to file, or package-relative path using format ``"python.module:relative/file/path"``. :returns: filehandle opened in 'rb' mode (unless encoding explicitly specified) rb:zIasset path must be absolute file path or use 'pkg.name:sub/path' format: ) codecs getreader_open_asset_pathospathisabsopen partition ValueErrorrfilesjoinpath)r6encodingpackagesepsubpaths&& rr4r4Ws)*:4*@AA ww}}TD$ NN3/G'  226 ;   ??7 # , ,W 5 : :4 @@rc\pRpW9dR#\V\4'g#\ \ V44\ V48XdIV'd?\ P!\4;_uu_4VPV4RRR4R#R#\ 4p\ 4pVFpWd9dTMTPV4K \V4p^p\ V4V8d^pRPRVRV44p\ V4V8d!VR\ V4V, ,, p\RV RV 24h \dRpELAi;i +'giR#;i) z helper for generators -- Throws ValueError if source elements aren't unique. Error message will display (abbreviated) repr of the duplicates in a string/list TFN, c3J"TFp\\V44xK R#5ir )reprstrr!words& rr#!_ensure_unique..sB\Tc$i\s!#z, ... plus %d others`z%` cannot contain duplicate elements: ) _ensure_unique_cacher& isinstance _set_typesr%set contextlibsuppressaddsortedjoinr:) r*paramcachehashableseendupselemtruncdup_reprs && r_ensure_uniquer[ws: !EH ?  &*%%S[)9S[)H $$Y// &!0 5D 5D4,,T2 $>tyy?UVW W  4 rc ,\VP4#)zJ Average entropy per symbol (assuming all symbols have equal probability) )rr`rks&rrd$SequenceGenerator.entropy_per_symbols D%%&&rc <VPVP,#)a Effective entropy of generated passwords. This value will always be a multiple of :attr:`entropy_per_symbol`. If entropy is specified in constructor, :attr:`length` will be chosen so so that this value is the smallest multiple >= :attr:`requested_entropy`. )rerdrrs&rrlSequenceGenerator.entropys{{T4444rc \R4h)z;main generation function, should create one password/phrasezimplement in subclass)NotImplementedErrorrrs&r__next__SequenceGenerator.__next__s!"9::rc Vf \V4#\V\4'd%\V4Uu.uFp\V4NK up#V\JdV#\ P !VRR4huupi)z> frontend used by genword() / genphrase() to create passwords z, int, or returns)nextrKr'rangeiterr ExpectedTypeError)rkr{_s&& r__call__SequenceGenerator.__call__ sd ?:  gs # #(-g71DJ7 7 d?K##G-EyQQ8sA.cV#r r_rrs&r__iter__SequenceGenerator.__iter__s r)rerar NNNr )__name__ __module__ __qualname____firstlineno____doc__rerar r`rjrrdrlrxrr__static_attributes____classdictcell__ __classcell__ro __classdict__s@@rr]r]sj&RF! CL!<'' 55; Rrr]zH0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!@#$%^&*?/>0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ2234679abcdefghjkmnpqrstuvwxyzACDEFGHJKMNPQRTUVWXYZ0123456789abcdef)ascii_72ascii_62ascii_50hexcXaa]tRtRtoRtRtRtR V3Rllt]R4t Rt Rt Vt V;t #) WordGeneratori&a Class which generates passwords by randomly choosing from a string of unique characters. Parameters ---------- :param chars: custom character string to draw from. :param charset: predefined charset to draw from. :param \*\*kwds: all other keywords passed to the :class:`SequenceGenerator` parent class. Attributes ---------- .. autoattribute:: chars .. autoattribute:: charset .. autoattribute:: default_charsets rNc <V'dV'd \R4hM+V'gVPpV'gQh\V,pW n\VRR7p\ VRR7Wn\ SV`!R/VBR#)z,`chars` and `charset` are mutually exclusivecharsrSNr_)r&charsetdefault_charsetsr r[rrirj)rkrrrmros&&&,rrjWordGenerator.__init__Bsk  NOO,,w$W-E 50uG,   4 rc,\VP4#r )r%rrrs&rr`WordGenerator.symbol_countU4::rcX\VPVPVP4#r )r r rrerrs&rrxWordGenerator.__next__Ys$((DJJ <>> # generate a random alphanumeric string with 48 bits of entropy (the default) >>> from passlib import pwd >>> pwd.genword() 'DnBHvDjMK6' >>> # generate a random hexadecimal string with 52 bits of entropy >>> pwd.genword(entropy=52, charset="hex") '310f1a7ac793f' :param entropy: Strength of resulting password, measured in 'guessing entropy' bits. An appropriate **length** value will be calculated based on the requested entropy amount, and the size of the character set. This can be a positive integer, or one of the following preset strings: ``"weak"`` (24), ``"fair"`` (36), ``"strong"`` (48), and ``"secure"`` (56). If neither this or **length** is specified, **entropy** will default to ``"strong"`` (48). :param length: Size of resulting password, measured in characters. If omitted, the size is auto-calculated based on the **entropy** parameter. If both **entropy** and **length** are specified, the stronger value will be used. :param returns: Controls what this function returns: * If ``None`` (the default), this function will generate a single password. * If an integer, this function will return a list containing that many passwords. * If the ``iter`` constant, will return an iterator that yields passwords. :param chars: Optionally specify custom string of characters to use when randomly generating a password. This option cannot be combined with **charset**. :param charset: The predefined character set to draw from (if not specified by **chars**). There are currently four presets available: * ``"ascii_62"`` (the default) -- all digits and ascii upper & lowercase letters. Provides ~5.95 entropy per character. * ``"ascii_50"`` -- subset which excludes visually similar characters (``1IiLl0Oo5S8B``). Provides ~5.64 entropy per character. * ``"ascii_72"`` -- all digits and ascii upper & lowercase letters, as well as some punctuation. Provides ~6.17 entropy per character. * ``"hex"`` -- Lower case hexadecimal. Providers 4 bits of entropy per character. :returns: :class:`!str` string containing randomly generated password; or list of 1+ passwords if :samp:`returns={int}` is specified. rerlr_)rrlrer{rmgens&&&, rgenwordr_s&L  ?v ?w ?$ ?C w<rc\VR4;_uu_4pRV4p\;QJd.RV4FNK 5M !RV44pRRR4\P!R\ X4V4V# +'giL3;i)a load wordset from compressed datafile within package data. file should be utf-8 encoded :param asset_path: string containing absolute path to wordset file, or "python.module:relative/file/path". :returns: tuple of words, as loaded from specified words file. zutf-8c3@"TFqP4xK R#5ir )striprFs& rr# _load_wordset..s+zz||sc38"TFq'gK VxK R#5ir r_rFs& rr#rs3stdddss  Nz!loaded %d-element wordset from %r)r4tupler debugr%) asset_pathfhrwordss& r _load_wordsetrse *g . ."++3s33s33 /$ LL4c%j*M L' / .s 6A66 B cxaa]tRtRtoRtRtRtV3RltRtRt Rt Rt ] R 4t R tR tR tR tVtV;t#) WordsetDictiz Special mapping used to store dictionary of wordsets. Different from a regular dict in that some wordsets may be lazy-loaded from an asset path. NcD</Vn/Vn\SV` !V/VBR#r )paths_loadedrirj)rkargsrmros&*,rrjWordsetDict.__init__s#   $'$'rcVPV,# \dMi;iTPT,p\T4;q0PT&T#r )rKeyErrorrr)rkkeyr6r"s&& r __getitem__WordsetDict.__getitem__sP <<$ $   zz#$1$$77 S! s  ##c "W PV&R#)z+ set asset path to lazy-load wordset from. N)r)rkrr6s&&&rset_pathWordsetDict.set_paths 3rc"W PV&R#r )r)rkrr"s&&&r __setitem__WordsetDict.__setitem__s! SrcW9d,VPVVPPVR4R#VPVR#r )rrpoprkrs&&r __delitem__WordsetDict.__delitem__s0 ; S! JJNN3 % 3rcf\VP4pVPVP4V#r )rMrupdater)rkrhs& r_keysetWordsetDict._keysets%4<<  DJJ rc,\VP4#r )r~rrrs&rrWordsetDict.__iter__sDLL!!rc,\VP4#r )r%rrrs&r__len__WordsetDict.__len__s4<<  rcJWP9;'gWP9#r rrrs&&r __contains__WordsetDict.__contains__sll"77cZZ&77rr)rrrrrrrrjrrrrpropertyrrrrrrrrs@@rrrsY EG(  "  "!88rrzpasslib:_data/wordsets/z.txtc\aa]tRtRtoRtRtRtRtR V3Rllt] R4t Rt R t Vt V;t#) PhraseGeneratoriaclass which generates passphrases by randomly choosing from a list of unique words. :param wordset: wordset to draw from. :param preset: name of preset wordlist to use instead of ``wordset``. :param spaces: whether to insert spaces between words in output (defaults to ``True``). :param \*\*kwds: all other keywords passed to the :class:`SequenceGenerator` parent class. .. autoattribute:: wordset eff_longN c X<VeVe \R4hM'VfVPpV'gQh\V,pWn\V\4'g \ V4p\ VRR7W nVf VPp\VRR7pW0n\SV`,!R/VBR#)Nz,`words` and `wordset` are mutually exclusiverrr?r_) r&wordsetdefault_wordsetsrK_sequence_typesrr[rr?r rirj)rkrrr?rmros&&&&,rrjPhraseGenerator.__init__*s  " NOO#,,w$W-E %11%LEuG,  ;((CE*  4 rc,\VP4#r )r%rrrs&rr`PhraseGenerator.symbol_countGrrcxaV3Rl\SP44pSPPV4#)c3n<"TF*pSPPSP4xK, R#5ir )r choicer)r!rrks& rr#+PhraseGenerator.__next__..Ls'I6H,,6Hs25)r}rer?rR)rkrsf rrxPhraseGenerator.__next__Ks)IeDKK6HIxx}}U##r)r?rrr)rrrrrrrr?rjrr`rxrrrrs@@rrrsB  G E C!:$$rrc 0\RRVRV/VBpV!V4#)aRGenerate one or more random password / passphrases. This function uses :mod:`random.SystemRandom` to generate one or more passwords; it can be configured to generate alphanumeric passwords, or full english phrases. The complexity of the password can be specified by size, or by the desired amount of entropy. Usage Example:: >>> # generate random phrase with 48 bits of entropy >>> from passlib import pwd >>> pwd.genphrase() 'gangly robbing salt shove' >>> # generate a random phrase with 52 bits of entropy >>> # using a particular wordset >>> pwd.genword(entropy=52, wordset="bip39") 'wheat dilemma reward rescue diary' :param entropy: Strength of resulting password, measured in 'guessing entropy' bits. An appropriate **length** value will be calculated based on the requested entropy amount, and the size of the word set. This can be a positive integer, or one of the following preset strings: ``"weak"`` (24), ``"fair"`` (36), ``"strong"`` (48), and ``"secure"`` (56). If neither this or **length** is specified, **entropy** will default to ``"strong"`` (48). :param length: Length of resulting password, measured in words. If omitted, the size is auto-calculated based on the **entropy** parameter. If both **entropy** and **length** are specified, the stronger value will be used. :param returns: Controls what this function returns: * If ``None`` (the default), this function will generate a single password. * If an integer, this function will return a list containing that many passwords. * If the ``iter`` builtin, will return an iterator that yields passwords. :param words: Optionally specifies a list/set of words to use when randomly generating a passphrase. This option cannot be combined with **wordset**. :param wordset: The predefined word set to draw from (if not specified by **words**). There are currently four presets available: ``"eff_long"`` (the default) Wordset containing 7776 english words of ~7 letters. Constructed by the EFF, it offers ~12.9 bits of entropy per word. This wordset (and the other ``"eff_"`` wordsets) were `created by the EFF `_ to aid in generating passwords. See their announcement page for more details about the design & properties of these wordsets. ``"eff_short"`` Wordset containing 1296 english words of ~4.5 letters. Constructed by the EFF, it offers ~10.3 bits of entropy per word. ``"eff_prefixed"`` Wordset containing 1296 english words of ~8 letters, selected so that they each have a unique 3-character prefix. Constructed by the EFF, it offers ~10.3 bits of entropy per word. ``"bip39"`` Wordset of 2048 english words of ~5 letters, selected so that they each have a unique 4-character prefix. Published as part of Bitcoin's `BIP 39 `_, this wordset has exactly 11 bits of entropy per word. This list offers words that are typically shorter than ``"eff_long"`` (at the cost of slightly less entropy); and much shorter than ``"eff_prefixed"`` (at the cost of a longer unique prefix). :param sep: Optional separator to use when joining words. Defaults to ``" "`` (a space), but can be an empty string, a hyphen, etc. :returns: :class:`!str` containing randomly generated passphrase; or list of 1+ passphrases if :samp:`returns={int}` is specified. rlrer_)rrs&&&, r genphraserPs&B  A' A& AD AC w<rcVV^8dQh/^\9d\\,;R&#)rJ)__conditional_annotations__rMr)rgs"r __annotate__rs f,+c(m+gr)rrrrr )r*r)r eff_short eff_prefixedbip39)2rr2rNr5 collectionsrcollections.abcrr importlibrmathrrpasslibr passlib._loggingr passlib.utilsr r r passlib.utils.decorr__all__dictrbrr.r4listrrrM frozensetrLrJr[r]rrrrrrnamerrrr)rs@rrs  #4#551   % !LXA2-9  '*e+&QRvvt W M A 6=%6=rGT F98.98|= ?Dd&=dV4$HI ?<$'<$~br