Metadata-Version: 2.1
Name: imio.email.dms
Version: 0.29.2
Summary: Package to read emails and send them to DMS
Home-page: https://pypi.python.org/pypi/imio.email.dms
Author: Laurent Lasudry
Author-email: info@affinitic.be
License: GPL version 2
Keywords: Python
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Requires-Python: >=3.10, <3.11
License-File: LICENSE.GPL
License-File: LICENSE.rst
Requires-Dist: setuptools
Requires-Dist: docopt
Requires-Dist: zc.lockfile
Requires-Dist: imio.email.parser
Requires-Dist: imio.pyutils
Requires-Dist: pathlib2; python_version < "3.0"
Requires-Dist: requests
Requires-Dist: six
Requires-Dist: configparser

==============
imio.email.dms
==============

This package ensures the import of incoming emails into DMS.

Features
========

1. fetch waiting emails from IMAP mailbox
2. parse emails (headers, attachments, ...)
3. generate a PDF email preview
4. send informations to DMS webservice
5. mark emails as imported

Usage
=====

To process emails, you can execute ::

 bin/process_mails config.ini

See `config.ini` file for various parameters.

For usage with Docker, it's similar to `bin/process_mails` but you need to build the Docker image first ::

 docker build -t imio.email.dms .
 docker run --rm imio.email.dms config.ini

Release
=======

On each commit on this repo, Jenkins will create a new Docker image, push it on imio staging registry and restart staging instance.
On each release (new tag with zest.releaser_) Jenkins copy latest staging image and push it on prod registry

.. _zest.releaser: https://pypi.org/project/zest.releaser/

Errors
======

In case the importation process fails, the corresponding emails are marked as
errors and are not taken into account anymore.
An email notification is sent with the problematic email attached.
To process them again, you can execute ::

 bin/process_mails config.ini --requeue_errors

Requirements
============

package wkhtmltopdf

Contribute
==========

- Issue Tracker: https://github.com/collective/imio.email.dms/issues
- Source Code: https://github.com/collective/imio.email.dms

License
=======

The project is licensed under the GPLv2.


Contributors
============

- Laurent Lasudry, info@affinitic.be
- Nicolas Demonté, info@affinitic.be
- Stéphan Geulette, stephan.geulette@imio.be


Changelog
=========

0.29.2 (2025-03-12)
-------------------

- Improved test coverage.
  [cadam]
- Decreased pdf attachment compression to improve quality.
  [cadam]

0.29.1 (2025-02-27)
-------------------

- imio.email.parser: improved `parser.correct_addresses`.
  [sgeulette]

0.29.0 (2025-02-18)
-------------------

- Replaced `utils.safe_unicode` by `utils.safe_text`.
  [sgeulette]
- Added `utils.save_attachment` function.
  [sgeulette]
- Improved `utils.get_reduced_size` to be more flexible.
  [sgeulette]
- Added notification for agent if exception occurs.
  [cadam]
- Changed options in `process_mails` to be more flexible.
  [sgeulette]
- Resized inline images in email body.
  [sgeulette,cadam]
- imio.email.parser improvements.
  [sgeulette]
- Added `main.compress_pdf` function to compress pdf attachment.
  [cadam]
- Added pdbp in buildout and env var to use breakpoint() alone.
  [sgeulette]
- Pinned versions. Added dependency. Corrected source.
  [sgeulette]

0.28.0 (2024-10-07)
-------------------

- Improved failed attempt message.
  [sgeulette]
- Corrected email parsing with empty body (avoiding AttributeError on is_attachment).
  [sgeulette]
- Added test script
  [sgeulette]

0.27 (2024-08-23)
-----------------

- Added `post_with_retries` function, to handle operational errors and timeout from webservice. 5 tries each 30 seconds.
  [sgeulette]
- Added new option `mail_id` to treat only a specific mail id (in any status).
  [sgeulette]
- Improved mark_mail_as_imported
  [sgeulette]
- Upgraded mr.developer and reportlab, Blacked files, Code improvements, Corrected main branch name in gha
  [sgeulette]

0.26 (2023-09-13)
-----------------

- Lowercased email addresses in parser.
  [sgeulette]

0.25 (2023-08-24)
-----------------

- Handled "OSError: broken data stream when reading image file"
  [sgeulette]
- Set lower smtp sent limit
  [sgeulette]

0.24 (2023-05-23)
-----------------

