EqgdZddlZddlZddlmZddlmZmZmZm Z m Z ddlm Z m Z m Z mZmZmZddlmZddlmZmZdd lmZmZmZ dd lmZny#e$rqddlZej ej!dd ks)ej ej!dd kre d ej"ddiZnYnwxYweZ#ej$ej%zZ&dZ'dZ(dZ)dZ*edZ+dZ,dediZ-e.dZ/e.dZ0e/e1dzZ2edZ3edZ4edZ5edZ6edZ7edZ8ed ed ed!ed!ed"ed"ed#ed#ed$ed$ed%ed%ed&ed&ed'ed'ed(ed(ededi Z9ied)ed"ed*ed"ed+ed"ed,ed#ed-ed#ed.ed#ed/ed$ed0ed$ed1ed$ed2ed%ed3ed%ed4ed%ed5ed&ed6ed&ed7ed&ed8ed'ed9ed'ed:ed'ed;ed'ed<ed(ed=ed(ed>ed(ed?eded@ededAededBedi Z:e;e:fie9Z<e;e3e3edededCedCifie9Z=e;iedDedDedEedDedFedDedGedDedHedDedIedDedJedDedKedDedLedDedMedMedNedMedOedOedPedOedQedOedRedRedSedRfie;dTe:>DdUe:>Dzfie9Z?ej@edVZAedWedXzZBedYZCe jDe:>e jDdZe:>DzZEed[ZFej@ed\eFzed]zZGej@ed\eBzed]zZHej@ed^eCzed_zej$ZIed\eFzeCzed`zZJej@eJej$ZKedaZLej@eLZMedbZNej@eNZOej@edcZPeCedde'zzedezed\zeFzedfzeBze4zedgzeCzedhzeBze4zeEzeCzedgzZQediZRdjZSdkZTeTdlZUeTdmZVdnZWd^eCzdezeWzd_zZXdoe3zeXzdzeCzeXzdpzZYej@eYZZeEeCzZ[d\e[zdqze[zdrzZ\d\eEzdqze[zdrzZ]dse\zdtze]zduzZ^ej@e^Z_ej@edveUzedwze&Z`ej@eQedvzeUzedxze&Zaej@edyZbej@edzZcd{Zdd|Zed}Zfej@d~ZgGddehZiGddehZjGddehZkGddehZle1ame1ane1aodZpepdZqdZrdZsdZtddZudZvdZwdZxdZydZzdZ{dZ|dZ}dZ~dZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZddZdZ ddZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZd„ZdÄZdĄZejjfdńZdƄZdDŽZdȄZdɄZdʄZd˄Zd̄Zd̈́Zd΄ZdτZdЄZdфZ dd҄ZdӄZdԄZdՄZdքZdׄZd؄ZdلZdڄZdۄZd܄Zd݄ZGdބdeeȦZdZdZdS)a"Python phone number parsing and formatting library If you use this library, and want to be notified about important changes, please sign up to the libphonenumber mailing list at https://groups.google.com/forum/#!aboutgroup/libphonenumber-discuss. NOTE: A lot of methods in this module require Region Code strings. These must be provided using CLDR two-letter region-code format. These should be in upper-case. The list of the codes can be found here: http://www.iso.org/iso/country_codes/iso_3166_code_lists/country_names_and_code_elements.htm N) fullmatch) UnicodeMixinuunicodprntto_long)U_EMPTY_STRINGU_SPACEU_DASHU_TILDEU_ZERO U_SEMICOLON)digit) PhoneNumberCountryCodeSource) NumberFormat PhoneMetadataREGION_CODE_FOR_NON_GEO_ENTITY)_COUNTRY_CODE_TO_REGION_CODEzbuildmetadatafromxml.pyzbuildprefixdata.pyzAFailed to import generated data (but OK as during autogeneration))file)USZZ69)V)4)r!r7>+*z;ext=ztel:z;phone-context=z;isub=012345678ABCDEFGHIJKLMNOPQRSTUVWXYZ#-u－u‐u‑u‒u–u—u―u−/u／ u　u⁠.u．c:g|]}||fSlower.0_cs N/var/www/html/env/lib/python3.11/site-packages/phonenumbers/phonenumberutil.py rVs%0c0c0cb"((**b1A0c0c0ccg|]}||fSrOrOrRs rUrVrVs0[0[0[b"b0[0[0[rWu[\d]+(?:[~⁓∼～][\d]+)?u-x‐-―−ー－-／ u+ ­​⁠　()（）［］.\[\]/~⁓∼～z\dc6g|]}|SrOrP)rS_ks rUrVrVs $Q$Q$QBRXXZZ$Q$Q$QrWu+＋[z]+()]z[\\/] *xz(?u)(?:_|[^#\w])+$z(?:.*?[A-Za-z]){3}.*z{%d}|z]*(?:[z]*z){3,}[z ext. cVtdtztd|zzS)Nr\z{1,%d}))r_DIGITS) max_lengths rU _extn_digitsrc"s# S66G q||j8 99rWc4d}d}d}d}td}td}td}td}td } td } tt|z} ||z|zt|z|z} || z|zt|z|z} | t|ztd z}| td z| ztd z| ztd z|z}|rtd }td}||z|zt|z|z}|tdz|zt|z|z}|td z|ztd z|zS|S)N u [  \t,]*u[:\.．]?[  \t,-]*z#?u:(?:e?xt(?:ensi(?:ó?|ó))?n?|ｅ?ｘｔｎ?|доб|anexo)u (?:[xｘ#＃~～]|int|ｉｎｔ)z[- ]+rIr_u[  \t]*z (?:,{2}|;)z(?:,)+)r_RFC3966_EXTN_PREFIXrc) for_parsingext_limit_after_explicit_labelext_limit_after_likely_labelext_limit_after_ambiguous_charext_limit_when_not_sure0possible_separators_between_number_and_ext_labelpossible_chars_after_ext_labeloptional_extn_suffixexplicit_ext_labelsambiguous_ext_labelsambiguous_separatorrfc_extn explicit_extnambiguous_extnamerican_style_extn_with_suffixextension_pattern-possible_separators_number_ext_label_no_comma"auto_dialling_and_ext_labels_foundauto_dialling_extnonly_commas_extns rU_create_extn_patternr~)s! &("#% %&"789I7J7J4%&'E%F%F"T77 xyyQRRG**#l3Q&R&RRHEH[[346BCa6b6bc)*MGI]]457CDb7c7cdfz{N':\Ja=b=b'befgjekek'k#"AcFF*&')*30'(*+C&&199 "9:/8J8J5./|__*K@ACab*+GHHIK_`JhKK(*HIKWXvKwKwx01"AcFF*"#%&sVV, ! " rWTFz [\-\.\(\)]?z^\z*$z ]+((\-)*[z])*z^(z\.)*z\.?$z(?:z)$z)?z(?:\D+)z(\\\d)z$NPz$FGz$CCz \(?\\1\)?c8eZdZdZdZdZdZdZedZ dS)PhoneNumberFormata~ Phone number format. INTERNATIONAL and NATIONAL formats are consistent with the definition in ITU-T Recommendation E123. However we follow local conventions such as using '-' instead of whitespace as separators. For example, the number of the Google Switzerland office will be written as "+41 44 668 1800" in INTERNATIONAL format, and as "044 668 1800" in NATIONAL format. E164 format is as per INTERNATIONAL format but with no formatting applied, e.g. "+41446681800". RFC3966 is as per INTERNATIONAL format, but with all spaces and other separating symbols replaced with a hyphen, and with any phone number extension appended with ";ext=". It also will have a prefix of "tel:" added, e.g. "tel:+41-44-668-1800". Note: If you are considering storing the number in a neutral format, you are highly advised to use the PhoneNumber class. rrrrc|tjkrtdS|tjkrtdS|tjkrtdS|tjkrtdStd|zS)z;Return a string representation of a PhoneNumberFormat valueE164 INTERNATIONALNATIONALRFC3966 INVALID (%d))rrrrrrclsvals rU to_stringzPhoneNumberFormat.to_strings #( ( (V99  %3 3 3_%% % %. . .Z== %- - -Y<< ^c)** *rWN) __name__ __module__ __qualname____doc__rrrr classmethodrrOrWrUrrsM" DMHG + +[ + + +rWrcneZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZedZedZdS)PhoneNumberTypezType of phone numbers.rrrrrhrg cc tjtjtjtjtjtjtjtjtj tj tj tj f SN) r FIXED_LINEMOBILEFIXED_LINE_OR_MOBILE TOLL_FREE PREMIUM_RATE SHARED_COSTVOIPPERSONAL_NUMBERPAGERUAN VOICEMAILUNKNOWN)rs rUvalueszPhoneNumberType.valuessT*&4),+$/%#)' ) )rWc|tjkrtdS|tjkrtdS|tjkrtdS|tjkrtdS|tjkrtdS|tjkrtdS|tjkrtdS|tj krtdS|tj krtd S|tj krtd S|tj krtd S|tj krtd Std |zS)z9Return a string representation of a PhoneNumberType valuerrrrrrrrrrrrr)rrrrrrrrrrrrrrrs rUrzPhoneNumberType.to_stringsX /, , ,\?? " O* * *X;;  O8 8 8+,, , O- - -[>> ! O0 0 0^$$ $ O/ / /]## # O( ( (V99  O3 3 3&'' ' O) ) )W::  O' ' 'U88O O- - -[>> ! O+ + +Y<< ^c)** *rWN)rrrrrrrrrrrrrrrrrrrrOrWrUrrs  J FILK DO E CIG ) )[ )++[+++rWrc<eZdZdZdZdZdZdZdZe dZ dS) MatchTypezTypes of phone number matches.rrrrrc\|tjkrtdS|tjkrtdS|tjkrtdS|tjkrtdS|tjkrtdStd|zS)z3Return a string representation of a MatchType value NOT_A_NUMBERNO_MATCHSHORT_NSN_MATCH NSN_MATCH EXACT_MATCHr)rrrrrrrrs rUrzMatchType.to_string)s )( ( (^$$ $ I& & &Z== I- - -&'' ' I' ' '[>> ! I) ) )]## #^c)** *rWN) rrrrrrrrrrrrOrWrUrrsR((LH OIK + +[ + + +rWrc@eZdZdZdZdZdZdZdZdZ e dZ d S) ValidationResultzEPossible outcomes when testing if a PhoneNumber is a possible number.rrrrrrc|tjkrtdS|tjkrtdS|tjkrtdS|tjkrtdS|tjkrtdS|tjkrtdStd|zS)z:Return a string representation of a ValidationResult value IS_POSSIBLEIS_POSSIBLE_LOCAL_ONLYINVALID_COUNTRY_CODE TOO_SHORTINVALID_LENGTHTOO_LONGr)rrrrrrrrrs rUrzValidationResult.to_stringQs ". . .]## # $; ; ;-.. . $9 9 9+,, , $. . .[>> ! $3 3 3%&& & $- - -Z== ^c)** *rWN) rrrrrrrrrrrrrOrWrUrr:sWOOK INH++[+++rWrc:tttD]^\}}t |dkr,|dt krt|Dt|_t tvrt t ttttdS)Nrr) SUPPORTED_REGIONSclear!COUNTRY_CODES_FOR_NON_GEO_REGIONSCOUNTRY_CODE_TO_REGION_CODEitemslenraddupdateremove_NANPA_REGIONS_NANPA_COUNTRY_CODE)cc region_codess rU_regenerate_derived_datarjs%++---7==??33L    " "|A:X'X'X - 1 1" 5 5 5 5  $ $\ 2 2 2 2%):::  !?@@@56IJKKKKKrWct|j|jt|j|j|j|j}d|_|S)z6Return a mutable copy of the given NumberFormat object)patternformatleading_digits_patternnational_prefix_formatting_rule(national_prefix_optional_when_formatting%domestic_carrier_code_formatting_ruleT) rrrlistrrrr_mutable)othercopys rU_copy_number_formatr|sP  $|/3E4P/Q/Q8=8]AFAo>C>i  k k kD DM KrWcdt|}|r||d}t|}|r|d|}t|}|r|d|}|St S)aAttempt to extract a possible number from the string passed in. This currently strips all leading characters that cannot be used to start a phone number. Characters that can be used to start a phone number are defined in the VALID_START_CHAR_PATTERN. If none of these characters are found in the number passed in, an empty string is returned. This function also attempts to strip off any alternative extensions or endings if two or more are present, such as in the case of: (530) 583-6985 x302/x2303. The second extension here makes this actually two phone numbers, (530) 583-6985 x302 and (530) 583-6985 x2303. We remove the second extension so that the first number is parsed correctly. Arguments: number -- The string that might contain a phone number. Returns the number, stripped of any non-phone-number prefix (such as "Tel:") or an empty string if no character used to start phone numbers (such as + or any digit) is found in the number N)_VALID_START_CHAR_PATTERNsearchstart_UNWANTED_END_CHAR_PATTERN_SECOND_NUMBER_START_PATTERNr )numbermatchtrailing_chars_matchsecond_number_matchs rU_extract_possible_numberrs( & , ,V 4 4E  '9@@HH  ;9177999:F:AA&II  :80668889F rWc~t|tkrdStt|}t |S)aBChecks to see if a string could possibly be a phone number. At the moment, checks to see that the string begins with at least 2 digits, ignoring any punctuation commonly found in phone numbers. This method does not require the number to be normalized in advance - but does assume that leading non-number symbols have been removed, such as by the method _extract_possible_number. Arguments: number -- string to be checked for viability as a phone number Returns True if the number could be a phone number of some sort, otherwise False F)r_MIN_LENGTH_FOR_NSNr_VALID_PHONE_NUMBER_PATTERNbool)rrs rU_is_viable_phone_numberrs7 6{{(((u 16 : :E ;;rWcztt|}|rt|tdSt |S)aDNormalizes a string of characters representing a phone number. This performs the following conversions: - Punctuation is stripped. - For ALPHA/VANITY numbers: - Letters are converted to their numeric representation on a telephone keypad. The keypad used here is the one defined in ITU Recommendation E.161. This is only done if there are 3 or more letters in the number, to lessen the risk that such letters are typos. - For other numbers: - Wide-ascii digits are converted to normal ASCII (European) digits. - Arabic-Indic numerals are converted to European numerals. - Spurious alpha characters are stripped. Arguments: number -- string representing a phone number Returns the normalized string version of the phone number. T)r_VALID_ALPHA_PHONE_PATTERN_normalize_helper_ALPHA_PHONE_MAPPINGSnormalize_digits_only)rms rU _normalizers=* ,f55A- )>EEE$V,,,rWct|}t|}t}t|D]>}t ||d}|dkr|t|z }1|r |||z }?|S)aNormalizes a string of characters representing a phone number. This converts wide-ascii and arabic-indic numerals to European numerals, and strips punctuation and alpha characters (optional). Arguments: number -- a string representing a phone number keep_non_digits -- whether to keep non-digits Returns the normalized string version of the phone number. )rrr range unicode_digit)rkeep_non_digits number_lengthnormalized_digitsiids rUrrsF^^FKKM&M"",, &*b ) ) 77  *    ,  +  rWc.t|tdS)aKNormalizes a string of characters representing a phone number. This strips all characters which are not diallable on a mobile phone keypad (including all non-ASCII digits). Arguments: number -- a string of characters representing a phone number Returns the normalized string version of the phone number. T)r_DIALLABLE_CHAR_MAPPINGSrs rUnormalize_diallable_chars_onlyrs V%=t D DDrWc.t|tdS)zlConvert alpha chars in a number to their respective digits on a keypad, but retains existing formatting.F)rrrs rU"convert_alpha_characters_in_numberrs V%:E B BBrWc$tjt|d}|dSt|}|j}|j|js |tvrdS|tj kr |tvrdSt||sdSt|S)aReturn length of the geographical area code for a number. Gets the length of the geographical area code from the PhoneNumber object passed in, so that clients could use it to split a national significant number into geographical area code and subscriber number. It works in such a way that the resultant subscriber number should be diallable, at least on some devices. An example of how this could be used: >>> import phonenumbers >>> numobj = phonenumbers.parse("16502530000", "US") >>> nsn = phonenumbers.national_significant_number(numobj) >>> ac_len = phonenumbers.length_of_geographical_area_code(numobj) >>> if ac_len > 0: ... area_code = nsn[:ac_len] ... subscriber_number = nsn[ac_len:] ... else: ... area_code = "" ... subscriber_number = nsn N.B.: area code is a very ambiguous concept, so the I18N team generally recommends against using it for most purposes, but recommends using the more general national_number instead. Read the following carefully before deciding to use this method: - geographical area codes change over time, and this method honors those changes; therefore, it doesn't guarantee the stability of the result it produces. - subscriber numbers may not be diallable from all devices (notably mobile devices, which typically require the full national_number to be dialled in most countries). - most non-geographical numbers have no area codes, including numbers from non-geographical entities. - some geographical numbers have no area codes. Arguments: numobj -- The PhoneNumber object to find the length of the area code form. Returns the length of area code of the PhoneNumber object passed in. Nr) rmetadata_for_regionregion_code_for_number number_type country_codenational_prefixitalian_leading_zero2_COUNTRIES_WITHOUT_NATIONAL_PREFIX_WITH_AREA_CODESrr/_GEO_MOBILE_COUNTRIES_WITHOUT_MOBILE_AREA_CODESis_number_type_geographical#length_of_national_destination_code)numobjmetadatantypers rU length_of_geographical_area_coder sP01G1O1OQUVVHq   E&L  (1L(NNNq ''' H H H q &ul ; ;q .v 6 66rWc|j+t}||d|_n|}t|tj}t jt|}t|dkrdSt|tj krJt|j}|tkr+t|dt|dzSt|dS)aBReturn length of the national destination code code for a number. Gets the length of the national destination code (NDC) from the PhoneNumber object passed in, so that clients could use it to split a national significant number into NDC and subscriber number. The NDC of a phone number is normally the first group of digit(s) right after the country calling code when the number is formatted in the international format, if there is a subscriber number part that follows. N.B.: similar to an area code, not all numbers have an NDC! An example of how this could be used: >>> import phonenumbers >>> numobj = phonenumbers.parse("18002530000", "US") >>> nsn = phonenumbers.national_significant_number(numobj) >>> ndc_len = phonenumbers.length_of_national_destination_code(numobj) >>> if ndc_len > 0: ... national_destination_code = nsn[:ndc_len] ... subscriber_number = nsn[ndc_len:] ... else: ... national_destination_code = "" ... subscriber_number = nsn Refer to the unittests to see the difference between this function and length_of_geographical_area_code. Arguments: numobj -- The PhoneNumber object to find the length of the NDC from. Returns the length of NDC of the PhoneNumber object passed in, which could be zero. Nrrr) extensionr merge_from format_numberrrresplitNON_DIGITS_PATTERNrrrrcountry_mobile_tokenrr )r copied_numobjnsn number_groups mobile_tokens rUrrNsD#$   ((("&   '8'F G GCH/55M  =Qq6o444,F,?@@ > ) )}Q'((3}Q/?+@+@@ @ }Q  rWcBt|tS)aReturns the mobile token for the provided country calling code if it has one, otherwise returns an empty string. A mobile token is a number inserted before the area code when dialing a mobile number from that country from abroad. Arguments: country_code -- the country calling code for which we want the mobile token Returns the mobile token, as a string, for the given country calling code. )_MOBILE_TOKEN_MAPPINGSgetr )rs rUrrs " % %lN C CCrWcg}|D]Y}||d}|||B|s||Ztj|S)aNormalizes a string of characters representing a phone number by replacing all characters found in the accompanying map with the values therein, and stripping all other characters if remove_non_matches is true. Arguments: number -- a string representing a phone number replacements -- a mapping of characters to what they should be replaced by in the normalized version of the phone number remove_non_matches -- indicates whether characters that are not able to be replaced should be stripped from the number. If this is False, they will be left unchanged in the number. Returns the normalized string version of the phone number. N)rupperappendr join)r replacementsremove_non_matchesnormalized_numberchar new_digits rUrrs++ $$TZZ\\488   $ $Y / / / /# +  $ $T * * *  0 1 11rWcNttS)aReturns all country calling codes the library has metadata for, covering both non-geographical entities (global network calling codes) and those used for geographical entities. This could be used to populate a drop-down box of country calling codes for a phone-number widget, for instance. Returns an unordered set of the country calling codes for every geographica and non-geographical entity the library supports. )setrkeysrOrWrUsupported_calling_codesr$s *//11 2 22rWc\|dSt|jdkp|jddkS)zWReturns true if there is any possible number data set for a particular PhoneNumberDesc.NFrrr)rpossible_lengthdescs rU_desc_has_possible_number_datar)s6  |u t# $ $ ) JT-A!-D-JJrWcL|dS|jdupt|p|jduS)zGReturns true if there is any data set for a particular PhoneNumberDesc.NF)example_numberr)national_number_patternr's rU_desc_has_datar-s> |u   , 7 *4 0 0 7  ) 58rWct}tD]O}|tjtjfvrt t ||r||P|S)zkReturns the types we have metadata for based on the PhoneMetadata object passed in, which must be non-None.)r"rrrrr-_number_desc_by_typer)rnumtypesnumtypes rU_supported_types_for_metadatar2stuuH"))++"" ;_=TU U U  .xAA B B " LL ! ! ! OrWct|stStj|}|Jt |S)aFReturns the types for a given region which the library has metadata for. Will not include FIXED_LINE_OR_MOBILE (if numbers in this region could be classified as FIXED_LINE_OR_MOBILE, both FIXED_LINE and MOBILE would be present) and UNKNOWN. No types will be returned for invalid or unknown region codes. )_is_valid_region_coder"rrrr2 region_coders rUsupported_types_for_regionr7sS ! - -uu 01B1B1D1DEEH     ( 2 22rWcjtj|d}|tSt|S)aReturns the types for a country-code belonging to a non-geographical entity which the library has metadata for. Will not include FIXED_LINE_OR_MOBILE (if numbers for this non-geographical entity could be classified as FIXED_LINE_OR_MOBILE, both FIXED_LINE and MOBILE would be present) and UNKNOWN. No types will be returned for country calling codes that do not map to a known non-geographical entity. N)rmetadata_for_nongeo_regionr"r2)rrs rU"supported_types_for_non_geo_entityr:s37 dKKHuu ( 2 22rWcN|dSttt|S)zHelper function to check if the national prefix formatting rule has the first group only, i.e., does not start with the national prefix. NT)rr _FIRST_GROUP_ONLY_PREFIX_PATTERN)rs rU%_formatting_rule_has_first_group_onlyr= s3'.t  :9;; < <Tests whether a phone number has a geographical association. It checks if the number is associated with a certain region in the country to which it belongs. Note that this doesn't verify if the number is actually in use. country_code -- the country calling code for which we want the mobile token )rrrrs rUis_number_geographicalr@s '{6':':F>A  !4!<# #!. %f - -C&+++88LjZ]^^^ *+? @ @ //CDDK@AUWbWhWhWjWjkkH"3*==89A9C9IKK 44H4>4D F FFrWc"|j}t|}t|s|St|}t j||}t }t||}||}nt|} |j } | r[|j } | rK| t| } | ttd} | | _ nd| _ t|| |}t!||||}t#|||}|S)aFormats a phone number using client-defined formatting rules. Note that if the phone number has a country calling code of zero or an otherwise invalid country calling code, we cannot work out things like whether there should be a national prefix applied, or how to format extensions, so we return the national significant number with no formatting applied. Arguments: numobj -- The phone number to be formatted number_format -- The format the phone number should be formatted into, as a PhoneNumberFormat value. user_defined_formats -- formatting rules specified by clients, as a list of NumberFormat objects. Returns the formatted phone number. N\1)rrMrHrOrrPr %_choose_formatting_pattern_for_numberrrrreplace _NP_STRING _FG_STRINGr_format_nsn_using_patternrRrN) r number_formatuser_defined_formatsrrr6rrTformatting_patternnum_format_copynp_formatting_rulers rUformat_by_patternraqsI$&L %f - -C *< 8 8 /|<?SUXYY!-.@AA 0O  G&6O G&8%?%? O%\%\"%7%?%? FSXMM%Z%Z"BT??CG?4S/=YY89A9F9IKK@ @M@PRR rWcB|j}t|}t|s|St|}t j||}t ||tj|}t||tj|}t|tj|}|S)aEFormat a number in national format for dialing using the specified carrier. The carrier-code will always be used regardless of whether the phone number already has a preferred domestic carrier code stored. If carrier_code contains an empty string, returns the number in national format without any carrier code. Arguments: numobj -- The phone number to be formatted carrier_code -- The carrier selection code to be used Returns the formatted phone number in national format for dialing using the carrier as specified in the carrier_code. ) rrMrHrOrrPrQrrrRrN)r carrier_coderrr6rrTs rU(format_national_number_with_carrier_coderds&L %f - -C *< 8 8 /|<>>&,,..+2M2M&,,..)/.}==/,$1@Q@_#`#`  #0@Q@Z#[#[  H;MJJH  H 0A0OPP P 0A0FGG G@-.>???rWct|st|tjS|j}t |}t |s|S|tkrBt|r2t|tzt|tj zSn-|t|krt|tj Stj||}|j}t"}|j|j}nt't(|r|}t+|}tj||}t-||tj} t/||tj| } t1|dkr&|tzt|ztz| z} nt3|tj| } | S)aFormats a phone number for out-of-country dialing purposes. If no region_calling_from is supplied, we format the number in its INTERNATIONAL format. If the country calling code is the same as that of the region where the number is from, then NATIONAL formatting will be applied. If the number itself has a country calling code of zero or an otherwise invalid country calling code, then we return the number with no formatting applied. Note this function takes care of the case for calling inside of NANPA and between Russia and Kazakhstan (who share the same country calling code). In those cases, no international prefix is used. For regions which have multiple international prefixes, the number in its INTERNATIONAL format will be returned instead. Arguments: numobj -- The phone number to be formatted region_calling_from -- The region where the call is being placed Returns the formatted phone number Nr)r4r rrrrMrHris_nanpa_countryrr rcountry_code_for_valid_regionrrPrinternational_prefixr preferred_international_prefixr_SINGLE_INTERNATIONAL_PREFIXrOrQrRrrN) rrprr metadata_for_region_calling_fromrzi18n_prefix_for_formattingr6rformatted_national_numberrTs rU$format_out_of_country_calling_numberris&0 !!4 5 5FV%6%DEEE&L %f - -C *< 8 8 *** / 0 0 G<((72!&*;*DEEF G G 67JKK K KV%6%?@@@(5'XYegzhAhAhChC(D(D$;P "0'FR%E%d"" /1E F F:%9".|< > >,  rWc|jtjkrt|tjS|jtjkrt||S|jtjkr"t|tjddSt|j }t|d}t|tj }|t|dkr|St|j||r|St!j|}|Jt%|}t'|j|}||S|j}||S|d} | dkr|S|d| }t/|}t|dkr|St1|} d| _t3|tj | gS)NrTrrV)rrFROM_NUMBER_WITH_PLUS_SIGNr rrFROM_NUMBER_WITH_IDDrFROM_NUMBER_WITHOUT_PLUS_SIGNrOrndd_prefix_for_regionrr#_raw_input_contains_national_prefixrLrrrMrWr\rfindrrra) rrpr6rnational_formatrrK format_rulecandidate_national_prefix_ruleindex_of_first_groupnew_format_rules rUrrs"&7&RRRV%6%DEEE  #'8'M M M3F?])^)^& - . .! 3 3" "-k:::>7 ):)CoEVWWWrWct|}||rD tt|t |d|S#t $rYdSwxYwdS)zCheck if raw_input, which is assumed to be in the national format, has a national prefix. The national prefix is assumed to be in digits-only form.NF)r startswithrtparserNumberParseException)rLrr6nnns rUrrs~ * *C ~~o&&   #5S-A-A-B-B)C[#Q#QRR R#   55  5s1A A&%A&c|j}t|}tj||}|dSt |}t |j|}|duS)NF)rrOrrPrMrWr\)rrphone_number_regionrrKrs rUrr-sa&L6|DD@ObccHu1&99O78NP_``K d ""rWcx|j}|t|dkrt||S|j}t |s|St |t d}t|}t|dkr-||dd}|dkr ||d}tj | d}|tkr*t|rt|tz|zSn|~|t!|krkt#|j|}||St'|}t)d|_t)d|_t/||t0jSt4} |(|j} t9t:| } | r| } n|j} t?|} tj || } tC|| t0j"|}| r&| tzt|ztz|z}ntG|t0j"|}|S)aFormats a phone number for out-of-country dialing purposes. Note that in this version, if the number was entered originally using alpha characters and this version of the number is stored in raw_input, this representation of the number will be used rather than the digit representation. Grouping information, as specified by characters such as "-" and " ", will be retained. Caveats: - This will not produce good results if the country calling code is both present in the raw input _and_ is the start of the national number. This is not a problem in the regions which typically use alpha numbers. - This will also not produce good results if the raw input has any grouping information within the first three digits of the national number, and if the function needs to strip preceding digits/words in the raw input before these digits. Normally people group the first three digits together so this is not a huge problem - and will be fixed if it proves to be so. Arguments: numobj -- The phone number that needs to be formatted. region_calling_from -- The region where the call is being placed. Returns the formatted phone number NrTrrz (\d+)(.*)z\1\2)$rLrrrrHr!_ALL_PLUS_NUMBER_GROUPING_SYMBOLSrMrrrrrrxrr country_code_for_regionrWr\rrrrr[rrr rzrr|r{rOrPrRrrN)rrprrrKfirst_national_number_digitr}r^ new_formatr~rz i18n_matchr6rrTs rU)format_out_of_country_keeping_alpha_charsr8s:$MM 2 2a 7 73F?PRXYY! (1CZQ]^^^rWc|D]}t|j}|dkr4tj|jd}||}|dks|r-tj|j}t ||r|cSdS)Nrr)rrr compilerrr)rrKrSsize ld_patternld_matchformat_patterns rUrWrWs' " " :455 !88J$Eb$IJJJ!''88H 1999Z (:;;N99 "!!!! 4rWc|j}tj|j}t}|t jkr_|r]|jrV|j}|t|}tj t||d}tj |||}nc|j }|t jkr6|r4tj t||d} tj || |}ntj |||}|t j kr^t|} | r"tj tt|d}tj tt |}|S)Nrcount)rr rrr rrrrX _CC_STRINGsub_FIRST_GROUP_PATTERNrr_SEPARATOR_PATTERNrr ) rKr^r\rcnumber_format_rulem_rercc_format_rulerfirst_group_rulers rUr[r[s{,2 :(0 1 1D .*333 3@ 4,Q'// LII  V$8$2$6*+---%'F41C_$U$U!!+=*\' .7 7 7 + 8!v&:&E&8,- / / / )+t5E(W(W % %(*t5G(Y(Y %)111  $ $%> ? ?  w(*/A>Sltu(v(v(v %$&F+=vG`$a$a! $$rWc6t|tjS)aGets a valid number for the specified region. Arguments: region_code -- The region for which an example number is needed. Returns a valid fixed-line number for the specified region. Returns None when the metadata does not contain such information, or the region 001 is passed in. For 001 (representing non-geographical numbers), call example_number_for_non_geo_entity instead. )example_number_for_typerrrEs rUr+r+&s #;0J K KKrWct|sdStj|}|Jt |t j}||jdS|j}t|dz }|tkrM|d|} t||}t|s|Sn#t$rYnwxYw|dz}|tkMdS)aGets an invalid number for the specified region. This is useful for unit-testing purposes, where you want to test what will happen with an invalid number. Note that the number that is returned will always be able to be parsed and will have the correct country code. It may also be a valid *short* number/code for this region. Validity checking such numbers is handled with shortnumberinfo. Arguments: region_code -- The region for which an example number is needed. Returns an invalid number for the specified region. Returns None when an unsupported region or the region 001 (Earth) is passed in. Nr) r4rrrr/rrr+rrrrtr)r6rr(r+phone_number_length number_to_trypossibly_valid_numbers rUinvalid_example_numberr4s ! - -t 01B1B1D1DEEH     /*D E ED |t*2t(N n--1 !4 4 4&';(;';<  $)-$E$E !"#899 -,, -#    D   q  !4 4 4 4s B22 B?>B?c|t|St|sdStj|}|Jt ||}|-|j& t|j|S#t$rYnwxYwdS)a_Gets a valid number for the specified region and number type. If None is given as the region_code, then the returned number object may belong to any country. Arguments: region_code -- The region for which an example number is needed, or None. num_type -- The type of number that is needed. Returns a valid number for the specified region and type. Returns None when the metadata does not contain such information or if an invalid region or region 001 was specified. For 001 (representing non-geographical numbers), call example_number_for_non_geo_entity instead. N) !_example_number_anywhere_for_typer4rrrr/r+rr)r6rCrr(s rUrrts0:::  - -t01B1B1D1DEEH     ( 3 3D D/; ,k:: :#    D  4s'A<< B B c@tD]}t||}||cStD]u}tj|d}t ||}|L|jE ttt|z|jztcS#t$rYqwxYwvdS)ayGets a valid number for the specified number type (it may belong to any country). Arguments: num_type -- The type of number that is needed. Returns a valid number for the specified type. Returns None when the metadata does not contain such information. This should only happen when no numbers of this type are allocated anywhere in the world anymore. N) rrrrr9r/r+rrrUNKNOWN_REGIONr)rCr6example_numobjrGrr(s rUrrs)"" 0hGG  %! ! ! ! &!B ;>AQQQ 44v7GGG MrWc|tjkr|jS|tjkr|jS|tjkr|jS|tjks|tjkr|j S|tj kr|j S|tj kr|j S|tjkr|jS|tjkr|jS|tjkr|jS|tjkr|jS|jS)zDReturn the PhoneNumberDesc of the metadata for the given number type)rrrrrrrrr fixed_linerrrrrpersonal_numberrpagerrrrr general_desc)rrCs rUr/r/s?///$$ _. . .!! _+ + + o0 0 0 o: : :"" _0 0 0## _) ) )} _4 4 4'' _* * *~ _( ( (| _. . .!!$$rWct|}tj|j|}| tjSt |}t||S)zGets the type of a valid phone number. Arguments: numobj -- The PhoneNumber object that we want to know the type of. Returns the type of the phone number, as a PhoneNumberType value; returns PhoneNumberType.UNKNOWN if it is invalid. )rrrPrrrrM_number_type_helper)rr6rrKs rUrrsS)00K@ATVabbH&&1&99O  9 99rWcft||js tjSt||jr tjSt||jr tjSt||jr tj St||j r tj St||j r tj St||jr tjSt||jr tjSt||jr tjSt||jr@|jr tjSt||jr tjStjS|js!t||jr tjStjS)z8Return the type of the given number against the metadata)_is_number_matching_descrrrrrrrrrrrrrrrrrrrr"same_mobile_and_fixed_line_patternrrrr)rKrs rUrrs #OX5J K K'&&1FGG,++1CDD)((1EFF+**??$##1IJJ/..@@%$$>>#""1CDD)((1DEE*  6 8"7 7 %ox G G 8"7 7))  7& (/BB&%%  ""rWc|dSt|}|j}t|dkr||vrdSt||dS)z9Determine if the number matches the given PhoneNumberDescNFr)rr&_match_national_number)rK number_desc actual_lengthpossible_lengthss rUrr(s[ u((M"2 q  ]:J%J%Ju !/; F FFrWc@t|}t||S)aTests whether a phone number matches a valid pattern. Note this doesn't verify the number is actually in use, which is impossible to tell by just looking at a number itself. It only verifies whether the parsed, canonicalised number is valid: not whether a particular series of digits entered by the user is diallable from the region provided when parsing. For example, the number +41 (0) 78 927 2696 can be parsed into a number with country code "41" and national significant number "789272696". This is valid, while the original string is not diallable. Arguments: numobj -- The phone number object that we want to validate Returns a boolean that indicates whether the number is of a valid pattern. )ris_valid_number_for_region)rr6s rUrtrt6s!")00K %fk : ::rWc|j}|dStj||}||tkr|t |krdSt |}t||tj kS)a3Tests whether a phone number is valid for a certain region. Note this doesn't verify the number is actually in use, which is impossible to tell by just looking at a number itself. If the country calling code is not the same as the country calling code for the region, this immediately exits with false. After this, the specific number pattern rules for the region are examined. This is useful for determining for example whether a particular number is valid for Canada, rather than just a valid NANPA number. Warning: In most cases, you want to use is_valid_number instead. For example, this method will mark numbers from British Crown dependencies such as the Isle of Man as invalid for the region "GB" (United Kingdom), since it has its own region code, "IM", which may be undesirable. Arguments: numobj -- The phone number object that we want to validate. region_code -- The region that we want to validate the phone number for. Returns a boolean that indicates whether the number is of a valid pattern. NF) rrrPrrryrMrrr)rr6rrrs rUrrKs,&Lu@{O`O`ObObccH 6 6 6 6{CC C Cu %f - -C X . ./2I IJrWc|j}t|d}|dSt|dkr|dSt ||S)aReturns the region where a phone number is from. This could be used for geocoding at the region level. Only guarantees correct results for valid, full numbers (not short-codes, or invalid numbers). Arguments: numobj -- The phone number object whose origin we want to know Returns the region where the phone number is from, or None if no region matches this calling code. Nrr)rrrr!_region_code_for_number_from_list)rrregionss rUrrosV&L)--lDAAGt 7||qqz0AAArWc>t|}|D]}tj|d}|,|j5t j|j}||}|r|cSht||tj kr|cSdS)z/Find the region in a list that matches a numberN) rMrrrleading_digitsr rrrrr)rrrKr6rleading_digit_rers rUrrs1&99O !4[5F5F5H5H$OO     " .!z(*ABB $**?;;E #"""" # ( ; ;?V V V   W 4rWcZt|d}|tS|dS)a%Returns the region code that matches a specific country calling code. In the case of no region code being found, UNKNOWN_REGION ('ZZ') will be returned. In the case of multiple regions, the one designated in the metadata as the "main" region for this calling code will be returned. If the country_code entered is valid but doesn't match a specific region (such as in the case of non-geographical calling codes like 800) the value "001" will be returned (corresponding to the value for World in the UN M.49 schema). Nr)rrrrrs rUrOrOs.*--lDAAGqzrWcDt|d}|dS|S)zReturns a list with the region codes that match the specific country calling code. For non-geographical country calling codes, the region code 001 is returned. Also, in the case of no region code being found, an empty list is returned. NrO)rrrs rUregion_codes_for_country_coders(*--lDAAGrrWcBt|sdSt|S)a>Returns the country calling code for a specific region. For example, this would be 1 for the United States, and 64 for New Zealand. Arguments: region_code -- The region that we want to get the country calling code for. Returns the country calling code for the region denoted by region_code. r)r4ryrEs rUrrs' ! - -q ( 5 55rWctj|d}|td|z|jS)adReturns the country calling code for a specific region. For example, this would be 1 for the United States, and 64 for New Zealand. Assumes the region is already valid. Arguments: region_code -- The region that we want to get the country calling code for. Returns the country calling code for the region denoted by region_code. NzInvalid region code %s)rrr Exceptionrr5s rUryrysE01B1B1D1DdKKH0;>???   rWc|dStj|d}|dS|j}|t |dkrdS|r t jtt|}|S)aQReturns the national dialling prefix for a specific region. For example, this would be 1 for the United States, and 0 for New Zealand. Set strip_non_digits to True to strip symbols like "~" (which indicates a wait for a dialling tone) from the prefix returned. If no national prefix is present, we return None. Warning: Do not use this method for do-your-own formatting - for some regions, the national dialling prefix is used only for certain types of numbers. Use the library's formatting functions to prefix the national prefix when required. Arguments: region_code -- The region that we want to get the dialling prefix for. strip_non_digits -- whether to strip non-digits from the national dialling prefix. Returns the dialling prefix for the region denoted by region_code. Nr) rrrrrr rr r )r6strip_non_digitsrrs rUrrs(t01B1B1D1DdKKHt.O#o"6"6!";";tK&./JJ rWc|tvS)zChecks if this region is a NANPA region. Returns True if region_code is one of the regions under the North American Numbering Plan Administration (NANPA). )rrEs rUrxrx s . ((rWct|sdSt|\}}ttt|S)aChecks if the number is a valid vanity (alpha) number such as 800 MICROSOFT. A valid vanity number will start with at least 3 digits and will have three or more alpha characters. This does not do region-specific checks - to work out if this number is actually valid for a region, it should be parsed and methods such as is_possible_number_with_reason() and is_valid_number() should be used. Arguments: number -- the number that needs to be checked Returns True if the number is a valid vanity number F)r_maybe_strip_extensionrrr)rr stripped_numbers rUis_alpha_numberr sD #6 * *u!7!?!?I  4oFF G GGrWc`t|}|tjkp|tjkS)aConvenience wrapper around is_possible_number_with_reason. Instead of returning the reason for failure, this method returns true if the number is either a possible fully-qualified number (containing the area code and country code), or if the number could be a possible local number (with a country code, but missing an area code). Local numbers are considered possible if they could be possibly dialled in this format: if the area code is needed for a call to connect, the number is not considered possible without it. Arguments: numobj -- the number object that needs to be checked Returns True if the number is possible )is_possible_number_with_reasonrrr)rresults rUis_possible_numberr s3",F 3 3F &2 2 > &= =?rWcbt||}|tjkp|tjkS)aConvenience wrapper around is_possible_number_for_type_with_reason. Instead of returning the reason for failure, this method returns true if the number is either a possible fully-qualified number (containing the area code and country code), or if the number could be a possible local number (with a country code, but missing an area code). Local numbers are considered possible if they could be possibly dialled in this format: if the area code is needed for a call to connect, the number is not considered possible without it. Arguments: numobj -- the number object that needs to be checked numtype -- the type we are interested in Returns True if the number is possible )'is_possible_number_for_type_with_reasonrrr)rr1rs rUis_possible_number_for_typer4 s5$5VW E EF &2 2 > &= =?rWct||}||jj}d}n-|j}t|dkr |jj}|j}|t jkrtt|t jst||t j St|t j }t|rt|}t|jdkr||jjz }n ||jz }t |t|dkr|j}n3t|}||jz }t || tjSt|}||vr tjS|d}||kr tjS||kr tjS|d|kr tjS||ddvr tjStjS)zHelper method to check a number against possible lengths for this number, and determine whether it matches, or is too short or too long. NrOrrr)r/rr&rpossible_length_local_onlyrrr)rrorrsortrrrrrr) rKrr1 desc_for_typer local_lengths mobile_descrminimum_lengths rUroroK s)7;;M#0@ )8  A % %'4D %@ /666-.B8_Mg.h.hii -'/BXYY Y.x9OPPK-k:: -#'(8#9#9 {233q88$(=(MM$$$ (CC$ *+++}%%**$/$JMM$($7$7M![%KKMIIm,,,..((M %%66%a(N&&++ - ' ')) "  - -(((,,,++..rWc6t|tjSr)rrrr?s rUrr s 26?;R S SSrWct|}|j}t|s tjSt |}t j||}t|||S)aCheck whether a phone number is a possible number of a particular type. For types that don't exist in a particular region, this will return a result that isn't so useful; it is recommended that you use supported_types_for_region or supported_types_for_non_geo_entity respectively before calling this method to determine whether you should call it for this number at all. This provides a more lenient check than is_valid_number in the following sense: - It only checks the length of phone numbers. In particular, it doesn't check starting digits of the number. - For some numbers (particularly fixed-line), many regions have the concept of area code, which together with subscriber number constitute the national significant number. It is sometimes okay to dial only the subscriber number when dialing in the same area. This function will return IS_POSSIBLE_LOCAL_ONLY if the subscriber-number-only version is passed in. On the other hand, because is_valid_number validates using information on both starting digits (for fixed line numbers, that would most likely be area codes) and length (obviously includes the length of area codes for fixed line numbers), it will return false for the subscriber-number-only version. Arguments: numobj -- The number object that needs to be checked numtype -- The type we are interested in Returns a value from ValidationResult which indicates whether the number is possible ) rMrrHrrrOrrPro)rr1rKrr6rs rUrr sf@2&99O&L +< 8 8544.|<wxYwd|fS)aExtracts country calling code from number. Returns a 2-tuple of (country_calling_code, rest_of_number). It assumes that the leading plus sign or IDD has already been removed. Returns (0, number) if number doesn't start with a valid country calling code. rrN)rrrmin_MAX_LENGTH_COUNTRY_CODEintrr)rrrs rU_extract_country_coder s 6{{a6!9..6{As3v;;(@AAAEFF vcrc{++L:::$fRSSk2222;    D  v;s+B BBcZt|dkr dtfS|}td}||j|j}t ||\}}|r||_|t jkrot|tkrttj dt|\}}|dkr ||_ ||fSttj d||j } t|j } |} | | r|t| d} |j} t#| |\}} }t%|| dst%| | dst'||t(jkr|rt j|_| |_ | | fSd|_ dtfS)aTries to extract a country calling code from a number. This method will return zero if no country calling code is considered to be present. Country calling codes are extracted in the following ways: - by stripping the international dialing prefix of the region the person is dialing from, if this is present in the number, and looking at the next digits - by stripping the '+' sign if present and then looking at the next digits - by comparing the start of the number and the country calling code of the default region. If the number is not considered possible for the numbering plan of the default region initially, but starts with the country calling code of this region, validation will be reattempted after stripping this country calling code. If this number is considered a possible number, then the first digits will be considered the country calling code and removed as such. It will raise a NumberParseException if the number starts with a '+' but the country calling code supplied after this does not match that of any known region. Arguments: number -- non-normalized telephone number that we wish to extract a country calling code from; may begin with '+' metadata -- metadata about the region this number may be from, or None keep_raw_input -- True if the country_code_source and preferred_carrier_code fields of numobj should be populated. numobj -- The PhoneNumber object where the country_code and country_code_source need to be populated. Note the country_code is always populated, whereas country_code_source is only populated when keep_raw_input is True. Returns a 2-tuple containing: - the country calling code extracted or 0 if none could be extracted - a string holding the national significant number, in the case that a country calling code was extracted. If no country calling code was extracted, this will be empty. rNonMatchNzXPhone number had an IDD, but after this was not long enough to be a viable phone number.z1Country calling code supplied was not recognised.F)rr rrz&_maybe_strip_i18n_prefix_and_normalizerrFROM_DEFAULT_COUNTRYrrTOO_SHORT_AFTER_IDDrrrrrr)_maybe_strip_national_prefix_carrier_coderrorrr)rrkeep_raw_inputr full_numberpossible_country_idd_prefixrpotential_country_coderest_of_numberdefault_country_codedefault_country_code_strrpotential_national_numberr_s rU_maybe_extract_country_coder) sT 6{{a>""K"("4"4 = I&.&C#'MkNi(k(k$9%8"/DDD {  2 2 2&';'O(RSS S2G{1S1S. !Q & &"8F *N; ;##7#L#VXX X   (4#&x'<#=#= '  ' '(@ A A I(3C8P4Q4Q4R4R(S %#0L.WXqX`/b/b +A(!,KuMM I'(AS[[A--5#))&11 =5 4rWc,t|dkr||dtkrmd|_d}|t|dz kr=||tkr,|dz }|t|dz kr||tk,|dkr ||_dSdSdSdS)zRA helper function to set the values related to leading zeros in a PhoneNumber.rrTN)rrrr)rKrrs rU+_set_italian_leading_zeros_for_phone_numberrI) s ?aOA$6&$@$@&*#"#'_)=)=)AAA676AA #q ( #'_)=)=)AAA676AA "a ' '-DF * * * $@$@ ( 'rWc|t}|ttjdt|tkrttjdt |}t|sttjd|r*t||sttj d|r||_ t|\}}t|dkr||_ |d}n'tj|d}d} t!||||\}} n#t$rt#j\} } } t&|} | jtj krR| Pt!|| d|||\}} |dkrttj dnYnwxYw|dkr/t/|} | |krtj|| }|Jn6| t3|z } ||j}||_n|rt6j|_t| t<krttjd|k| }tA||\}}} tC||}|tDj#tDj$tDj%fvr |} |r|t|dkr||_&t| }|t<krttjd|tNkrttjd tQ| |tS| |_*|S) a Parse a string and return a corresponding PhoneNumber object. The method is quite lenient and looks for a number in the input text (raw input) and does not check whether the string is definitely only a phone number. To do this, it ignores punctuation and white-space, as well as any text before the number (e.g. a leading "Tel: ") and trims the non-number bits. It will accept a number in any format (E164, national, international etc), assuming it can be interpreted with the defaultRegion supplied. It also attempts to convert any alpha characters into digits if it thinks this is a vanity number of the type "1800 MICROSOFT". This method will throw a NumberParseException if the number is not considered to be a possible number. Note that validation of whether the number is actually a valid number for a particular region is not performed. This can be done separately with is_valid_number. Note this method canonicalizes the phone number such that different representations can be easily compared, no matter what form it was originally entered in (e.g. national, international). If you want to record context about the number being parsed, such as the raw input that was entered, how the country code was derived etc. then ensure keep_raw_input is set. Note if any new field is added to this method that should always be filled in, even when keep_raw_input is False, it should also be handled in the _copy_core_fields_only() function. Arguments: number -- The number that we are attempting to parse. This can contain formatting such as +, ( and -, as well as a phone number extension. It can also be provided in RFC3966 format. region -- The region that we are expecting the number to be from. This is only used if the number being parsed is not written in international format. The country_code for the number in this case would be stored as that of the default region supplied. If the number is guaranteed to start with a '+' followed by the country calling code, then None or UNKNOWN_REGION can be supplied. keep_raw_input -- Whether to populate the raw_input field of the PhoneNumber object with number (as well as the country_code_source field). numobj -- An optional existing PhoneNumber object to receive the parsing results _check_region -- Whether to check the supplied region parameter; should always be True for external callers. Returns a PhoneNumber object filled with the parse number. Raises: NumberParseException if the string is not considered to be a viable phone number (e.g. too few or too many digits) or if no default region was supplied and the number is not in international format (does not start with +). Nz#The phone number supplied was None.z*The string supplied was too long to parse.z6The string supplied did not seem to be a phone number.z"Missing or invalid default region.rz,Could not interpret numbers after plus-sign.z6The string supplied is too short to be a phone number.z5The string supplied is too long to be a phone number.)+rrrr_MAX_INPUT_STRING_LENGTHr"_build_national_number_for_parsingrrGrrLrr rrrr)sysexc_infor4r error_typer+rOrPrrrrrr TOO_SHORT_NSNrrorrrrrf_MAX_LENGTH_FOR_NSNrIr rK)rregionr r _check_regionrKr rrnormalized_national_numberr(ematchobj number_regionr'rcrlen_national_numbers rUrr8 st~ ~"#7#D#HJJ J V/ / /"#7#@#OQQ Q9@@O "? 3 3]"#7#D#[]] ] I6OOI"#7#L#GII I"!"8!H!HI 9~~$ ~ 4V\\^^TJJL3NOWO]OU4W4W0 00 ,..1a&,,_== L0E E E  7RSbckcococqcqcrcrSsS[SaSY8[8[ 4L4q  *+?+T+Y[[[!  !  q4\BB F " "$HWdeeH''' #j&A&AA"  #0L".F    G):)FF & %&&)<<<"#7#E#[]] ]$>!5^_x_g6i6i2 / 00I8TT %5%?%5%L%5%D%F F F*C & F,":s">(?1(D(D&=s??S?S%S%SKL !6":;Q"QRR36:: $(()ABBMq).=.9 rWct}|j|_|j|_|j$t |jdkr |j|_|jr!d|_|j|_|jd|_|S)zReturns a new phone number containing only the fields needed to uniquely identify a phone number, rather than any fields that capture the context in which the phone number was created. NrTr)rrrKr rrr)inobjrs rU_copy_core_fields_onlyrm, s} ]]F,F"2F "s5?';';a'?'? ? !/&*#).)F&  ) 1-.F * MrWct|}t|}|j#|j|j|jkr tjS|j}|j}|dkrF|dkr@||kr tjS||krt ||r tjStjS||_||kr tjSt ||r tjStjS)z>Takes two phone number objects and compares them for equality.Nr) rmr rrrr#_is_national_number_suffix_of_otherrr) numobj1_in numobj2_innumobj1numobj2 country_code1 country_code2s rU_is_number_match_OOrv@ s%Z00G$Z00G %%W...!!(M(Mmq00 g  ( (},,1'7CC- , ,!! )G'""*7G<<)((  rWct|j}t|j}||p||S)z_Returns true when one national number is the suffix of the other or both are the same. )rrKendswith)rrrsnn1nn2s rUroroh sG g% & &C g% & &C <<   1 S 1 11rWc ` t|t}t||S#t$rt j\}}}|jtjkr t|t}t||cYS#t$rt j\}}}|jtjkr] t|dddd}t|dddd}t||cYcYS#t$rtj cYcYcYSwxYwYnwxYwYnwxYwtj S)zTakes two phone numbers as strings and compares them for equality. This is a convenience wrapper for _is_number_match_OO/_is_number_match_OS. No default region is known. NFr rSr) rr_is_number_match_OSrrMrNrOrrvrr)number1number2rrr(excrsexc2s rU_is_number_match_SSrr s{ 600"7G444 666LNN 3 >1F F F 688*7G<<<<<' 6 6 6 \^^ 4?&:&OOO6"'e6;D#J#J#J"'e6;D#J#J#J27GDDDDDDD/666(555555556PO 6 6(  !!sc$'6D!$BD!6D<7C83D4D!8DDD!DDD!DD! D!c* t|t}t||S#t$rt j\}}}|jtjkrt|j } |tkrBt||}t||}|tj krtj cYS|cYSt|dddd}t||cYS#t$rtj cYcYSwxYwYnwxYwtj S)zaWrapper variant of _is_number_match_OO that copes with one PhoneNumber object and one string.NFr|)rrrvrrMrNrOrrOrrrrr)rrrrsr(rregion1rs rUr}r} sG .00"7G444 ...LNN 3 >1F F F 373GHHG .n,,#GW55G/AAE 555(2222$ $GT%27FFFG.w@@@@@' . . . ------ .+ G F.6  !!sM$'A D2AC%8D;C%<D?#C%"D%D;D?DDDc*t|tr%t|trt||St|trt||St|trt||St ||S)aCTakes two phone numbers and compares them for equality. For example, the numbers +1 345 657 1234 and 657 1234 are a SHORT_NSN_MATCH. The numbers +1 345 657 1234 and 345 657 are a NO_MATCH. Arguments num1 -- First number object or string to compare. Can contain formatting, and can have country calling code specified with + at the start. num2 -- Second number object or string to compare. Can contain formatting, and can have country calling code specified with + at the start. Returns: - EXACT_MATCH if the country_code, NSN, presence of a leading zero for Italian numbers and any extension present are the same. - NSN_MATCH if either or both has no region specified, and the NSNs and extensions are the same. - SHORT_NSN_MATCH if either or both has no region specified, or the region specified is the same, and one NSN could be a shorter version of the other number. This includes the case where one has an extension specified, and the other does not. - NO_MATCH otherwise. ) isinstancerrvr}r)num1num2s rUis_number_matchr s.$ $$/D+)F)F/"4... D+ & &/"4... D+ & &/"4..."4...rWctjt|d}|dSt|}t ||j S)aReturns True if the number can only be dialled from outside the region, or unknown. If the number can only be dialled from within the region as well, returns False. Does not check the number is a valid number. Note that, at the moment, this method does not handle short numbers (which are currently all presumed to not be diallable from outside their country). Arguments: numobj -- the phone number objectfor which we want to know whether it is diallable from outside the region. NT)rrrrMrno_international_dialling)rrrs rUrnrn sP01G1O1OQUVVHt %f - -C'X-OPP PPrWcBtj|d}|dS|jS)aAReturns true if the supplied region supports mobile number portability. Returns false for invalid, unknown or regions that don't support mobile number portability. Arguments: region_code -- the region for which we want to know whether it supports mobile number portability or not. NF)rrmobile_number_portable_regionr5s rU is_mobile_number_portable_regionr s*0dCCHu  11rWc8eZdZdZdZdZdZdZdZdZ dZ d Z d S) rz:Exception when attempting to parse a putative phone numberrrrrrcXt||||_||_dSr)r__init__rO_msg)selfrOmsgs rUrzNumberParseException.__init__ s*4%%%$ rWc<t||j|jffSr)typerOrrs rU __reduce__zNumberParseException.__reduce__% sT T_di899rWc>td|j|jfzS)Nz(%s) %s)rrOrrs rU __unicode__z NumberParseException.__unicode__( si  DOTY#???rWN) rrrrrrrrPrrrrrOrWrUrr sqDD L MH :::@@@@@rWrc||jt|jdkrdSt|tj|j|S)zReturns whether the given national number (a string containing only decimal digits) matches the national number pattern defined in the given PhoneNumberDesc object. NrF)r,r_matchr r)rrallow_prefix_matchs rUrr, sN kAISQ\QtMuMuyzMzMzu &"*[%HIIK] ^ ^^rWcX||sdSt||rdS|S)NFT)rr)rrrs rUrr7 s8 == &u Wf % % &4% %rW)Fr)NFNT)rrMr re_utilrutilrrrrr r r r r rr unicode_utilrr phonenumberrr phonemetadatarrrdatar ImportErrorospathbasenameargvstderrrUNICODE IGNORECASE _REGEX_FLAGSrrQrrKrrr frozensetrrr"rBr _STAR_SIGNrirr[rg_ASCII_DIGITS_MAP_ALPHA_MAPPINGSdictrrr#rrr|_VALID_PUNCTUATIONrar _VALID_ALPHA _PLUS_CHARSr4rr,_VALID_START_CHARr_SECOND_NUMBER_STARTr_UNWANTED_END_CHARSrr_VALID_PHONE_NUMBERrrcr~_EXTN_PATTERNS_FOR_PARSING_EXTN_PATTERNS_FOR_MATCHING_RFC3966_VISUAL_SEPARATOR_RFC3966_PHONE_DIGIT_RFC3966_GLOBAL_NUMBER_DIGITSrb _ALPHANUM_RFC3966_DOMAINLABEL_RFC3966_TOPLABEL_RFC3966_DOMAINNAMErcrDrrrrYrZrr<objectrrrrrrrrrrrrrrrrrrrr$r)r-r2r7r:r=r@rr4rHr rardrhrvrrrrrrrMrNrQrWr[r+rrrrrRr/rrrrtrrrrOrrryrrxrrrrrorrrrrr)r2rrrrGrIrr`rerLrmrvrorr}rrnrrrrrrOrWrUrso  4 88888888888888OOOOOOOOOOOOOOOO00000087777777VVVVVVVVVV 2222222   III !%%)BBB !%%)===  PWZWabbbb()7|$$  %$ ;zBM) 4 aaff 3<)= 3 3 /6?Y@ 6 6 2H##OK K   QsVV QsVV qzz!F)),--1X;;QsVVQQsVVQQsVVQQsVVQsVVQQsVVQQsVVQQsVVQsVVQQsVVQQsVVQQsVVQsVVQQsVVQQsVVQQsVVQsVVQQsVVQQsVVQQsVV 5%11S6611S66%1S6611S66%1S6611S66%1S6611S66%1S6611S66 % 1S6611S66 % 1S6611S66 %1S6611S66%1S6611S66%1S6611S66%1S6611S66%1S6611S66%1S6611S66%1S6611S66%1S6611S66%1S6611S66% 1S6611S66!%"1S6611S661S6611S661S6611S661S6611S661S6611S661S6611S661S6611S661S6611S661S6611S663%%6_BB0ABB  4Z!"33!"33!155#455%)D*?!!C&&!!C&&*?*+!H++qqvv*?*+!H++qqvv*?+,!H++qqvv*?+,!H++qqvv *? +,!H++qqvv *? +,!H++qqvv *?+,!H++qqvv*?+,!H++qqvv*?+,!C&&!!C&&*?+,!H++qqvv*?+,!C&&!!C&&*?+,!H++qqvv*?+,!H++qqvv*?+,!C&&!!C&&*?+,!H++qqvv*?%F%F$,040c0cOL`L`LbLb0c0c0c0[0[ODXDXDZDZ0[0[0[1\,E,E2C,E,E%%F%F!8 *rz!!,T*U*UVVaCDDamnno &--$#O$8$8$:$:;;##$Q$Q/:N:N:P:P$Q$Q$QRRS a ll  bj3+!5$!?@@RZ#); ;aagg EFF%2:aaffw&63&?LLAcFF[(72QQsVV;&BJ'8"*EEq)rz*>??&a-..'RZ(;<< (RZ*@(A(ABB&!!F)).A"ABQQsVVKqvv +,./akk:OORYY(bj)<== 11U88&@@11T77JLYY )bj)#> #+#+#+#+#+#+#+#+LJ+J+J+J+J+fJ+J+J+Z + + + + + + + +F'+'+'+'+'+v'+'+'+VCEE$'CEE! L L L   !!!H*---80 E E ECCC B7B7B7JA!A!A!H D D D2224 3 3 3KKK 8 8 8    3 3 3 3 3 3 <<<QQQ 2 2 2...AAA4F4F4Fn>>>B%%%PJJJDj@j@j@ZNNNb'''T4X4X4Xn$###oood4    ____2   ,0,%,%,%,%^ L L L===@>84   %%%6:::"!#!#!#H G G G;;;*!K!K!KHBBB2*$    6 6 6 !!!"   F)))HHH(???,???.B*```F.$@$@$@N;-;-;-|8    E E E/4%)____D<<<. C C C,,,^(%%%P222"""@#"#"#"L///BQQQ. 2 2 2*@*@*@*@*@<*@*@*@Z___&&&&&sAA3CC