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.post7:
  34
  35     GHActions: Test with Python 3.12.
  36
  37 Version 3.1.0.post6 (2023-09-17)
  38
  39     GHActions: Ensure ``pip`` only if needed
  40
  41     This is to work around a problem in conda with Python 3.7 -
  42     it brings in wrong version of ``setuptools`` incompatible with Python 3.7.
  43
  44 Version 3.1.0.post5 (2023-07-07)
  45
  46    Install all Python and PyPy versions from ``conda-forge``.
  47
  48 Version 3.1.0.post4 (2022-12-15)
  49
  50    Use ``conda`` to install old Python versions.
  51
  52 Version 3.1.0.post3 (2022-12-02)
  53
  54    PyPy3.
  55
  56 Version 3.1.0.post2
  57
  58    Python 3.11.
  59
  60 Version 3.1.0.post1 (2021-09-24)
  61
  62    GitHub Actions.
  63
  64    Stop testing at Travis.
  65
  66 Version 3.1.0 (2021-05-23)
  67
  68    Convert mimedecode.docbook to reST. Generate html/man/text
  69    using Sphinx.
  70
  71    Replaced outdated and insecure `mktemp` with `NamedTemporaryFile`.
  72
  73    Python 3.8, 3.9.
  74
  75
  76 WHERE TO GET
  77    Home page: https://phdru.name/Software/Python/#mimedecode
  78     git clone https://github.com/phdru/mimedecode.git
  79     git clone https://git.phdru.name/mimedecode.git
  80     git clone  git://git.phdru.name/mimedecode.git
  81
  82    Requires: Python 2.7 or Python 3.4+, m_lib.defenc 1.0+.
  83    Tests require: tox, m_lib 3.1+.
  84
  85    Recommends: configured mailcap database.
  86
  87    Documentation: https://phdru.name/Software/Python/mimedecode.html
  88       (also included in the package in html, man and txt formats).
  89
  90
  91 AUTHOR
  92    Oleg Broytman <phd@phdru.name>
  93
  94 COPYRIGHT
  95    Copyright (C) 2001-2024 PhiloSoft Design.
  96
  97 LICENSE
  98    GPL