
    Rh                         d Z g dZddlZddlmZ ddlmZ  e       Zej                  Z	ej                  Z
d ZdZddZdd	Zdd
Zy)zGenerate cryptographically strong pseudo-random numbers suitable for
managing secrets such as account authentication, tokens, and similar.

See PEP 506 for more information.
https://peps.python.org/pep-0506/

)choice	randbelowrandbitsSystemRandomtoken_bytes	token_hextoken_urlsafecompare_digest    N)r	   )r   c                 L    | dk  rt        d      t        j                  |       S )z(Return a random int in the range [0, n).r
   zUpper bound must be positive.)
ValueError_sysrand
_randbelow)exclusive_upper_bounds    /usr/lib/python3.12/secrets.pyr   r      s(    !899455        c                 <    | t         } t        j                  |       S )zReturn a random byte string containing *nbytes* bytes.

    If *nbytes* is ``None`` or not supplied, a reasonable
    default is used.

    >>> token_bytes(16)  #doctest:+SKIP
    b'\xebr\x17D*t\xae\xd4\xe3S\xb6\xe2\xebP1\x8b'

    )DEFAULT_ENTROPYr   	randbytesnbytess    r   r   r   !   s     ~ f%%r   c                 4    t        |       j                         S )a"  Return a random text string, in hexadecimal.

    The string has *nbytes* random bytes, each byte converted to two
    hex digits.  If *nbytes* is ``None`` or not supplied, a reasonable
    default is used.

    >>> token_hex(16)  #doctest:+SKIP
    'f9bf78b9a18ce6d46a0cd2b0b86df9da'

    )r   hexr   s    r   r   r   /   s     v""$$r   c                 ~    t        |       }t        j                  |      j                  d      j	                  d      S )zReturn a random URL-safe text string, in Base64 encoding.

    The string has *nbytes* random bytes.  If *nbytes* is ``None``
    or not supplied, a reasonable default is used.

    >>> token_urlsafe(16)  #doctest:+SKIP
    'Drmhze6EPcv0fN_81Bj-nA'

       =ascii)r   base64urlsafe_b64encoderstripdecode)r   toks     r   r   r   <   s5     f
C##C(//5<<WEEr   )N)__doc____all__r   hmacr	   randomr   r   getrandbitsr   r   r   r   r   r   r    r   r   <module>r(      sS      >	6 &%Fr   