X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=ANNOUNCE;h=b6a51c23ed1c406fa684d638446d4e42b7a25c7e;hb=8d2e459bcceaea1530857ab58411e2e2426743a1;hp=613982dcf240370063a68bc8a21fe3960ae03ab5;hpb=9b68db3414c847b241e4e8ce2a0a636521d10c5c;p=mimedecode.git diff --git a/ANNOUNCE b/ANNOUNCE index 613982d..b6a51c2 100644 --- a/ANNOUNCE +++ b/ANNOUNCE @@ -1,94 +1,68 @@ - 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: -WHAT'S NEW in version 2.5.0 (2014-03-??) + mimedecode -t application/pdf -t application/postscript -t text/plain -b text/html -B 'image/*' -i '*/*' - Add option --set-header=header:value to set header's value (only at the top -level). - Add option --set-param=header:param=value to set header parameter's value -(only at the top level). The header must exist. +Version 2.9.0 (2017-12-12) - Add option -B to skip content-transfer-decoding binary attachments. + Split mimedecode.py into mimedecode library and a small script. - Fix a minor bug: if a multipart message (or a subpart) lacks any textual -content - avoid putting an excessive newline. + Made the library executable via ``python -m mimedecode``. -WHAT'S NEW in version 2.4.0 (2014-03-08) +Version 2.8.0 (2017-11-03) - Change option -d to accept a comma-separated list of headers: --d h1,h2,h3,... + Python 3. - Change option -d to decode all headers and accept a list of exceptions: --d *,-h1,-h2,... - - Change option -p to accept lists of headers and parameters: --p h1,h2,h3,..:p1,p2,p3,.. - - Allow * and exceptions for -p in the headers and parameters lists: --p *,-h1,-h2,-h3:p1,p2,p3 --p h1,h2,h3:*,-p1,-p2,-p3 --p *,-h1,-h2,-h3:*,-p1,-p2,-p3 - - Change option -r to accept a list of headers: -r h1,h2,h3,... - - Change option -r to remove all headers and accept a list of exceptions: --r *,-h1,-h2,... - - Change option -R to accept lists of headers and parameters: --R h1,h2,h3:p1,p2,p3 --R h1,h2,h3:*,-p1,-p2,-p3 --R *,-h1,-h2,-h3:p1,p2,p3 --R *,-h1,-h2,-h3:*,-p1,-p2,-p3 - - Publish docs in html format. - - Add ChangeLog. - -WHAT'S NEW in version 2.3.7 (2014-02-23) - - Add option -r to remove headers and option -R to remove headers parameters. + Stop supporting Python 2.6. WHERE TO GET Home page: http://phdru.name/Software/Python/#mimedecode + git clone https://github.com/phdru/mimedecode.git git clone http://git.phdru.name/mimedecode.git git clone git://git.phdru.name/mimedecode.git - Requires: Python 2.2.2+, m_lib 2.0+. + Requires: Python 2.7 or Python 3.3+, m_lib.defenc 1.0+. + Tests require: tox, m_lib 3.1+. Recommends: configured mailcap database. Documentation: http://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-2017 PhiloSoft Design. LICENSE GPL