U mhb@sddlZddlZddlmZddlmZmZmZmZm Z m Z m Z ddl m Z ddlmZddlmZmZedZed Zed Zed Zed Zed ZedZe dZe eeeeeffZGdddZGdddeZdS)N) OrderedDict)Any CollectionListOptionalSequenceTypeVarUnion) Generator)OrderedDictType)choices_distributionchoices_distribution_unique#%z\$!@z\?z\^Tc@seZdZUdZdZeeed<dZddddd d d d d d d ddddd d dddd ddddddddddddd d d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1dd2d d dd3dd4d d d5d6d7d8d9dd:d3d;dd?d@dAdBd dCd d dDddEdFdGdHd/dIdJdKdLdd d dMddNdOd dPd d dQdRdSddTdUdVdWdXdYdTddddZd dd[d\dd]d^d d d_d`dad d d/d[dTd;dbddcdddedfdgdddhdiddjd d dkdldVd2ddmd,ddndddodd%d[dpddqdrdsdd*dd%d3dtduddvZ e ddwdxdyZ edzd{d|Z edzd}d~Z deeeedddZedzddZedzddZedzddZeeefdzddZeeefdzddZdeeeedddZedzddZdeeedddZedzddZedzddZdeeeeeeeeedddZdeeeeeedddZ deeedddZ!deeeeeedddZ"deeeeeeeedddZ#deedddZ$de%j&feeedddZ'de%j&feeedddZ(deeedddZ)dS) BaseProviderbaseN__lang__F)DJERET)ZA)ZGH)r)ES)IN)ZAEZBHrDZZEGZEHrILrIQZJOZKMZKWZLBZLYMAZMRZOMZPSZQAZSAZSDSOZSSZSYZTDZTNZYE)PE)ZAZr)ZBY)ZM)rr )ZBG)BDr)CNr)FR)ZBA)r)ZADrr&IT)RU)r)TW)UA)ZCZ)ZPL)GB)DK)ATBECHDEZLILU)ZMV)ZBT)ZGRCY)ZAGZAUr$ZBWCAr,r+HKIErNGNZPHPKSGUSrr#ZZW)r;)ZARZBOZCLZCOCRZCUZDOZECrGTZHNMXZNIZPAr"ZPRZPYZSVr;ZUYZVE)ZEE)rr&)ZIR)ZSN)FI)r8)ZFO)r3r/r&r1)r')NLr0)r5)rr)r6)r)ZHR)r0)ZHT)ZHU)ZAM)ZID)r3)ZIS)r/r')ZJP)ZGE)ZKZ)ZGL)ZKH)ZKR)TR)ZKG)r1)ZUG)r.r@)ZCD)ZLA)LT)ZLV)ZMG)r7)ZMK)ZMN)ZMY)ZMT)ZMM)ZNO)r0r@)ZNP)r>)ZNUr7)AWr.r@)rKE)rr9)ANrCZCW)ZAF)ZBRZPT)ZRO)r(r*)ZRW)LK)ZSK)ZSI)rrrDr!)ALZML)ZMEZRS)r?ZSE)rDZTZ)rrF)ZTJ)ZTH)ZTM)r2rA)r%)ZUZ)ZVN)r.)r/)r4)r%r4r:r))ZaaafZakamanZapnarasastZaycazbeZbemberbgZbhbZbhoZbnZbobrZbrxbsZbyncaZceZckbZcmnZcrhcsZcsbZcvcydadeZdoiZdvZdzeleneoeseteufaZfffiZfilfofrZfurZfygagdZgezglZgugvZhaZhakhehihnehrZhsbZhthuZhyiaidZigZikisitiuiwjakakkklZkmknkoZkokksZkukwkyZlbZlgZliZlijZlnloltlvZlzhZmagmaiZmgZmhrmimkmlZmnZmnimrmsmtmynannbZndsneZnhnZniunlnnnrnsoocZomorospaZpapplZpsptZquzZrajrorurwsasatZscsdZseZshssiZsidskslsosqsrssstsvswZszltaZtcytetgthZtheZtiZtigtktltntrtsttZugukZunmuruzveviwaZwaeZwalZwoxhyiZyoZyuezhzu) generatorreturncCs ||_dS)zc Base class for fake data providers :param generator: `Generator` instance N)r)selfrr`/var/www/html/peyman_registration/venvv2/lib/python3.8/site-packages/faker/providers/__init__.py__init__szBaseProvider.__init__)rcCs |}|d|tj|S)z   zBaseProvider.random_elements)rrrcCs|j||ddS)a\Generate a list of objects randomly sampled from ``elements`` with replacement. For information on the ``elements`` and ``length`` arguments, please refer to :meth:`random_elements() ` which is used under the hood with the ``unique`` argument explicitly set to ``False``. :sample: elements=('a', 'b', 'c', 'd') :sample: elements=('a', 'b', 'c', 'd'), length=10 :sample: elements=OrderedDict([ ("a", 0.45), ("b", 0.35), ("c", 0.15), ("d", 0.05), ]) :sample: elements=OrderedDict([ ("a", 0.45), ("b", 0.35), ("c", 0.15), ("d", 0.05), ]), length=20 FrrrrrrrrrszBaseProvider.random_choices)rrcCs|j|dddS)aWGenerate a randomly sampled object from ``elements``. For information on the ``elements`` argument, please refer to :meth:`random_elements() ` which is used under the hood with the ``unique`` argument set to ``False`` and the ``length`` argument set to ``1``. :sample: elements=('a', 'b', 'c', 'd') :sample size=10: elements=OrderedDict([ ("a", 0.45), ("b", 0.35), ("c", 0.15), ("d", 0.05), ]) rrrr)rrrrrrszBaseProvider.random_elementcCs|j||ddS)aGenerate a list of objects randomly sampled from ``elements`` without replacement. For information on the ``elements`` and ``length`` arguments, please refer to :meth:`random_elements() ` which is used under the hood with the ``unique`` argument explicitly set to ``True``. :sample: elements=('a', 'b', 'c', 'd', 'e', 'f') :sample: elements=('a', 'b', 'c', 'd', 'e', 'f'), length=3 Trrrrrr random_sample+s zBaseProvider.random_sampler)numberlegerrrc Csl|r |r |S|rdnd}|r dnd}t||jj||d}|dk rT||krT|}|dk rh||krh|}|S)a1Generate a random integer near ``number`` according to the following rules: - If ``le`` is ``False`` (default), allow generation up to 140% of ``number``. If ``True``, upper bound generation is capped at 100%. - If ``ge`` is ``False`` (default), allow generation down to 60% of ``number``. If ``True``, lower bound generation is capped at 100%. - If a numerical value for ``min`` is provided, generated values less than ``min`` will be clamped at ``min``. - If a numerical value for ``max`` is provided, generated values greater than ``max`` will be clamped at ``max``. - If both ``le`` and ``ge`` are ``True``, the value of ``number`` will automatically be returned, regardless of the values supplied for ``min`` and ``max``. :sample: number=100 :sample: number=100, ge=True :sample: number=100, ge=True, min=120 :sample: number=100, le=True :sample: number=100, le=True, max=80 :sample: number=79, le=True, ge=True, min=80 d<N)intrrr) rrrrrr_minZ_maxrrrrrandomize_nb_elements9s  z"BaseProvider.randomize_nb_elements###)textrcshtfdd|}tfdd|}tfdd|}tfdd|}tfdd|}|S)aJGenerate a string with each placeholder in ``text`` replaced according to the following rules: - Number signs ('#') are replaced with a random digit (0 to 9). - Percent signs ('%') are replaced with a random non-zero digit (1 to 9). - Dollar signs ('$') are replaced with a random digit above two (2 to 9). - Exclamation marks ('!') are replaced with a random digit or an empty string. - At symbols ('@') are replaced with a random non-zero digit or an empty string. Under the hood, this method uses :meth:`random_digit() `, :meth:`random_digit_not_null() `, :meth:`random_digit_or_empty() `, and :meth:`random_digit_not_null_or_empty() ` to generate the random values. :sample: text='Intel Core i%-%%##K vs AMD Ryzen % %%##X' :sample: text='!!! !!@ !@! !@@ @!! @!@ @@! @@@' cs tSN)strrxrrrsz'BaseProvider.numerify..cs tSr )r rrrrrrtrcs tSr )r rrrrrrurcs tSr )r rrrrrrvrcs tSr )r rrrrrrwr)_re_hashsub_re_perc_re_dol_re_excl_re_at)rr rrrnumerify`s zBaseProvider.numerifyz????)r rrcstfdd|S)aSGenerate a string with each question mark ('?') in ``text`` replaced with a random character from ``letters``. By default, ``letters`` contains all ASCII letters, uppercase and lowercase. :sample: text='Random Identifier: ??????????' :sample: text='Random Identifier: ??????????', letters='ABCDE' cs Sr rrrrrrrrz%BaseProvider.lexify..)_re_qmrrr rrrrlexifyzs zBaseProvider.lexifyz## ??cCs|j|||dS)aGenerate a string with each placeholder in ``text`` replaced according to the following rules: - Number signs ('#') are replaced with a random digit (0 to 9). - Question marks ('?') are replaced with a random character from ``letters``. By default, ``letters`` contains all ASCII letters, uppercase and lowercase. Under the hood, this method uses :meth:`numerify() ` and and :meth:`lexify() ` to generate random values for number signs and question marks respectively. :sample: letters='ABCDE' :sample: text='Product Number: ????-########' :sample: text='Product Number: ????-########', letters='ABCDE' )r)rrrrrrbothifyszBaseProvider.bothify^^^^)r upperrcs0tjdd|rtfdd|S)aGenerate a string with each circumflex ('^') in ``text`` replaced with a random hexadecimal character. By default, ``upper`` is set to False. If set to ``True``, output will be formatted using uppercase hexadecimal characters. :sample: text='MAC Address: ^^:^^:^^:^^:^^:^^' :sample: text='MAC Address: ^^:^^:^^:^^:^^:^^', upper=True Nics Sr rrrrrrrz%BaseProvider.hexify..)r hexdigitsr _re_cirr)rr r rrrhexifys zBaseProvider.hexify)rrr)NF)r)rNFN)rN)r)rN)rFFNN)r )rF)*__name__ __module__ __qualname__ __provider__rrr __annotations__rrrrrrrrrrrr rrboolrrrrrr ElementsTyperrrrrr rrrrrr#rrrrrs       a   ' rcsReZdZd eeeeedfdd ZeddddZd e ed d d Z Z S)DynamicProviderN) provider_namerrcsP|s t}t||dr(td||_g|_|r>||_t|||jdS)a A faker Provider capable of getting a list of elements to randomly select from, instead of using the predefined list of elements which exist in the default providers in faker. :param provider_name: Name of provider, which would translate into the function name e.g. faker.my_fun(). :param elements: List of values to randomly select from :param generator: Generator object. If missing, the default Generator is used. :example: >>>from faker import Faker >>>from faker.providers import DynamicProvider >>>medical_professions_provider = DynamicProvider( >>> provider_name="medical_profession", >>> elements=["dr.", "doctor", "nurse", "surgeon", "clerk"], >>>) >>>fake = Faker() >>>fake.add_provider(medical_professions_provider) >>>fake.medical_profession() "dr." __zBProvider name cannot start with __ as it would be ignored by FakerN) r superr startswithrr,rsetattrget_random_value)rr,rr __class__rrrs  zDynamicProvider.__init__)elementrcCs|j|dS)zAdd new element.N)rappend)rr4rrr add_elementszDynamicProvider.add_elementT)rrcCs2|jrt|jdkrtd|j|jd|ddS)zReturns a random value for this provider. :param use_weighting: boolean option to use weighting. Defaults to True rz=Elements should be a list of values the provider samples fromr)rr)rrrr)rrrrrr1sz DynamicProvider.get_random_value)NN)T) r$r%r&r rrrrr6r)r1 __classcell__rrr2rr+s,r+)rer collectionsrtypingrrrrrrr rr r Zutils.distributionr rcompilerrrrrrr"rfloatr*rr+rrrrs, $