/
lib
/
python2.7
/
site-packages
/
passlib
/
Upload File
HOME
� �K@Xc @` sS d Z d d l m Z m Z m Z m Z d d l Z d d l m Z m Z d d l m Z m Z d d l Z e j e � Z d d l Z d d l Z d d l m Z d d l m Z m Z m Z m Z d d l m Z m Z m Z d d l m Z d d d d g Z e! d d d d d d d d d d � Z" d � Z# d � Z$ d d � Z& e' e( f Z) e* e+ f Z, e* � Z- d d � Z. d e/ f d � � YZ0 e! d d d! d" d# d$ d% d& � Z1 d' e0 f d( � � YZ2 d d d d) � Z3 d* � Z4 d+ e f d, � � YZ5 e5 � Z6 x( d- j7 � D] Z8 e6 j9 e8 d. e8 � q Wd/ e0 f d0 � � YZ: d d d d1 � Z; d S(2 u* passlib.pwd -- password generation helpersi ( t absolute_importt divisiont print_functiont unicode_literalsN( t defaultdictt MutableMapping( t ceilt log( t exc( t PY2t iranget itervaluest int_types( t rngt getrandstrt to_unicode( t memoized_propertyu genwordu default_charsetsu genphraseu default_wordsetst unsafei t weaki t fairi$ t strongi0 t securei< c C` s$ t | � j } | | j | � d S( u2 return remaining classes in object's MRO after clsi ( t typet __mro__t index( t objt clst mro( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt _superclasses3 s c C` s� y t | � } Wn t k r) d } n Xt t � } x | D] } | | c d 7<q= W| d k r~ | j � } t | � } n t | � } | s� d St | d � t d � | D� � | S( u� returns 'rate of self-information' -- i.e. average (per-symbol) entropy of the sequence **source**, where probability of a given symbol occurring is calculated based on the number of occurrences within the sequence itself. if all elements of the source are unique, this should equal ``log(len(source), 2)``. :arg source: iterable containing 0+ symbols (e.g. list of strings or ints, string of characters, etc). :returns: float bits of entropy i i i c s` s" | ] } | t | d � Vq d S( i N( t logf( t .0t value( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pys <genexpr>Z s N( t lent TypeErrort NoneR t intt valuest sumR R ( t sourcet sizet countst charR$ ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt _self_info_rate9 s c C` s� | r t j | � t | � � St j j | � r> t | d � S| j d � \ } } } | sr t d | f � � n t j | | � S( u :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) u rbu :uK asset path must be absolute file path or use 'pkg.name:sub/path' format: %r( t codecst getreadert _open_asset_patht ost patht isabst opent partitiont ValueErrort pkg_resourcest resource_stream( R/ t encodingt packaget sept subpath( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyR- e s u sourcec C` sl t } t } y | | k r t SWn t k r9 t } n Xt | t � sg t t | � � t | � k r� | r� y | j | � Wq� t k r� q� Xn t St � } t � } x- | D]% } | | k r� | n | j | � q� Wt | � } d } t | � | k rd } n d j d � | | D� � } t | � | k rR| d t | � | 7} n t d | | f � � d S( u� helper for generators -- Throws ValueError if source elements aren't unique. Error message will display (abbreviated) repr of the duplicates in a string/list i i u , c s` s! | ] } t t | � � Vq d S( N( t reprt str( R t word( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pys <genexpr>� s u , ... plus %d othersu* `%s` cannot contain duplicate elements: %sN( t _ensure_unique_cachet TrueR! t Falset isinstancet _set_typesR t sett addt sortedt joinR3 ( R& t paramt cachet hashablet seent dupst elemt trunct dup_repr( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt _ensure_unique� s6 - # t SequenceGeneratorc B` s� e Z d Z d Z d Z e Z d Z d d d d � Z e d � � Z e d � � Z d � Z d d � Z d � Z e r� d � Z n RS( uY Base class used by word & phrase generators. These objects take a series of options, corresponding to those of the :func:`generate` function. They act as callables which can be used to generate a password or a list of 1+ passwords. They also expose some read-only informational attributes. Parameters ---------- :param entropy: Optionally specify the amount of entropy the resulting passwords should contain (as measured with respect to the generator itself). This will be used to auto-calculate the required password size. :param length: Optionally specify the length of password to generate, measured as count of whatever symbols the subclass uses (characters or words). Note if ``entropy`` requires a larger minimum length, that will be used instead. :param rng: Optionally provide a custom RNG source to use. Should be an instance of :class:`random.Random`, defaults to :class:`random.SystemRandom`. Attributes ---------- .. autoattribute:: length .. autoattribute:: symbol_count .. autoattribute:: entropy_per_symbol .. autoattribute:: entropy Subclassing ----------- Subclasses must implement the ``.__next__()`` method, and set ``.symbol_count`` before calling base ``__init__`` method. u strongc K` s9 | d k s | d k r� | d k r0 | j } n t j | | � } | d k r] t d � � n t t | | j � � } | d k s� | | k r� | } q� n | | _ | d k r� t d � � n | | _ | d k r� | | _ n | r t | t � t f k r t d d j | j � � � � n t t | � j | � d S( Ni u! `entropy` must be positive numberi u! `length` must be positive integeru Unexpected keyword(s): %su , ( R" t requested_entropyt entropy_aliasest getR3 R# R t entropy_per_symbolt lengthR R RO t objectR! RE t keyst supert __init__( t selft entropyRT R t kwdst min_length( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyRX � s$ "c C` s t | j d � S( uZ Average entropy per symbol (assuming all symbols have equal probability) i ( R t symbol_count( RY ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyRS s c C` s | j | j S( u+ 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`. ( RT RS ( RY ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyRZ s c C` s t d � � d S( u; main generation function, should create one password/phraseu implement in subclassN( t NotImplementedError( RY ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt __next__$ s c C` sq | d k r t | � St | t � rH g t | � D] } t | � ^ q2 S| t k rX | St j | d d � � d S( uN frontend used by genword() / genphrase() to create passwords u <None>, int, or <iter>u returnsN( R" t nextR@ R R t iterR t ExpectedTypeError( RY t returnst _( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt __call__( s # c C` s | S( N( ( RY ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt __iter__5 s c C` s | j � S( N( R_ ( RY ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyR` 9 s N( t __name__t __module__t __doc__R" RT RP R R] RX R RS RZ R_ Re Rf R R` ( ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyRO � s '# t ascii_72uH 0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!@#$%^&*?/t ascii_62u> 0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZt ascii_50u2 234679abcdefghjkmnpqrstuvwxyzACDEFGHJKMNPQRTUVWXYZt hexu 0123456789abcdeft WordGeneratorc B` sA e Z d Z d Z d Z d d d � Z e d � � Z d � Z RS( u� 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 u ascii_62c K` s� | r | r: t d � � q: n | s0 | j } n t | } | | _ t | d d �} t | d d �| | _ t t | � j | � d S( Nu, `chars` and `charset` are mutually exclusiveRF u chars( R! t charsett default_charsetsR RN t charsRW Rn RX ( RY Rq Ro R[ ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyRX y s c C` s t | j � S( N( R Rq ( RY ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyR] � s c C` s t | j | j | j � S( N( R R Rq RT ( RY ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyR_ � s N( Rg Rh Ri Ro R" Rq RX R R] R_ ( ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyRn W s c K` s" t d | d | | � } | | � S( u� Generate one or more random passwords. This function uses :mod:`random.SystemRandom` to generate one or more passwords using various character sets. The complexity of the password can be specified by size, or by the desired amount of entropy. Usage Example:: >>> # 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:`!unicode` string containing randomly generated password; or list of 1+ passwords if :samp:`returns={int}` is specified. RT RZ ( Rn ( RZ RT Rc R[ t gen( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt genword� s Fc C` s[ t | d � �- } d � | D� } t d � | D� � } Wd QXt j d t | � | � | S( u2 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. u utf-8c s` s | ] } | j � Vq d S( N( t strip( R R< ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pys <genexpr>� s c s` s | ] } | r | Vq d S( N( ( R R< ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pys <genexpr>� s Nu! loaded %d-element wordset from %r( R- t tupleR t debugR ( t asset_patht fhRr t words( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt _load_wordset� s t WordsetDictc B` sq e Z d Z d Z d Z d � Z d � Z d � Z d � Z d � Z e d � � Z d � Z d � Z d � Z RS( u� 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. c O` s/ i | _ i | _ t t | � j | | � d S( N( t pathst _loadedRW R{ RX ( RY t argsR[ ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyRX s c C` sK y | j | SWn t k r" n X| j | } t | � } | j | <| S( N( R} t KeyErrorR| Rz ( RY t keyR/ R ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt __getitem__% s c C` s | | j | <d S( u; set asset path to lazy-load wordset from. N( R| ( RY R� R/ ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt set_path. s c C` s | | j | <d S( N( R} ( RY R� R ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt __setitem__4 s c C` s: | | k r, | j | =| j j | d � n | j | =d S( N( R} R| t popR" ( RY R� ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt __delitem__7 s c C` s# t | j � } | j | j � | S( N( RB R} t updateR| ( RY RV ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt _keyset> s c C` s t | j � S( N( Ra R� ( RY ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyRf D s c C` s t | j � S( N( R R� ( RY ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt __len__G s c C` s | | j k p | | j k S( N( R} R| ( RY R� ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt __contains__K s N( Rg Rh Ri R" R| R} RX R� R� R� R� t propertyR� Rf R� R� ( ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyR{ s u% eff_long eff_short eff_prefixed bip39u passlib:_data/wordsets/%s.txtt PhraseGeneratorc B` sJ e Z d Z d Z d Z d Z d d d d � Z e d � � Z d � Z RS( u� class 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 u eff_longu c K` s� | d k r* | d k rL t d � � qL n" | d k rB | j } n t | } | | _ t | t � ss t | � } n t | d d �| | _ | d k r� | j } n t | d d �} | | _ t t | � j | � d S( Nu, `words` and `wordset` are mutually exclusiveRF u wordsu sep( R" R! t wordsett default_wordsetsR@ t _sequence_typesRu RN Ry R8 R RW R� RX ( RY R� Ry R8 R[ ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyRX y s" c C` s t | j � S( N( R Ry ( RY ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyR] � s c ` s/ � f d � t � j � D� } � j j | � S( Nc 3` s$ | ] } � j j � j � Vq d S( N( R t choiceRy ( R Rd ( RY ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pys <genexpr>� s ( R RT R8 RE ( RY Ry ( ( RY s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyR_ � s N( Rg Rh Ri R� R" Ry R8 RX R R] R_ ( ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyR� Z s "c K` s" t d | d | | � } | | � S( um Generate 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 <https://www.eff.org/deeplinks/2016/07/new-wordlists-random-passphrases>`_ 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 <https://github.com/bitcoin/bips/blob/master/bip-0039/english.txt>`_, 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:`!unicode` string containing randomly generated passphrase; or list of 1+ passphrases if :samp:`returns={int}` is specified. RZ RT ( R� ( RZ RT Rc R[ Rr ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt genphrase� s a(< Ri t __future__R R R R R+ t collectionsR R t mathR R R t loggingt getLoggerRg R4 R. t passlibR t passlib.utils.compatR R R R t passlib.utilsR R R t passlib.utils.decorR t __all__t dictRQ R R* R" R- t listRu R� RB t frozensetRA R= RN RU RO Rp Rn Rs Rz R{ R� t splitt nameR� R� R� ( ( ( s/ /usr/lib/python2.7/site-packages/passlib/pwd.pyt <module> sT " " , .� LM #> R