- Corrected unicode error when creating unsupported email.
  [sgeulette]

0.23 (2023-05-23)
-----------------

- Added email subject in unsupported message.
  [sgeulette]
- Added MS Exchange "resent-from" in parser
  [sgeulette]

0.22 (2023-02-03)
-----------------

- Prefixed gotten eml with mailbox login.
  [sgeulette]
- Set a size limit to attach the notified email: so the output email can be sent.
  [sgeulette]
- Handled an exif parsing error
  [sgeulette]
- Renamed filenames in tar when already in
  [sgeulette]

0.21 (2023-01-25)
-----------------

- Changed orientation of image following exif information.
  [sgeulette]
- Added pil test script.
  [sgeulette]

0.20 (2023-01-24)
-----------------

- Kept exif information from original resized image.
  [sgeulette]

0.19 (2022-12-01)
-----------------

- Handled specifically IBM Notes forward (parser modification).
  [sgeulette]

0.18 (2022-11-28)
-----------------

- Handled specifically Apple Mail forward with image in content (parser modification).
  [sgeulette]

0.17 (2022-07-03)
-----------------

- Changed process_mails output to filter easierly.
  [sgeulette]
- Added new option `reset_flags` for `process_mails` to reset all flags of an email id.
  [sgeulette]
- Used default policy in parser
  [sgeulette]
- Output rfc822 payload in parser
  [sgeulette]

0.16 (2022-06-07)
-----------------

- Used now email2pdf2.
  [sgeulette]
- Handled exception when sending notification mail
  [sgeulette]

0.15 (2022-05-12)
-----------------

- Set locale time to avoid UTC time
  [sgeulette]

0.14 (2022-04-29)
-----------------

- Do not mark mail in dev_mode.
  [sgeulette]
- Handled image save when quality parameter is not compliant
  [sgeulette]
- Avoided error with x-forward
  [sgeulette]

0.13 (2022-04-19)
-----------------

- Retried 5 times to upload when webservice has an unknown response
  [sgeulette]
- Handled UnidentifiedImageError when opening image file to resize
  [sgeulette]
- Corrected UnicodeEncodeError when sending notification email
  [sgeulette]

0.12 (2022-03-31)
-----------------

- Used correct recipient for ignored mail
  [sgeulette]
- Used `smtp.send_message` to consider bcc
  [sgeulette]

0.11 (2022-03-14)
-----------------

- Corrected false 'inline' disposition attachments.
  [sgeulette]
- Do not include inline attachments
  [sgeulette]
- Reduced image attachments
  [sgeulette]
- Improved `--list_emails` output.
  [sgeulette]
- Added dev_mode flag
  [sgeulette]

0.10 (2022-02-17)
-----------------

- Removed newline characters from attachment filename in imio.email.parser.
  [sgeulette]

0.9 (2022-02-17)
----------------

- Removed pattern in sent email for ignored error.
  [sgeulette]
- Corrected badly addresses from email.utils.getAddresses (in imio.email.parser)
  [sgeulette]
- Upgraded mail-parser
  [sgeulette]

0.8 (2022-01-24)
----------------

- Ignored 'ignored' flaged mails when getting waiting emails.
  [sgeulette]

0.7 (2022-01-21)
----------------

- Added transferer check following pattern to avoid anyone can push an email in the app.
  [sgeulette]

0.6 (2022-01-13)
----------------

- Corrected bug in email2pdf.
  [sgeulette]

0.5 (2022-01-11)
----------------

- Added --stats option.
  [sgeulette]
- Added timeout in email2pdf to avoid wasting time in external image retriever
  [sgeulette]

0.4 (2021-11-24)
----------------

- Send email notification after clean_mails.
  [sgeulette]
- Corrected error in get_eml option. Added `save_as_eml` function.
  [sgeulette]
- Handled pdf conversion error by sending eml file
  [sgeulette]
- Set unsupported email in french
  [sgeulette]

0.3 (2021-07-23)
----------------

- Avoid exception when decoding in `get_email`
  [sgeulette]
- Added script to clean old processed emails.
  [sgeulette]
- Changed --list_emails parameter in main script
  [sgeulette]

0.2 (2021-05-12)
----------------

- Used https in requests urls if port is 443.
  [sgeulette]

0.1 (2021-05-12)
----------------

- Initial release.
  [laulaz, sgeulette]
