o
     JAfE  ã                   @   s¤   d Z g d¢ZddlZddlZdZdZdZg d¢Zg d¢Zddddd	d
dd	dddddddœZ	dd„ Z
dd„ Zdd„ Zdd„ Zdd„ ZG dd„ dƒZG dd„ deƒZdS )zcEmail address parsing code.

Lifted directly from rfc822.py.  This should eventually be rewritten.
)Ú	mktime_tzÚ	parsedateÚparsedate_tzÚquoteé    Nú Ú z, )ZjanZfebZmarZaprÚmayZjunZjulZaugÚsepÚoctZnovZdecZjanuaryZfebruaryZmarchZaprilr   ZjuneZjulyZaugustZ	septemberZoctoberZnovemberZdecember)ZmonZtueZwedZthuZfriZsatZsunipþÿÿiÔþÿÿiþÿÿi¨ýÿÿiDýÿÿiàüÿÿ)ZUTZUTCZGMTÚZZASTZADTZESTZEDTZCSTZCDTZMSTZMDTZPSTZPDTc                 C   s,   t | ƒ}|sdS |d du rd|d< t|ƒS )zQConvert a date string to a time tuple.

    Accounts for military timezones.
    Né	   r   )Ú_parsedate_tzÚtuple)ÚdataÚres© r   ú'/usr/lib/python3.10/email/_parseaddr.pyr   -   s   r   c              
   C   sÎ  | sdS |   ¡ } | sdS | d  d¡s| d  ¡ tv r| d= n| d  d¡}|dkr6| d |d d… | d< t| ƒdkrQ| d   d¡}t|ƒdkrQ|| dd…  } t| ƒdkrƒ| d }| d¡}|d	kri| d¡}|dkr~|d|… ||d… g| dd…< n|  d
¡ t| ƒdk r‹dS | dd… } | \}}}}}|rž|rž|s dS | ¡ }|tvrµ|| ¡ }}|tvrµdS t 	|¡d }|dkrÄ|d8 }|d	 dkrÐ|dd	… }| d¡}|dkrÞ||}}|d	 dkrî|dd	… }|sîdS |d  
¡ sù||}}|d	 dkr|dd	… }|  d¡}t|ƒdkr|\}	}
d}nAt|ƒdkr&|\}	}
}n4t|ƒdkrXd|d v rX|d   d¡}t|ƒdkrI|\}	}
d}nt|ƒdkrV|\}	}
}ndS dS zt|ƒ}t|ƒ}t|	ƒ}	t|
ƒ}
t|ƒ}W n ty{   Y dS w |dk r|dkr‹|d7 }n|d7 }d}| ¡ }|tv rŸt| }nzt|ƒ}W n
 ty¯   Y nw |dkr½| d¡r½d}|rÛ|dk rËd	}| }nd}||d d |d d   }||||	|
|ddd	|g
S )a†  Convert date to extended time tuple.

    The last (additional) element is the time zone offset in seconds, except if
    the timezone was specified as -0000.  In that case the last element is
    None.  This indicates a UTC timestamp that explicitly declaims knowledge of
    the source timezone, as opposed to a +0000 timestamp that indicates the
    source timezone really was UTC.

    Nr   ú,é   é   ú-é   ú+éÿÿÿÿr   é   é   ú:é   Ú0Ú.éd   éD   il  iÐ  i  é<   )ÚsplitÚendswithÚlowerÚ	_daynamesÚrfindÚlenÚfindÚappendÚ_monthnamesÚindexÚisdigitÚintÚ
ValueErrorÚupperÚ
_timezonesÚ
startswith)r   ÚiÚstuffÚsÚddZmmZyyZtmZtzZthhZtmmZtssZtzoffsetZtzsignr   r   r   r   9   s¾   


"




ÿ




ÿ
r   c                 C   s"   t | ƒ}t|tƒr|dd… S |S )z&Convert a time string to a time tuple.Nr   )r   Ú
isinstancer   ©r   Útr   r   r   r   ¶   s   
r   c                 C   s8   | d du rt  | dd… d ¡S t | ¡}|| d  S )zETurn a 10-tuple as returned by parsedate_tz() into a POSIX timestamp.r   Né   )r   )ÚtimeÚmktimeÚcalendarZtimegmr8   r   r   r   r   ¿   s   
r   c                 C   s   |   dd¡  dd¡S )zøPrepare string to be used in a quoted string.

    Turns backslash and double quote characters into quoted pairs.  These
    are the only characters that need to be quoted inside a quoted string.
    Does not add the surrounding double quotes.
    ú\z\\ú"z\")Úreplace)Ústrr   r   r   r   É   s   r   c                   @   s|   e Zd ZdZdd„ Zdd„ Zdd„ Zdd	„ Zd
