ž
¦ÿ f÷7 c @ sÄ d Z d d l Z d d l m Z d d l m Z d d l m Z d d d g Z Gd d
„ d
ƒ Z d d „ Z
d
d „ Z Gd d „ d e d e j ƒZ
e Gd d „ d e
ƒ ƒ Z e ƒ Z d S( uw Policy framework for the email package.
Allows fine grained feature control of how the package parses and emits data.
i N( u header( u charset( u _has_surrogatesu Policyu Compat32u compat32c s\ | Ee Z d Z d Z ‡ f d d † Z d d „ Z d d „ Z d d „ Z d
d „ Z ‡ S( u _PolicyBaseu‡ Policy Object basic framework.
This class is useless unless subclassed. A subclass should define
class attributes with defaults for any values that are to be
managed by the Policy object. The constructor will then allow
non-default values to be set for these attributes at instance
creation time. The instance will be callable, taking these same
attributes keyword arguments, and returning a new instance
identical to the called instance except for those values changed
by the keyword arguments. Instances may be added, yielding new
instances with any non-default values from the right hand
operand overriding those in the left hand operand. That is,
A + B == A()
The repr of an instance can be used to reconstruct the object
if and only if the repr of the values can be used to reconstruct
those values.
c sj xc | j ƒ D]U \ } } t | | ƒ rD t t | ƒ j | | ƒ q
t d j | | j j ƒ ƒ ‚ q
Wd S( u‚ Create new Policy, possibly overriding some defaults.
See class docstring for a list of overridable attributes.
u* {!r} is an invalid keyword argument for {}N( u itemsu hasattru superu _PolicyBaseu __setattr__u TypeErroru formatu __class__u __name__( u selfu kwu nameu value( u __class__( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu __init__) s u _PolicyBase.__init__c C s; d d „ | j j ƒ Dƒ } d j | j j d j | ƒ ƒ S( Nc S s( g | ] \ } } d j | | ƒ ‘ q S( u {}={!r}( u format( u .0u nameu value( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu
8 s u( _PolicyBase.__repr__..u {}({})u , ( u __dict__u itemsu formatu __class__u __name__u join( u selfu args( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu __repr__7 s u _PolicyBase.__repr__c K s¬ | j j | j ƒ } x0 | j j ƒ D] \ } } t j | | | ƒ q% Wx] | j ƒ D]O \ } } t | | ƒ s‘ t d j | | j j ƒ ƒ ‚ n t j | | | ƒ qU W| S( uÐ Return a new instance with specified attributes changed.
The new instance has the same attribute values as the current object,
except for the changes passed in as keyword arguments.
u* {!r} is an invalid keyword argument for {}(
u __class__u __new__u __dict__u itemsu objectu __setattr__u hasattru TypeErroru formatu __name__( u selfu kwu newpolicyu attru value( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu clone< s u _PolicyBase.clonec C s@ t | | ƒ r d } n d } t | j | j j | ƒ ƒ ‚ d S( Nu' {!r} object attribute {!r} is read-onlyu! {!r} object has no attribute {!r}( u hasattru AttributeErroru formatu __class__u __name__( u selfu nameu valueu msg( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu __setattr__N s u _PolicyBase.__setattr__c C s | j | j S( u‰ Non-default values from right operand override those from left.
The object returned is a new instance of the subclass.
( u cloneu __dict__( u selfu other( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu __add__U s u _PolicyBase.__add__( u __name__u
__module__u __qualname__u __doc__u __init__u __repr__u cloneu __setattr__u __add__( u
__locals__( ( u __class__u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu _PolicyBase s u _PolicyBasec C s8 | j d d ƒ d } | j d d ƒ d } | d | S( Nu
i i ( u rsplitu split( u docu added_doc( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu _append_doc^ s u _append_docc C s× | j r= | j j d ƒ r= t | j d j | j ƒ | _ n x“ | j j ƒ D]‚ \ } } | j rM | j j d ƒ rM xX d d „ | j Dƒ D]= } t t | | ƒ d ƒ } | r‹ t | | j ƒ | _ Pq‹ q‹ WqM qM W| S( Nu +i c s s( | ] } | j ƒ D] } | Vq q d S( N( u mro( u .0u baseu c( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu h s u% _extend_docstrings..u __doc__( u __doc__u
startswithu _append_docu __bases__u __dict__u itemsu getattr( u clsu nameu attru cu doc( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu _extend_docstringsc s " u _extend_docstringsc B s¿ | Ee Z d Z d Z d Z d Z d Z d Z d d „ Z d d „ Z
d d
„ Z e j
d d „ ƒ Z e j
d
d „ ƒ Z e j
d d „ ƒ Z e j
d d „ ƒ Z e j
d d „ ƒ Z d S( u Policyu Controls for how messages are interpreted and formatted.
Most of the classes and many of the methods in the email package accept
Policy objects as parameters. A Policy object contains a set of values and
functions that control how input is interpreted and how output is rendered.
For example, the parameter 'raise_on_defect' controls whether or not an RFC
violation results in an error being raised or not, while 'max_line_length'
controls the maximum length of output lines when a Message is serialized.
Any valid attribute may be overridden when a Policy is created by passing
it as a keyword argument to the constructor. Policy objects are immutable,
but a new Policy object can be created with only certain values changed by
calling the Policy instance with keyword arguments. Policy objects can
also be added, producing a new Policy object in which the non-default
attributes set in the right hand operand overwrite those specified in the
left operand.
Settable attributes:
raise_on_defect -- If true, then defects should be raised as errors.
Default: False.
linesep -- string containing the value to use as separation
between output lines. Default '\n'.
cte_type -- Type of allowed content transfer encodings
7bit -- ASCII only
8bit -- Content-Transfer-Encoding: 8bit is allowed
Default: 8bit. Also controls the disposition of
(RFC invalid) binary data in headers; see the
documentation of the binary_fold method.
max_line_length -- maximum length of lines, excluding 'linesep',
during serialization. None or 0 means no line
wrapping is done. Default is 78.
u
u 8bitiN c C s& | j r | ‚ n | j | | ƒ d S( uZ Based on policy, either raise defect or call register_defect.
handle_defect(obj, defect)
defect should be a Defect subclass, but in any case must be an
Exception subclass. obj is the object on which the defect should be
registered if it is not raised. If the raise_on_defect is True, the
defect is raised as an error, otherwise the object and the defect are
passed to register_defect.
This method is intended to be called by parsers that discover defects.
The email package parsers always call it with Defect instances.
N( u raise_on_defectu register_defect( u selfu obju defect( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu
handle_defectŸ s u Policy.handle_defectc C s | j j | ƒ d S( uÒ Record 'defect' on 'obj'.
Called by handle_defect if raise_on_defect is False. This method is
part of the Policy API so that Policy subclasses can implement custom
defect handling. The default implementation calls the append method of
the defects attribute of obj. The objects used by the email package by
default that get passed to this method will always have a defects
attribute with an append method.
N( u defectsu append( u selfu obju defect( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu register_defect² s u Policy.register_defectc C s d S( u[ Return the maximum allowed number of headers named 'name'.
Called when a header is added to a Message object. If the returned
value is not 0 or None, and there are already a number of headers with
the name 'name' equal to the value returned, a ValueError is raised.
Because the default behavior of Message's __setitem__ is to append the
value to the list of headers, it is easy to create duplicate headers
without realizing it. This method allows certain headers to be limited
in the number of instances of that header that may be added to a
Message programmatically. (The limit is not observed by the parser,
which will faithfully produce as many headers as exist in the message
being parsed.)
The default implementation returns None for all header names.
N( u None( u selfu name( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu header_max_count¿ s u Policy.header_max_countc C s
t ‚ d S( uZ Given a list of linesep terminated strings constituting the lines of
a single header, return the (name, value) tuple that should be stored
in the model. The input lines should retain their terminating linesep
characters. The lines passed in by the email package may contain
surrogateescaped binary data.
N( u NotImplementedError( u selfu sourcelines( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu header_source_parseÒ s u Policy.header_source_parsec C s
t ‚ d S( u– Given the header name and the value provided by the application
program, return the (name, value) that should be stored in the model.
N( u NotImplementedError( u selfu nameu value( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu header_store_parseÜ s u Policy.header_store_parsec C s
t ‚ d S( uw Given the header name and the value from the model, return the value
to be returned to the application program that is requesting that
header. The value passed in by the email package may contain
surrogateescaped binary data if the lines were parsed by a BytesParser.
The returned value should not contain any surrogateescaped data.
N( u NotImplementedError( u selfu nameu value( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu header_fetch_parseã s u Policy.header_fetch_parsec C s
t ‚ d S( už Given the header name and the value from the model, return a string
containing linesep characters that implement the folding of the header
according to the policy controls. The value passed in by the email
package may contain surrogateescaped binary data if the lines were
parsed by a BytesParser. The returned value should not contain any
surrogateescaped data.
N( u NotImplementedError( u selfu nameu value( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu foldî s
u Policy.foldc C s
t ‚ d S( u% Given the header name and the value from the model, return binary
data containing linesep characters that implement the folding of the
header according to the policy controls. The value passed in by the
email package may contain surrogateescaped binary data.
N( u NotImplementedError( u selfu nameu value( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu fold_binaryú s u Policy.fold_binaryNF( u __name__u
__module__u __qualname__u __doc__u Falseu raise_on_defectu linesepu cte_typeu max_line_lengthu
handle_defectu register_defectu header_max_countu abcu abstractmethodu header_source_parseu header_store_parseu header_fetch_parseu foldu fold_binary( u
__locals__( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu Policyp s (
u metaclassc B sn | Ee 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( u Compat32u‰ +
This particular policy is the backward compatibility Policy. It
replicates the behavior of the email package version 5.1.
c C sC t | t ƒ s | St | ƒ r; t j | d t j d | ƒS| Sd S( Nu charsetu header_name( u
isinstanceu stru _has_surrogatesu headeru Headeru _charsetu UNKNOWN8BIT( u selfu nameu value( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu _sanitize_header
s u Compat32._sanitize_headerc C sU | d j d d ƒ \ } } | j d ƒ d j | d d … ƒ } | | j d ƒ f S( u: +
The name is parsed as everything up to the ':' and returned unmodified.
The value is determined by stripping leading whitespace off the
remainder of the first line, joining all subsequent lines together, and
stripping any trailing carriage return or linefeed characters.
i u :i u u Nu
( u splitu lstripu joinu rstrip( u selfu sourcelinesu nameu value( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu header_source_parse s &u Compat32.header_source_parsec C s
| | f S( u> +
The name and value are returned unmodified.
( ( u selfu nameu value( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu header_store_parse% s u Compat32.header_store_parsec C s | j | | ƒ S( u¨ +
If the value contains binary data, it is converted into a Header object
using the unknown-8bit charset. Otherwise it is returned unmodified.
( u _sanitize_header( u selfu nameu value( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu header_fetch_parse+ s u Compat32.header_fetch_parsec C s | j | | d d ƒS( u +
Headers are folded using the Header folding algorithm, which preserves
existing line breaks in the value, and wraps each resulting line to the
max_line_length. Non-ASCII binary data are CTE encoded using the
unknown-8bit charset.
u sanitizeT( u _foldu True( u selfu nameu value( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu fold2 s u
Compat32.foldc C s1 | j | | d | j d k ƒ} | j d d ƒ S( u +
Headers are folded using the Header folding algorithm, which preserves
existing line breaks in the value, and wraps each resulting line to the
max_line_length. If cte_type is 7bit, non-ascii binary data is CTE
encoded using the unknown-8bit charset. Otherwise the original source
header is used, with its existing line breaks and/or binary data.
u sanitizeu 7bitu asciiu surrogateescape( u _foldu cte_typeu encode( u selfu nameu valueu folded( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu fold_binary< s !u Compat32.fold_binaryc C sÞ g } | j d | ƒ t | t ƒ r‡ t | ƒ ro | rY t j | d t j d | ƒ} q„ | j | ƒ d } q t j | d | ƒ} n | } | d k rÁ | j | j d | j
d | j ƒ ƒ n | j | j
ƒ d j | ƒ S( Nu %s: u charsetu header_nameu linesepu
maxlinelenu (
u appendu
isinstanceu stru _has_surrogatesu headeru Headeru _charsetu UNKNOWN8BITu Noneu encodeu linesepu max_line_lengthu join( u selfu nameu valueu sanitizeu partsu h( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu _foldH s"
u Compat32._foldN( u __name__u
__module__u __qualname__u __doc__u _sanitize_headeru header_source_parseu header_store_parseu header_fetch_parseu foldu fold_binaryu _fold( u
__locals__( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu Compat32 s
( u __doc__u abcu emailu headeru charsetu _charsetu email.utilsu _has_surrogatesu __all__u _PolicyBaseu _append_docu _extend_docstringsu ABCMetau Policyu Compat32u compat32( ( ( u6 /opt/alt/python33/lib64/python3.3/email/_policybase.pyu s L
• `