gh-82530: Create blank function instead of invalid import for email example (GH-97529)

miss-islington · slateny · web-flow · commit cf61fa278e0a · 2022-09-25T21:15:52.000-07:00
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> (cherry picked from commit 2b428a1) Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
diff --git a/Doc/includes/email-read-alternative.py b/Doc/includes/email-read-alternative.py
@@ -8,8 +8,15 @@
 from email import policy
 from email.parser import BytesParser
 
-# An imaginary module that would make this work and be safe.
-from imaginary import magic_html_parser
+
+def magic_html_parser(html_text, partfiles):
+    """Return safety-sanitized html linked to partfiles.
+
+    Rewrite the href="cid:...." attributes to point to the filenames in partfiles.
+    Though not trivial, this should be possible using html.parser.
+    """
+    raise NotImplementedError("Add the magic needed")
+
 
 # In a real program you'd get the filename from the arguments.
 with open('outgoing.msg', 'rb') as fp:
@@ -62,9 +69,6 @@
     print("Don't know how to display {}".format(richest.get_content_type()))
     sys.exit()
 with tempfile.NamedTemporaryFile(mode='w', delete=False) as f:
-    # The magic_html_parser has to rewrite the href="cid:...." attributes to
-    # point to the filenames in partfiles.  It also has to do a safety-sanitize
-    # of the html.  It could be written using html.parser.
     f.write(magic_html_parser(body.get_content(), partfiles))
 webbrowser.open(f.name)
 os.remove(f.name)
