Current File : //usr/lib/python2.7/site-packages/passlib/pwd.pyo
�
�K@Xc@`sSdZddlmZmZmZmZddlZddlmZm	Z	ddl
mZmZ
ddlZeje�ZddlZddlZddlmZddlmZmZmZmZddlmZmZmZdd	lmZd
ddd
gZ e!dddddddddd�Z"d�Z#d�Z$dd�Z&e'e(fZ)e*e+fZ,e*�Z-dd�Z.de/fd��YZ0e!dd d!d"d#d$d%d&�Z1d'e0fd(��YZ2dddd)�Z3d*�Z4d+e	fd,��YZ5e5�Z6x(d-j7�D]Z8e6j9e8d.e8�q	Wd/e0fd0��YZ:dddd1�Z;dS(2u*passlib.pwd -- password generation helpersi(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tdefaultdicttMutableMapping(tceiltlog(texc(tPY2tiranget
itervaluest	int_types(trngt
getrandstrt
to_unicode(tmemoized_propertyugenwordudefault_charsetsu	genphraseudefault_wordsetstunsafeitweakitfairi$tstrongi0tsecurei<cC`s$t|�j}||j|�dS(u2return remaining classes in object's MRO after clsi(ttypet__mro__tindex(tobjtclstmro((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt
_superclasses3scC`s�yt|�}Wntk
r)d}nXtt�}x|D]}||cd7<q=W|dkr~|j�}t|�}nt|�}|s�dSt|d�td�|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
    iiics`s"|]}|t|d�VqdS(iN(tlogf(t.0tvalue((s//usr/lib/python2.7/site-packages/passlib/pwd.pys	<genexpr>ZsN(	tlent	TypeErrortNoneRtinttvaluestsumRR(tsourcetsizetcountstcharR$((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt_self_info_rate9s


cC`s�|rtj|�t|��Stjj|�r>t|d�S|jd�\}}}|srtd|f��nt	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)
    urbu:uKasset path must be absolute file path or use 'pkg.name:sub/path' format: %r(tcodecst	getreadert_open_asset_pathtostpathtisabstopent	partitiont
ValueErrort
pkg_resourcestresource_stream(R/tencodingtpackagetseptsubpath((s//usr/lib/python2.7/site-packages/passlib/pwd.pyR-es
usourcec	C`slt}t}y||krtSWntk
r9t}nXt|t�sgtt|��t|�kr�|r�y|j|�Wq�tk
r�q�XntSt�}t�}x-|D]%}||kr�|n|j|�q�Wt	|�}d}t|�|krd}ndj
d�|| D��}t|�|krR|dt|�|7}ntd||f��dS(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
    iiu, cs`s!|]}tt|��VqdS(N(treprtstr(Rtword((s//usr/lib/python2.7/site-packages/passlib/pwd.pys	<genexpr>�su, ... plus %d othersu*`%s` cannot contain duplicate elements: %sN(t_ensure_unique_cachetTrueR!tFalset
isinstancet
_set_typesR tsettaddtsortedtjoinR3(	R&tparamtcachethashabletseentdupstelemttrunctdup_repr((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt_ensure_unique�s6

-
		
#	tSequenceGeneratorcB`s�eZdZd	ZdZeZd	Zd	d	d	d�Ze	d��Z
e	d��Zd�Zd	d�Z
d�Zer�d�ZnRS(
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.
    ustrongcK`s9|dk	s|dkr�|dkr0|j}ntj||�}|dkr]td��ntt||j��}|dks�||kr�|}q�n||_|dkr�td��n||_|dk	r�||_	n|rt
|t�tfkrt
ddj|j����ntt|�j|�dS(Niu!`entropy` must be positive numberiu!`length` must be positive integeruUnexpected keyword(s): %su, (R"trequested_entropytentropy_aliasestgetR3R#Rtentropy_per_symboltlengthR
RROtobjectR!REtkeystsupert__init__(tselftentropyRTR
tkwdst
min_length((s//usr/lib/python2.7/site-packages/passlib/pwd.pyRX�s$		"cC`st|jd�S(uZ
        Average entropy per symbol (assuming all symbols have equal probability)
        i(Rtsymbol_count(RY((s//usr/lib/python2.7/site-packages/passlib/pwd.pyRSscC`s|j|jS(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`.
        (RTRS(RY((s//usr/lib/python2.7/site-packages/passlib/pwd.pyRZs	cC`std��dS(u;main generation function, should create one password/phraseuimplement in subclassN(tNotImplementedError(RY((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt__next__$scC`sq|dkrt|�St|t�rHgt|�D]}t|�^q2S|tkrX|Stj|dd��dS(uN
        frontend used by genword() / genphrase() to create passwords
        u<None>, int, or <iter>ureturnsN(R"tnextR@RR
titerRtExpectedTypeError(RYtreturnst_((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt__call__(s
#cC`s|S(N((RY((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt__iter__5scC`s
|j�S(N(R_(RY((s//usr/lib/python2.7/site-packages/passlib/pwd.pyR`9sN(t__name__t
__module__t__doc__R"RTRPR
R]RXRRSRZR_ReRfR	R`(((s//usr/lib/python2.7/site-packages/passlib/pwd.pyRO�s'#	
	tascii_72uH0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!@#$%^&*?/tascii_62u>0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZtascii_50u2234679abcdefghjkmnpqrstuvwxyzACDEFGHJKMNPQRTUVWXYZthexu0123456789abcdeft
WordGeneratorcB`sAeZdZdZdZddd�Zed��Zd�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
    uascii_62cK`s�|r|r:td��q:n|s0|j}nt|}||_t|dd�}t|dd�||_tt|�j|�dS(Nu,`chars` and `charset` are mutually exclusiveRFuchars(	R!tcharsettdefault_charsetsRRNtcharsRWRnRX(RYRqRoR[((s//usr/lib/python2.7/site-packages/passlib/pwd.pyRXys	
		cC`s
t|j�S(N(R Rq(RY((s//usr/lib/python2.7/site-packages/passlib/pwd.pyR]�scC`st|j|j|j�S(N(RR
RqRT(RY((s//usr/lib/python2.7/site-packages/passlib/pwd.pyR_�sN(
RgRhRiRoR"RqRXRR]R_(((s//usr/lib/python2.7/site-packages/passlib/pwd.pyRnWscK`s"td|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.
    RTRZ(Rn(RZRTRcR[tgen((s//usr/lib/python2.7/site-packages/passlib/pwd.pytgenword�sFcC`s[t|d��-}d�|D�}td�|D��}WdQXtjdt|�|�|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.
    uutf-8cs`s|]}|j�VqdS(N(tstrip(RR<((s//usr/lib/python2.7/site-packages/passlib/pwd.pys	<genexpr>�scs`s|]}|r|VqdS(N((RR<((s//usr/lib/python2.7/site-packages/passlib/pwd.pys	<genexpr>�sNu!loaded %d-element wordset from %r(R-ttupleRtdebugR (t
asset_pathtfhRrtwords((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt
_load_wordset�s

tWordsetDictcB`sqeZdZd
Zd
Zd�Zd�Zd�Zd�Z	d�Z
ed��Zd�Z
d�Zd	�ZRS(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.
    cO`s/i|_i|_tt|�j||�dS(N(tpathst_loadedRWR{RX(RYtargsR[((s//usr/lib/python2.7/site-packages/passlib/pwd.pyRX s		cC`sKy|j|SWntk
r"nX|j|}t|�}|j|<|S(N(R}tKeyErrorR|Rz(RYtkeyR/R((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt__getitem__%s

cC`s||j|<dS(u;
        set asset path to lazy-load wordset from.
        N(R|(RYR�R/((s//usr/lib/python2.7/site-packages/passlib/pwd.pytset_path.scC`s||j|<dS(N(R}(RYR�R((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt__setitem__4scC`s:||kr,|j|=|jj|d�n
|j|=dS(N(R}R|tpopR"(RYR�((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt__delitem__7s
cC`s#t|j�}|j|j�|S(N(RBR}tupdateR|(RYRV((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt_keyset>scC`s
t|j�S(N(RaR�(RY((s//usr/lib/python2.7/site-packages/passlib/pwd.pyRfDscC`s
t|j�S(N(R R�(RY((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt__len__GscC`s||jkp||jkS(N(R}R|(RYR�((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt__contains__KsN(RgRhRiR"R|R}RXR�R�R�R�tpropertyR�RfR�R�(((s//usr/lib/python2.7/site-packages/passlib/pwd.pyR{s								u%eff_long eff_short eff_prefixed bip39upasslib:_data/wordsets/%s.txttPhraseGeneratorcB`sJeZdZdZdZdZdddd�Zed��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
    ueff_longu cK`s�|dk	r*|dk	rLtd��qLn"|dkrB|j}nt|}||_t|t�sst|�}nt|dd�||_|dkr�|j	}nt
|dd�}||_	tt|�j
|�dS(Nu,`words` and `wordset` are mutually exclusiveRFuwordsusep(R"R!twordsettdefault_wordsetsR@t_sequence_typesRuRNRyR8RRWR�RX(RYR�RyR8R[((s//usr/lib/python2.7/site-packages/passlib/pwd.pyRXys"	
			cC`s
t|j�S(N(R Ry(RY((s//usr/lib/python2.7/site-packages/passlib/pwd.pyR]�sc`s/�fd�t�j�D�}�jj|�S(Nc3`s$|]}�jj�j�VqdS(N(R
tchoiceRy(RRd(RY(s//usr/lib/python2.7/site-packages/passlib/pwd.pys	<genexpr>�s(R
RTR8RE(RYRy((RYs//usr/lib/python2.7/site-packages/passlib/pwd.pyR_�sN(RgRhRiR�R"RyR8RXRR]R_(((s//usr/lib/python2.7/site-packages/passlib/pwd.pyR�Zs"cK`s"td|d||�}||�S(umGenerate 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.
    RZRT(R�(RZRTRcR[Rr((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt	genphrase�sa(<Rit
__future__RRRRR+tcollectionsRRtmathRRRtloggingt	getLoggerRgR4R.tpasslibRtpasslib.utils.compatR	R
RRt
passlib.utilsR
RRtpasslib.utils.decorRt__all__tdictRQRR*R"R-tlistRuR�RBt	frozensetRAR=RNRURORpRnRsRzR{R�tsplittnameR�R�R�(((s//usr/lib/python2.7/site-packages/passlib/pwd.pyt<module>sT""			,	.�	LM	#>	R