fCN c @ s, d Z d d l m Z d d l m Z d d l m Z Gd d d Z Gd d d Z Gd d
d
e Z d d Z
Gd
d d Z Gd d d e Z Gd d d Z
Gd d d e
Z Gd d d Z Gd d d e Z Gd d d e Z Gd d d e Z Gd d d Z Gd d d Z Gd! d" d" e Z Gd# d$ d$ e Z Gd% d& d& Z i e d' 6e d( 6e
d) 6e d* 6e d+ 6e 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 6Z Gd: d; d; Z d< S(= 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 ( u utils( u errors( u _header_value_parserc B s | Ee Z d Z d d d d d d Z e d d Z e d d Z e d d Z e d
d Z d d
Z
d d Z d d Z d S( u Addressu 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( u Noneu TypeErroru parseru
get_addr_specu
ValueErroru formatu all_defectsu
local_partu domainu
_display_nameu _usernameu _domain( u selfu display_nameu usernameu domainu addr_specu a_su rest( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu __init__ s u Address.__init__c C s | j S( N( u
_display_name( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu display_name6 s u Address.display_namec C s | j S( N( u _username( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu username: s u Address.usernamec C s | j S( N( u _domain( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu domain> s u Address.domainc 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 <>( u setu usernameu lenu parseru
DOT_ATOM_ENDSu quote_stringu domain( u selfu namesetu lp( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu addr_specB s u Address.addr_specc C s d j | j | j | j S( Nu6 Address(display_name={!r}, username={!r}, domain={!r})( u formatu display_nameu usernameu domain( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu __repr__R s u Address.__repr__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 {} <{}>( u setu display_nameu lenu parseru SPECIALSu quote_stringu addr_specu format( u selfu namesetu dispu addr_spec( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu __str__V s u Address.__str__c C sP t | t | k r d S| j | j k oO | j | j k oO | j | j k S( NF( u typeu Falseu display_nameu usernameu domain( u selfu other( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu __eq__a s
u Address.__eq__N(
u __name__u
__module__u __qualname__u Noneu __init__u propertyu display_nameu usernameu domainu addr_specu __repr__u __str__u __eq__( u
__locals__( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu Address s % u Addressc B sn | Ee Z d Z d
d
d d Z e d d Z e d d Z d d Z d d
Z d d Z
d
S( u Groupc 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( u
_display_nameu tupleu
_addresses( u selfu display_nameu addresses( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu __init__k s u Group.__init__c C s | j S( N( u
_display_name( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu display_name} s u Group.display_namec C s | j S( N( u
_addresses( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu addresses s u Group.addressesc C s d j | j | j S( Nu' Group(display_name={!r}, addresses={!r}( u formatu display_nameu addresses( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu __repr__ s u Group.__repr__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 d | j D } | r d | n | } d j
| | S( Ni i u , c s s | ] } t | Vq d S( N( u str( u .0u x( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu s u Group.__str__..u u {}:{};( u display_nameu Noneu lenu addressesu stru setu parseru SPECIALSu quote_stringu joinu format( u selfu dispu namesetu adrstr( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu __str__ s $ u
Group.__str__c C s> t | t | k r d S| j | j k o= | j | j k S( NF( u typeu Falseu display_nameu addresses( u selfu other( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu __eq__ s u Group.__eq__N( u __name__u
__module__u __qualname__u Noneu __init__u propertyu display_nameu addressesu __repr__u __str__u __eq__( u
__locals__( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu Groupi s u Groupc B s | Ee Z d Z d Z d d Z d d Z e d d Z e d d Z d
d Z e
d d
Z d d Z d S( u
BaseHeaderu| 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 s{ i g d 6} | j | | t j | d rJ t j | d | d R s u' AddressHeader.parse..u __iter__c S s7 g | ]- } t | d s- t d | g n | q S( u addressesN( u hasattru Groupu None( u .0u item( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu
[ s u groupsu defectsu , c S s g | ] } t | q S( ( u str( u .0u item( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu
a s u decoded( u
isinstanceu stru value_parseru addressesu appendu Groupu display_nameu
all_mailboxesu listu all_defectsu hasattru join( u clsu valueu kwdsu address_listu groupsu addru defects( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu parseI s$
u AddressHeader.parsec s8 t | j d | _ d | _ t j | | d S( Nu groups( u tupleu popu _groupsu Noneu
_addressesu superu init( u selfu argsu kw( u __class__( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu inite s u AddressHeader.initc C s | j S( N( u _groups( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu groupsj s u AddressHeader.groupsc C s8 | j d k r1 t d d | j D | _ n | j S( Nc S s& g | ] } | j D] } | q q S( ( u addresses( u .0u groupu address( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu
q s u+ AddressHeader.addresses..( u
_addressesu Noneu tupleu _groups( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu addressesn s "u AddressHeader.addressesN(
u __name__u
__module__u __qualname__u Noneu max_countu staticmethodu value_parseru classmethodu parseu initu propertyu groupsu addresses( u
__locals__( ( u __class__u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu
AddressHeader? s u
AddressHeaderc B s | Ee Z d Z d Z d S( u UniqueAddressHeaderi N( u __name__u
__module__u __qualname__u max_count( u
__locals__( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu UniqueAddressHeaderv s u UniqueAddressHeaderc B s& | Ee Z d Z e d d Z d S( u SingleAddressHeaderc 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 ( u lenu addressesu
ValueErroru formatu name( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu address} s u SingleAddressHeader.addressN( u __name__u
__module__u __qualname__u propertyu address( u
__locals__( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu SingleAddressHeader{ s u SingleAddressHeaderc B s | Ee Z d Z d Z d S( u UniqueSingleAddressHeaderi N( u __name__u
__module__u __qualname__u max_count( u
__locals__( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu UniqueSingleAddressHeader s u UniqueSingleAddressHeaderc s | Ee Z d Z d Z e e j Z e d d Z f d d Z
e d d Z e d d Z
e d
d Z S( u MIMEVersionHeaderi 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 s u1 ParameterizedMIMEHeader.parse..( u value_parseru stru extendu all_defectsu paramsu None( u clsu valueu kwdsu
parse_tree( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu parse s
u ParameterizedMIMEHeader.parsec s) | j d | _ t j | | d S( Nu params( u popu _paramsu superu init( u selfu argsu kw( u __class__( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu init s u ParameterizedMIMEHeader.initc C s
| j j S( N( u _paramsu copy( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu params s u ParameterizedMIMEHeader.params( u __name__u
__module__u __qualname__u max_countu classmethodu parseu initu propertyu params( u
__locals__( ( u __class__u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu ParameterizedMIMEHeader s
u ParameterizedMIMEHeaderc sk | Ee Z d Z e e j Z f d d Z e d d Z e d d Z
e d d Z S( u ContentTypeHeaderc sG t j | | t j | j j | _ t j | j j | _ d S( N( u superu initu utilsu _sanitizeu _parse_treeu maintypeu _maintypeu subtypeu _subtype( u selfu argsu kw( u __class__( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu init s u ContentTypeHeader.initc C s | j S( N( u _maintype( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu maintype s u ContentTypeHeader.maintypec C s | j S( N( u _subtype( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu subtype s u ContentTypeHeader.subtypec C s | j d | j S( Nu /( u maintypeu subtype( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu content_type s u ContentTypeHeader.content_type( u __name__u
__module__u __qualname__u staticmethodu parseru parse_content_type_headeru value_parseru initu propertyu maintypeu subtypeu content_type( u
__locals__( ( u __class__u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu ContentTypeHeader s
u ContentTypeHeaderc sG | Ee Z d Z e e j Z f d d Z e d d Z S( u ContentDispositionHeaderc sG t j | | | j j } | d k r1 | n t j | | _ d S( N( u superu initu _parse_treeu content_dispositionu Noneu utilsu _sanitizeu _content_disposition( u selfu argsu kwu cd( u __class__( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu init s u ContentDispositionHeader.initc C s | j S( N( u _content_disposition( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu content_disposition s u, ContentDispositionHeader.content_disposition(
u __name__u
__module__u __qualname__u staticmethodu parseru parse_content_disposition_headeru value_parseru initu propertyu content_disposition( u
__locals__( ( u __class__u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu ContentDispositionHeader s u ContentDispositionHeaderc s_ | Ee Z d Z d Z e e j Z e d d Z f d d Z
e d d Z S( u ContentTransferEncodingHeaderi c C s? | j | | d <} t | | d <| d j | j d S( Nu
parse_treeu decodedu defects( u value_parseru stru extendu all_defects( u clsu valueu kwdsu
parse_tree( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu parse s u# ContentTransferEncodingHeader.parsec s/ t j | | t j | j j | _ d S( N( u superu initu utilsu _sanitizeu _parse_treeu cteu _cte( u selfu argsu kw( u __class__( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu init s u" ContentTransferEncodingHeader.initc C s | j S( N( u _cte( u self( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu cte s u! ContentTransferEncodingHeader.cte(
u __name__u
__module__u __qualname__u max_countu staticmethodu parseru& parse_content_transfer_encoding_headeru value_parseru classmethodu parseu initu propertyu cte( u
__locals__( ( u __class__u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu ContentTransferEncodingHeader s
u ContentTransferEncodingHeaderu 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-encodingc B sS | Ee Z d Z d Z e e d d d Z d d Z d d Z d d Z
d
S( u HeaderRegistryu% 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( u registryu
base_classu
default_classu updateu _default_header_map( u selfu
base_classu
default_classu use_default_map( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu __init__! s
u HeaderRegistry.__init__c C s | | j | j | j j | j | j } t d | j | | j f i S( Nu _( u registryu getu loweru
default_classu typeu __name__u
base_class( u selfu nameu cls( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu __getitem__9 s u HeaderRegistry.__getitem__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.
( ( u selfu nameu value( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu __call__= s
u HeaderRegistry.__call__NT( u __name__u
__module__u __qualname__u __doc__u
BaseHeaderu UnstructuredHeaderu Trueu __init__u map_to_typeu __getitem__u __call__( u
__locals__( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu HeaderRegistry s u HeaderRegistryN( u __doc__u emailu utilsu errorsu _header_value_parseru parseru Addressu Groupu stru
BaseHeaderu _reconstruct_headeru UnstructuredHeaderu UniqueUnstructuredHeaderu
DateHeaderu UniqueDateHeaderu
AddressHeaderu UniqueAddressHeaderu SingleAddressHeaderu UniqueSingleAddressHeaderu MIMEVersionHeaderu ParameterizedMIMEHeaderu ContentTypeHeaderu ContentDispositionHeaderu ContentTransferEncodingHeaderu _default_header_mapu HeaderRegistry( ( ( u9 /opt/alt/python33/lib64/python3.3/email/headerregistry.pyu sR Z5a '7
%