o
    'hj0                     @  s   d dl mZ d dlmZ d dlmZ d dlmZ d dlm	Z	 d dl
mZmZmZmZ ddlmZmZ dd	lmZmZmZ G d
d dZG dd dZeeef Zee ZG dd dZdS )    )annotations)aliases)sha256)dumps)sub)AnyIteratorListTuple   )RE_POSSIBLE_ENCODING_INDICATIONTOO_BIG_SEQUENCE)	iana_nameis_multi_byte_encodingunicode_rangec                   @  sH  e Zd Z		dGdHddZdIddZdIddZedJddZdKddZdKddZ	dLdd Z
edKd!d"ZedMd$d%ZedNd&d'ZedNd(d)ZedMd*d+ZedKd,d-ZedJd.d/ZedJd0d1ZedJd2d3ZedJd4d5ZedOd6d7ZedPd9d:ZedNd;d<ZedMd=d>ZedMd?d@ZdQdRdCdDZedKdEdFZdS )SCharsetMatchNpayloadbytesguessed_encodingstrmean_mess_ratiofloathas_sig_or_bombool	languagesCoherenceMatchesdecoded_payload
str | Nonepreemptive_declarationc                 C  sL   || _ || _|| _|| _|| _d | _g | _d| _d | _d | _	|| _
|| _d S )N        )_payload	_encoding_mean_mess_ratio
_languages_has_sig_or_bom_unicode_ranges_leaves_mean_coherence_ratio_output_payload_output_encoding_string_preemptive_declaration)selfr   r   r   r   r   r   r    r-   U/var/www/html/olx_land/venv/lib/python3.10/site-packages/charset_normalizer/models.py__init__   s   

zCharsetMatch.__init__otherobjectreturnc                 C  s>   t |tst |trt|| jkS dS | j|jko| j|jkS )NF)
isinstancer   r   r   encodingfingerprintr,   r0   r-   r-   r.   __eq__*   s
   

zCharsetMatch.__eq__c                 C  s   t |tstt| j|j }t| j|j }|dk r%|dkr%| j|jkS |dk r@|dkr@t| jtkr:| j|jk S | j	|j	kS | j|jk S )zQ
        Implemented to make sorted available upon CharsetMatches items.
        g{Gz?g{Gz?)
r3   r   
ValueErrorabschaos	coherencelenr    r   multi_byte_usage)r,   r0   chaos_differencecoherence_differencer-   r-   r.   __lt__1   s   
zCharsetMatch.__lt__c                 C  s   dt t| t | j  S )Ng      ?)r<   r   rawr,   r-   r-   r.   r=   G   s   zCharsetMatch.multi_byte_usagec                 C  s"   | j d u rt| j| jd| _ | j S )Nstrict)r*   r   r    r!   rB   r-   r-   r.   __str__K   s   
zCharsetMatch.__str__c                 C  s   d| j  d| j dS )Nz<CharsetMatch 'z' bytes(z)>)r4   r5   rB   r-   r-   r.   __repr__Q   s   zCharsetMatch.__repr__Nonec                 C  s8   t |tr	|| krtd|jd |_| j| d S )Nz;Unable to add instance <{}> as a submatch of a CharsetMatch)r3   r   r8   format	__class__r*   r&   appendr6   r-   r-   r.   add_submatchT   s   zCharsetMatch.add_submatchc                 C     | j S N)r!   rB   r-   r-   r.   r4   _      zCharsetMatch.encoding	list[str]c                 C  sD   g }t  D ]\}}| j|kr|| q| j|kr|| q|S )z
        Encoding name are known by many name, using this could help when searching for IBM855 when it's listed as CP855.
        )r   itemsr4   rI   )r,   also_known_asupr-   r-   r.   encoding_aliasesc   s   


zCharsetMatch.encoding_aliasesc                 C  rK   rL   r$   rB   r-   r-   r.   bomp   rM   zCharsetMatch.bomc                 C  rK   rL   rT   rB   r-   r-   r.   byte_order_markt   rM   zCharsetMatch.byte_order_markc                 C  s   dd | j D S )z
        Return the complete list of possible languages found in decoded sequence.
        Usually not really useful. Returned list may be empty even if 'language' property return something != 'Unknown'.
        c                 S  s   g | ]}|d  qS )r   r-   ).0er-   r-   r.   
