imap.rb 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45cf03dcb336e9795a5ef5339e6ac0c6e3b2f5e79014f3462684f39f79aae98f
-  data.tar.gz: e204d83b456b966f0f9a9c3a55acfb492564da65a2b2be22d8c27326104ba755
+  metadata.gz: a11cb6eb95eff27b2d107a0e1ad8fc727b1eabb6d2c24523ada41b3906b9d42e
+  data.tar.gz: 5a37e2eff7d0177f768aeb77182f04dd47d7686cdbd42f99814c35a140e4d270
 SHA512:
-  metadata.gz: 20938befdd15cc9da7f5679b0043facbdbc0d3a69b04f93a0100c43b4314b6832ecfed375484d1429221ee60703dfc94ac3abdd1f4ff40060ed528828187fcf4
-  data.tar.gz: e467e3aed0b2b09cc86e175a1b3f940e37922232e4efb97998c5dc7a959b5a3f9b8f012bb1a8ff6505d7dff83f488e418c5e7d8670fe5b4db7333991ff683d77
+  metadata.gz: 8a22fc1e24e9c7765d06733837547a29f581083586b0e9fdef601756ee1d61561b44689cb7dcf5ed62f3db8fc2096ac295ac8859fc765de30fd1135123a9aac6
+  data.tar.gz: 22a69f98811483319992902f342267743bbb69acac1723b1dc8067a54f9805e8965d91925a289cfd376eac22fff3d8ec333125f4f8733cf05debd9025ad38843

data/CHANGELOG

@@ -2,6 +2,15 @@
 
 ## 20260917
 
+0.9.0: + all_of and ALL
+
+1. + Imap::Search#all_of: all_of: [{text: 'invoice'}, {text: 'overdue'}] for TEXT invoice TEXT overdue. IMAP has no AND keyword, keys simply sitting side by side, but a hash cannot hold the same key twice, so two terms upon the one key could not be asked for at all: {text: 'a', text: 'b'} keeps b and drops a without a word. Each element is a criteria hash of its own, so or and not nest inside it.
+2. ~ Imap::Search#to_imap_search_keys: + ALL_OF and + ALL, read before the operator tests beside OR and NOT, being none of the three. ALL sat in ALL_SEARCH_KEYS and in neither operator list, so {all: true} raised UnknownSearchKey. It is the key meaning every message, which is precisely what a search with no criteria has to send, so the hash could not express the simplest search there is.
+3. ALL is a case and not a member of BOOLEAN_SEARCH_KEYS, where it appears to belong: each of those defines a method of its own name, and #all is already the alias for #message_ids which the header's own example ends upon. Adding it there redefined the alias silently, which warning = true reported and 0.4.4 turned on for this.
+4. + 5 tests: that all_of ands a list, that it is how the one key carries several terms where a hash cannot, that or and not nest within it, that it sits beside the plain keys, and that {all: true} answers ['ALL'].
+5. ~ Imap::VERSION: /0.8.0/0.9.0/
+
+
 0.8.0: + Imap::Message.for, the fetch without the search, and a class a program can subclass.
 
 1. + Imap::Message.for(imap_client, message_ids): the batched fetch on its own, .search now being the search and then this. A program which builds its own search keys had no way in: .search couples the two, so search-mail had 159 lines of its own Hit reimplementing the fetch beside it.

data/lib/Imap/Message.rb

@@ -29,7 +29,6 @@ class Imap
     ENCODED_WORD = /=\?([^?]+)\?([BbQq])\?([^?]*)\?=/
 
     class << self
-
       def search(imap_client, **search_criteria)
         self.for(imap_client, Imap::Search.new(imap_client, search_criteria).message_ids)
       end
@@ -68,7 +67,6 @@ class Imap
       rescue StandardError
         text
       end
-
     end # class << self
 
     attr_accessor :imap_client

data/lib/Imap/Search.rb

@@ -4,6 +4,7 @@
 # Usage:
 # 1. Imap::Search.new(imap_client).not.subject('Payday Loans').answered.from('noreply@example.com').all
 # 2. Imap::Search.new(imap_client, {from: 'noreply@example.com', answered: true})
+# 3. Imap::Search.new(imap_client, {all_of: [{text: 'invoice'}, {text: 'overdue'}]})
 
 # Notes:
 # 1. List of search keys taken from RFC-3501 (INTERNET MESSAGE ACCESS PROTOCOL - VERSION 4rev1), http://tools.ietf.org/html/rfc3501.
@@ -123,6 +124,10 @@ class Imap
       criteria.inject([]) do |m, kv|
         key, value = kv.first.to_s.upcase, kv.last
         case
+        when key == 'ALL'
+          m << 'ALL'
+        when key == 'ALL_OF'
+          m << all_of(value)
         when key == 'OR'
           m << any_of(value)
         when key == 'NOT'
@@ -137,6 +142,13 @@ class Imap
       end.flatten
     end
 
+    # AND has no keyword: keys sit side by side and the server ands them.  A hash
+    # cannot hold the same key twice, though, so several terms upon the one key
+    # say so here: all_of: [{text: 'a'}, {text: 'b'}] for TEXT a TEXT b.
+    def all_of(criteria_hashes)
+      criteria_hashes.flat_map{|criteria_hash| Search.new(nil, criteria_hash).to_imap_search_keys}
+    end
+
     # OR takes two keys and no more, so three criteria nest: OR OR a b c.  Each
     # is a criteria hash of its own, so either side may nest further.
     def any_of(criteria_hashes)

data/lib/Imap/VERSION.rb

@@ -1,3 +1,3 @@
 class Imap
-  VERSION = '0.8.0'
+  VERSION = '0.9.0'
 end

data/test/Imap/Search_test.rb

@@ -47,6 +47,27 @@ describe Imap::Search do
   describe 'OR, NOT and HEADER' do
     def keys(criteria) = Imap::Search.new(client, criteria).to_imap_search_keys
 
+    it 'answers ALL, which every key list named and neither operator list held' do
+      _(keys(all: true)).must_equal ['ALL']
+    end
+
+    it 'ands a list of criteria hashes for ALL_OF' do
+      _(keys(all_of: [{text: 'invoice'}, {text: 'overdue'}])).must_equal ['TEXT', 'invoice', 'TEXT', 'overdue']
+    end
+
+    it 'is how the one key carries more than one term, a hash holding it once' do
+      _(keys({text: 'invoice'}.merge(text: 'overdue'))).must_equal ['TEXT', 'overdue']
+      _(keys(all_of: [{text: 'invoice'}, {text: 'overdue'}])).must_equal ['TEXT', 'invoice', 'TEXT', 'overdue']
+    end
+
+    it 'nests OR and NOT inside ALL_OF' do
+      _(keys(all_of: [{not: {text: 'draft'}}, {or: [{from: 'a@x'}, {to: 'b@y'}]}])).must_equal ['NOT', 'TEXT', 'draft', 'OR', 'FROM', 'a@x', 'TO', 'b@y']
+    end
+
+    it 'sits beside the plain keys' do
+      _(keys(since: '1-Sep-2026', all_of: [{text: 'a'}, {text: 'b'}])).must_equal ['SINCE', '1-Sep-2026', 'TEXT', 'a', 'TEXT', 'b']
+    end
+
     it 'takes two criteria hashes for OR' do
       _(keys(or: [{from: 'a@x'}, {to: 'b@y'}])).must_equal ['OR', 'FROM', 'a@x', 'TO', 'b@y']
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: imap.rb
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - thoran