
    *pj                    x   % S SK Jr  S SKrS SKJr  S SKJr  S SKJr  SSK	J
r
JrJrJr  SSKJrJrJrJrJr  SS	KJr  SS
KJrJr  SSKJrJrJrJrJrJr  \R@                  " S5      r!\RD                  " 5       r#\#RI                  \RJ                  " S5      5        \&" \S S9r'S\(S'            S                     SS jjr)         S                     SS jjr*         S                     SS jjr+         S                     SS jjr,g)    )annotationsN)	lru_cache)PathLike)BinaryIO   )coherence_ratioencoding_languagesmb_encoding_languagesmerge_coherence_ratios)IANA_SUPPORTEDIANA_SUPPORTED_SIMILARTOO_BIG_SEQUENCETOO_SMALL_SEQUENCETRACE)
mess_ratio)CharsetMatchCharsetMatches)any_specified_encodingcut_sequence_chunks	iana_nameidentify_sig_or_bomis_multi_byte_encodingshould_strip_sig_or_bomcharset_normalizerz)%(asctime)s | %(levelname)s | %(message)sc                "    [        U 5      (       + $ N)r   encodings    R/var/www/html/pdf-tiff/venv/lib/python3.13/site-packages/charset_normalizer/api.py<lambda>r    .   s    -CH-M)M    )keyz	list[str]IANA_SUPPORTED_MB_FIRSTc
                   [        U [        [        45      (       d#  [        SR	                  [        U 5      5      5      eU(       aB  [        R                  n
[        R                  [        5        [        R                  [        5        [        U 5      nUS:X  ad  [        R                  S5        U(       a.  [        R                  [        5        [        R                  W
5        [        [!        U SSS/ S5      /5      $ UbG  [        R#                  [        S	S
R%                  U5      5        U Vs/ s H  n['        US5      PM     nnO/ nUbG  [        R#                  [        SS
R%                  U5      5        U Vs/ s H  n['        US5      PM     nnO/ nXU-  ::  a!  [        R#                  [        SUUU5        SnUnUS:  a  X-  U:  a  [)        X-  5      n[        U 5      [*        :  n[        U 5      [,        :  nU(       a  [        R#                  [        SU5        O"U(       a  [        R#                  [        SU5        / nU(       a  [/        U 5      OSnUb,  UR1                  U5        [        R#                  [        SU5        [3        5       n/ n/ n[3        5       n[5        SS9" [6        5      n[5        SS9" [8        5      nSn[3        5       nSnSnSnSnSnSn[        5       n[        5       n [;        U 5      u  n!n"U!b7  UR=                  SU!5        [        R#                  [        S[        U"5      U!5        UR1                  S5        SU;  a  UR1                  S5        U[>        -    GHb  n#U(       a  U#U;  a  M  U(       a  U#U;   a  M"  U#U;   a  M*  URA                  U#5        Sn$U!U#:H  n%U%=(       a    [C        U#5      n&U#S;   a$  U%(       d  [        R#                  [        SU#5        M  U#S;   a$  U%(       d  [        R#                  [        SU#5        M  U#U;   a  [        R#                  [        SU#5        M   [E        U#5      n'U(       af  U'(       d  [3        [K        U#5      5      n(O[3        [M        U#5      5      n(U(RO                  U5      (       d   [        R#                  [        SU#U(U5        GMF  U(       a-  U'(       d&  UU:  a   [        R#                  [        SU#UU5        GMz  U(       a%  U'(       d  [        R#                  [        SU#5        GM  U'(       + =(       a    U(       + n) U(       a<  U'(       d5  [Q        U&(       d  U S[)        S5       OU [        U"5      [)        S5       U#S9  OSU)(       dL  U#S :X  a'  U%(       a   [Q        U U#S9n$U$(       a  U$S   S!:X  a  U$SS n$O[Q        U&(       d  U OU [        U"5      S U#S9n$[W        U%(       d  SO
[        U"5      U[)        X-  5      5      n+U'=(       a    U$SL=(       a    [        U$5      U:  n,U,(       a  [        R#                  [        S#U#5        [)        [        U+5      S$-  5      n-[Y        U-S%5      n-Sn.Sn// n0/ n1 [[        U U#U+UU%U&U"U'U$U)5
       Hx  n2U0R1                  U25        U1R1                  U" U2UU=(       a    S[        U5      s=:*  =(       a    S%:*  Os  5      5        U1S&   U:  a  U.S-  n.U.U-:  d  U%(       d  Mo  U&(       a  Mx    O    U1(       a  []        U15      [        U15      -  OSn3U/(       d7  U(       a0  U'(       d)  U3U:  a#  U.U-:  a   U [)        S)5      S R_                  U#S*S+9  U3U:  d  U.U-:  a  UR1                  U#5        U#[`        ;   a  URc                  [`        U#   5        [        R#                  [        S-U#U.[e        U3S.-  S/S095        U	(       aa  U#SSUS1S24;   aV  U/(       dO  U$c)   [Q        U&(       d  U OU [        U"5      S U#S9n$U(       a  Sn$[!        U U#UU%/ U$US49n4U#U:X  a  U4nOU#S:X  a  U4nOU4nGM  U)(       a    [Q        U&(       d  U OU [        U"5      S U#S9n$[        R#                  [        S5U#[e        U3S.-  S/S095        U'(       d  [K        U#5      n5O[M        U#5      n5U5(       a  [        R#                  [        S6U#U55        / n6U#S:w  a>  U5(       a  S7R%                  U55      OSn7U0 H  n2U" U2UU75      n8U6R1                  U85        M      [g        U65      n9U9(       a  [        R#                  [        S8U9U#5        [!        U U#U3U%U9U(       a	  U#USS4;   a  U$OSUS49n:UR1                  U:5        U(       a  U'(       d  U3S9:  a  US-  nU#USS4;   a  U3S::  az  U3S:X  ac  [        R                  S;U:Rh                  5        U(       a.  [        R                  [        5        [        R                  W
5        [        U:/5      s  $ U R1                  U:5        [        U 5      (       a  Ub  UU;   a  SU;   a~  SU;   ax  U Rk                  5       n;U;c   e[        R                  S;U;Rh                  5        U(       a.  [        R                  [        5        [        R                  W
5        [        U;/5      s  $ U(       dc  U'(       d\  U9(       a  [Y        S< U9 5       SS=9OSn<U<S>:  a<  SU;   a6  SU;   a0  S(nURc                  U55        [        R#                  [        S?U#U3U<5        U(       dn  U'(       ag  U,(       a`  U$b]  [        U$5      US@-  :  aK  U#SA;  aE  SU;   a?  SU;   a9  S(n[        R#                  [        SBU#U3[        U$5      U[        U$5      U-  S.-  5        U#U!:X  d  GM	  [        R                  SCU#5        U(       a.  [        R                  [        5        [        R                  W
5        [        UU#   /5      s  $    [        U5      S:X  a  U(       d  U(       d  U(       a  [        R#                  [        SD5        U(       a2  [        R                  SEURh                  5        UR1                  U5        OU(       a  Ub+  U(       a!  U(       a  URl                  URl                  :w  d  Ub'  [        R                  SF5        UR1                  U5        O-U(       a&  [        R                  SG5        UR1                  U5        U(       a<  [        R                  SHURk                  5       Rh                  [        U5      S-
  5        O[        R                  SI5        U(       a.  [        R                  [        5        [        R                  W
5        U$ s  snf s  snf ! [F        [H        4 a     [        R#                  [        SU#5         G
M/  f = f! [R        [T        4 aW  n*[        U*[T        5      (       d%  [        R#                  [        S"U#[Q        U*5      5        UR1                  U#5         Sn*A*G
M  Sn*A*ff = f! [R        [T        4 ax  n*U)(       a=  [        R#                  [        S"U#[Q        U*5      5        UR1                  U#5         Sn*A*G
M  [        R#                  [        S'U#[Q        U*5      5        U-n.S(n/ Sn*A*GNSn*A*ff = f! [R         aB  n*[        R#                  [        S,U#[Q        U*5      5        UR1                  U#5         Sn*A*GMo  Sn*A*ff = f! [R        [T        4 a     [        R#                  [        S3U#5         GM  f = f! [R        [T        4 aB  n*[        R#                  [        S"U#[Q        U*5      5        UR1                  U#5         Sn*A*GM  Sn*A*ff = f)Ja2  
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: {}r   z<Encoding detection on empty bytes, assuming utf_8 intention.utf_8g        F Nz`cp_isolation is set. use this flag for debugging purpose. limited list of encoding allowed : %s.z, zacp_exclusion is set. use this flag for debugging purpose. limited list of encoding excluded : %s.z^override steps (%i) and chunk_size (%i) as content does not fit (%i byte(s) given) parameters.r   z>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.)maxsize   zIDetected a SIG or BOM mark on first %i byte(s). Priority +1 given for %s.ascii>   utf_16utf_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.g    Ar   r,   u   ﻿z9Code 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. %sTg     j@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      )ndigitsr*   r+   z>%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?皙?z.Encoding detection: %s is most likely the one.c              3  *   #    U  H	  u  pUv   M     g 7fr    ).0_vs      r   	<genexpr>from_bytes.<locals>.<genexpr>  s     4#341Q#3s   )defaultg      ?zyDefinitive match found: %s (chaos=%.3f, coherence=%.2f). Encodings targeting different language families will be skipped.g\(\?>	   r,   r%   r*   r+   	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.)7
isinstance	bytearraybytes	TypeErrorformattypeloggerlevel
addHandlerexplain_handlersetLevelr   lendebugremoveHandlerr   r   logjoinr   intr   r   r   appendsetr   r   r   r   insertr#   addr   r   ModuleNotFoundErrorImportErrorr	   r
   intersectionstrUnicodeDecodeErrorLookupErrorrangemaxr   sumdecoder   updateroundr   r   bestfingerprint)=	sequencessteps
chunk_size	thresholdcp_isolationcp_exclusionpreemptive_behaviourexplainlanguage_thresholdenable_fallbackprevious_logger_levellengthcpis_too_small_sequenceis_too_large_sequenceprioritized_encodingsspecified_encodingtestedtested_but_hard_failuretested_but_soft_failuresoft_failure_skipcached_mess_ratiocached_coherence_ratiodefinitive_match_founddefinitive_target_languages post_definitive_sb_success_countPOST_DEFINITIVE_SB_CAPmb_definitive_match_foundfallback_asciifallback_u8fallback_specifiedresultsearly_stop_resultssig_encodingsig_payloadencoding_ianadecoded_payloadbom_or_sig_availablestrip_sig_or_bomis_multi_byte_decoderenc_languagesdeferred_decodinger_multi_byte_bonusmax_chunk_gave_upearly_stop_countlazy_str_hard_failure	md_chunks	md_ratioschunkmean_mess_ratiofallback_entrytarget_languages	cd_ratioslg_inclusionchunk_languagescd_ratios_mergedcurrent_matchprobable_resultbest_coherences=                                                                r   
from_bytesr   2   s   < i)U!344AHHY
 	
 %+\\/*i.F{ST  1OO12|IwUBPRSTUU

5IIl#		
 8DD|	"e,|D

6IIl#		
 8DD|	"e,|Du$%

l	
 
qyV^j0(
"%i.3E"E"%i.4D"D

L	

 


W	
 (* .By)t  %$$%78

N	
 uF)+)+"%% "$/
;&t4_E $),/E -.$"# ',*.N'+K.2,.G)7)9 3I >L+$$Q5

W		
   )++$$W-.1HHM=M\9F"

=!&*%1]%B!5 "
:Q;
 009MJJn
 I%.BJJd
  --JJk
 	*@*O! "( #$6}$E F #$9-$H I --.IJJ

x!!/  #)04JJJJj0& 
 %-BJJU
  &%C.C*C 	*	$-B  0 "+CI.&s;'7#d)D* ' !G+0D&)!!.'O '?1+=+I*9!"*=&) $4 &!*3{+;+=!>!.'O& )As;/?
 " .t+.O$v- 	 JJ-	 "%SWq[!1 115 ! %!		5	),$ %!   '  %!?A\):$?$?a$? R=I-$)$$(99((1A1A9l ENY#i.!@SV
 &%))+ #44
#d)+&--mH-M i'+;?P+P#**=9 66!(()?)NOJJ0 o+Q7  !W&8(HMN- #*!*- (8 !*%.s;/?/A%B%2+ -*.!-!(#+=" !$66)7&"g-%3N"0K"%  0 "&s;'7'9:*#$ 	

K/C'3		
 %*<]*K4]CJJ8 	 	 G# /?)*D  #"8& #   1 # 2)<JJ2 	 %  .$);Wg(NN  
 #5
" 	}% #)$&,1, 0'7CC#% #%D!** ((9OO$9:%}o66%%m4 "###+/AV/K6!6!0557O"...LL@(( $$_5 56!?"344 &.C $ 4#34cB 
 $F):w&?P)-&+223CD

 P!#" *% +O$v}4
 6!6!(,%JJ|O$O$v-3 L(LL1
 $$_5 56!7=#9":;;m Ip 7|q.,>JJa
 LLI"++ NN-.^3"++~/I/II'LLUVNN;'LLUVNN>*kLLN##L1	
 	TU_--.Nw E Ex $[1 	JJD
 	H #K0 		a--

O!F	 $**=9		N 
 	) ! 

O!F	 (..}=JJsA	  1$(!/	)L & 

t!F	 (..}=V /< !

!\)
 !!P '4 

O!F	 (..}=s   .u :u%8u*&Av)3vvA?xx"x$x)z	{!|*+vvx-Aw??xz=z
)z

z
{6{{!+||}&$6}!!}&c
                F    [        U R                  5       UUUUUUUUU	5
      $ )zz
Same thing than the function from_bytes but using a file pointer that is already ready.
Will not close the file pointer.
)r   read)
fpri   rj   rk   rl   rm   rn   ro   rp   rq   s
             r   from_fpr   *  s5      
	 r!   c
                x    [        U S5       n
[        U
UUUUUUUUU	5
      sSSS5        $ ! , (       d  f       g= f)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   )pathri   rj   rk   rl   rm   rn   ro   rp   rq   r   s              r   	from_pathr   H  sB      
dD	R 
 
		s   +
9c
                   [        U [        [        45      (       a  [        U UUUUUUUUU	S9
n
U
(       + $ [        U [        [
        45      (       a  [        U UUUUUUUUU	S9
n
U
(       + $ [        U UUUUUUUUU	S9
n
U
(       + $ )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.
)	ri   rj   rk   rl   rm   rn   ro   rp   rq   )rE   r]   r   r   rG   rF   r   r   )fp_or_path_or_payloadri   rj   rk   rl   rm   rn   ro   rp   rq   guessess              r   	is_binaryr   g  s    " '#x99!!%%!51+
Z ;C 
	

 
 !!%%!51+
4 ; !!%%!51+
 ;r!   )	      皙?NNTFr7   T)rh   zbytes | bytearrayri   rU   rj   rU   rk   floatrl   list[str] | Nonerm   r   rn   boolro   r   rp   r   rq   r   returnr   )r   r   ri   rU   rj   rU   rk   r   rl   r   rm   r   rn   r   ro   r   rp   r   rq   r   r   r   )r   zstr | bytes | PathLikeri   rU   rj   rU   rk   r   rl   r   rm   r   rn   r   ro   r   rp   r   rq   r   r   r   )	r   r   r   NNTFr7   F)r   z!PathLike | str | BinaryIO | bytesri   rU   rj   rU   rk   r   rl   r   rm   r   rn   r   ro   r   rp   r   rq   r   r   r   )-
__future__r   logging	functoolsr   osr   typingr   cdr   r	   r
   r   constantr   r   r   r   r   mdr   modelsr   r   utilsr   r   r   r   r   r   	getLoggerrK   StreamHandlerrN   setFormatter	Formattersortedr#   __annotations__r   r   r   r   r9   r!   r   <module>r      s   "        0  
		/	0'')   AB &,M&   %)%)!% # u uu u 	u
 #u #u u u u u ut %)%)!% #   	
 # #     @ %)%)!% # 

 

 
 	

 #
 #
 
 
 
 
 
B %)%)!% #!?<?? ? 	?
 #? #? ? ? ? ? 
?r!   