]> git.phdru.name Git - mimedecode.git/blob - ANNOUNCE
Docs: Fix INSTALL.txt
[mimedecode.git] / ANNOUNCE
1
2                                 mimedecode.py
3
4 WHAT IS IT
5
6    Mail users, especially in non-English countries, often find that mail
7 messages arrived in different formats, with different content types, in
8 different encodings and charsets. Usually this is good because it allows us to
9 use appropriate format/encoding/whatever. Sometimes, though, some unification
10 is desirable. For example, one may want to put mail messages into an archive,
11 make HTML indices, run search indexer, etc. In such situations converting
12 messages to text in one character set and skipping some binary attachments is
13 much desirable.
14
15    Here is the solution - mimedecode.py.
16
17    This is a program to decode MIME messages. The program expects one input
18 file (either on command line or on stdin) which is treated as an RFC822
19 message, and decodes to stdout or an output file. If the file is not an RFC822
20 message it is just copied to the output one-to-one. If the file is a simple
21 RFC822 message it is decoded as one part. If it is a MIME message with multiple
22 parts ("attachments") all parts are decoded. Decoding can be controlled by
23 command-line options.
24
25
26 Version 2.8.0 (2017-10-??)
27
28    Python 3.
29
30    Monkey-patch email.message._formatparam under Python 3:
31    replace it with _formatparam from Python 2.7
32    to avoid re-encoding non-ascii params.
33
34    Fix: do not decode bytes to unicode under Python 2.7.
35
36    Stop supporting Python 2.6.
37
38    Code cleanup: fixed flake8 errors and warnings.
39
40
41 WHERE TO GET
42    Home page: http://phdru.name/Software/Python/#mimedecode
43     git clone http://git.phdru.name/mimedecode.git
44     git clone  git://git.phdru.name/mimedecode.git
45
46    Requires: Python 2.7 or Python 3.4+, m_lib.defenc 1.0+.
47    Tests require: tox, m_lib 3.1+.
48
49    Recommends: configured mailcap database.
50
51    Documentation: http://phdru.name/Software/Python/mimedecode.html
52       (also included in the package in html, man and txt formats).
53
54
55 AUTHOR
56    Oleg Broytman <phd@phdru.name>
57
58 COPYRIGHT
59    Copyright (C) 2001-2017 PhiloSoft Design.
60
61 LICENSE
62    GPL