imap_mogura 0.2.0 → 0.2.2.pre.dev

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ccc5914a45fede7ba28883f41ef95bba9e0f426c7a4a563a926dd7dcbb3c17f1
-  data.tar.gz: '069f651ef1fee7cb2f5a5f3547a7c13eca03646c46f47a3d298ba3b21a8db6a8'
+  metadata.gz: e8ab3a83b682da8cfeeb55ea96c1e1bd3b046246da28923196d33fe7cd3d7f26
+  data.tar.gz: 3d0fd5fa039f632ed3c63e2467e3eb31703cb4ec9aca2aa8a0a15d2592b04124
 SHA512:
-  metadata.gz: 0cfac9d2da8aca0e2d8ec59775699ebea6038d70e3308522a067eccb5b80150116200796071ac23713af8f4a3b4224b8fdc940e67601f1f00ee4c1599fe211ec
-  data.tar.gz: 7b89c3160fd326abdac3ed32d019adbfe18870a7aba4159411e974cac4e408f9aead8f52f28f187d245c9bb60ce0f6c166a273ac5ac4f1e5c292f891dbaaf2f7
+  metadata.gz: 05230b9da5a38e8abc1b398d0939528fed9dcccf1f01dae327844d63e26f25dfa009083c3ee5b84d070fc164cce22ce18c23a52edb3fcbbef34926f908fd256f
+  data.tar.gz: c81ee3bc93144669f170ea3d139aac88bbfc2c660d6fa3e15a2f653b7fde2ff8b2f69bb7dbcef69fed73ff51845aa6ce08f005d1b4326e2ed0798fe397cf3249

data/README.md

@@ -7,9 +7,11 @@ A mail filtering tool for IMAP.
 To install this gem, just run as following. You can get the gem from [RubyGems.org](https://rubygems.org/).
 
 ```console
-$ gem install imap_mogura
+$ gem install imap_mogura --pre
 ```
 
+(This branch is `develop`, that means this is a pre-release version. You can install this version by specifying `--pre` option.)
+
 ## Usage
 
 Create `rules.yml` and write rules like following.

data/lib/imap_mogura/cli.rb

@@ -51,6 +51,7 @@ module ImapMogura
         warn "* start monitoring recent mails in \"#{target_mailbox}\""
 
         monitor_recents_on_mailbox(imap_handler, target_mailbox) do
+          # find mails with search keys on the target mailbox and handle them
           imap_handler.find_and_handle_mails(target_mailbox, search_keys) do |message_id|
             warn "mail (id = #{message_id} on \"#{target_mailbox}\") is recent"
 
@@ -105,7 +106,10 @@ module ImapMogura
         if all_mailbox
           excluded_mailboxes = options[:excluded_mailboxes]
 
-          imap_handler.all_mailbox_list.reject { |mailbox| excluded_mailboxes.include?(mailbox) }.each do |mailbox|
+          # figure out target mailboxes
+          target_mailboxes = imap_handler.all_mailbox_list.reject { |mailbox| excluded_mailboxes.include?(mailbox) }
+
+          target_mailboxes.each do |mailbox|
             filter_mails(imap_handler, rules, mailbox, search_keys, dry_run: dry_run)
           end
         else
@@ -133,6 +137,7 @@ module ImapMogura
                                      starttls: starttls, usessl: use_ssl, certs: nil, verify: true,
                                      auth_info: { auth_type: auth_type, user: user, password: password })
 
+      # output all mailbox list
       puts imap_handler.all_mailbox_list
 
       imap_handler.close
@@ -172,10 +177,12 @@ module ImapMogura
       #   exit
       # end
 
+      # create directories specified as destination
       touch_all_mailboxes_in_rules(imap_handler, rules, dry_run: dry_run) if create_directory
 
       options = { excluded_mailboxes: excluded_mailboxes }
 
+      # call the given block
       block[imap_handler, rules, options]
 
       imap_handler.close
@@ -211,9 +218,9 @@ module ImapMogura
     rescue IMAPHandler::MailFetchError => e
       handle_mail_fetch_error_and_preprocess_retrying(e, retry_count)
 
+      # retry monitor recents on mailbox itself with retry count to be incremented
       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
 
@@ -224,9 +231,9 @@ module ImapMogura
     rescue IMAPHandler::MailFetchError => e
       handle_mail_fetch_error_and_preprocess_retrying(e, retry_count)
 
+      # retry filter all mails itself with retry count to be incremented
       warn "retry filtering all mails on #{e.mailbox}"
 
-      # 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
 
@@ -238,7 +245,6 @@ module ImapMogura
 
       warn "wait a moment..."
 
-      # wait a moment...
       sleep 10
     end
 
@@ -248,27 +254,31 @@ module ImapMogura
       warn "# filtering mail on \"#{mailbox}\" of subject \"#{mail.subject}\"..."
 
       rules.each do |rule_set|
-        dst_mailbox = rule_set.destination
-        rule = rule_set.rule
+        try_to_filter_mail_for_rule_set(imap_handler, rule_set, mailbox, message_id, mail, dry_run: dry_run)
+      end
 
-        next unless rule.match?(mail)
+      imap_handler.close_operation_for_mailbox(mailbox)
+    end
 
-        warn "the mail matches for the rule of the destination \"#{dst_mailbox}\""
-        warn "moving the mail..."
+    def try_to_filter_mail_for_rule_set(imap_handler, rule_set, mailbox, message_id, mail, dry_run: false)
+      dst_mailbox = rule_set.destination
+      rule = rule_set.rule
 
-        if dry_run
-          warn "moving skipped because this is dry run"
+      return unless rule.match?(mail)
+
+      warn "the mail matches for the rule of the destination \"#{dst_mailbox}\""
+      warn "moving the mail..."
+
+      if dry_run
+        warn "moving skipped because this is dry run"
+      else
+        result = imap_handler.move(mailbox, message_id, dst_mailbox)
+        if result
+          warn "moving done"
         else
-          result = imap_handler.move(mailbox, message_id, dst_mailbox)
-          if result
-            warn "moving done"
-          else
-            warn "moving skipped because the destination is the same with the current mailbox \"#{mailbox}\""
-          end
+          warn "moving skipped because the destination is the same with the current mailbox \"#{mailbox}\""
         end
       end
-
-      imap_handler.close_operation_for_mailbox(mailbox)
     end
   end
 end

data/lib/imap_mogura/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ImapMogura
-  VERSION = "0.2.0"
+  VERSION = "0.2.2.pre.dev"
 end

metadata

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