pop3mail v0.1.5 Pop3mail.FileStore

Store header, messages and attachments on the filesystem.

Summary

Functions

Convert a part’s content text from dos-format (with carriage return + linefeed after each line) to unix-format (with just the linefeed)

Construct a filename for an email message

get line seperator for text files. On windows/dos this is carriage return + linefeed, on other platforms it is just the linefeed

make directory. Returns created directory name full path

Remove characters which are undesirable for filesystems (like / : * ? “ < > | [ ] and control characters)

set default filename in the multipart_part

store one part of the body

Functions

dos2unix(multipart_part)

Convert a part’s content text from dos-format (with carriage return + linefeed after each line) to unix-format (with just the linefeed).

multipart_part - a Pop3mail.Part

get_default_filename(media_type, charset, index)

Construct a filename for an email message.

filename will be: ‘message’ . .

The default file extenstion for text/plain is .txt In other cases the last part of the media_type wil be used as extension.

get_line_separator()

get line seperator for text files. On windows/dos this is carriage return + linefeed, on other platforms it is just the linefeed.

mkdir(base_dir, name, unsafe_addition)

make directory. Returns created directory name full path.

directory is base_dir / name - unsafe_addition

unsafe_addition - append this to the directory name. It will be truncated at 45 characters. Unusual characters for the filesystem will be filtered out. If creating the directory with unsafe_addition fails, the directory will be created without it.

remove_unwanted_chars(text, max_chars)

Remove characters which are undesirable for filesystems (like / : * ? “ < > | [ ] and control characters)

set_default_filename(multipart_part)

set default filename in the multipart_part.

Calls FileStore.get_default_filename to get the default filename.

multipart_part - a Pop3mail.Part

store_mail_header(content, filename_prefix, unsafe_addition, dirname)

Store mail header.

filename is filename_prefix . unsafe_addition . txt

unsafe_addition - append this to the filename. It will be truncated at 35 characters. Unusual characters for the filesystem will be filtered out. If storing with unsafe_addition fails, the file will be stored without it.

store_part(multipart_part, base_dir)

store one part of the body.

Text files (media types text/plain, text/html for example) will be converted from dos to unix format on non-windows platforms.

multipart_part - a Pop3mail.Part

store_raw(mail_content, filename, dirname)

store raw email