d„ Zdd„ Z	dd„ Z
ddd„Zdd„ Zdd„ Zdd„ Zddd„Zdd„ ZdS ) ÚAddrlistClassa  Address parser class by Ben Escoto.

    To understand what this class does, it helps to have a copy of RFC 2822 in
    front of you.

    Note: this class interface is deprecated and may be removed in the future.
    Use email.utils.AddressList instead.
    c                 C   sZ   d| _ d| _d| _d| _| j| j | _| j | j | j | _| j dd¡| _|| _g | _	dS )zƒInitialize a new instance.

        `field' is an unparsed address header field, containing
        one or more addresses.
        z()<>@,:;."[]r   z 	z
r   r   N)
ÚspecialsÚposÚLWSZCRÚFWSÚatomendsr@   Ú
phraseendsÚfieldÚcommentlist©ÚselfrI   r   r   r   Ú__init__Ý   s   
zAddrlistClass.__init__c                 C   sš   g }| j t| jƒk rH| j| j  | jd v r.| j| j  dvr&| | j| j  ¡ |  j d7  _ n| j| j  dkr?| j |  ¡ ¡ nn| j t| jƒk s
t |¡S )z&Skip white space and extract comments.z
r   ú()	rD   r(   rI   rE   r*   rJ   Ú
getcommentÚEMPTYSTRINGÚjoin)rL   Zwslistr   r   r   Úgotonextð   s   ø
	zAddrlistClass.gotonextc                 C   sH   g }| j t| jƒk r"|  ¡ }|r||7 }n| d¡ | j t| jƒk s
|S )zVParse all addresses.

        Returns a list containing all of the addresses.
        )r   r   )rD   r(   rI   Ú
getaddressr*   )rL   ÚresultZadr   r   r   Úgetaddrlistþ   s   

ûzAddrlistClass.getaddrlistc                 C   sê  g | _ |  ¡  | j}| j }|  ¡ }|  ¡  g }| jt| jƒkr-|r,t | j ¡|d fg}n«| j| j dv rI|| _|| _ |  ¡ }t | j ¡|fg}n| j| j dkrg }t| jƒ}|  jd7  _| jt| jƒk rŽ|  ¡  | j|k r€| j| j dkr€|  jd7  _n||  	¡  }| jt| jƒk sgnI| j| j dkrº|  
¡ }| j r±t |¡d d | j ¡ d	 |fg}n't |¡|fg}n|rÈt | j ¡|d fg}n| j| j | jv rØ|  jd7  _|  ¡  | jt| jƒk ró| j| j d
kró|  jd7  _|S )zParse the next address.r   z.@r   r   ú;ú<z (r   ú)r   )rJ   rR   rD   Úgetphraselistr(   rI   ÚSPACErQ   ÚgetaddrspecrS   ÚgetrouteaddrrC   )rL   ZoldposZoldclÚplistZ
returnlistZaddrspecZfieldlenZ	routeaddrr   r   r   rS     s^   €
û€
ÿÿÿ zAddrlistClass.getaddressc                 C   sô   | j | j dkr
dS d}|  jd7  _|  ¡  d}| jt| j ƒk rx|r*|  ¡  d}nB| j | j dkr<|  jd7  _	 |S | j | j dkrN|  jd7  _d}n| j | j d	kr^|  jd7  _n|  ¡ }|  jd7  _	 |S |  ¡  | jt| j ƒk s!|S )
zParse a route address (Return-path value).

        This method just skips all the route stuff and returns the addrspec.
        rW   NFr   r   ú>ú@Tr   )rI   rD   rR   r(   Ú	getdomainr[   )rL   ZexpectrouteZadlistr   r   r   r\   G  s4   õþðzAddrlistClass.getrouteaddrc                 C   sZ  g }|   ¡  | jt| jƒk ryd}| j| j dkr3|r$|d  ¡ s$| ¡  | d¡ |  jd7  _d}n1| j| j dkrG| dt|  ¡ ƒ ¡ n| j| j | j	v r]|r\|d  ¡ s\| ¡  n| |  
¡ ¡ |   ¡ }|rq|rq| |¡ | jt| jƒk s| jt| jƒks‰| j| j dkrŽt |¡S | d¡ |  jd7  _|   ¡  |  ¡ }|s¦tS t |¡| S )	zParse an RFC 2822 addr-spec.Tr   r   r   Fr?   z"%s"r_   )rR   rD   r(   rI   ÚstripÚpopr*   r   ÚgetquoterG   ÚgetatomrP   rQ   r`   )rL   ZaslistZpreserve_wsÚwsÚdomainr   r   r   r[   g  s<   

î 

zAddrlistClass.getaddrspecc                 C   sò   g }| j t| jƒk rt| j| j  | jv r|  j d7  _ nQ| j| j  dkr,| j |  ¡ ¡ n@| j| j  dkr<| |  ¡ ¡ n0| j| j  dkrQ|  j d7  _ | d¡ n| j| j  dkr[tS | j| j  | j	v ren| |  
¡ ¡ | j t| jƒk s
t |¡S )z-Get the complete domain name from an address.r   rN   ú[r   r_   )rD   r(   rI   rE   rJ   r*   rO   ÚgetdomainliteralrP   rG   rd   rQ   )rL   Zsdlistr   r   r   r`     s$   ï
zAddrlistClass.getdomainTc                 C   sì   | j | j |kr
dS dg}d}|  jd7  _| jt| j ƒk rq|r,| | j | j ¡ d}n6| j | j |v r<|  jd7  _n5|rN| j | j dkrN| |  ¡ ¡ q| j | j dkrYd}n	| | j | j ¡ |  jd7  _| jt| j ƒk st |¡S )aæ  Parse a header fragment delimited by special characters.

        `beginchar' is the start character for the fragment.
        If self is not looking at an instance of `beginchar' then
        getdelimited returns the empty string.

        `endchars' is a sequence of allowable end-delimiting characters.
        Parsing stops when one of these is encountered.

        If `allowcomments' is non-zero, embedded RFC 2822 comments are allowed
        within the parsed fragment.
        r   Fr   rN   r>   T)rI   rD   r(   r*   rO   rP   rQ   )rL   Z	begincharZendcharsZallowcommentsZslistr   r   r   r   Úgetdelimited¤  s*   ò
zAddrlistClass.getdelimitedc                 C   ó   |   ddd¡S )z1Get a quote-delimited fragment from self's field.r?   z"F©ri   ©rL   r   r   r   rc   É  ó   zAddrlistClass.getquotec                 C   rj   )z7Get a parenthesis-delimited fragment from self's field.rN   z)Trk   rl   r   r   r   rO   Í  rm   zAddrlistClass.getcommentc                 C   s   d|   ddd¡ S )z!Parse an RFC 2822 domain-literal.z[%s]rg   z]Frk   rl   r   r   r   rh   Ñ  s   zAddrlistClass.getdomainliteralNc                 C   sp   dg}|du r
| j }| jt| jƒk r3| j| j |v rn| | j| j ¡ |  jd7  _| jt| jƒk st |¡S )a  Parse an RFC 2822 atom.

        Optional atomends specifies a different set of end token delimiters
        (the default is to use self.atomends).  This is used e.g. in
        getphraselist() since phrase endings must not include the `.' (which
        is legal in phrases).r   Nr   )rG   rD   r(   rI   r*   rP   rQ   )rL   rG   Zatomlistr   r   r   rd   Õ  s   û
