[Bps-public-commit] app-wsgetmail branch master updated. 0.06-11-ga7c57e2
BPS Git Server
git at git.bestpractical.com
Fri Sep 23 15:40:35 UTC 2022
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "app-wsgetmail".
The branch, master has been updated
via a7c57e246715a27fd24325496785b51703e34adb (commit)
via 0525771bbf76c6fc72dad4de57d94da03261ff57 (commit)
via 3e0bcb901a894161ff8e59d8fdfabb66a9ff1725 (commit)
via 8ef1da91bfb1f5d38766fefafef6b6b64173f475 (commit)
via 57baf42a22bed75694b3cac3730921d12a58dc2c (commit)
via c2b00125b22300cec6d1980018f6fa29682e1240 (commit)
via 79139e24975414f00e4951c2e68a1f8def9ce1b7 (commit)
via 32374a4c67b98b71d73f6ed3419657a0ed6a17e1 (commit)
via cfa4ec14c38de28970c2c3f3a26fac40d762adf9 (commit)
via 3c804d44a6f9996918f962d8cf829abf68ef191b (commit)
via ef1166688563c07c0f7e9a15121aa56c0132ca3e (commit)
from df9ae2b6a787366f9a2c6c2b394c2a308c86d019 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit a7c57e246715a27fd24325496785b51703e34adb
Author: sunnavy <sunnavy at bestpractical.com>
Date: Fri Sep 23 23:30:07 2022 +0800
Prep 0.07
diff --git a/Changes b/Changes
index 60782c6..0855a93 100644
--- a/Changes
+++ b/Changes
@@ -1,6 +1,6 @@
Revision history for App-wsgetmail
-0.07 ??/??/??
+0.07 22/09/23
* Add documentation about error messages, warnings, and
diagnosing problems with processing.
* Count and report messages with errors in post-fetch processing
diff --git a/MANIFEST b/MANIFEST
index b3288bc..28b4209 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -12,7 +12,6 @@ inc/Module/Install/Makefile.pm
inc/Module/Install/Metadata.pm
inc/Module/Install/ReadmeFromPod.pm
inc/Module/Install/Scripts.pm
-inc/Module/Install/Substitute.pm
inc/Module/Install/Win32.pm
inc/Module/Install/WriteAll.pm
lib/App/wsgetmail.pm
diff --git a/META.yml b/META.yml
index a49b083..102d520 100644
--- a/META.yml
+++ b/META.yml
@@ -3,9 +3,9 @@ abstract: 'Fetch mail from the cloud using webservices'
author:
- 'Best Practical Solutions, LLC <modules at bestpractical.com>'
build_requires:
- ExtUtils::MakeMaker: 6.36
+ ExtUtils::MakeMaker: 6.59
configure_requires:
- ExtUtils::MakeMaker: 6.36
+ ExtUtils::MakeMaker: 6.59
distribution_type: module
dynamic_config: 1
generated_by: 'Module::Install version 1.19'
@@ -32,13 +32,13 @@ requires:
Module::Load: 0
Moo: 0
Pod::Usage: 0
- perl: '5.010'
Test::LWP::UserAgent: 0
Test::More: 0
URI: 0
URI::Escape: 0
+ perl: 5.10.0
strict: 0
warnings: 0
resources:
license: http://opensource.org/licenses/gpl-license.php
-version: '0.06'
+version: '0.07'
diff --git a/README.md b/README.md
index 507e03a..744aacf 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,7 @@ where `wsgetmail.json` looks like:
"global_access": 1,
"username": "rt-comment at example.com",
"folder": "Inbox",
+ "strip_cr": 0,
"command": "/opt/rt5/bin/rt-mailgate",
"command_args": "--url=http://rt.example.com/ --queue=General --action=comment",
"command_timeout": 30,
@@ -202,6 +203,14 @@ configuration file.
Set this to the name string of a mail folder to read.
+- strip\_cr
+
+ Set this to 1 to make wsgetmail convert the messages from the CRLF
+ line-ending encoding to the LF line-ending encoding.
+
+ This is technically not standards-compliant, but some unix utilities
+ don't work with CRLF line-endings.
+
- command
Set this to an executable command. You can specify an absolute path,
@@ -219,7 +228,7 @@ configuration file.
- command\_timeout
Set this to the number of seconds the `command` has to return before
- timeout is reached. The default value is 30. Use 'inf' for no timeout.
+ timeout is reached. The default value is 30. Use "inf" for no timeout.
- action\_on\_fetched
@@ -231,6 +240,12 @@ configuration file.
deliver messages that are marked unread in the configured folder, so it does
not try to deliver the same email multiple times.
+- dump\_messages
+
+ Set this to 1 to preserve the temporary files after processing.
+
+ When `"debug"` is also set the filenames will be reported on STDERR.
+
# TESTING AND DEPLOYMENT
After you write your wsgetmail configuration file, you can test it by running:
@@ -245,6 +260,20 @@ runs successfully.
Once your configuration is stable, you can configure wsgetmail to run
periodically through cron or a systemd service on a timer.
+# ERRORS AND DIAGNOSTIC MESSAGES
+
+wsgetmail sends warning, error, and debug messages to STDERR, while purely
+informational messages are sent to STDOUT. Operators may want to capture both
+output streams as a merged stream for diagnostic purposes. For example:
+
+ wsgetmail --debug --dry-run --config=wsgetmail.json > wsgetmail.debug 2>&1
+
+When the mail processing command exits with an error (non-zero) status the
+action\_on\_fetched is not performed on that message so that it will be processed
+on the next run.
+
+Full output of the processing command is produced with `--debug`.
+
# LIMITATIONS
## Fetching from Multiple Folders
@@ -288,7 +317,7 @@ Best Practical Solutions, LLC <modules at bestpractical.com>
# LICENSE AND COPYRIGHT
-This software is Copyright (c) 2015-2020 by Best Practical Solutions, LLC.
+This software is Copyright (c) 2015-2022 by Best Practical Solutions, LLC.
This is free software, licensed under:
diff --git a/lib/App/wsgetmail.pm b/lib/App/wsgetmail.pm
index 44b463d..3676bc8 100644
--- a/lib/App/wsgetmail.pm
+++ b/lib/App/wsgetmail.pm
@@ -52,7 +52,7 @@ package App::wsgetmail;
use Moo;
-our $VERSION = '0.06';
+our $VERSION = '0.07';
=head1 NAME
@@ -535,7 +535,7 @@ Best Practical Solutions, LLC <modules at bestpractical.com>
=head1 LICENSE AND COPYRIGHT
-This software is Copyright (c) 2015-2020 by Best Practical Solutions, LLC.
+This software is Copyright (c) 2015-2022 by Best Practical Solutions, LLC.
This is free software, licensed under:
commit 0525771bbf76c6fc72dad4de57d94da03261ff57
Merge: df9ae2b 3e0bcb9
Author: sunnavy <sunnavy at bestpractical.com>
Date: Fri Sep 23 23:26:36 2022 +0800
Merge branch 'branch-for-multiple-improvements'
-----------------------------------------------------------------------
Summary of changes:
Changes | 13 ++++
MANIFEST | 1 -
META.yml | 8 +--
Makefile.PL | 7 ---
README.md | 41 ++++++++++--
bin/wsgetmail | 28 +++++++--
inc/Module/Install/Substitute.pm | 131 ---------------------------------------
lib/App/wsgetmail.pm | 35 ++++++++++-
lib/App/wsgetmail/MDA.pm | 2 +-
lib/App/wsgetmail/MS365.pm | 23 +++++--
10 files changed, 126 insertions(+), 163 deletions(-)
delete mode 100644 inc/Module/Install/Substitute.pm
hooks/post-receive
--
app-wsgetmail
More information about the Bps-public-commit
mailing list