Current File : //opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyc
�
�A�[c @` s� d 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 d d l m Z d d l
m Z d d l
m Z d d
l
m
Z d e f d � � YZ d
e f d � � YZ d e f d � � YZ d � Z d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d! � � YZ d" e f d# � � YZ d$ e f d% � � YZ d& e f d' � � YZ d( e f d) � � YZ d* e f d+ � � YZ i e d, 6e d- 6e d. 6e d/ 6e d0 6e d1 6e d2 6e d3 6e d4 6e d5 6e d6 6e d7 6e d8 6e d9 6e d: 6e d; 6e d< 6e d= 6e d> 6Z! d? e f d@ � � YZ" dA S(B u; Representing and manipulating email headers via custom objects.
This module provides an implementation of the HeaderRegistry API.
The implementation is designed to flexibly follow RFC5322 rules.
Eventually HeaderRegistry will be a public API, but it isn't yet,
and will probably change some before that happens.
i ( t unicode_literals( t division( t absolute_import( t super( t str( t text_to_native_str( t utils( t errors( t _header_value_parsert Addressc B` st e Z d d d d d � Z e d � � Z e d � � Z e d � � Z e d � � Z d � Z d � Z
d � Z RS(
u c C` s� | d k r� | s | r' t d � � n t j | � \ } } | r] t d j | | � � � n | j rv | j d � n | j } | j } n | | _ | | _
| | _ d S( u� Create an object represeting a full email address.
An address can have a 'display_name', a 'username', and a 'domain'. In
addition to specifying the username and domain separately, they may be
specified together by using the addr_spec keyword *instead of* the
username and domain keywords. If an addr_spec string is specified it
must be properly quoted according to RFC 5322 rules; an error will be
raised if it is not.
An Address object has display_name, username, domain, and addr_spec
attributes, all of which are read-only. The addr_spec and the string
value of the object are both quoted according to RFC5322 rules, but
without any Content Transfer Encoding.
u= addrspec specified when username and/or domain also specifiedu6 Invalid addr_spec; only '{}' could be parsed from '{}'i N( t Nonet TypeErrort parsert
get_addr_spect
ValueErrort formatt all_defectst
local_partt domaint
_display_namet _usernamet _domain( t selft display_namet usernameR t addr_spect a_st rest( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt __init__ s c C` s | j S( N( R ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR < s c C` s | j S( N( R ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR @ s c C` s | j S( N( R ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR D s c C` sr t | j � } t | � t | t j � k rC t j | j � } n | j } | j rd | d | j S| sn d S| S( u� The addr_spec (username@domain) portion of the address, quoted
according to RFC 5322 rules, but with no Content Transfer Encoding.
u @u <>( t setR t lenR t
DOT_ATOM_ENDSt quote_stringR ( R t namesett lp( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR H s c C` s d j | j | j | j � S( Nu6 Address(display_name={!r}, username={!r}, domain={!r})( R R R R ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt __repr__X s c C` s� t | j � } t | � t | t j � k rC t j | j � } n | j } | r� | j d k rg d n | j } d j | | � S| j S( Nu <>u u {} <{}>( R R R R t SPECIALSR R R ( R R! t dispR ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt __str__\ s c C` sP t | � t | � k r t S| j | j k oO | j | j k oO | j | j k S( N( t typet FalseR R R ( R t other( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt __eq__g s
N( t __name__t
__module__R
R t propertyR R R R R# R& R* ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR s % t Groupc B` sP e Z d d d � Z e d � � Z e d � � Z d � Z d � Z d � Z RS( c C` s+ | | _ | r t | � n t � | _ d S( u Create an object representing an address group.
An address group consists of a display_name followed by colon and an
list of addresses (see Address) terminated by a semi-colon. The Group
is created by specifying a display_name and a possibly empty list of
Address objects. A Group can also be used to represent a single
address that is not in a group, which is convenient when manipulating
lists that are a combination of Groups and individual Addresses. In
this case the display_name should be set to None. In particular, the
string representation of a Group whose display_name is None is the same
as the Address object, if there is one and only one Address object in
the addresses list.
N( R t tuplet
_addresses( R R t addresses( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR q s c C` s | j S( N( R ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR � s c C` s | j S( N( R0 ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR1 � s c C` s d j | j | j � S( Nu' Group(display_name={!r}, addresses={!r}( R R R1 ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR# � s c C` s� | j d k r5 t | j � d k r5 t | j d � S| j } | d k r� t | � } t | � t | t j � k r� t j | � } q� n d j d � | j D� � } | r� d | n | } d j
| | � S( Ni i u , c s` s | ] } t | � Vq d S( N( R ( t .0t x( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pys <genexpr>� s u u {}:{};( R R
R R1 R R R R$ R t joinR ( R R% R! t adrstr( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR& � s $ c C` s> t | � t | � k r t S| j | j k o= | j | j k S( N( R' R( R R1 ( R R) ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR* � s N(
R+ R, R
R R- R R1 R# R& R* ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR. o s t
BaseHeaderc B` s_ e Z d Z d � Z d � Z e d � � Z e d � � Z d � Z e d � � Z
d � Z RS( u| Base class for message headers.
Implements generic behavior and provides tools for subclasses.
A subclass must define a classmethod named 'parse' that takes an unfolded
value string and a dictionary as its arguments. The dictionary will
contain one key, 'defects', initialized to an empty list. After the call
the dictionary must contain two additional keys: parse_tree, set to the
parse tree obtained from parsing the header, and 'decoded', set to the
string value of the idealized representation of the data from the value.
(That is, encoded words are decoded, and values that have canonical
representations are so represented.)
The defects key is intended to collect parsing defects, which the message
parser will subsequently dispose of as appropriate. The parser should not,
insofar as practical, raise any errors. Defects should be added to the
list instead. The standard header parsers register defects for RFC
compliance issues, for obsolete RFC syntax, and for unrecoverable parsing
errors.
The parse method may add additional keys to the dictionary. In this case
the subclass must define an 'init' method, which will be passed the
dictionary as its keyword arguments. The method should use (usually by
setting them as the value of similarly named attributes) and remove all the
extra keys added by its parse method, and then use super to call its parent
class with the remaining arguments and keywords.
The subclass should also make sure that a 'max_count' attribute is defined
that is either None or 1. XXX: need to better define this API.
c C` st i g d 6} | j | | � t j | d � rJ t j | d � | d <n t j | | d � } | j | | � | S( Nu defectsu decoded( t parseR t _has_surrogatest _sanitizeR t __new__t init( t clst namet valuet kwdsR ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR: � s
c K` sA | d } | d =| d } | d =| | _ | | _ | | _ d S( Nu defectsu
parse_tree( t _namet _parse_treet _defects( R R= t _3to2kwargst defectst
parse_tree( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR; � s
c C` s | j S( N( R@ ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR= � s c C` s
t | j � S( N( R/ RB ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyRD � s c C` s+ t | j j | j j t | � f | j f S( N( t _reconstruct_headert __class__R+ t __bases__R t __dict__( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt
__reduce__� s
c C` s t j | | � S( N( R R: ( R< R> ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt _reconstruct� s c K` s~ | d } | d =t j t j t j | j d � t j d d � g � t j t j d d � g � | j g � } | j d | � S( Nu policyu header-nameu :u
header-sepu u fwst policy( R t Headert HeaderLabelt
ValueTerminalR= t CFWSListt WhiteSpaceTerminalRA t fold( R RC RL t header( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyRR � s
( R+ R, t __doc__R: R; R- R= RD RJ t classmethodRK RR ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR6 � s
c C` s t t | � | i � j | � S( N( R' R RK ( t cls_namet basesR> ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyRF s t UnstructuredHeaderc B` s, e Z d Z e e j � Z e d � � Z RS( c C` s+ | j | � | d <t | d � | d <d S( Nu
parse_treeu decoded( t value_parserR ( R< R> R? ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR7 s N(
R+ R, R
t max_countt staticmethodR t get_unstructuredRY RU R7 ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyRX s t UniqueUnstructuredHeaderc B` s e Z d Z RS( i ( R+ R, RZ ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR] s t
DateHeaderc B` sJ e Z d Z d Z e e j � Z e d � � Z
d � Z e d � � Z
RS( u� Header whose value consists of a single timestamp.
Provides an additional attribute, datetime, which is either an aware
datetime using a timezone, or a naive datetime if the timezone
in the input string is -0000. Also accepts a datetime as input.
The 'value' attribute is the normalized form of the timestamp,
which means it is the output of format_datetime on the datetime.
c C` s� | sE | d j t j � � d | d <d | d <t j � | d <d St | t � rf t j | � } n | | d <t j
| d � | d <| j | d � | d <d S( Nu defectsu datetimeu u decodedu
parse_tree( t appendR t HeaderMissingRequiredValueR
R t TokenListt
isinstanceR R t parsedate_to_datetimet format_datetimeRY ( R< R> R? ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR7 , s
c O` s) | j d � | _ t � j | | � d S( Nu datetime( t popt _datetimeR R; ( R t argst kw( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR; : s c C` s | j S( N( Rf ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt datetime> s N( R+ R, RT R
RZ R[ R R\ RY RU R7 R; R- Ri ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR^ s t UniqueDateHeaderc B` s e Z d Z RS( i ( R+ R, RZ ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyRj C s t
AddressHeaderc B` sS e Z d Z e d � � Z e d � � Z d � Z e d � � Z
e d � � Z RS( c C` s, t j | � \ } } | s( t d � � | S( Nu this should not happen( R t get_address_listt AssertionError( R> t address_list( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyRY L s c
C` sm t | t � r� | j | � | d <} g } xg | j D]\ } | j t | j g | j D]3 } t | j pj d | j pv d | j
p� d � ^ qU � � q6 Wt | j � } n[ t
| d � s� | g } n g | D]- } t
| d � s� t d | g � n | ^ q� } g } | | d <| | d <d j g | D] } t | � ^ q$� | d <d | k ri| j | d � | d <n d S( Nu
parse_treeu u __iter__u addressesu groupsu defectsu , u decoded( Rb R RY R1 R_ R. R t
all_mailboxesR R R t listR t hasattrR
R4 ( R< R> R? Rn t groupst addrt mbRD t item( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR7 R s$ H 7
, c O` s8 t | j d � � | _ d | _ t � j | | � d S( Nu groups( R/ Re t _groupsR
R0 R R; ( R Rg Rh ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR; n s c C` s | j S( N( Rv ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyRr s s c C` sN | j d k rG t g | j D] } | j D] } | ^ q) q � | _ n | j S( N( R0 R
R/ Rv R1 ( R t groupt address( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR1 w s %N( R+ R, R
RZ R[ RY RU R7 R; R- Rr R1 ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyRk H s t UniqueAddressHeaderc B` s e Z d Z RS( i ( R+ R, RZ ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyRy s t SingleAddressHeaderc B` s e Z e d � � Z RS( c C` s; t | j � d k r0 t d j | j � � � n | j d S( Ni u9 value of single address header {} is not a single addressi ( R R1 R R R= ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyRx � s ( R+ R, R- Rx ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyRz � s t UniqueSingleAddressHeaderc B` s e Z d Z RS( i ( R+ R, RZ ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR{ � s t MIMEVersionHeaderc B` sb e Z d Z e e j � Z e d � � Z d � Z e
d � � Z e
d � � Z e
d � � Z
RS( i c C` s� | j | � | d <} t | � | d <| d j | j � | j d k rP d n | j | d <| j | d <| j d k r� d j | d | d � | d <n
d | d <d S( Nu
parse_treeu decodedu defectsu majoru minoru {}.{}u version( RY R t extendR t minorR
t majorR ( R< R> R? RE ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR7 � s "
!c O` sM | j d � | _ | j d � | _ | j d � | _ t � j | | � d S( Nu versionu majoru minor( Re t _versiont _majort _minorR R; ( R Rg Rh ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR; � s c C` s | j S( N( R� ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR � s c C` s | j S( N( R� ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR~ � s c C` s | j S( N( R� ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt version� s ( R+ R, RZ R[ R t parse_mime_versionRY RU R7 R; R- R R~ R� ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR| � s t ParameterizedMIMEHeaderc B` s5 e Z d Z e d � � Z d � Z e d � � Z RS( i c C` sx | j | � | d <} t | � | d <| d j | j � | j d k rW i | d <n t d � | j D� � | d <d S( Nu
parse_treeu decodedu defectsu paramsc s` s9 | ]/ \ } } t j | � j � t j | � f Vq d S( N( R R9 t lower( R2 R= R> ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pys <genexpr>� s ( RY R R} R t paramsR
t dict( R< R> R? RE ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR7 � s
c O` s) | j d � | _ t � j | | � d S( Nu params( Re t _paramsR R; ( R Rg Rh ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR; � s c C` s
| j j � S( N( R� t copy( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR� � s ( R+ R, RZ RU R7 R; R- R� ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR� � s
t ContentTypeHeaderc B` sM e Z e e j � Z d � Z e d � � Z e d � � Z e d � � Z
RS( c O` sG t � j | | � t j | j j � | _ t j | j j � | _ d S( N( R R; R R9 RA t maintypet _maintypet subtypet _subtype( R Rg Rh ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR; � s c C` s | j S( N( R� ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR� � s c C` s | j S( N( R� ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR� � s c C` s | j d | j S( Nu /( R� R� ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt content_type� s ( R+ R, R[ R t parse_content_type_headerRY R; R- R� R� R� ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR� � s
t ContentDispositionHeaderc B` s/ e Z e e j � Z d � Z e d � � Z RS( c O` sG t � j | | � | j j } | d k r1 | n t j | � | _ d S( N( R R; RA t content_dispositionR
R R9 t _content_disposition( R Rg Rh t cd( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR; � s c C` s | j S( N( R� ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR� � s ( R+ R, R[ R t parse_content_disposition_headerRY R; R- R� ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR� � s t ContentTransferEncodingHeaderc B` sD e Z d Z e e j � Z e d � � Z d � Z e
d � � Z RS( i c C` s? | j | � | d <} t | � | d <| d j | j � d S( Nu
parse_treeu decodedu defects( RY R R} R ( R< R> R? RE ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR7 � s c O` s/ t � j | | � t j | j j � | _ d S( N( R R; R R9 RA t ctet _cte( R Rg Rh ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR; s c C` s | j S( N( R� ( R ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR� s ( R+ R, RZ R[ R t& parse_content_transfer_encoding_headerRY RU R7 R; R- R� ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR� � s
u subjectu dateu resent-dateu orig-dateu senderu
resent-senderu tou resent-tou ccu resent-ccu bccu
resent-bccu fromu resent-fromu reply-tou mime-versionu content-typeu content-dispositionu content-transfer-encodingt HeaderRegistryc B` s; e Z d Z e e e d � Z d � Z d � Z d � Z RS( u% A header_factory and header registry.c C` s8 i | _ | | _ | | _ | r4 | j j t � n d S( u� Create a header_factory that works with the Policy API.
base_class is the class that will be the last class in the created
header class's __bases__ list. default_class is the class that will be
used if "name" (see __call__) does not appear in the registry.
use_default_map controls whether or not the default mapping of names to
specialized classes is copied in to the registry when the factory is
created. The default is True.
N( t registryt
base_classt
default_classt updatet _default_header_map( R R� R� t use_default_map( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR * s
c C` s | | j | j � <d S( uL Register cls as the specialized class for handling "name" headers.
N( R� R� ( R R= R< ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt map_to_type< s c C` sD | j j | j � | j � } t t d | j � | | j f i � S( Nu _( R� t getR� R� R' R R+ R� ( R R= R< ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt __getitem__B s c C` s | | | | � S( u� Create a header instance for header 'name' from 'value'.
Creates a header instance by creating a specialized class for parsing
and representing the specified header by combining the factory
base_class with a specialized class from the registry or the
default_class, and passing the name and value to the constructed
class's constructor.
( ( R R= R> ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt __call__F s
(
R+ R, RT R6 RX t TrueR R� R� R� ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyR� & s N(# RT t
__future__R R R t future.builtinsR R t future.utilsR t future.backports.emailR R R R t objectR R. R6 RF RX R] R^ Rj Rk Ry Rz R{ R| R� R� R� R� R� R� ( ( ( sV /opt/alt/python27/lib/python2.7/site-packages/future/backports/email/headerregistry.pyt <module> s^ Z5d '7
%
Mini Shell