ANNOUNCE

   1
   2                                   mimedecode
   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
   9 us to use appropriate format/encoding/whatever. Sometimes, though, some
  10 unification is desirable. For example, one may want to put mail messages
  11 into an archive, make HTML indices, run search indexer, etc. In such
  12 situations converting messages to text in one character set and skipping
  13 some binary attachments is much desirable.
  14
  15    Here is the solution - mimedecode.
  16
  17    This is a program to decode MIME messages. The program expects one
  18 input file (either on command line or on stdin) which is treated as an
  19 RFC822 message, and decodes to stdout or an output file. If the file is
  20 not an RFC822 message it is just copied to the output one-to-one. If the
  21 file is a simple RFC822 message it is decoded as one part. If it is a
  22 MIME message with multiple parts ("attachments") all parts are decoded.
  23 Decoding can be controlled by command-line options.
  24
  25    Think about said mail archive; for example, its maintainer wants to
  26 put there only texts, convert PDF/Postscript to text, pass HTML and
  27 images decoding base64 to html but leaving images encoded, and ignore
  28 everything else. This is how it could be done:
  29
  30    mimedecode -t application/pdf -t application/postscript -t text/plain -b text/html -B 'image/*' -i '*/*'
  31
  32
  33 Version 3.1.0.post6 (2023-09-17)
  34
  35     GHActions: Ensure ``pip`` only if needed
  36
  37     This is to work around a problem in conda with Python 3.7 -
  38     it brings in wrong version of ``setuptools`` incompatible with Python 3.7.
  39
  40 Version 3.1.0.post5 (2023-07-07)
  41
  42    Install all Python and PyPy versions from ``conda-forge``.
  43
  44 Version 3.1.0.post4 (2022-12-15)
  45
  46    Use ``conda`` to install old Python versions.
  47
  48 Version 3.1.0.post3 (2022-12-02)
  49
  50    PyPy3.
  51
  52 Version 3.1.0.post2
  53
  54    Python 3.11.
  55
  56 Version 3.1.0.post1 (2021-09-24)
  57
  58    GitHub Actions.
  59
  60    Stop testing at Travis.
  61
  62 Version 3.1.0 (2021-05-23)
  63
  64    Convert mimedecode.docbook to reST. Generate html/man/text
  65    using Sphinx.
  66
  67    Replaced outdated and insecure `mktemp` with `NamedTemporaryFile`.
  68
  69    Python 3.8, 3.9.
  70
  71
  72 WHERE TO GET
  73    Home page: https://phdru.name/Software/Python/#mimedecode
  74     git clone https://github.com/phdru/mimedecode.git
  75     git clone https://git.phdru.name/mimedecode.git
  76     git clone  git://git.phdru.name/mimedecode.git
  77
  78    Requires: Python 2.7 or Python 3.4+, m_lib.defenc 1.0+.
  79    Tests require: tox, m_lib 3.1+.
  80
  81    Recommends: configured mailcap database.
  82
  83    Documentation: https://phdru.name/Software/Python/mimedecode.html
  84       (also included in the package in html, man and txt formats).
  85
  86
  87 AUTHOR
  88    Oleg Broytman <phd@phdru.name>
  89
  90 COPYRIGHT
  91    Copyright (C) 2001-2022 PhiloSoft Design.
  92
  93 LICENSE
  94    GPL