Ei-jSSKrSSKJs Jr SSKJrJrJ r J r J r SSK J r JrJrJr SSKJr SSKJrJrJr SSKJr SS KJrJr SS KJr S r"S S 5r "SS\5rg)N) IPV4LENGTH IPV6LENGTH IPv4Network IPv6Address IPv6Network)DictListOptionalTuple) unidecode) lowercaseslugifyslugify_unicode)choices_distribution) BaseProvider ElementsType)ProviderTc\rSrSr%Sr\"S5\"S5\"S5S.r\\\4\ S'\"S5\"S 5\"S 5/r \ \\ S '\"S 5\"S 5\"S5\"S5\"S5\"S5\"S5\"S5\"S5\"S5\"S5\"S5\"S5\"S5\"S5\"S5/r \ \\ S'Sr g)_IPv4Constants z IPv4 network constants used to group networks into different categories. Structure derived from `ipaddress._IPv4Constants`. Excluded network list is updated to comply with current IANA list of private and reserved networks. z 0.0.0.0/1z 128.0.0.0/2z 192.0.0.0/3)abc_network_classesz 10.0.0.0/8z 172.16.0.0/12z192.168.0.0/16_private_networksz 0.0.0.0/8z 100.64.0.0/10z 127.0.0.0/8z169.254.0.0/16z 192.0.0.0/24z 192.0.2.0/24z192.31.196.0/24z192.52.193.0/24z192.88.99.0/24z192.175.48.0/24z 198.18.0.0/15z198.51.100.0/24z203.0.113.0/24z 224.0.0.0/4z 240.0.0.0/4z255.255.255.255/32_excluded_networksN)__name__ __module__ __qualname____firstlineno____doc__rrrstr__annotations__rr r__static_attributes__r^/home/mande/repo/quber/.venv/lib/python3.13/site-packages/faker/providers/internet/__init__.pyrr s %  '  '0d3 +, L!O$$%,tK( K O$M"$%N#N#%&%&$%%&O$%&$%M"M"()!-[)r(rc <\rSrSr%Sr\\\S'Sr\\\S'Sr \\\S'Sr \\\S 'S r \\\S 'S r \\\S 'Sr \\\S'Sr\\\S'Sr\\\S'Sr\\\S'Sr\\\S'Sr\\\S'Sr\\\S'Sr\\\\4S4\S'S\S \4S!jr\ShS#\S$\\S \4S%jj5r\S \4S&j5r\S \4S'j5r\S \4S(j5r\S \4S)j5r\S \4S*j5r \S \4S+j5r!\S \4S,j5r"\S \4S-j5r#\S \4S.j5r$\%S \4S/j5r&\SiS0\S \4S1jj5r'\SiS0\S \4S2jj5r(\\%S \4S3j55r)SjS4\\S5\\S6\\S7\\S8\\S \4 S9jjr*S \4S:jr+S \4S;jr,SkS<\S \4S=jjr-SlS>\\.\S \4S?jjr/SlS@\\S \\.\0\.\44SAjjr1SlS@\\S \\.\0\.\44SBjjr2SlS@\\S \\.\0\.\44SCjjr3SmSD\.\0SE\\.\SF\S \4SGjjr4SH\.\0SI\.\0S \.\04SJjr5S \4SKjr6SnSF\S@\\SL\\S \4SMjjr7SoSF\S@\\S \4SNjjr8SoSF\S@\\S \4SOjjr9SpSF\S \4SPjjr:SpSQ\S \4SRjjr;SqSS\ST\SU\S \4SVjjrS \4SZjr?SrS>\\.\SX\\S \4S[jjr@\ASlS\\\S \4S]jj5rBSsS^\\S_\\S`\\S \4SajjrCS \4SbjrDS \4ScjrEStSd\S \4SejjrFSuSf\Sd\S \.\4SgjjrGSrHg")vr;)z example.orgz example.comz example.netsafe_domain_names)z gmail.comz yahoo.comz hotmail.comfree_email_domains) comr.r.r.r.r.bizinfonetorgtlds)dbsrvdesktoplaptopltemailwebhostname_prefixes)indexhomesearchmainposthomepagecategoryregisterloginfaqabouttermsprivacyauthor uri_pages) appr?z wp-contentr>rBtag categoriestagsblogpostslistexplore uri_paths) .htmlrTrT.htmrU.phprVz.jspz.aspuri_extensions) GETHEADPOSTPUTDELETECONNECTOPTIONSTRACEPATCH http_methods)=defgi,i-i.i/i0i1i3i4iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiihttp_assigned_codes)z{{last_name}}.{{first_name}}z{{first_name}}.{{last_name}}z{{first_name}}##z?{{last_name}}user_name_formats)z{{user_name}}@{{domain_name}}z#{{user_name}}@{{free_email_domain}} email_formats)zwww.{{domain_name}}/z{{domain_name}}/ url_formats)z&https://picsum.photos/{width}/{height}z'https://dummyimage.com/{width}x{height}z)https://placekittens.com/{width}/{height}image_placeholder_servicesr. replacementsstringreturnchURHup#URX#5nM [U5nU$N)rureplacer )selfrvr>rzs r) _to_asciiProvider._to_asciis3#00OF^^F4F 16" r(NsafedomaincBU(aUR5SU3nU$U(a%UR5SUR53nU$URUR5nSR UR R U5RS55nU$)N@ ) user_namesafe_domain_namerandom_elementrrjoin generatorparsesplit)r{r~rr9patterns r)r9Provider.emails ~~'(&2E  ~~'($*?*?*A)BCE  ..t/A/ABGGGDNN009??DEE r(c8URUR5$ry)rr,r{s r)rProvider.safe_domain_names""4#9#9::r(cJUR5S-UR5-$Nr)rrrs r) safe_emailProvider.safe_emails"~~#%(=(=(???r(cJUR5S-UR5-$r)rfree_email_domainrs r) free_emailProvider.free_emails"~~#%(>(>(@@@r(cJUR5S-UR5-$r)r domain_namers r) company_emailProvider.company_emails"~~#%(8(8(:::r(c8URUR5$ry)rr-rs r)rProvider.free_email_domains""4#:#:;;r(cURUR5nURSRURR U5R S555$)Nrr)rrrr|rrrrr{rs r) ascii_emailProvider.ascii_emailsO**4+=+=>~~ GGDNN((177< =  r(chURUR5S-UR5-5$r)r|rrrs r)ascii_safe_emailProvider.ascii_safe_email s+~~dnn.4t7L7L7NNOOr(chURUR5S-UR5-5$r)r|rrrs r)ascii_free_emailProvider.ascii_free_emails0~~ NN s "T%;%;%= =  r(chURUR5S-UR5-5$r)r|rrrs r)ascii_company_emailProvider.ascii_company_emails0~~ NN s "T%5%5%7 7  r(cURUR5nURURURR U55R 55$ry)rrqr|bothifyrrlowerrs r)rProvider.user_namesH**4+A+AB~~dll4>>+?+?+HIOOQRRr(levelscURUR5nUS-URS5-nUS:aU$US-URU5-$)z Produce a hostname with specified number of subdomain levels. >>> hostname() db-01.nichols-phillips.com >>> hostname(0) laptop-56 >>> hostname(2) web-12.williamson-hopkins.jackson.com -z##.)rr;numerifyr)r{rhostname_prefixhostname_prefix_first_levels r)hostnameProvider.hostnamesc $2243I3IJ+:S+@4==QUCV+V#+1A: ' ;VY\;\_c_o_opv_w;w r(cUS:a [S5eUS:Xa$UR5S-UR5-$UR5S-URUS- 5-$)z Produce an Internet domain name with the specified number of subdomain levels. >>> domain_name() nichols-phillips.com >>> domain_name(2) williamson-hopkins.jackson.com rz)levels must be greater than or equal to 1r) ValueError domain_wordtldr)r{rs r)rProvider.domain_name1se A:HI I Q;##%+dhhj8 8!C'$*:*:6A:*FFFr(cURRS5nURS5nURUR S55$)Ncompanyrr)rformatrr|pop)r{rcompany_elementss r)rProvider.domain_wordBsB~~,,Y7&-mmC&8~~.221566r(yearmonthdayrlengthcSnU=(d URSSS9nU=(d URSSS9nU=(d URSSS9nU=(d UR5nU=(d URSSS9n[U5HWnUS U-- S - US -S -- nUS U-- S- SUS--- nX3S-- S- US-S-- nU[X- U- S-S-5- nMY US-U-$)zGenerates a domain name by given date https://en.wikipedia.org/wiki/Domain_generation_algorithm :type year: int :type month: int :type day: int :type tld: str :type length: int :rtype: str rri'minmax r? llrlar) random_intrrangechr)r{rrrrrr_s r)dga Provider.dgaIs&7t1$77QB73T___3TXXZ94??qb?9vAAH_+ 1Br0IJDa%i'B." 8J2KKE"9%",# 2Br1IJC cDL3."4:; ;F  |c!!r(c8URUR5$ry)rr3rs r)r Provider.tldks""499--r(c8URUR5$)zbReturns random HTTP method https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods :rtype: str )rrars r) http_methodProvider.http_methodns""4#4#455r(include_unassignedcfU(aURSSS9$URUR5$)aReturns random HTTP status code https://www.rfc-editor.org/rfc/rfc9110#name-status-codes :param include_unassigned: Whether to include status codes which have not yet been assigned or are unused :return: a random three digit status code :rtype: int :example: 404 rbiWr)rrrp)r{rs r)http_status_codeProvider.http_status_codews1 ??s?4 4&&t'?'?@ @r(schemescUcSS/nU(aURU5OSSURUR53nURRU5$)z :param schemes: a list of strings to use as schemes, one will chosen randomly. If None, it will generate http and https urls. Passing an empty list will result in schemeless url generation like "://domain.com". :return: a random url string. httphttpsr://)rrsrr)r{rrs r)url Provider.urls[ ?w'G:A$--g6rJ#dNaNabfbrbrNsMtu~~##G,,r( address_classcU[RR5;aSUS3n[RU/nOSn[S5/nUS3n[ X5(a&[ X5(a[ X5[ X54$UR U[R5nUVs/sHoURPM nn[XU5 [XU5 X64$s snf)z Produces a 2-tuple of valid IPv4 networks and corresponding relative weights :param address_class: IPv4 address class (a, b, or c) _cached_all_class_ _networks_cached_all_networksz 0.0.0.0/0_weights) rrkeysrhasattrgetattr_exclude_ipv4_networksr num_addressessetattr)r{r networks_attr all_networks weights_attrnetworkweightss r)_get_all_networks_and_weights&Provider._get_all_networks_and_weightss N;;@@B B0yIM*;;MJKL2M' 45L(1 4 ' 'GD,G,G4/1LL L22   - - 9EE W(( E \2G,$$ Fs+CcJU(a"U[RR5;aUR5nSUS3nUS3n[ X5(a&[ X5(a[ X5[ X54$[RUn[R Vs/sHoURU5(dMUPM nnURU[R5nUVs/sHowRPM nn[XU5 [XU5 Xh4$s snfs snf)z Produces an OrderedDict of valid private IPv4 networks and corresponding relative weights :param address_class: IPv4 address class (a, b, or c) _cached_private_class_rr) rrripv4_network_classrrroverlapsrrrr) r{rrrsupernetsubnetprivate_networksrrs r)!_get_private_networks_and_weights*Provider._get_private_networks_and_weightss ^5T5T5Y5Y5[ [ 335M1yI '1 4 ' 'GD,G,G4/1LL L"22=A1?1Q1Qo1QvUdUdemUnF1Qo66   - -  9II8HW((8HI %56G,((pJs D=D)D cU[RR5;aUR5nSUS3nUS3n[ X5(a&[ X5(a[ X5[ X54$[RU/nUR U[R[R-5nUVs/sHoURPM nn[XU5 [XU5 XF4$s snf)z Produces a 2-tuple of valid public IPv4 networks and corresponding relative weights :param address_class: IPv4 address class (a, b, or c) _cached_public_class_rr) rrrrrrrrrrr)r{rrrpublic_networksrrs r) _get_public_networks_and_weights)Provider._get_public_networks_and_weightss  ? ? D D F F 335M0 iH '1 4 ' 'GD,G,G4/1LL L*::=IJ55   , ,~/P/P P  9HHW((H _5G,'' Is=C/subnetsrrc U(d [S5e[U[5(am[U5[U5:XaU[ SU55(a>[ UUVs/sHn[ U5PM snURRSS9SnO%URRRU5n[UURRRSURS- 55nU(a\US[URRRURUR55-- n[[USS95nU$s snf) aX Produces a random IPv4 address or network with a valid CIDR from within the given subnets using a distribution described by weights. :param subnets: List of IPv4Networks to choose from within :param weights: List of weights corresponding to the individual IPv4Networks :param network: Return a network address, and not an IP address :return: zNo subnets to choose fromc3N# UHn[U[[45v M g7fry) isinstancefloatint).0ws r) =Provider._random_ipv4_address_from_subnets..sAAJq5#,//s#%r)randomrr/Fstrict)rrrQlenallrrrrchoicer%randintr prefixlen max_prefixlenr)r{rrrrraddresss r)!_random_ipv4_address_from_subnets*Provider._random_ipv4_address_from_subnetss; 89 9 w % %G G ,AAAA)#*+7aq7+~~,,   F^^**11':F %%--((1,    sS%%--$$(( G +ge<=G3,s!E networksnetworks_to_excludec^URSS9 UH9mU4Sjn[[X155nUVVs/sH oUHofPM M nnnM; U$s snnf)z Exclude the list of networks from another list of networks and return a flat list of new networks. :param networks: List of IPv4 networks to exclude from :param networks_to_exclude: List of IPv4 networks to exclude :returns: Flat list of IPv4 networks cUR$ry)r )xs r)1Provider._exclude_ipv4_networks..>sq{{r()keyc>[URT55$![a URT5(a/s$U/s$f=f)a Exclude a single network from another single network and return a list of networks. Network to exclude comes from the outer scope. :param network: Network to exclude from :returns: Flat list of IPv4 networks after exclusion. If exclude fails because networks do not overlap, a single element list with the orignal network is returned. If it overlaps, even partially, the network is excluded. )rQaddress_excluderr)rnetwork_to_excludes r)_exclude_ipv4_network>Provider._exclude_ipv4_networks.._exclude_ipv4_networkAsO ) 7 78J KLL!)''(:;;! 'y()s"AAA)sortrQmap)r{r%r&r0nested_networksnesteditemr/s @r)rProvider._exclude_ipv4_networks3sd   %: ;"5  )0#3'<#GHO+:N?vtv?HNH7#6:OsAc$URS5$)zM Returns a IPv4 network class 'a', 'b' or 'c'. :returns: IPv4 network class abc)rrs r)rProvider.ipv4_network_class^s ""5))r(privatecUSLaURX!S9$USLaURX!S9$URUS9upEURXEUS9$)z Returns a random IPv4 address or network with a valid CIDR. :param network: Network address :param address_class: IPv4 address class (a, b, or c) :param private: Public or private :returns: IPv4 T)rrFrrr) ipv4_private ipv4_publicrr#)r{rrr;rrs r)ipv4 Provider.ipv4fsi d?$$=$R R  ##-#Q Q$($F$FUb$F$c !L99,ah9i ir(cDURUS9up4URX4US9$)z Returns a private IPv4. :param network: Network address :param address_class: IPv4 address class (a, b, or c) :returns: Private IPv4 r=r>)rr#)r{rrrrs r)r?Provider.ipv4_private|s4%)$J$JYf$J$g!556Fah5iir(cDURUS9up4URX4US9$)z Returns a public IPv4 excluding private blocks. :param network: Network address :param address_class: IPv4 address class (a, b, or c) :returns: Public IPv4 r=r>)r r#)r{rrr rs r)r@Provider.ipv4_publics2$(#H#HWd#H#e 55o`g5hhr(c >[[URRR S[ -S[ -S- 555nU(aLUS[URRR S[ 55-- n[[USS95nU$)z:Produce a random IPv6 address or network with a valid CIDRrrrrFr)r%rrrrrrr)r{rr"s r)ipv6 Provider.ipv6s}k$.."7"7"?"?: PQS]P]abOb"cde  sS!6!6!>!>q*!MNN NG+ge<=Gr( multicastc[SS5Vs/sH(o RRRSS5PM* nnUSLa8UR SURRR SSS55 O7UR SURRR SSS55 SR S U55$s snf) zZ Returns a random MAC address. :param multicast: Multicast address :returns: MAC Address rTrr:c3,# UH nSU-v M g7f)z%02xNr)rr)s r)r'Provider.mac_address..s0Cq Cs)rrrrinsert randranger)r{rJrmacs r) mac_addressProvider.mac_addresssCH1+N+Q~~$$,,T48+N   JJq$..//99$aH I JJq$..//99$aH Ixx0C000 Os/C  is_systemis_user is_dynamiccU(aURSSS9$U(aURSSS9$U(aURSSS9$URSSS9$)zReturns a network port number https://tools.ietf.org/html/rfc6335 :param is_system: System or well-known ports :param is_user: User or registered ports :param is_dynamic: Dynamic / private / ephemeral ports :rtype: int ririii)r)r{rWrXrYs r) port_numberProvider.port_numbersY ??qd?3 3 ??t?7 7 ??u%?8 81%00r(c8URUR5$ry)rrJrs r)uri_pageProvider.uri_pages""4>>22r(deepcU(aUO%URRRSS5nSRUR UR US95$)Nrr r)r)rrrrrandom_elementsrS)r{ras r)uri_pathProvider.uri_pathsJt!6!6!>!>q!!Dxx   =  r(c8URUR5$ry)rrWrs r) uri_extensionProvider.uri_extensions""4#6#677r(c$UcSS/nU(aURU5OSSURUR53nURUS9nUR5nUR 5nUR R U5UUU3$)aW :param schemes: a list of strings to use as schemes, one will chosen randomly. If None, it will generate http and https uris. Passing an empty list will result in schemeless uri generation like "://domain.com/index.html". :param deep: an integer specifying how many path components the URI should have.. :return: a random url string. rrrr)ra)rrsrdr_rgrr)r{rrarpathpage extensions r)uri Provider.uris ?w'G:A$--g6rJ#dNaNabfbrbrNsMtu}}$}'}}&&( ..&&w/0tfYKHHr(valuec`Uc*[RnURRSUS9nU$)zDjango algorithm) ext_word_list)USLoremProvider word_listrtext)r{rorrs r)slug Provider.slugs4 =,55MNN''-'HE r(widthheightplaceholder_urlcU=(d URSS9nU=(d URSS9nUcURUR5nURXES9$)ap Returns URL to placeholder image Example: http://placehold.it/640x480 :param width: Optional image width :param height: Optional image height :param placeholder_url: Optional template string of image URLs from custom placeholder service. String must contain ``{width}`` and ``{height}`` placeholders, eg: ``https:/example.com/{width}/{height}``. :rtype: str r[)r)rxry)rrrtr)r{rxryrzwidth_height_s r) image_urlProvider.image_urls^"3$//d/35DOOO5  ""11$2Q2QRO%%F%CCr(c4[URSSS95$)zjReturns IANA Registrar ID https://www.iana.org/assignments/registrar-ids/registrar-ids.xhtml :rtype: str ri8r)r%rrs r)iana_idProvider.iana_ids4??qg?677r(cSURSSS9-nSURSSS9-nURSUUS 35R5$) zReturns RIPE Organization ID https://www.ripe.net/manage-ips-and-asns/db/support/organisation-object-in-the-ripe-database :rtype: str ?rrr%rrLzORG-z-RIPE)rrupper)r{lexnums r)ripe_idProvider.ripe_idsWDOOqO11DOOqO11||d3%uE2399;;r(suffixc[U5S:a [S5eSURSSS9-nSURSSS9-nURUUS U35R 5$) z]Returns NIC Handle ID https://www.apnic.net/manage-ip/using-whois/guide/person/ :rtype: str rz0suffix length must be greater than or equal to 2rrrrrrLr)rrrrr)r{rrrs r) nic_handleProvider.nic_handlesp v;?OP PDOOqO11DOOqO11||seC5&2399;;r(countc\[U5Vs/sHo0RUS9PM sn$s snf)z.Returns NIC Handle ID list :rtype: list[str] )r)rr)r{rrrs r) nic_handlesProvider.nic_handless) 9>e E 1v. EEEs))TN)r)NNNNN)Try)NF)FNN)FN)F)FFF)NN)NNN)FAKE)rz????)Ir r!r"r#r,rr%r&r-r3r;rJrSrWrarprrqrrrsrtrur r|rboolr r9rrrrrrrrrrrrrrrrrrr rrrrr r#rrrAr?r@rHrUr\r_rdrgrmrrvr~rrrrr'rr(r)rr;s+X|C(X,U S)U D,s  ,|C($I|C  $I|C  )NL%  'L,s# >.c*>@,|C( (M<$&Kc"5 S 1 13L%c3h,-2$x};#;;@C@@ACAA;s;;<3<< S  P#PP #   S  S3SS s 3  "G#GcGG 7S77##!! $ "sm "} "c] " c] "  "  "D.S.6S6A4A3A" -8DI. -# -%8C=%TYZ^_jZkmqrumvZvTw%F(,!)}!) tK $s)+ ,!)J(, (} ( tK $s)+ , (J(, 4k"4$s)$4 4 4l)[))@D[@Q) k )V*C*'+!% jj }j# j j, jD j# jZ] j i4 i iY\ iDS 1T 1c 11T1D1VZ1gj1&3#3 Xc] c 8s8I8DI.IXc]IVYI" (3-3  $ $)- D}D D"# D D.88 < < < <# <FF#F49FFr(r)!builtins @py_builtins_pytest.assertion.rewrite assertionrewrite @pytest_ar ipaddressrrrrrtypingrr r r decoder utils.decoratorsrrrutils.distributionrrrr lorem.en_USrrs localizedrrr(r)rsHSS..CC6)5  ++\g F|g Fr(