<listcomp>~       z*CharsetMatch.languages.<locals>.<listcomp>r#   rB   r-   r-   r.   r   x   s   zCharsetMatch.languagesc                 C  sp   | j s1d| jv r
dS ddlm}m} t| jr|| jn|| j}t|dks+d|v r-dS |d S | j d d S )z
        Most probable language found in decoded sequence. If none were detected or inferred, the property will return
        "Unknown".
        asciiEnglishr   )encoding_languagesmb_encoding_languageszLatin BasedUnknown)r#   could_be_from_charsetcharset_normalizer.cdr^   r_   r   r4   r<   )r,   r^   r_   r   r-   r-   r.   language   s   
zCharsetMatch.languagec                 C  rK   rL   )r"   rB   r-   r-   r.   r:      rM   zCharsetMatch.chaosc                 C  s   | j sdS | j d d S )Nr   r   r   r[   rB   r-   r-   r.   r;      s   zCharsetMatch.coherencec                 C     t | jd ddS Nd      )ndigits)roundr:   rB   r-   r-   r.   percent_chaos      zCharsetMatch.percent_chaosc                 C  rd   re   )ri   r;   rB   r-   r-   r.   percent_coherence   rk   zCharsetMatch.percent_coherencec                 C  rK   )z+
        Original untouched bytes.
        )r    rB   r-   r-   r.   rA      s   zCharsetMatch.rawlist[CharsetMatch]c                 C  rK   rL   )r&   rB   r-   r-   r.   submatch   rM   zCharsetMatch.submatchc                 C     t | jdkS Nr   )r<   r&   rB   r-   r-   r.   has_submatch   s   zCharsetMatch.has_submatchc                 C  s@   | j d ur| j S dd t| D }ttdd |D | _ | j S )Nc                 S  s   g | ]}t |qS r-   )r   )rW   charr-   r-   r.   rY      rZ   z*CharsetMatch.alphabets.<locals>.<listcomp>c                 S  s   h | ]}|r|qS r-   r-   )rW   rr-   r-   r.   	<setcomp>   rZ   z)CharsetMatch.alphabets.<locals>.<setcomp>)r%   r   sortedlist)r,   detected_rangesr-   r-   r.   	alphabets   s
   
zCharsetMatch.alphabetsc                 C  s   | j gdd | jD  S )z
        The complete list of encoding that output the exact SAME str result and therefore could be the originating
        encoding.
        This list does include the encoding available in property 'encoding'.
        c                 S  s   g | ]}|j qS r-   )r4   )rW   mr-   r-   r.   rY      s    z6CharsetMatch.could_be_from_charset.<locals>.<listcomp>)r!   r&   rB   r-   r-   r.   ra      s   z"CharsetMatch.could_be_from_charsetutf_8r4   c                   s~    j du s
 j |kr<| _ t } jdur5 j dvr5tt fdd|dd dd}||dd  }||d _ jS )	z
        Method to get re-encoded bytes payload using given target encoding. Default to UTF-8.
        Any errors will be simply ignored by the encoder NOT replaced.
        N)zutf-8utf8rz   c                   s<   | j |  d |  d  |  d t jddS )Nr   r   _-)stringspanreplacegroupsr   r)   )ry   rB   r-   r.   <lambda>   s    
z%CharsetMatch.output.<locals>.<lambda>i    r   )countr   )r)   r   r+   lowerr   r   encoder(   )r,   r4   decoded_stringpatched_headerr-   rB   r.   output   s    



zCharsetMatch.outputc                 C  s   t |   S )zw
        Retrieve the unique SHA256 computed using the transformed (re-encoded) payload. Not the original one.
        )r   r   	hexdigestrB   r-   r-   r.   r5      s   zCharsetMatch.fingerprint)NN)r   r   r   r   r   r   r   r   r   r   r   r   r   r   )r0   r1   r2   r   )r2   r   r2   r   )r0   r   r2   rF   )r2   rN   r2   r   )r2   r   )r2   rm   )rz   )r4   r   r2   r   )__name__
