jdUddlmZddlZddlmZddlmZddlmZddl m Z m Z m Z m Z ddlmZmZmZmZmZdd lmZdd lmZmZdd lmZmZmZmZmZmZej d Z!ej"Z#e#$ej%d e&edZ'de(d< d3d4d)Z) d3d5d,Z* d3d6d/Z+ d7d8d2Z,dS)9) annotationsN) lru_cache)PathLike)BinaryIO)coherence_ratioencoding_languagesmb_encoding_languagesmerge_coherence_ratios)IANA_SUPPORTEDIANA_SUPPORTED_SIMILARTOO_BIG_SEQUENCETOO_SMALL_SEQUENCETRACE) mess_ratio) CharsetMatchCharsetMatches)any_specified_encodingcut_sequence_chunks iana_nameidentify_sig_or_bomis_multi_byte_encodingshould_strip_sig_or_bomcharset_normalizerz)%(asctime)s | %(levelname)s | %(message)sc"t| SN)rencodings DC:\Projects\DSCons\.venv\Lib\site-packages\charset_normalizer\api.pyr .s-CH-M-M)M)keyz list[str]IANA_SUPPORTED_MB_FIRST皙?TF皙? sequencesbytes | bytearraystepsint chunk_size thresholdfloat cp_isolationlist[str] | None cp_exclusionpreemptive_behaviourboolexplainlanguage_thresholdenable_fallbackreturnrc  t|ttfs/tdt ||rJt j} t tt tt|} | dkrwt d|r9t tt | tt!|dddgdgS|At td d |d |D}ng}|At td d |d |D}ng}| ||zkr't td||| d}| }|dkr| |z |krt'| |z }t|t(k} t|t*k} | r"t td| n#| r!t td| g}|rt-|nd}|6||t td|t1}g}g}t1}t3dt4}t3dt6}d}t1}d}d}d}d}d}d}t}t}t9|\} }!| E|d| t tdt|!| |dd|vr|d|t<zD ]}"|r|"|vr |r|"|vr|"|vr||"d}#| |"k}$|$otA|"}%|"dvr$|$s"t td|"l|"dvr$|$s"t td|"|"|vr"t td|" tC|"}&n8#tDtFf$r$t td|"YwxYw|ru|&st1tI|"}'nt1tK|"}'|'&|s%t td|"|'|z|r-|&s+||kr%t td|"|||r%|&s#t td|"|& o| }( | rO|&sMtO|%s|dt'd n#|t|!t'd |"!n^|(s\|"d"kr,|$r*tO||"!}#|#r|#dd#kr |#dd}#n*tO|%s|n|t|!d|"!}#nx#tPtRf$rd})t|)tRs/t td$|"tO|)||"Yd})~)d})~)wwxYwtU|$sdnt|!| t'| |z }*|&o|#duot|#| k}+|+r!t td%|"t't|*d&z },tW|,d'},d}-d}.g}/g}0 tY||"|*||$|%|!|&|#|( D]q}1|/|1|0||1||odt|cxkod'knc|0d(|kr|-dz }-|-|,ks|$r|%snrn#tPtRf$r})|(rJt td$|"tO|)||"Yd})~)t td)|"tO|)|,}-d*}.Yd})~)nd})~)wwxYw|0rt[|0t|0z nd}2|.s| r|&s|2|kr|-|,kr |t'd+d.|"d,-n\#tP$rO})t td.|"tO|)||"Yd})~)d})~)wwxYw|2|ks|-|,kr||"|"t^vr |0t^|"t td/|"|-tc|2d0zd12| r|"dd|d3d4fvr|.s|#i tO|%s|n|t|!d|"!}#n9#tPtRf$r%t td5|"Y|wxYw| rd}#t!||"||$g|#|6}3|"|kr|3}n |"dkr|3}n|3}|(r tO|%s|n|t|!d|"!}#nc#tPtRf$rO})t td$|"tO|)||"Yd})~)9d})~)wwxYwt td7|"tc|2d0zd12|&stI|"}4ntK|"}4|4r"t td8|"|4g}5|"dkr@|4rd9|4nd}6|/D]$}1||1||6}7|5|7%te|5}8|8r"t td:|8|"t!||"|2|$|8| r|"|ddfvr|#nd|6}9||9|r |&s |2d;kr|dz }|"|ddfvr|2d|8Dd?nd};|;d@krBd|vr>d|vr:d*}|0|4t tdA|"|2|;|so|&rm|+rk|#it|#| dBzkrS|"dCvrOd|vrKd|vrGd*}t tdD|"|2t|#| t|#| z d0z|"| krnt dE|"|r9t tt | t||"gcS t|dkr|s|s|r t tdF|r6t dG|j3||n{|r||r|r|j5|j5ks|0t dH||n1|r/t dI|||rDt dJ|4j3t|dz nt dK|r9t tt | |S)Laf Given a raw bytes sequence, return the best possibles charset usable to render str objects. If there is no results, it is a strong indicator that the source is binary/not text. By default, the process will extract 5 blocks of 512o each to assess the mess and coherence of a given sequence. And will give up a particular code page after 20% of measured mess. Those criteria are customizable at will. The preemptive behavior DOES NOT replace the traditional detection workflow, it prioritize a particular code page but never take it for granted. Can improve the performance. You may want to focus your attention to some code page or/and not others, use cp_isolation and cp_exclusion for that purpose. This function will strip the SIG in the payload/sequence every time except on UTF-16, UTF-32. By default the library does not setup any handler other than the NullHandler, if you choose to set the 'explain' toggle to True it will alter the logger configuration to add a StreamHandler that is suitable for debugging. Custom logging format and handler can be set manually. z3Expected object of type bytes or bytearray, got: {}rzzfrom_bytes..l"DDD "e,,DDDr!zacp_exclusion is set. use this flag for debugging purpose. limited list of encoding excluded : %s.c.g|]}t|dSr<r=r>s rrAzfrom_bytes..wrBr!z^override steps (%i) and chunk_size (%i) as content does not fit (%i byte(s) given) parameters.rz>Trying to detect encoding from a tiny portion of (%i) byte(s).zIUsing lazy str decoding because the payload is quite large, (%i) byte(s).z@Detected declarative mark in sequence. Priority +1 given for %s.)maxsizezIDetected a SIG or BOM mark on first %i byte(s). Priority +1 given for %s.ascii>utf_16utf_32z\Encoding %s won't be tested as-is because it require a BOM. Will try some sub-encoder LE/BE.>utf_7zREncoding %s won't be tested as-is because detection is unreliable without BOM/SIG.zY%s is deemed too similar to a code page that was already considered unsuited. Continuing!z2Encoding %s does not provide an IncrementalDecoderzbSkipping %s: definitive match already found, this encoding targets different languages (%s vs %s).zXSkipping %s: already accumulated %d same-family results after definitive match (cap=%d).zCSkipping single-byte %s: multi-byte definitive match already found.gArrIuz9Code page %s does not fit given bytes sequence at ALL. %szpCode page %s is a multi byte encoding table and it appear that at least one character was encoded using n-bytes.zaLazyStr Loading: After MD chunk decode, code page %s does not fit given bytes sequence at ALL. %sTgj@strict)errorsz^LazyStr Loading: After final lookup, code page %s does not fit given bytes sequence at ALL. %szc%s was excluded because of initial chaos probing. Gave up %i time(s). Computed mean chaos is %f %%.d)ndigitsrGrHz>%s does not decode the whole payload: fallback entry withheld.)preemptive_declarationz=%s passed initial chaos probing. Mean measured chaos is %f %%z&%s should target any language(s) of %s,z We detected language %s using %sg{Gz?r'z.Encoding detection: %s is most likely the one.c3 K|] \}}|V dSr)r?_vs r zfrom_bytes..s&4441aQ444444r!)defaultg?zyDefinitive match found: %s (chaos=%.3f, coherence=%.2f). Encodings targeting different language families will be skipped.g\(\?> rIr9rGrH utf_16_be utf_16_le utf_32_be utf_32_le utf_8_sigzjMulti-byte definitive match: %s (chaos=%.3f, decoded=%d/%d=%.1f%%). Single-byte encodings will be skipped.zoEncoding detection: %s is most likely the one as we detected a BOM or SIG within the beginning of the sequence.zONothing got out of the detection process. Using ASCII/UTF-8/Specified fallback.z7Encoding detection: %s will be used as a fallback matchz:Encoding detection: utf_8 will be used as a fallback matchz:Encoding detection: ascii will be used as a fallback matchz]Encoding detection: Found %s as plausible (best-candidate) for content. With %i alternatives.z=Encoding detection: Unable to determine any suitable charset.)6 isinstance bytearraybytes TypeErrorformattypeloggerlevel addHandlerexplain_handlersetLevelrlendebug removeHandlerrrlogjoinr+rrrappendsetrrrrinsertr#addrrModuleNotFoundError ImportErrorr r intersectionstrUnicodeDecodeError LookupErrorrangemaxrsumdecoder updateroundr rbest fingerprint) >L+$$Q 555  W          )))+++$$W---.1HHV<V<  M==   M\99  F " "  =!!!&*%1]%B!5" :Q ; ;  0 0 09M 0 JJn     I % %.B % JJd     - - - JJk     *@*O*O ! !#[1    JJD    H   " ( J #$6}$E$E F F #$9-$H$H I I  --.IJJ  x!!/  # ) 14JJJ JJj0&      % -B  JJU    & % C.C*C * $ -B  0E +CII+..&s;'7'7#d))'CD* ' !G++0D+&)!!.'''O'>?1+=+I+I*9!""*=&)$4?II!*3{+;+;+=+=!>!. '''O#K0   a--  O!FF  $ * *= 9 9 9 HHHH ) ?AAs;/?/?       " .t+ .O$$v-    JJ-    "%SWWq[!1!1 1155 ! %!  5 ),$ %!      '''  %%!?A\):):$?$?$?$?a$?$?$?$?R=I--$)$$(999(:1A:E    ) ) )!  O!FF  (..}=== JJsA     1 $( ! ! ! ! ! !/ )2EN!VY#i..!@!@SV & % *  )++ #444 #d))++&--mH-MMMM%    t!FF  (..}===  i ' '+;?P+P+P # * *= 9 9 9 666!(()? )NOOO JJ0 o+Q777     - 1!W&8(HMNN-N#*!*-(8!C %.s;/?/?/A/A%B%2 +++/ <!!! !\) ! !-/*.!-!(#+="""!$666)7&&"g--%3NN"0K    "% 0; &s;'7'7'9'9:* ###' 4    O!FF  (..}===    K  /C' 3 3 3    % D*<]*K*K  4]CC    JJ8      G # #/?H)***D # 2 2"8"8& ##   11111)<<   JJ2     %    .%);Wg(NNN  #5   " }%%% # 2) 2 $&& , 1 , 0'7C C C#%%#%% D!*;((999OO$9:::%}o66666  % %m 4 4 4 " # # 5#+/AV/K/K6!!6!!05577O"... LL@(    7$$_555 5666!?"344 4 4 4& .C $44#3444cBBBB  $$F):):w&?P?P)-&+223CDDD P!#" * % !  +O$$v}44   6!!6!!(, % JJ|O$$O$$v-3    L ( ( LL1     7$$_555 5666!7=#9":;; ; ; ; ) 7||q  . ,>  JJa     + LLI"+    NN- . . . .  ++34#4 +~/III' LLU V V V NN; ' ' ' '  + LLU V V V NN> * * *V k LLNN # LL1      TUUU/_----... Ns#R332S('S(?B/Y//[$A[[$ B `b2)Ab-53b--b2+,d e1"Ae,,e1*h//2i%$i%*kl&Al!!l&fprc Vt|||||||||| S)z Same thing than the function from_bytes but using a file pointer that is already ready. Will not close the file pointer. )rread) rr*r,r-r/r1r2r4r5r6s rfrom_fpr*s<       r!pathstr | bytes | PathLikec t|d5} t| ||||||||| cdddS#1swxYwYdS)z Same thing than the function from_bytes but with one extra step. Opening and reading given file path in binary mode. Can raise IOError. rbN)openr) rr*r,r-r/r1r2r4r5r6rs r from_pathrHs dD    R                               s 6::fp_or_path_or_payload!PathLike | str | BinaryIO | bytesc t|ttfrt||||||||||  } nOt|tt frt ||||||||||  } nt||||||||||  } | S)a) Detect if the given input (file, bytes, or path) points to a binary file. aka. not a string. Based on the same main heuristic algorithms and default kwargs at the sole exception that fallbacks match are disabled to be stricter around ASCII-compatible but unlikely to be a string. ) r*r,r-r/r1r2r4r5r6)r_rvrrrar`rr) rr*r,r-r/r1r2r4r5r6guessess r is_binaryrgs"'#x99,  !!%%!51+            !!%%!51+     !!%%!51+    ;r!) r$r%r&NNTFr'T)r(r)r*r+r,r+r-r.r/r0r1r0r2r3r4r3r5r.r6r3r7r)rrr*r+r,r+r-r.r/r0r1r0r2r3r4r3r5r.r6r3r7r)rrr*r+r,r+r-r.r/r0r1r0r2r3r4r3r5r.r6r3r7r) r$r%r&NNTFr'F)rrr*r+r,r+r-r.r/r0r1r0r2r3r4r3r5r.r6r3r7r3)- __future__rlogging functoolsrosrtypingrcdrr r r constantr r rrrmdrmodelsrrutilsrrrrrr getLoggerre StreamHandlerrh setFormatter Formattersortedr#__annotations__rrrrrUr!rrs""""""" 00000000  / 0 0'''))GABB&,VMM&&&%)%)!% # u u u u u t%)%)!% # @%)%)!% #      B%)%)!% #!???????r!