summaryrefslogtreecommitdiff
path: root/modules/language/python/module/email.py
diff options
context:
space:
mode:
Diffstat (limited to 'modules/language/python/module/email.py')
-rw-r--r--modules/language/python/module/email.py49
1 files changed, 49 insertions, 0 deletions
diff --git a/modules/language/python/module/email.py b/modules/language/python/module/email.py
new file mode 100644
index 0000000..f50af12
--- /dev/null
+++ b/modules/language/python/module/email.py
@@ -0,0 +1,49 @@
+module(email)
+
+# Copyright (C) 2001-2007 Python Software Foundation
+# Author: Barry Warsaw
+# Contact: email-sig@python.org
+
+"""A package for parsing, handling, and generating email messages."""
+
+__all__ = [
+ 'message_from_file',
+ 'message_from_binary_file',
+ 'message_from_string',
+ 'message_from_bytes',
+ ]
+
+# Some convenience routines. Don't import Parser and Message as side-effects
+# of importing email since those cascadingly import most of the rest of the
+# email package.
+def message_from_string(s, *args, **kws):
+ """Parse a string into a Message object model.
+
+ Optional _class and strict are passed to the Parser constructor.
+ """
+ import email
+ return email.Parser(*args, **kws).parsestr(s)
+
+def message_from_bytes(s, *args, **kws):
+ """Parse a bytes string into a Message object model.
+
+ Optional _class and strict are passed to the Parser constructor.
+ """
+ import email
+ return email.BytesParser(*args, **kws).parsebytes(s)
+
+def message_from_file(fp, *args, **kws):
+ """Read a file and parse its contents into a Message object model.
+
+ Optional _class and strict are passed to the Parser constructor.
+ """
+ import email
+ return email.Parser(*args, **kws).parse(fp)
+
+def message_from_binary_file(fp, *args, **kws):
+ """Read a binary file and parse its contents into a Message object model.
+
+ Optional _class and strict are passed to the Parser constructor.
+ """
+ import email
+ return email.BytesParser(*args, **kws).parse(fp)