zAddrlistClass.getatomc                 C   s¶   g }| j t| jƒk rY| j| j  | jv r|  j d7  _ n6| j| j  dkr+| |  ¡ ¡ n&| j| j  dkr<| j |  ¡ ¡ n| j| j  | jv rH	 |S | |  	| j¡¡ | j t| jƒk s
|S )zýParse a sequence of RFC 2822 phrases.

        A phrase is a sequence of words, which are in turn either RFC 2822
        atoms or quoted-strings.  Phrases are canonicalized by squeezing all
        runs of continuous whitespace into one space.
        r   r?   rN   )
rD   r(   rI   rF   r*   rc   rJ   rO   rH   rd   )rL   r]   r   r   r   rY   é  s   þözAddrlistClass.getphraselist)T©N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__rM   rR   rU   rS   r\   r[   r`   ri   rc   rO   rh   rd   rY   r   r   r   r   rB   Ó   s    	; &
%
rB   c                   @   sH   e Zd ZdZdd„ Zdd„ Zdd„ Zdd	„ Zd
d„ Zdd„ Z	dd„ Z
dS )ÚAddressListz@An AddressList encapsulates a list of parsed RFC 2822 addresses.c                 C   s(   t  | |¡ |r|  ¡ | _d S g | _d S rn   )rB   rM   rU   ÚaddresslistrK   r   r   r   rM     s   
zAddressList.__init__c                 C   s
   t | jƒS rn   )r(   rt   rl   r   r   r   Ú__len__	  s   
zAddressList.__len__c                 C   s>   t d ƒ}| jd d … |_|jD ]}|| jvr|j |¡ q|S rn   ©rs   rt   r*   ©rL   ÚotherZnewaddrÚxr   r   r   Ú__add__  s   

€zAddressList.__add__c                 C   s&   |j D ]}|| j vr| j  |¡ q| S rn   )rt   r*   ©rL   rx   ry   r   r   r   Ú__iadd__  ó
   

€zAddressList.__iadd__c                 C   s.   t d ƒ}| jD ]}||jvr|j |¡ q|S rn   rv   rw   r   r   r   Ú__sub__  s   

€zAddressList.__sub__c                 C   s&   |j D ]}|| j v r| j  |¡ q| S rn   )rt   Úremover{   r   r   r   Ú__isub__$  r}   zAddressList.__isub__c                 C   s
   | j | S rn   )rt   )rL   r,   r   r   r   Ú__getitem__+  s   
zAddressList.__getitem__N)ro   rp   rq   rr   rM   ru   rz   r|   r~   r€   r   r   r   r   r   rs      s    	rs   )rr   Ú__all__r;   r=   rZ   rP   Z
COMMASPACEr+   r&   r1   r   r   r   r   r   rB   rs   r   r   r   r   Ú<module>   s0   û	}	

  /