home *** CD-ROM | disk | FTP | other *** search
/ Freelog 116 / FreelogNo116-JuilletSeptembre2013.iso / Bureautique / gImageReader / gimagereader_0.9-1_win32.exe / bin / email / utils.pyc (.txt) < prev   
Python Compiled Bytecode  |  2011-03-24  |  9KB  |  285 lines
  1. # Source Generated with Decompyle++
  2. # File: in.pyc (Python 2.7)
  3.  
  4. '''Miscellaneous utilities.'''
  5. __all__ = [
  6.     'collapse_rfc2231_value',
  7.     'decode_params',
  8.     'decode_rfc2231',
  9.     'encode_rfc2231',
  10.     'formataddr',
  11.     'formatdate',
  12.     'getaddresses',
  13.     'make_msgid',
  14.     'mktime_tz',
  15.     'parseaddr',
  16.     'parsedate',
  17.     'parsedate_tz',
  18.     'unquote']
  19. import os
  20. import re
  21. import time
  22. import base64
  23. import random
  24. import socket
  25. import urllib
  26. import warnings
  27. from email._parseaddr import quote
  28. from email._parseaddr import AddressList as _AddressList
  29. from email._parseaddr import mktime_tz
  30. from email._parseaddr import parsedate as _parsedate
  31. from email._parseaddr import parsedate_tz as _parsedate_tz
  32. from quopri import decodestring as _qdecode
  33. from email.encoders import _bencode, _qencode
  34. COMMASPACE = ', '
  35. EMPTYSTRING = ''
  36. UEMPTYSTRING = u''
  37. CRLF = '\r\n'
  38. TICK = "'"
  39. specialsre = re.compile('[][\\\\()<>@,:;".]')
  40. escapesre = re.compile('[][\\\\()"]')
  41.  
  42. def _identity(s):
  43.     return s
  44.  
  45.  
  46. def _bdecode(s):
  47.     """Decodes a base64 string.
  48.  
  49.     This function is equivalent to base64.decodestring and it's retained only
  50.     for backward compatibility. It used to remove the last 
  51.  of the decoded
  52.     string, if it had any (see issue 7143).
  53.     """
  54.     if not s:
  55.         return s
  56.     return None.decodestring(s)
  57.  
  58.  
  59. def fix_eols(s):
  60.     '''Replace all line-ending characters with \r
  61. .'''
  62.     s = re.sub('(?<!\\r)\\n', CRLF, s)
  63.     s = re.sub('\\r(?!\\n)', CRLF, s)
  64.     return s
  65.  
  66.  
  67. def formataddr(pair):
  68.     '''The inverse of parseaddr(), this takes a 2-tuple of the form
  69.     (realname, email_address) and returns the string value suitable
  70.     for an RFC 2822 From, To or Cc header.
  71.  
  72.     If the first element of pair is false, then the second element is
  73.     returned unmodified.
  74.     '''
  75.     (name, address) = pair
  76.     if name:
  77.         quotes = ''
  78.         if specialsre.search(name):
  79.             quotes = '"'
  80.         name = escapesre.sub('\\\\\\g<0>', name)
  81.         return '%s%s%s <%s>' % (quotes, name, quotes, address)
  82.  
  83.  
  84. def getaddresses(fieldvalues):
  85.     '''Return a list of (REALNAME, EMAIL) for each fieldvalue.'''
  86.     all = COMMASPACE.join(fieldvalues)
  87.     a = _AddressList(all)
  88.     return a.addresslist
  89.  
  90. ecre = re.compile('\n  =\\?                   # literal =?\n  (?P<charset>[^?]*?)   # non-greedy up to the next ? is the charset\n  \\?                    # literal ?\n  (?P<encoding>[qb])    # either a "q" or a "b", case insensitive\n  \\?                    # literal ?\n  (?P<atom>.*?)         # non-greedy up to the next ?= is the atom\n  \\?=                   # literal ?=\n  ', re.VERBOSE | re.IGNORECASE)
  91.  
  92. def formatdate(timeval = None, localtime = False, usegmt = False):
  93.     '''Returns a date string as specified by RFC 2822, e.g.:
  94.  
  95.     Fri, 09 Nov 2001 01:08:47 -0000
  96.  
  97.     Optional timeval if given is a floating point time value as accepted by
  98.     gmtime() and localtime(), otherwise the current time is used.
  99.  
  100.     Optional localtime is a flag that when True, interprets timeval, and
  101.     returns a date relative to the local timezone instead of UTC, properly
  102.     taking daylight savings time into account.
  103.  
  104.     Optional argument usegmt means that the timezone is written out as
  105.     an ascii string, not numeric one (so "GMT" instead of "+0000"). This
  106.     is needed for HTTP, and is only used when localtime==False.
  107.     '''
  108.     if timeval is None:
  109.         timeval = time.time()
  110.     if localtime:
  111.         now = time.localtime(timeval)
  112.         if time.daylight and now[-1]:
  113.             offset = time.altzone
  114.         else:
  115.             offset = time.timezone
  116.         (hours, minutes) = divmod(abs(offset), 3600)
  117.         if offset > 0:
  118.             sign = '-'
  119.         else:
  120.             sign = '+'
  121.         zone = '%s%02d%02d' % (sign, hours, minutes // 60)
  122.     else:
  123.         now = time.gmtime(timeval)
  124.         if usegmt:
  125.             zone = 'GMT'
  126.         else:
  127.             zone = '-0000'
  128.     return '%s, %02d %s %04d %02d:%02d:%02d %s' % ([
  129.         'Mon',
  130.         'Tue',
  131.         'Wed',
  132.         'Thu',
  133.         'Fri',
  134.         'Sat',
  135.         'Sun'][now[6]], now[2], [
  136.         'Jan',
  137.         'Feb',
  138.         'Mar',
  139.         'Apr',
  140.         'May',
  141.         'Jun',
  142.         'Jul',
  143.         'Aug',
  144.         'Sep',
  145.         'Oct',
  146.         'Nov',
  147.         'Dec'][now[1] - 1], now[0], now[3], now[4], now[5], zone)
  148.  
  149.  
  150. def make_msgid(idstring = None):
  151.     '''Returns a string suitable for RFC 2822 compliant Message-ID, e.g:
  152.  
  153.     <20020201195627.33539.96671@nightshade.la.mastaler.com>
  154.  
  155.     Optional idstring if given is a string used to strengthen the
  156.     uniqueness of the message id.
  157.     '''
  158.     timeval = time.time()
  159.     utcdate = time.strftime('%Y%m%d%H%M%S', time.gmtime(timeval))
  160.     pid = os.getpid()
  161.     randint = random.randrange(100000)
  162.     if idstring is None:
  163.         idstring = ''
  164.     else:
  165.         idstring = '.' + idstring
  166.     idhost = socket.getfqdn()
  167.     msgid = '<%s.%s.%s%s@%s>' % (utcdate, pid, randint, idstring, idhost)
  168.     return msgid
  169.  
  170.  
  171. def parsedate(data):
  172.     if not data:
  173.         return None
  174.     return None(data)
  175.  
  176.  
  177. def parsedate_tz(data):
  178.     if not data:
  179.         return None
  180.     return None(data)
  181.  
  182.  
  183. def parseaddr(addr):
  184.     addrs = _AddressList(addr).addresslist
  185.     if not addrs:
  186.         return ('', '')
  187.     return None[0]
  188.  
  189.  
  190. def unquote(str):
  191.     '''Remove quotes from a string.'''
  192.     if len(str) > 1:
  193.         if str.startswith('"') and str.endswith('"'):
  194.             return str[1:-1].replace('\\\\', '\\').replace('\\"', '"')
  195.         if None.startswith('<') and str.endswith('>'):
  196.             return str[1:-1]
  197.     return str
  198.  
  199.  
  200. def decode_rfc2231(s):
  201.     '''Decode string according to RFC 2231'''
  202.     parts = s.split(TICK, 2)
  203.     if len(parts) <= 2:
  204.         return (None, None, s)
  205.  
  206.  
  207. def encode_rfc2231(s, charset = None, language = None):
  208.     '''Encode string according to RFC 2231.
  209.  
  210.     If neither charset nor language is given, then s is returned as-is.  If
  211.     charset is given but not language, the string is encoded using the empty
  212.     string for language.
  213.     '''
  214.     import urllib as urllib
  215.     s = urllib.quote(s, safe = '')
  216.     if charset is None and language is None:
  217.         return s
  218.     if None is None:
  219.         language = ''
  220.     return "%s'%s'%s" % (charset, language, s)
  221.  
  222. rfc2231_continuation = re.compile('^(?P<name>\\w+)\\*((?P<num>[0-9]+)\\*?)?$')
  223.  
  224. def decode_params(params):
  225.     '''Decode parameters list according to RFC 2231.
  226.  
  227.     params is a sequence of 2-tuples containing (param name, string value).
  228.     '''
  229.     params = params[:]
  230.     new_params = []
  231.     rfc2231_params = { }
  232.     (name, value) = params.pop(0)
  233.     new_params.append((name, value))
  234.     while params:
  235.         (name, value) = params.pop(0)
  236.         if name.endswith('*'):
  237.             encoded = True
  238.         else:
  239.             encoded = False
  240.         value = unquote(value)
  241.         mo = rfc2231_continuation.match(name)
  242.         if mo:
  243.             (name, num) = mo.group('name', 'num')
  244.             if num is not None:
  245.                 num = int(num)
  246.             rfc2231_params.setdefault(name, []).append((num, value, encoded))
  247.             continue
  248.         new_params.append((name, '"%s"' % quote(value)))
  249.     if rfc2231_params:
  250.         for name, continuations in rfc2231_params.items():
  251.             value = []
  252.             extended = False
  253.             continuations.sort()
  254.             for num, s, encoded in continuations:
  255.                 if encoded:
  256.                     s = urllib.unquote(s)
  257.                     extended = True
  258.                 value.append(s)
  259.             
  260.             value = quote(EMPTYSTRING.join(value))
  261.             if extended:
  262.                 (charset, language, value) = decode_rfc2231(value)
  263.                 new_params.append((name, (charset, language, '"%s"' % value)))
  264.                 continue
  265.             new_params.append((name, '"%s"' % value))
  266.         
  267.     return new_params
  268.  
  269.  
  270. def collapse_rfc2231_value(value, errors = 'replace', fallback_charset = 'us-ascii'):
  271.     if isinstance(value, tuple):
  272.         rawval = unquote(value[2])
  273.         if not value[0]:
  274.             pass
  275.         charset = 'us-ascii'
  276.         
  277.         try:
  278.             return unicode(rawval, charset, errors)
  279.         except LookupError:
  280.             return unicode(rawval, fallback_charset, errors)
  281.         
  282.  
  283.     return unquote(value)
  284.  
  285.