imap 0.4.4 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b76876b4d1c1ddc5defaa94a8890166b334c133312ca17a8b809364aaba585b
-  data.tar.gz: d6b4bdf67504e50422fda5d737ae5311060b38fbf5f3f754daad45bb292a154f
+  metadata.gz: 26d3a42b29eb3be8775fc3ec60f3559b0834e8ef106e2e3458cd2b93bdee7364
+  data.tar.gz: 85aebe82c105a2d7db62c581ca61bd2c0630fcd7054dc777a02a86e84fd620ba
 SHA512:
-  metadata.gz: c5360236b3f337c04191d7debe88a74ab44e30adf242565973baf1aee561b6deb57cf96f2e1c52d4d0c680e32f4517eccabae5ac7ccf18be961ed60e9ce0c5ee
-  data.tar.gz: bc7a2e7096757a0274ffc54b3136537f646f3ad3a150f2ef2fca3ea960a5410a600942d09e1d49c1231b8f7ab199b7b2265e87a921b04f9186b39f64fb593a9d
+  metadata.gz: bb36b35b0cd5f9ddc6895aa0bfe9c0d644cd5386f13f4b26a66324d767560c3af41a8741be6a4fecf4f69fbbf6028dc823e1207e9aba50ab63a382b0a9750c50
+  data.tar.gz: 79add07e74eb8acc3105b3791be56d020cc50c89e80d47d3e47f8b46cf997b6e9c7fdd44e536292435f5560f380bd1bdac2d966c4bfc53bd548a010e77b93432

data/CHANGELOG

@@ -1,5 +1,21 @@
 # CHANGELOG
 
+## [0.4.6] - 2026-09-17, ~ Imap::Message#body: BODY.PEEK[TEXT]; ~ Imap::Search#to_imap_search_keys: raise upon a key which is neither
+- ~ Imap::Message#body: BODY.PEEK[TEXT] for BODY[TEXT]. Reading a body set \Seen, so anything which looked at one marked it read; PEEK is the whole of the difference and the response still answers to BODY[TEXT].
+- ~ Imap::Search#to_imap_search_keys: + UnknownSearchKey where the case matched neither operator. An unrecognised key was dropped and the search ran wider than it was asked for, saying nothing.
+- ~ Imap::Message#to: [] where the envelope carries no to, which raised NoMethodError upon nil.
+- ~ test/test_helper.rb: MockIMAP answers BODY.PEEK[TEXT] with BODY[TEXT] as a server does, records the attrs fetched, and gives message 99 an envelope with no to.
+- + a test apiece: that #body peeks, that #to is empty where there is no to, and that an unknown key raises.
+- ~ Imap::VERSION: /0.4.5/0.4.6/
+
+## [0.4.5] - 2026-09-17, + Gemfile; ~ imap.gemspec: dependencies=, - spec.date, + metadata
+- + Gemfile: source and gemspec, as switches, eodhd and moby have it, so that the dependencies are declared once in the gemspec rather than restated here to drift. bitget and coinmarketcap restate theirs and are the minority. This was the only gem here with no Gemfile at all.
+- ~ imap.gemspec: + 'Gemfile' to spec.files, which every other gem here ships.
+- ~ imap.gemspec: dependencies= and development_dependencies= through the Gem::Specification extension, as switches, eodhd and moby have it and as bitget, coinmarketcap and this did not. The constraints survive: the splat takes a bare string or a [name, constraint] pair alike.
+- ~ imap.gemspec: - spec.date = '2025-12-20', nine months and two versions stale, and the last one left in the estate. RubyGems answers 1980-01-02 in its place, the reproducible-build epoch, which is what coinmarketcap has carried since dropping its own at 0.6.0.
+- ~ imap.gemspec: + metadata, the four uris switches and moby declare, so that the RubyGems page links to the issues, the changelog, the source and the README. master here where moby says main, each by the branch it is on.
+- ~ Imap::VERSION: /0.4.4/0.4.5/
+
 ## [0.4.4] - 2026-09-17, + Rakefile, - test/test_all.rb
 - + Rakefile: Rake::TestTask over FileList['test/**/*_test.rb'], with libs for lib and test, and warning = true. The minimal form nine of the gems here use rather than the fuller one five use: the :spec alias and the :version task belong to the minority, and a :version task reading VERSION.rb would not have caught 0.4.1, where require 'imap' left Imap::VERSION undefined while VERSION.rb sat there defining it. rake has been a development dependency since 0.4.0 with nothing here to run.
 - - test/test_all.rb: a second entry point which the Rakefile's FileList makes redundant, and which had drifted from the files on disk in two ways: it never loaded test/Imap/VERSION_test.rb, added in 0.4.2, so it ran 42 tests where there are 44; and it required './Imap_test' for a file named imap_test.rb, which resolved only because the filesystem is case insensitive and would not have on Linux. A glob cannot drift. 14 of the 16 gems here with a Rakefile carry no such file; switches keeps spec/all.rb because its Rakefile targets it, and bitget carries the same redundancy this removes.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/imap.gemspec

