Example provided in 19.1.14.1. Examples using the Provisional API
at https://docs.python.org/3.4/library/email-examples.html?highlight=email%20example

Doesn't work. This could be a EmailMessage class issue also?

Could you please specify which example of the Provisional API among 2 examples of the documentation and how does it not work? Thank you

Is this your bug:

  Traceback (most recent call last):
    File "/tmp/email_example.py", line 9, in <module>
      with open(textfile) as fp:
  NameError: name 'textfile' is not defined

?

If not, can you please provide us the full traceback ?

#26426 has been marked as duplicate of this, and contains more information about the error.

emailexample.patch fixes the specific issue mentioned in #26426: the Address constructor is now used as documented.  It changes the final output of the two combined examples (as presented in the documentation) accordingly.

In general it seems as though these examples (the two in in 19.1.14.1) were meant to be read, not run.  To run them, the user would have to supply (1) their own roasted-asparagus.jpg, (2) their own local SMTP server, and (3) their own implementation of imaginary.magic_html_parser.  However, the Address constructor usage issue was real, and I was able to generate the relevant output without (2) and (3).

Thank you for the patch.  I blame the mistake on too great a familiarity with the old API :)

New changeset 1530fd9a7089 by R David Murray in branch '3.5':
#26176: fix usage of Address constructor in email examples.
https://hg.python.org/cpython/rev/1530fd9a7089

New changeset a9c11fecd83b by R David Murray in branch 'default':
Merge: #26176: fix usage of Address constructor in email examples.
https://hg.python.org/cpython/rev/a9c11fecd83b

Thanks, Nathan.