X-Git-Url: https://git.phdru.name/?p=mimedecode.git;a=blobdiff_plain;f=ANNOUNCE;h=e38e966c67f184f7ee59055f2e4b119b6c50fb43;hp=d38f05156a0909b1487de8866f4b95477c154e0e;hb=HEAD;hpb=3782c584d7ed8cc1abf70c2b5a6b5d1963366a2f diff --git a/ANNOUNCE b/ANNOUNCE index d38f051..f34c5d1 100644 --- a/ANNOUNCE +++ b/ANNOUNCE @@ -1,76 +1,98 @@ - mimedecode.py + mimedecode WHAT IS IT Mail users, especially in non-English countries, often find that mail messages arrived in different formats, with different content types, in -different encodings and charsets. Usually this is good because it allows us to -use appropriate format/encoding/whatever. Sometimes, though, some unification -is desirable. For example, one may want to put mail messages into an archive, -make HTML indices, run search indexer, etc. In such situations converting -messages to text in one character set and skipping some binary attachments is -much desirable. +different encodings and charsets. Usually this is good because it allows +us to use appropriate format/encoding/whatever. Sometimes, though, some +unification is desirable. For example, one may want to put mail messages +into an archive, make HTML indices, run search indexer, etc. In such +situations converting messages to text in one character set and skipping +some binary attachments is much desirable. - Here is the solution - mimedecode.py. + Here is the solution - mimedecode. - This is a program to decode MIME messages. The program expects one input -file (either on command line or on stdin) which is treated as an RFC822 -message, and decodes to stdout or an output file. If the file is not an RFC822 -message it is just copied to the output one-to-one. If the file is a simple -RFC822 message it is decoded as one part. If it is a MIME message with multiple -parts ("attachments") all parts are decoded. Decoding can be controlled by -command-line options. + This is a program to decode MIME messages. The program expects one +input file (either on command line or on stdin) which is treated as an +RFC822 message, and decodes to stdout or an output file. If the file is +not an RFC822 message it is just copied to the output one-to-one. If the +file is a simple RFC822 message it is decoded as one part. If it is a +MIME message with multiple parts ("attachments") all parts are decoded. +Decoding can be controlled by command-line options. + Think about said mail archive; for example, its maintainer wants to +put there only texts, convert PDF/Postscript to text, pass HTML and +images decoding base64 to html but leaving images encoded, and ignore +everything else. This is how it could be done: -Version 2.6.0 (2014-06-08) + mimedecode -t application/pdf -t application/postscript -t text/plain -b text/html -B 'image/*' -i '*/*' - Make options -e/-i to work with multipart subparts. - Add option -I to completely ignore a part - no headers, no body, - no warning. +Version 3.1.0.post7: - Open all output files in binary mode. Output os.linesep instead of '\n'. + GHActions: Test with Python 3.12. - Test --save-headers|body|message masks one after another to allow - saving a message or a subpart to more than one file. +Version 3.1.0.post6 (2023-09-17) -WHAT'S NEW in version 2.5.0 (2014-03-18) + GHActions: Ensure ``pip`` only if needed - Add option --set-header=header:value to set header's value (only at the top -level). + This is to work around a problem in conda with Python 3.7 - + it brings in wrong version of ``setuptools`` incompatible with Python 3.7. - Add option --set-param=header:param=value to set header parameter's value -(only at the top level). The header must exist. +Version 3.1.0.post5 (2023-07-07) - Add option -B to skip content-transfer-decoding binary attachments. + Install all Python and PyPy versions from ``conda-forge``. - Add options --save-headers, --save-body and --save-message to save decoded -headers/bodies/messages to files. +Version 3.1.0.post4 (2022-12-15) - Add option -O to set the destination directory for output files. + Use ``conda`` to install old Python versions. - Fix a minor bug: if a multipart message (or a subpart) lacks any textual -content - avoid putting an excessive newline. +Version 3.1.0.post3 (2022-12-02) + + PyPy3. + +Version 3.1.0.post2 + + Python 3.11. + +Version 3.1.0.post1 (2021-09-24) + + GitHub Actions. + + Stop testing at Travis. + +Version 3.1.0 (2021-05-23) + + Convert mimedecode.docbook to reST. Generate html/man/text + using Sphinx. + + Replaced outdated and insecure `mktemp` with `NamedTemporaryFile`. + + Python 3.8, 3.9. WHERE TO GET - Home page: http://phdru.name/Software/Python/#mimedecode - git clone http://git.phdru.name/mimedecode.git + Home page: https://phdru.name/Software/Python/#mimedecode + git clone https://github.com/phdru/mimedecode.git + git clone https://git.phdru.name/mimedecode.git git clone git://git.phdru.name/mimedecode.git - Requires: Python 2.6+, m_lib 3.1+, m_lib.defenc 1.0+. + Requires: Python 2.7 or Python 3.4+, m_lib.defenc 1.0+. + Tests require: tox, m_lib 3.1+. Recommends: configured mailcap database. - Documentation: http://phdru.name/Software/Python/mimedecode.html + Documentation: https://phdru.name/Software/Python/mimedecode.html (also included in the package in html, man and txt formats). + AUTHOR Oleg Broytman COPYRIGHT - Copyright (C) 2001-2014 PhiloSoft Design. + Copyright (C) 2001-2024 PhiloSoft Design. LICENSE GPL