@@ -2,11 +2,20 @@
 
 require_relative './lib/Imap/VERSION'
 
+class Gem::Specification
+  def dependencies=(gems)
+    gems.each{|gem| add_dependency(*gem)}
+  end
+
+  def development_dependencies=(gems)
+    gems.each{|gem| add_development_dependency(*gem)}
+  end
+end
+
 Gem::Specification.new do |spec|
   spec.name = 'imap'
 
   spec.version = Imap::VERSION
-  spec.date = '2025-12-20'
 
   spec.summary = "IMAP for Ruby made easy."
   spec.description = "A Ruby wrapper around Net::IMAP with an elegant DSL for searching, reading, and managing email."
@@ -18,20 +27,32 @@ Gem::Specification.new do |spec|
 
   spec.required_ruby_version = '>= 2.7'
 
-  spec.add_dependency 'net-imap', "~> 0.4"
+  spec.dependencies = [
+    ['net-imap', '~> 0.4']
+  ]
 
-  spec.add_development_dependency 'minitest', '~> 5.0'
-  spec.add_development_dependency 'minitest-mock'
-  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.development_dependencies = [
+    ['minitest', '~> 5.0'],
+    'minitest-mock',
+    ['rake', '~> 13.0']
+  ]
 
   spec.files = [
     'imap.gemspec',
     Dir['lib/**/*.rb'],
     Dir['test/**/*.rb'],
     'CHANGELOG',
+    'Gemfile',
     'Rakefile',
     'LICENSE',
     'README.md',
   ].flatten
   spec.require_paths = ['lib']
+
+  spec.metadata = {
+    "bug_tracker_uri" => "https://github.com/thoran/imap/issues",
+    "changelog_uri" => "https://github.com/thoran/imap/blob/master/CHANGELOG",
+    "source_code_uri" => "https://github.com/thoran/imap",
+    "documentation_uri" => "https://github.com/thoran/imap/blob/master/README.md"
+  }
 end

data/lib/Imap/Message.rb

@@ -29,7 +29,7 @@ class Imap
     attr_accessor :message_id
 
     def body
-      @body ||= fetch_data('BODY[TEXT]').first.attr['BODY[TEXT]']
+      @body ||= fetch_data('BODY.PEEK[TEXT]').first.attr['BODY[TEXT]']
     end
 
     def subject
@@ -41,7 +41,7 @@ class Imap
     end
 
     def to
-      @to ||= fetch_data('ENVELOPE').first.attr['ENVELOPE'].to.map{|addr| addr.mailbox + '@' + addr.host}
+      @to ||= (fetch_data('ENVELOPE').first.attr['ENVELOPE'].to || []).map{|addr| addr.mailbox + '@' + addr.host}
     end
 
     def urls

data/lib/Imap/Search.rb

@@ -11,6 +11,8 @@
 class Imap
   class Search
 
