1~hbddlZddlZddlmZddlmZmZmZmZm Z m Z m Z ddl m Z ddlmZddlmZmZej$dZej$d Zej$d Zej$d Zej$d Zej$d Zej$dZe dZe eeeeeeeffZGddZGddeZy)N) OrderedDict)Any CollectionListOptionalSequenceTypeVarUnion) Generator)OrderedDictType)choices_distributionchoices_distribution_unique#%z\$!@z\?z\^TceZdZUdZdZeeed<dZiddddd d d d d ddddddddddddddddddddd d!dd"did#d$d%d&d'd(d)dd*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;dd?d@dAdBidCddDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcidddedfd>dgdhdiddjddkd>dldmdnd5dodpdqddrddsdtdudvdwdxdydzd{d|d}d(id~dddmddddddddddpddddddddddddddddddddidd>ddddddddddadddddddddd5dddddddd1ddddidddddddddddddddd5ddÓddœddǓddɓdd˓dd͓ddÓddddidd(ddӓdddd1ddדddٓdd;ddܓddޓddddddddddddddddaiddדddÓdddddd dddddddddddddddddddd;ddddiddddddd dǓd dhd d-d d dd[dddddddd1dddd7ddMddדddddddd dWddMdmdddd Z d!e d"dfd#Z d"efd$Z d"efd%Z dKd&ed'ed(ed"efd)Zd"efd*Zd"efd+Zd"efd,Zd"eeeffd-Zd"eeeffd.ZdLd/eed0ed"efd1Zd"efd2ZdMd3ed"eefd4Zd"efd5Zd"efd6Z dNd7eed3eed8ed9eed"eef d:Z dOd7eed3eed"eefd;Z dPd7eed"efd<Z! dOd7eed3eed"eefd=Z" dQd>ed?ed@ed&eed'eed"ef dAZ#dRdBed"efdCZ$dDe%jLfdBedEed"efdFZ'dGe%jLfdBedEed"efdHZ(dSdBedIed"efdJZ)y(T BaseProviderbaseN__lang__Faa)DJERETaf)ZAak)GHam)ran)ESapn)INar)AEBHrDZEGEHrILr%IQJOKMKWLBLYMAMROMPSQASASDSOSSSYTDTNYEasastayc)PEaz)AZr%be)BYbem)ZMber)r)r3bg)BGbhbbhobn)BDr%bo)CNr%br)FRbrxbs)BAbyn)rca)ADr#rTITce)RUckb)r-cmn)TWcrh)UAcs)CZcsb)PLcvcy)GBda)DKde)ATBECHDELILUdoidv)MVdz)BTel)GRCYen)AGAUrPBWCArkriHKIEr%NGNZPHPKSGUSrrIZWeo)res)ARBOCLCOCRCUDOECr#GTHNMXNIPArCPRPYSVrUYVEet)EEeu)r#rTfa)IRff)SNfi)FIfil)rfo)FOfr)rrorTrrfur)r[fy)NLrpga)rgdgez)rrglgugvha)rhakhe)r,hihnehr)HRhsb)rpht)HThu)HUhy)AMiaid)IDigik)ris)ISit)ror[iuiwja)JPka)GEkk)KZkl)GLkm)KHknko)KRkokksku)TRkwky)KGlb)rrlg)UGli)rnrlijln)CDlo)LAlt)LTlv)LVlzhmagmaimg)MGmhrmi)rmk)MKmlmn)MNmnimrms)MYmt)MTmy)MMnannb)NOnds)rprne)NPnhn)rniu)NUrnl)AWrnrnnnrnsoocom)rKEorospa)r%rpap)ANr CWplps)AFpt)BRPTquzrajro)ROru)r]rbrw)RWsasatscsdseshssi)LKsidsk)SKsl)SIso)rrrr:sq)ALMLsr)MERSssstsv)rSEsw)rTZszlta)r%r+tcytetg)TJth)THthetitigtk)TMtltntr)rzrtsttug)rRukunmuruz)UZ)VN)rn)ro)r)rRrrr`) veviwawaewalwoxhyiyoyuezhzu generatorreturnc||_y)zc Base class for fake data providers :param generator: `Generator` instance N)rc)selfrcs a/var/www/peopleoo.sandbox-dev.co.uk/venv/lib/python3.12/site-packages/faker/providers/__init__.py__init__zBaseProvider.__init__s #cr|j}|dz|jtj|zS)z >> ( (A .>>((00A6 6ric|jjjddr&|jjjddSy)zGenerate a random non-zero digit (1 to 9) or an empty string. This method will return an empty string 50% of the time, and each digit has a 1/18 chance of being generated. rrwr|rr}rrs rgrandom_digit_not_null_or_emptyz+BaseProvider.random_digit_not_null_or_empty\rridigitsfix_lencP||j}|dkr td|rP|dkDr@|jjj t d|dz t d|dz Std|jjj dt d|dz S)aXGenerate a random integer according to the following rules: - If ``digits`` is ``None`` (default), its value will be set to a random integer from 1 to 9. - If ``fix_len`` is ``False`` (default), all integers that do not exceed the number of ``digits`` can be generated. - If ``fix_len`` is ``True``, only integers with the exact number of ``digits`` can be generated. :sample: fix_len=False :sample: fix_len=True :sample: digits=3 :sample: digits=3, fix_len=False :sample: digits=3, fix_len=True rz7The digit parameter must be greater than or equal to 0. rwz=A number of fixed length cannot have less than 1 digit in it.)r ValueErrorrcrxr~pow)rfrrs rg random_numberzBaseProvider.random_numberhs >//1F A:VW W z~~,,44SVaZ5H#bRX/\]J]^^ !`aa>>((00CFOa4GH Hric|jjjttdtj S)z-Generate a random ASCII letter (a-z and A-Z).letters)rcrxchoicegetattrstring ascii_lettersrrs rg random_letterzBaseProvider.random_letters.~~$$++GFIvG[G[,\]]rilengthcb|jttdtj|S)zwGenerate a list of random ASCII letters (a-z and A-Z) of the specified ``length``. :sample: length=10 rr)random_choicesrrr)rfrs rgrandom_letterszBaseProvider.random_letterss1 "" FIv';'; <#  rich|jjjtjS)z/Generate a random lowercase ASCII letter (a-z).)rcrxrrascii_lowercaserrs rgrandom_lowercase_letterz$BaseProvider.random_lowercase_letter%~~$$++F,B,BCCrich|jjjtjS)z/Generate a random uppercase ASCII letter (A-Z).)rcrxrrascii_uppercaserrs rgrandom_uppercase_letterz$BaseProvider.random_uppercase_letterrrielementsunique use_weightingc||n |j}t|trt|ts t d|rt nt }|/|jjjdt|}|r|t|kDr t dt|trTt|dst|j|_|j}|rt|jnd}n,|r&|jjj!||S|}d}|t|||jj|S)a Generate a list of randomly sampled objects from ``elements``. Set ``unique`` to ``False`` for random sampling with replacement, and set ``unique`` to ``True`` for random sampling without replacement. If ``length`` is set to ``None`` or is omitted, ``length`` will be set to a random integer from 1 to the size of ``elements``. The value of ``length`` cannot be greater than the number of objects in ``elements`` if ``unique`` is set to ``True``. The value of ``elements`` can be any sequence type (``list``, ``tuple``, ``set``, ``string``, etc) or an ``OrderedDict`` type. If it is the latter, the keys will be used as the objects for sampling, and the values will be used as weighted probabilities if ``unique`` is set to ``False``. For example: .. code-block:: python # Random sampling with replacement fake.random_elements( elements=OrderedDict([ ("variable_1", 0.5), # Generates "variable_1" 50% of the time ("variable_2", 0.2), # Generates "variable_2" 20% of the time ("variable_3", 0.2), # Generates "variable_3" 20% of the time ("variable_4": 0.1), # Generates "variable_4" 10% of the time ]), unique=False ) # Random sampling without replacement (defaults to uniform distribution) fake.random_elements( elements=OrderedDict([ ("variable_1", 0.5), ("variable_2", 0.2), ("variable_3", 0.2), ("variable_4": 0.1), ]), unique=True ) :sample: elements=('a', 'b', 'c', 'd'), unique=False :sample: elements=('a', 'b', 'c', 'd'), unique=True :sample: elements=('a', 'b', 'c', 'd'), length=10, unique=False :sample: elements=('a', 'b', 'c', 'd'), length=4, unique=True :sample: elements=OrderedDict([ ("a", 0.45), ("b", 0.35), ("c", 0.15), ("d", 0.05), ]), length=20, unique=False :sample: elements=OrderedDict([ ("a", 0.45), ("b", 0.35), ("c", 0.15), ("d", 0.05), ]), unique=True NzFUse OrderedDict only to avoid dependency on PYTHONHASHSEED (See #363).rwzOSample length cannot be longer than the number of unique elements to pick from. _key_cacher)__use_weighting__ isinstancedictrrrrrcrxr~lenhasattrtuplerqrvaluessample)rfrrrrfnchoices probabilitiess rgrandom_elementszBaseProvider.random_elementss|*7)B H^H^ h %j;.Oef f,2 (8L >^^**221c(mDF fs8},no o h %8\2&+HMMO&<#))G8EE(//"344M~~,,33HfEEG M 'N  NN ! !   ric*|j||dS)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 Frrrfrrs rgrzBaseProvider.random_choicess4##HfU#CCric.|j|ddS)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), ]) rwrrr)rfrs rgrmzBaseProvider.random_elements"##HQ#7::ric*|j||dS)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 Trrrs rg random_samplezBaseProvider.random_sample+s##HfT#BBrinumberlegec|r|r|S|rdnd}|rdnd}t||jjj||zdz }|||kr|}|||kDr|}|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<)intrcrxr~) rfrrrrsrt_min_maxrs rgrandomize_nb_elementsz"BaseProvider.randomize_nb_elements9sp8 "Msbsc $..//77dCCcI J ?rCxB ?rCxB ritextctjfd|}tjfd|}tjfd|}tjfd|}t jfd|}|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='!!! !!@ !@! !@@ @!! @!@ @@! @@@' c6tjSN)strrxrfs rgz'BaseProvider.numerify..ssc$*;*;*=&>ric6tjSr)rrrs rgrz'BaseProvider.numerify..tc$*D*D*F&Gric6tjSr)rrrs rgrz'BaseProvider.numerify..usS)D)D)F%Gric6tjSr)rrrs rgrz'BaseProvider.numerify..vrric6tjSr)rrrs rgrz'BaseProvider.numerify..wsC(K(K(M$Nri)_re_hashsub_re_perc_re_dol_re_excl_re_at)rfrs` rgnumerifyzBaseProvider.numerify`s`&||>E||GN{{GN||GNzzNPTU riz????rc:tjfd|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' c&jSrrmrrrfs rgrz%BaseProvider.lexify..sD$7$7$@ri)_re_qmrrfrrs` `rglexifyzBaseProvider.lexifyzszz@$GGriz## ??cF|j|j||S)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)rrrs rgbothifyzBaseProvider.bothifys {{4==.{@@riupperctjdd|rjtj fd|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 Nic&jSrrrs rgrz%BaseProvider.hexify..sT%8%8%Ari)r hexdigitsr_re_cirr)rfrrrs` @rghexifyzBaseProvider.hexifys7""3B' mmoG{{A4HHri)ri'rw)NF))abcNFN)rN)r)rFFNN)z###)z^^^^F)*__name__ __module__ __qualname__ __provider__rrr__annotations__rrnrrhrorlrrzrrrr rrboolrrrrrr ElementsTyperrrrmrrrrrrrrrirgrrs L"Hhsm"~  ~ g~ g~ g ~ g ~ w ~  ~J gK~L wM~N wO~P lQ~R gS~T wU~V |W~X gY~Z w[~\ w]~^ l_~` la~b gc~d we~f gg~h wi~j &k~l gm~n wo~p wq~r ws~t gu~v ww~x gy~z g{~| g}~~ 2~@ wA~B gC~D gE~F lG~H  I~r gs~t  u~b gc~d le~f gg~h gi~j gk~l wm~n go~p &q~r ws~t lu~v gw~x gy~z |{~| g}~~ g~@ gA~B gC~D wE~F gG~H gI~J wK~L gM~N wO~P gQ~R gS~T gU~V gW~X gY~Z g[~\ g]~^ g_~` la~b gc~d ge~f gg~h gi~j gk~l gm~n go~p gq~r gs~t wu~v gw~x gy~z g{~| g}~~ g~@ gA~B lC~D wE~F gG~H gI~J gK~L gM~N wO~P wQ~R wS~T gU~V wW~X gY~Z g[~\ g]~^ g_~` wa~b gc~d ge~f gg~h gi~j wk~l gm~n |o~p gq~r ws~t |u~v  w~x gy~z g{~| w}~~ g~@ lA~B gC~D gE~F lG~H !I~J gK~L gM~N lO~P wQ~R wS~T gU~V lW~X gY~Z g[~\ w]~^ g_~` la~b gc~d we~f gg~h wi~j gk~l gm~n &o~p lq~r ls~t gu~v gw~x ly~z l{~| w}~~ l~@ wA~B gC~D gE~F gG~H wI~J lK~L wM~N gO~P gQ~R gS~T lU~V gW~X gY~Z g[~\ g]~^ w_~` la~b gc~d&{~@###$#    NsN Cc CC Cc C# C3c3 3s3 33 uS#X  c3h IHSMI4ITWI8^s^  S (3- DD DD%4 $(, ] q/]  ]  ]  ~ ] ! ] B%4 $Dq/D D ! D8;|A;Q;(TX C$Q CCKC= C ! C !! %% %  % c] % c] % %NSS4"(8L8L H3 H# HQT H#*&:N:NACACASVA$ I3 I I Irirc`eZdZ d dedeedeeffd ZdeddfdZd d e defd Z xZ S) DynamicProviderN provider_namerrcc|s t}t| ||jdr t d||_g|_|r||_t|||jy)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 superrh startswithrrrsetattrget_random_value)rfrrrc __class__s rgrhzDynamicProvider.__init__sa<! I #  # #D )ab b* $DMmT%:%:;rielementrdc:|jj|y)zAdd new element.N)rappend)rfrs rg add_elementzDynamicProvider.add_elements W%rirc|jrt|jdk(r td|j|jd|dS)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 fromrw)rr)rrrr)rfrs rgrz DynamicProvider.get_random_valuesI }}DMM 2a 7\] ]##DMM!=#YZ[\\ri)NN)T) rrrrrrrrhrrr __classcell__)rs@rgrrs^$(#' *<*<4.*<C= *rs #LLL!$R 2::d  2::d  "**U  2::d  D  E  "**U  CLZ_jm_QX5NNO M IM I`9]l9]ri