1~hD3ddlmZddlZddlZddlZddlmZddlmZddl m Z m Z m Z m Z mZddlmZddlmZdd lmZdd lmZmZdd l mZdd lmZd ZedZGddZGddZGddZy)) annotationsN) OrderedDict)Random)AnyCallablePatternSequenceTypeVar)DEFAULT_LOCALE)UniquenessException)Factory) Generatorrandom)SeedType)choices_distributioniRetTypeceZdZUdZej dZded<ee Dcgc]}|jdr|dvs|c}}Z d ddZ fdZ dd Zd fd Zd d Zd Zd!d Zed"dZed#dZd$dZdZdZd%dZed&d'dZd&d'dZd&d(dZed)dZej>d*dZed+dZ ed,dZ!ed-dZ"d.dZ#xZ$Scc}}w)/Fakerz2Proxy class capable of supporting multiple localesz^_cached_\w*_mapping$r cache_pattern__)seed seed_instancerc &t|_d|_t||_t ||_t|tr|jddg}n%t|tttfrZg}|D]R}t|tstdt|d|jdd} | |vsB|j| Tnt|ttfrt!d|j#DsJt} |j%D]\} } | jdd} | | | <t| j'}t| j#|_nt(g}t+|dk(r/t-j.|d|||fd|i||j|d<n%|D] }t1||||fd|i||j|<"||_t|jj#|_y) N-_z The locale "z" must be a string.c3HK|]}t|ttfywN) isinstanceintfloat).0vs T/var/www/peopleoo.sandbox-dev.co.uk/venv/lib/python3.12/site-packages/faker/proxy.py z!Faker.__init__..<sLqz!c5\2Ls "r r use_weighting)r _factory_map_weights UniqueProxy _unique_proxy OptionalProxy_optional_proxyrstrreplacelisttupleset TypeErrorappenddictallvaluesitemskeysr lenrcreater_locales _factories)selflocale providers generatorincludesr&configlocalescode final_localeodictkr#keys r$__init__zFaker.__init__sBM (.,T2 fc "~~c3/0Guc 2 3G 1!$,#l3t9+=P$QRR#||C5 w.NN<0  1d 3 4LFMMOLL LLME  1iiS)c  5::<(G 0DM&&G w<1 ,3NN  - , -  -D  gaj )" ,1 - #0 -  -!!&)   t00779:ctt| }|jD]0}|t |Dchc]}|j dr|c}z}2t |Scc}w)Nr)r1super__dir__ factoriesdir startswithsorted)r= attributesfactoryattr __class__s r$rMz Faker.__dir__^s_*+ ~~ VG CLUDPS@T4U UJ Vj!!Vs A# A#c|jdd|jvrt|jdk(r|S|j|jdd}t |t sJ|S)Nrrr )r.rCr9r'rr)r=r>instances r$ __getitem__zFaker.__getitem__ds^ >>#s #t|| 3DLL8IQ8NK$$V^^C%=>(E***rJcF|dk(r d}t|t| |S)z Handles the "attribute resolution" behavior for declared members of this proxy class The class method `seed` cannot be called from an instance. :param attr: attribute name :return: the appropriate attribute rzZCalling `.seed()` on instances is deprecated. Use the class method `Faker.seed()` instead.)r2rL__getattribute__)r=rTmsgrUs r$rZzFaker.__getattribute__ks+ 6>qCC. 7+D1 1rJc0t|jdk(rt|jd|S||jvrd|z}t ||j j |rd|z}t||j|}t||S)z Handles cache access and proxying behavior :param attr: attribute name :return: the appropriate attribute r rzBProxying calls to `%s` is not implemented in multiple locale mode.z$Cached attribute `%s` does not exist) r9r<getattrgenerator_attrsNotImplementedErrorrmatchAttributeError_select_factory)r=rTr[rSs r$ __getattr__zFaker.__getattr__zs t 1 $4??1-t4 4 T)) )VY]]C%c* *    % %d +84?C % %**40G7D) )rJc8|j}|j|}tj|j|_tj|j |_tj|j |_tj|j|_t||_ |jjjDcic]}||jjhc}|j_ |Scc}wr) rU__new__copydeepcopyr;r<r'r(r)r*_seenr8 _sentinel)r=memodictclsresultrGs r$ __deepcopy__zFaker.__deepcopy__snnS!-- 6 MM$//:"mmD,=,=>-- 6*40SWSeSeSkSkSpSpSr%saa&*>*>*H*H)I&I%s" &ts$Dc:|jj|yr__dict__updater=states r$ __setstate__zFaker.__setstate__ U#rJc|jSr)r*r=s r$uniquez Faker.uniques!!!rJc|jSr)r,rws r$optionalzFaker.optionals###rJc|j|\}}t|dk(rd|}t|t|dk(r|dS|r|j||}|S|j |}|S)z Returns a random factory that supports the provider method :param method_name: Name of provider method :return: A factory that supports the provider method rz"No generator object has attribute r )_map_provider_methodr9ra_select_factory_distribution_select_factory_choice)r= method_namerNweightsr[rSs r$rbzFaker._select_factorys"66{C 7 y>Q 6{oFC % % ^q Q<  77 7KG11)>4=='I#GV7K0&!E "%e Iw9otG}4G,0NN\gg{>[W\E\TkG dG$]sCC -C c.tj|y)zs Hashables the shared `random.Random` object across all factories :param seed: seed value N)rr)rkrs r$rz Faker.seeds trJcH|jD]}|j|y)zr Creates and seeds a new `random.Random` object for each factory :param seed: seed value N)r<r)r=rrSs r$rzFaker.seed_instances%  (G  ! !$ ' (rJc`|j|jddj|y)z Creates and seeds a new `random.Random` object for the factory of the specified locale :param locale: locale string :param seed: seed value rrN)r'r.r)r=r>rs r$ seed_localezFaker.seed_locales( &..c23AA$GrJc~t|jdk(r|jdjSd}t|)a Proxies `random` getter calls In single locale mode, this will be proxied to the `random` getter of the only internal `Generator` object. Subclasses will have to implement desired behavior in multiple locale mode. r rzJProxying `random` getter calls is not implemented in multiple locale mode.r9r<rr_)r=r[s r$rz Faker.randoms: t 1 $??1%,, ,^C%c* *rJcvt|jdk(r||jd_yd}t|)a Proxies `random` setter calls In single locale mode, this will be proxied to the `random` setter of the only internal `Generator` object. Subclasses will have to implement desired behavior in multiple locale mode. r rzJProxying `random` setter calls is not implemented in multiple locale mode.Nr)r=rr[s r$rz Faker.random s6 t 1 $(-DOOA  %^C%c* *rJc,t|jSr)r/r;rws r$rCz Faker.localessDMM""rJc|jSr)r(rws r$rz Faker.weightss }}rJc|jSr)r<rws r$rNzFaker.factories#s rJcHt|jjSr)r/r'r7rws r$r7z Faker.items'sD%%++-..rJ)NNNNT)r>z3str | Sequence[str] | dict[str, int | float] | Noner?list[str] | Noner@zGenerator | NonerArr&boolrBrreturnNone)r>r-rr)rTr-rr)rsrrr)rr))rr+)rr-rr)rr-rz(tuple[list[Factory], list[float] | None]r)rSeedType | Nonerr)r>r-rrrr)rr)rrrr)rz list[str])rzlist[int | float] | None)rzlist[Generator | Faker])rz#list[tuple[str, Generator | Faker]])%__name__ __module__ __qualname____doc__recompiler__annotations__rOrrPr^rIrMrXrZrcrmrtpropertyrxrzrbr}r~r| classmethodrrrrsetterrCrrNr7 __classcell__)r"rTrUs00@r$rrs<'RZZ(@AM7AYtt/DUxIxO GK&*&*%)" =;C=;$=;$ =; # =;  =;=; =;~"  2*& $""$$,M(B(H + + ]] + +##/YsC3C3C3rc8eZdZddZd dZd dZdZdZd dZy) r)c>||_i|_t|_yr)_proxyrhobjectrir=proxys r$rIzUniqueProxy.__init__,s  rJci|_yr)rhrws r$clearzUniqueProxy.clear1s  rJc~t|j|}t|r|j||St d)Nz9Accessing non-functions through .unique is not supported.r]rcallable_wrapr2r=nameobjs r$rczUniqueProxy.__getattr__4s6dkk4( C=::dC( (WX XrJc:|jj}|Srrprfrrs r$ __getstate__zUniqueProxy.__getstate__; ""$ rJc:|jj|yrrorrs r$rtzUniqueProxy.__setstate__BrurJcJtjfd}|S)NcF|tt|jf}jj |j h}j }t tD]}||vrn|i|}tdtdd|j||S)NzGot duplicated values after ,z iterations.) r0rQr7rh setdefaultrirange_UNIQUE_ATTEMPTSr add) argskwargsrH generatedretvalifunctionrr=s r$wrapperz"UniqueProxy._wrap..wrapperFsuVFLLN%;<=C --cDNN3CDI^^F+, k*!4262 k *,HIYZ[H\\h*ijj MM& !MrJ functoolswrapsr=rrrs``` r$rzUniqueProxy._wrapEs%  "  # (rJNrr)rrrr-rr)rr-rrrr) rrrrIrrcrrtrrJr$r)r)+s!" Y$rJr)c4eZdZdZddZd dZdZdZd dZy) r+zN Return either a fake value or None, with a customizable probability. c||_yr)rrs r$rIzOptionalProxy.__init__cs  rJc~t|j|}t|r|j||St d)Nz;Accessing non-functions through .optional is not supported.rrs r$rczOptionalProxy.__getattr__fs6dkk4( C=::dC( (YZ ZrJc:|jj}|Srrrrs r$rzOptionalProxy.__getstate__mrrJc:|jj|yrrorrs r$rtzOptionalProxy.__setstate__trurJcNtjdddfd}|S)Ng?)probcd|cxkrdkstdtdjjt|dzr|i|SdS)Nrg?zprob must be between 0 and 1d)chance_of_getting_true) ValueErrorrbooleanr )rrrrr=s r$rz$OptionalProxy._wrap..wrapperxsbt?s? !?@@# !?@@04 0C0C[^_cfi_i[j0C0k8T,V, uqu urJ)rrrr!rrrzRetType | Nonerrs` ` r$rzOptionalProxy._wrapws*  ".1 v # v rJNrr)rr-rzCallable[..., RetType]rzCallable[..., RetType | None]) rrrrrIrcrrtrrrJr$r+r+^s![$rJr+) __future__rrfrr collectionsrrrtypingrrrr r rBr exceptionsr rSrr@rrutils.distributionrrrrr)r+rrJr$rsa"  #<<"+(4 ) Q/Q/h00f  rJ