+    class UnknownSearchKey < ArgumentError; end
+
     ALL_SEARCH_KEYS = %w{
       ALL
       ANSWERED
@@ -112,6 +114,8 @@ class Imap
           m << general_to_imap_search_key(key, value)
         when boolean_operator?(key)
           m << boolean_to_imap_search_key(key, value)
+        else
+          raise UnknownSearchKey, "no such search key: #{key}"
         end
       end.flatten
     end

data/lib/Imap/VERSION.rb

@@ -1,3 +1,3 @@
 class Imap
-  VERSION = '0.4.4'
+  VERSION = '0.4.6'
 end

data/test/Imap/Message_test.rb

@@ -40,6 +40,11 @@ describe Imap::Message do
       second_call = imap_message.body
       _(first_call.object_id).must_equal second_call.object_id
     end
+
+    it 'peeks, so that reading a body does not mark it seen' do
+      imap_message.body
+      _(client.imap.fetched_attrs).must_include 'BODY.PEEK[TEXT]'
+    end
   end
 
   describe '#subject' do
@@ -74,6 +79,10 @@ describe Imap::Message do
       addresses = imap_message.to
       _(addresses.first).must_equal('user@example.com')
     end
+
+    it 'is empty where the envelope carries no to' do
+      _(Imap::Message.new(99, client).to).must_equal []
+    end
   end
 
   describe '#urls' do

data/test/Imap/Search_test.rb

@@ -33,6 +33,10 @@ describe Imap::Search do
       _(keys).must_include 'SEEN'
     end
 
+    it 'raises upon a key which is neither' do
+      _{Imap::Search.new(client, bogus: 'x').to_imap_search_keys}.must_raise Imap::Search::UnknownSearchKey
+    end
+
     it 'handles multiple criteria' do
       test_search = Imap::Search.new(client, from: 'test@example.com', seen: true)
       keys = test_search.to_imap_search_keys

data/test/test_helper.rb

@@ -31,7 +31,10 @@ class MockIMAP
     [1, 2, 3]
   end
 
+  attr_reader :fetched_attrs
+
   def fetch(message_id, attrs)
+    @fetched_attrs = attrs
     [OpenStruct.new(attr: mock_fetch_attrs(message_id, attrs))]
   end
 
@@ -58,7 +61,7 @@ class MockIMAP
     result = {}
     attrs.each do |attr|
       case attr
-      when 'BODY[TEXT]'
+      when 'BODY[TEXT]', 'BODY.PEEK[TEXT]'
         result['BODY[TEXT]'] = "Mock body for message #{message_id}"
       when 'BODY[HEADER.FIELDS (SUBJECT)]'
         result['BODY[HEADER.FIELDS (SUBJECT)]'] = "Subject: Mock Subject #{message_id}\r\n"
@@ -66,7 +69,7 @@ class MockIMAP
         result['BODY[HEADER.FIELDS (FROM)]'] = "From: sender@example.com\r\n"
       when 'ENVELOPE'
         result['ENVELOPE'] = OpenStruct.new(
-          to: [OpenStruct.new(mailbox: 'user', host: 'example.com')]
+          to: message_id == 99 ? nil : [OpenStruct.new(mailbox: 'user', host: 'example.com')]
         )
       end
     end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: imap
 version: !ruby/object:Gem::Version
-  version: 0.4.4
+  version: 0.4.6
 platform: ruby
 authors:
 - thoran
 bindir: bin
 cert_chain: []
-date: 2025-12-20 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-imap
@@ -73,6 +73,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG
+- Gemfile
 - LICENSE
 - README.md
 - Rakefile
@@ -84,12 +85,16 @@ files:
 - test/Imap/Message_test.rb
 - test/Imap/Search_test.rb
 - test/Imap/VERSION_test.rb
-- test/imap_test.rb
+- test/Imap_test.rb
 - test/test_helper.rb
 homepage: https://github.com/thoran/imap
 licenses:
 - MIT
-metadata: {}
+metadata:
+  bug_tracker_uri: https://github.com/thoran/imap/issues
+  changelog_uri: https://github.com/thoran/imap/blob/master/CHANGELOG
+  source_code_uri: https://github.com/thoran/imap
+  documentation_uri: https://github.com/thoran/imap/blob/master/README.md
 rdoc_options: []
 require_paths:
 - lib