VgcddlmZmZmZmZmZddlmZmZm Z m Z ddl m Z ddl mZmZmZddlmZddlmZmZd ZGd d ZGd d eZy)) IPV4LENGTH IPV6LENGTH IPv4Network IPv6Address IPv6Network)DictListOptionalTuple) unidecode) lowercaseslugifyslugify_unicode)choices_distribution) BaseProvider ElementsTypeTceZdZUdZedededdZeeefed<ededed gZ e eed <ed ed ed edededededededededededededgZ e eed<y)_IPv4Constantsz 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____doc__rrrstr__annotations__rr rb/var/www/html/hubwallet-dev/venv/lib/python3.12/site-packages/faker/providers/internet/__init__.pyrr s %  '  '0d3 +, L!O$$%,tK( K O$M"$%N#N#%&%&$%%&O$%&$%M"M"()!-[)r$rc eZdZUdZeeed<dZeeed<dZeeed<dZ eeed<d Z eeed <d Z eeed <d Z eeed<dZ eeed<dZeeed<dZeeed<dZeeed<dZeeed<dZeeeefdfed<dedefdZedcd ed!eedefd"Zedefd#Zedefd$Zedefd%Zedefd&Zedefd'Zedefd(Zedefd)Zedefd*Z edefd+Z!e"defd,Z#eddd-e$defd.Z%eddd-e$defd/Z&ee"defd0Z' ded1ee$d2ee$d3ee$d4eed5ee$def d6Z(defd7Z)defd8Z*dfd9ee+edefd:Z,dfd;eedee+e-e+e$ffd<Z. dfd;eedee+e-e+e$ffd=Z/ dfd;eedee+e-e+e$ffd>Z0 dgd?e+e-d@ee+e$dAedefdBZ1dCe+e-dDe+e-de+e-fdEZ2defdFZ3 dhdAed;eedGeedefdHZ4didAed;eedefdIZ5didAed;eedefdJZ6djdAedefdKZ7djdLedefdMZ8dkdNedOedPede$fdQZ9defdRZ:dfdSee$defdTZ;defdUZdfdWeedefdXZ? dmdYee$dZee$d[eedefd\Z@defd]ZAdefd^ZBdnd_edefd`ZCdodae$d_ede+efdbZDy)pProvider)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:r>tag categoriestagsblogpostslistexplore uri_paths) .htmlrPrP.htmrQ.phprRz.jspz.aspuri_extensions) GETHEADPOSTPUTDELETECONNECTOPTIONSTRACEPATCH http_methods)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://placekitten.com/{width}/{height}image_placeholder_servicesr#. replacementsstringreturnch|jD]\}}|j||}t|}|SN)rbreplacer )selfrcr:rgs r% _to_asciizProvider._to_asciis<#00 5OFG^^FG4F 56" r$Nsafedomainc.|r|jd|}|S|r%|jd|j}|S|j|j}dj |j j |jd}|S)N@ ) user_namesafe_domain_namerandom_elementr_join generatorparsesplit)rhrjrkr5patterns r%r5zProvider.emails ~~'(&2E  ~~'($*?*?*A)BCE  ..t/A/ABGGGDNN009??DEE r$c8|j|jSrf)rrr(rhs r%rqzProvider.safe_domain_names""4#9#9::r$cJ|jdz|jzSNrm)rprqrys r% safe_emailzProvider.safe_emails"~~#%(=(=(???r$cJ|jdz|jzSr{)rpfree_email_domainrys r% free_emailzProvider.free_emails"~~#%(>(>(@@@r$cJ|jdz|jzSr{)rp domain_namerys r% company_emailzProvider.company_emails"~~#%(8(8(:::r$c8|j|jSrf)rrr)rys r%r~zProvider.free_email_domains""4#:#:;;r$c|j|j}|jdj|jj |j dS)Nrnro)rrr_rirsrtrurvrhrws r% ascii_emailzProvider.ascii_emailsO**4+=+=>~~ GGDNN((177< =  r$ch|j|jdz|jzSr{)rirprqrys r%ascii_safe_emailzProvider.ascii_safe_emails+~~dnn.4t7L7L7NNOOr$ch|j|jdz|jzSr{)rirpr~rys r%ascii_free_emailzProvider.ascii_free_emails0~~ NN s "T%;%;%= =  r$ch|j|jdz|jzSr{)rirprrys r%ascii_company_emailzProvider.ascii_company_emails0~~ NN s "T%5%5%7 7  r$c|j|j}|j|j|jj |j Srf)rrr^ribothifyrtrulowerrs r%rpzProvider.user_namesH**4+A+AB~~dll4>>+?+?+HIOOQRRr$levelsc|j|j}|dz|jdz}|dkr|S|dz|j|zS)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##.)rrr7numerifyr)rhrhostname_prefixhostname_prefix_first_levels r%hostnamezProvider.hostnamesc $2243I3IJ+:S+@4==QUCV+V#+1A: ' ;VY\;\_c_o_opv_w;w r$c|dkr td|dk(r$|jdz|jzS|jdz|j|dz zS)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)rhrs r%rzProvider.domain_namese A:HI I Q;##%+dhhj8 8!C'$*:*:6A:*FFFr$c|jjd}|jd}|j|j dS)Ncompanyror)rtformatrvripop)rhrcompany_elementss r%rzProvider.domain_wordsB~~,,Y7&-mmC&8~~.221566r$yearmonthdayrlengthcd}|xs|jdd}|xs|jdd}|xs|jdd}|xs|j}|xs|jdd}t|D]X}|d |zz d z |d zd zz }|d |zz dz d|dzzz }||dzz dz |dzdzz }|t||z |z dzdzz }Z|dz|zS)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 rnri'minmax r? ll lar) random_intrrangechr)rhrrrrrrk_s r%dgaz Provider.dga s &7t1$77QB73T___3TXXZ94??qb?9v t ||Dcgc] }t |c}|jjdd}n%|jjj|}t||jjjd|jdz }|r_|dt|jjj|j|jzz }tt|d}|Scc}w) a 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 fromc3HK|]}t|ttfywrf) isinstancefloatint).0ws r% z=Provider._random_ipv4_address_from_subnets..sAAJq5#,/As "r)randomrr/Fstrict)rrrMlenallrrrtrchoicer!randintr prefixlen max_prefixlenr)rhrrrrraddresss r%!_random_ipv4_address_from_subnetsz*Provider._random_ipv4_address_from_subnetss1 89 9 w %G G ,AAA)#*+aq+~~,,   F^^**11':F %%--((1,    sS%%--$$(( G +ge<=G3,sE networksnetworks_to_excludec|jd|D]4fd}tt||}|Dcgc] }|D]}| }}}6|Scc}}w)a. 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 c|jSrf)r)xs r%z1Provider._exclude_ipv4_networks..s q{{r$)keyc t|jS#t$r|jrgcYS|gcYSwxYw)aR 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. )rMaddress_excluderr)rnetwork_to_excludes r%_exclude_ipv4_networkz>Provider._exclude_ipv4_networks.._exclude_ipv4_networksL ) 7 78J KLL!)''(:;! 'y()sAAA)sortrMmap)rhrrrnested_networksnesteditemrs @r%rzProvider._exclude_ipv4_networkssn   %: ;"5 O  )0#3'!>q*!MNN NG+ge<=Gr$ multicastctddDcgc](}|jjjdd*}}|dur8|j d|jjj dddn7|j d|jjj ddddj d |DScc}w) zz Returns a random MAC address. :param multicast: Multicast address :returns: MAC Address rTrr:c3&K|] }d|z yw)z%02xNr#)rrs r%rz'Provider.mac_address..Us0q 0s)rrtrrinsert randrangers)rhrrmacs r% mac_addresszProvider.mac_addressIsCH1+NQt~~$$,,T48NN   JJq$..//99$aH I JJq$..//99$aH Ixx0C000 Os-C  is_systemis_user is_dynamicc|r|jddS|r|jddS|r|jddS|jddS)a Returns 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)rhrr r!s r% port_numberzProvider.port_numberWsY ??qd?3 3 ??t?7 7 ??u%?8 81%00r$c8|j|jSrf)rrrFrys r%uri_pagezProvider.uri_pagejs""4>>22r$deepc|r|n%|jjjdd}dj|j |j |S)Nrr r)r)rtrrrsrandom_elementsrO)rhr's r%uri_pathzProvider.uri_pathmsJt!6!6!>!>q!!Dxx   =  r$c8|j|jSrf)rrrSrys r% uri_extensionzProvider.uri_extensionss""4#6#677r$c|ddg}|r|j|ndd|j|j}|j|}|j}|j }|j j ||||S)a :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. rrrnr)r')rrr`r*r&r,rtru)rhrr'rwpathpage extensions r%uriz Provider.urivs ?w'G:A$--g6rJ#dNaNabfbrbrNsMtu}}$}'}}&&( ..&&w/0tfYKHHr$valuec@||jjd}|S)zDjango algorithm)rttext)rhr2s r%slugz Provider.slugs" =NN''+E r$widthheightplaceholder_urlc|xs|jd}|xs|jd}||j|j}|j||S)a 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)r7r8)rrrrar)rhr7r8r9width_height_s r% image_urlzProvider.image_urls`"3$//d/35DOOO5  ""11$2Q2QRO%%F7%CCr$c:t|jddS)zReturns IANA Registrar ID https://www.iana.org/assignments/registrar-ids/registrar-ids.xhtml :rtype: str ri8r)r!rrys r%iana_idzProvider.iana_ids4??qg?677r$cd|jddz}d|jddz}|jd||d jS) zReturns RIPE Organization ID https://www.ripe.net/manage-ips-and-asns/db/support/organisation-object-in-the-ripe-database :rtype: str ?rrr%rrzORG-z-RIPE)rrupper)rhlexnums r%ripe_idzProvider.ripe_idsWDOOqO11DOOqO11||d3%uE2399;;r$suffixct|dkr tdd|jddz}d|jddz}|j||d |j S) zuReturns NIC Handle ID https://www.apnic.net/manage-ip/using-whois/guide/person/ :rtype: str rz0suffix length must be greater than or equal to 2rArrrBrrr)rrrrrC)rhrGrDrEs r% nic_handlezProvider.nic_handlesp v;?OP PDOOqO11DOOqO11||seC5&2399;;r$countc^t|Dcgc]}|j|c}Scc}w)z>Returns NIC Handle ID list :rtype: list[str] )rG)rrI)rhrJrGrs r% nic_handleszProvider.nic_handless' 9>e E1v.EEEs*)TN)r)NNNNNrf)NF)FNN)FN)F)FFF)NN)NNN)FAKE)rz????)Errrr(rr!r"r)r/r7rFrOrSr]r^r_r`rarbr rirboolr r5rqr|rrr~rrrrrrprrrrrrrr rrrrrrrrrr rrrr$r&r*r,r1rr6r=r?rFrIrLr#r$r%r'r':sZ+X|C(X,U S)U D,s  ,|C($I|C  $I|C  )NL%  'L,s# ,|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.6S6 -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#F49Fr$r'N) ipaddressrrrrrtypingrr r r decoder utils.decoratorsrrrutils.distributionrrnrr localizedrr'r#r$r%rUs@SS..CC6)  ++\S F|S Fr$