imap_mogura 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f5a65d48e4e81a37e519995c39cddf533e3336477c358044462f51935ee1d0f
-  data.tar.gz: 59975c34bdd3ce2d372c71c5d6b8d9689867e431956104df8cd958294a18dc3d
+  metadata.gz: ccc5914a45fede7ba28883f41ef95bba9e0f426c7a4a563a926dd7dcbb3c17f1
+  data.tar.gz: '069f651ef1fee7cb2f5a5f3547a7c13eca03646c46f47a3d298ba3b21a8db6a8'
 SHA512:
-  metadata.gz: c29a3b716cfde67b59876ad149add941ac2db45fa92154fbaa0a3587e438939568ae6eb536b12ddcc28bd14c0ab131a3f4a5725d0e11775cc3f1a95d30400b84
-  data.tar.gz: fc9c28711eb63e293e09173a3b4eac353e5ca40d4b3d7b01b07ea5f571c80d941d669c1bd93217c21d179a16ff59b116996f0a581b80ad883c5875a590e2f8b2
+  metadata.gz: 0cfac9d2da8aca0e2d8ec59775699ebea6038d70e3308522a067eccb5b80150116200796071ac23713af8f4a3b4224b8fdc940e67601f1f00ee4c1599fe211ec
+  data.tar.gz: 7b89c3160fd326abdac3ed32d019adbfe18870a7aba4159411e974cac4e408f9aead8f52f28f187d245c9bb60ce0f6c166a273ac5ac4f1e5c292f891dbaaf2f7

data/README.md

@@ -4,14 +4,12 @@ A mail filtering tool for IMAP.
 
 ## Installation
 
-To install this gem, you can get it from RubyGems.org. Just run as following.
+To install this gem, just run as following. You can get the gem from [RubyGems.org](https://rubygems.org/).
 
 ```console
-$ gem install imap_mogura --pre
+$ gem install imap_mogura
 ```
 
-(This gem has only released pre-release versions now, so you must specify `--pre` option.)
-
 ## Usage
 
 Create `rules.yml` and write rules like following.
@@ -35,22 +33,21 @@ rules:
       subject: "i'm trash-like email!!"
 ```
 
-As following, `start` command will start monitoring RECENT mails on "INBOX". If a mail is coming
- and it's RECENT, it will be filtered.
+Running `mogura start` command will start monitoring RECENT mails coming to "INBOX". If a mail with RECENT flag is coming to the mailbox, it will be filtered.
 
 ```console
 $ mogura start <host> -u <user> --password-base64=<password-base64-encoded> -c rules.yml -b INBOX
 ```
 
-You can specify a mailbox which to be monitored by `-b` option.
+You can specify the mailbox by `-b` option.
 
-If you want to just filter mails on a specific mailbox, run the `filter` command as following.
+If you want to just filter mails on the specific mailbox, use `mogura filter` command.
 
 ```console
 $ mogura filter <host> -u <user> --password-base64=<password-base64-encoded> -c rules.yml -b <mailbox>
 ```
 
-You can check your config by `check-config` command. It returns just OK if no errors in the config.
+You can check your config by `mogura check-config` command. It returns just OK if no errors in the config.
 
 ```console
 $ mogura check-config -c rules.yml

data/lib/imap_mogura/cli.rb

@@ -42,7 +42,6 @@ module ImapMogura
       create_directory = options[:create_directory]
       dry_run = options[:dry_run]
 
-      monitored_events = ["RECENT"]
       search_keys = ["RECENT", *(["UNSEEN"] if filter_unseen)]
 
       with_preparation_ready(config_name, host, port, starttls, use_ssl,
@@ -51,7 +50,7 @@ module ImapMogura
                              dry_run: dry_run) do |imap_handler, rules|
         warn "* start monitoring recent mails in \"#{target_mailbox}\""
 
-        imap_handler.monitor_events(target_mailbox, monitored_events) do
+        monitor_recents_on_mailbox(imap_handler, target_mailbox) do
           imap_handler.find_and_handle_mails(target_mailbox, search_keys) do |message_id|
             warn "mail (id = #{message_id} on \"#{target_mailbox}\") is recent"
 
@@ -86,13 +85,12 @@ module ImapMogura
       all_mailbox = options[:all_mailbox]
       exclude_mailboxes = options[:exclude_mailboxes]
       target_mailbox = options[:target_mailbox] unless all_mailbox
-
-      raise CustomOptionError, "--all-mailbox (-a) or --target-mailbox (-b) is required" if !all_mailbox && target_mailbox.nil?
-
       filter_only_unseen = options[:filter_only_unseen]
       create_directory = options[:create_directory]
       dry_run = options[:dry_run]
 
+      raise CustomOptionError, "--all-mailbox (-a) or --target-mailbox (-b) is required" if !all_mailbox && target_mailbox.nil?
+
       search_keys = if filter_only_unseen
                       ["UNSEEN"]
                     else
@@ -208,29 +206,40 @@ module ImapMogura
       end
     end
 
+    def monitor_recents_on_mailbox(imap_handler, mailbox, retry_count = 0, &block)
+      imap_handler.monitor_events(mailbox, ["RECENT"], &block)
+    rescue IMAPHandler::MailFetchError => e
+      handle_mail_fetch_error_and_preprocess_retrying(e, retry_count)
+
+      warn "retry monitoring mails on #{e.mailbox}..."
+
+      # retry monitor recents on mailbox itself with retry count to be incremented
+      monitor_recents_on_mailbox(imap_handler, mailbox, retry_count + 1)
+    end
+
     def filter_mails(imap_handler, rules, mailbox, search_keys = ["ALL"], retry_count = 0, dry_run: false)
       imap_handler.find_and_handle_mails(mailbox, search_keys) do |message_id|
         filter_mail(imap_handler, rules, mailbox, message_id, dry_run: dry_run)
       end
     rescue IMAPHandler::MailFetchError => e
-      warn "failed to fetch mail (id = #{e.message_id} on mailbox #{e.mailbox}): #{e.bad_response_error_message}"
+      handle_mail_fetch_error_and_preprocess_retrying(e, retry_count)
 
-      # if retry_count is over the threshold, terminate processing
-      unless retry_count < 3
-        warn "retry count is over the threshold, stop processing"
+      warn "retry filtering all mails on #{e.mailbox}"
 
-        return
-      end
+      # retry filter all mails itself with retry count to be incremented
+      filter_mails(imap_handler, rules, mailbox, search_keys, retry_count + 1, dry_run: dry_run)
+    end
+
+    def handle_mail_fetch_error_and_preprocess_retrying(error, retry_count)
+      warn "failed to fetch mail (id = #{error.message_id} on mailbox #{error.mailbox}): #{error.bad_response_error_message}"
+
+      # if retry_count is over the threshold, abort processing
+      raise Thor::Error, "retry count is over the threshold, stop processing" unless retry_count < 3
 
       warn "wait a moment..."
 
       # wait a moment...
       sleep 10
-
-      warn "retry filter all mails on #{e.mailbox}"
-
-      # retry filter all mails itself
-      filter_mails(imap_handler, rules, mailbox, search_keys, retry_count + 1, dry_run: dry_run)
     end
 
     def filter_mail(imap_handler, rules, mailbox, message_id, dry_run: false)

data/lib/imap_mogura/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ImapMogura
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: imap_mogura
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - ysk
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-11-19 00:00:00.000000000 Z
+date: 2024-11-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64