__module____qualname__r/   r7   r@   propertyr=   rD   rE   rJ   r4   rS   rU   rV   r   rc   r:   r;   rj   rl   rA   rn   rq   rx   ra   r   r5   r-   r-   r-   r.   r      sX    




	r   c                   @  sb   e Zd ZdZddddZd d	d
Zd!ddZd"ddZd#ddZd$ddZ	d%ddZ
d%ddZdS )&CharsetMatchesz
    Container with every CharsetMatch items ordered by default from most probable to the less one.
    Act like a list(iterable) but does not implements all related methods.
    Nresultslist[CharsetMatch] | Nonec                 C  s   |r	t || _d S g | _d S rL   )ru   _results)r,   r   r-   r-   r.   r/      s   zCharsetMatches.__init__r2   Iterator[CharsetMatch]c                 c  s    | j E d H  d S rL   r   rB   r-   r-   r.   __iter__   s   zCharsetMatches.__iter__item	int | strr   c                 C  sJ   t |tr
| j| S t |tr#t|d}| jD ]}||jv r"|  S qt)z
        Retrieve a single item either by its position or encoding name (alias may be used here).
        Raise KeyError upon invalid index or encoding not present in results.
        F)r3   intr   r   r   ra   KeyError)r,   r   resultr-   r-   r.   __getitem__  s   





zCharsetMatches.__getitem__r   c                 C  s
   t | jS rL   r<   r   rB   r-   r-   r.   __len__  s   
zCharsetMatches.__len__r   c                 C  ro   rp   r   rB   r-   r-   r.   __bool__  s   zCharsetMatches.__bool__rF   c                 C  s|   t |tstdt|jt|jtk r0| j	D ]}|j
|j
kr/|j|jkr/||  dS q| j	| t| j	| _	dS )z~
        Insert a single match. Will be inserted accordingly to preserve sort.
        Can be inserted as a submatch.
        z-Cannot append instance '{}' to CharsetMatchesN)r3   r   r8   rG   r   rH   r<   rA   r   r   r5   r:   rJ   rI   ru   )r,   r   matchr-   r-   r.   rI     s   


zCharsetMatches.appendCharsetMatch | Nonec                 C  s   | j sdS | j d S )zQ
        Simply return the first match. Strict equivalent to matches[0].
        Nr   r   rB   r-   r-   r.   best)  s   
zCharsetMatches.bestc                 C  s   |   S )zP
        Redundant method, call the method best(). Kept for BC reasons.
        )r   rB   r-   r-   r.   first1  s   zCharsetMatches.firstrL   )r   r   )r2   r   )r   r   r2   r   )r2   r   r   )r   r   r2   rF   )r2   r   )r   r   r   __doc__r/   r   r   r   r   rI   r   r   r-   r-   r-   r.   r      s    





r   c                   @  s.   e Zd ZdddZedddZdddZdS )CliDetectionResultpathr   r4   r   rS   rN   alternative_encodingsrc   rx   r   r   r:   r   r;   unicode_pathis_preferredc                 C  sF   || _ |
| _|| _|| _|| _|| _|| _|| _|| _|	| _	|| _
d S rL   )r   r   r4   rS   r   rc   rx   r   r:   r;   r   )r,   r   r4   rS   r   rc   rx   r   r:   r;   r   r   r-   r-   r.   r/   =  s   
zCliDetectionResult.__init__r2   dict[str, Any]c                 C  s2   | j | j| j| j| j| j| j| j| j| j	| j
dS )Nr   r4   rS   r   rc   rx   r   r:   r;   r   r   r   rB   r-   r-   r.   __dict__W  s   zCliDetectionResult.__dict__c                 C  s   t | jdddS )NT   )ensure_asciiindent)r   r   rB   r-   r-   r.   to_jsong  s   zCliDetectionResult.to_jsonN)r   r   r4   r   rS   rN   r   rN   rc   r   rx   rN   r   r   r:   r   r;   r   r   r   r   r   )r2   r   r   )r   r   r   r/   r   r   r   r-   r-   r-   r.   r   <  s
    
r   N)
__future__r   encodings.aliasesr   hashlibr   jsonr   rer   typingr   r   r	   r
   constantr   r   utilsr   r   r   r   r   r   r   CoherenceMatchr   r   r-   r-   r-   r.   <module>   s     iC