Home | History | Annotate | Download | only in library
      1 .. _email-examples:
      2 
      3 :mod:`email`: Examples
      4 ----------------------
      5 
      6 Here are a few examples of how to use the :mod:`email` package to read, write,
      7 and send simple email messages, as well as more complex MIME messages.
      8 
      9 First, let's see how to create and send a simple text message:
     10 
     11 .. literalinclude:: ../includes/email-simple.py
     12 
     13 
     14 And parsing RFC822 headers can easily be done by the parse(filename) or
     15 parsestr(message_as_string) methods of the Parser() class:
     16 
     17 .. literalinclude:: ../includes/email-headers.py
     18 
     19 
     20 Here's an example of how to send a MIME message containing a bunch of family
     21 pictures that may be residing in a directory:
     22 
     23 .. literalinclude:: ../includes/email-mime.py
     24 
     25 
     26 Here's an example of how to send the entire contents of a directory as an email
     27 message: [1]_
     28 
     29 .. literalinclude:: ../includes/email-dir.py
     30 
     31 
     32 Here's an example of how to unpack a MIME message like the one
     33 above, into a directory of files:
     34 
     35 .. literalinclude:: ../includes/email-unpack.py
     36 
     37 Here's an example of how to create an HTML message with an alternative plain
     38 text version: [2]_
     39 
     40 .. literalinclude:: ../includes/email-alternative.py
     41 
     42 
     43 .. rubric:: Footnotes
     44 
     45 .. [1] Thanks to Matthew Dixon Cowles for the original inspiration and examples.
     46 .. [2] Contributed by Martin Matejek.
     47