imap_guard 0.0.4 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d95cc42f451c9e8d2230c9ed670c5b5cb5f42d20
-  data.tar.gz: 22a08ac744d604430aa795cf156f8b0ea899a9fc
+  metadata.gz: b9bad59e96b10c29a2a065cd6b5d866f10e8d7c8
+  data.tar.gz: d110224b73afef6abc0cc7805aefc906ee222b35
 SHA512:
-  metadata.gz: 9a7fe8edceec8be75626f91f69b8228bd1e2f4205d4fe52f742cf5bea0b828f79851e3ce9b843c1941eaefe63092541204c61f8c225bcbdcf54dfc3e7d29c1b7
-  data.tar.gz: 47a6ba91f840a30ad8164a84593f3fdbd91fdf5c46bd798a74f1af8926152b66e0c2af02ddfcebfc3f2166fe04dd6f843fe04cf6213266daba6822f4e79e7fc2
+  metadata.gz: ef2d1979d3459bf83732861e5d6972af03cf698dd3178b8d9b7326eed9b0c44c4b17b3dab7c038a14425c5eb980c7f3255f6d412729af4c89810e66d597a42f9
+  data.tar.gz: f23003553803bf31aaf648d840f221a627387c147e326e399f8ecf02a320059325ef6a412161a00c35a96efea91fc65f1e2e2097309c18097045f8b932b02a0d

data/.ruby-version

@@ -1 +1 @@
-2.1.0
+2.2

data/.travis.yml

@@ -5,14 +5,11 @@ after_script:
 rvm:
   - 1.9.3
   - 2.0.0
-  - 2.1.0
+  - 2.1
+  - 2.2
   - ruby-head
   - rbx
 matrix:
   allow_failures:
     - rvm: ruby-head
     - rvm: rbx
-notifications:
-  email:
-    on_success: always
-    on_failure: always

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2013 Cédric Félizard
+Copyright (c) 2013-2015 Cédric Félizard
 
 MIT License
 

data/imap_guard.gemspec

@@ -1,11 +1,10 @@
 # coding: utf-8
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'imap_guard/version'
 
 Gem::Specification.new do |spec|
   spec.name          = "imap_guard"
-  spec.version       = ImapGuard::VERSION
+  spec.version       = "1.0.0"
   spec.authors       = ["Cédric Félizard"]
   spec.email         = ["cedric@felizard.fr"]
   spec.description   = %q{A guard for your IMAP server}
@@ -18,10 +17,10 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_dependency 'mail', '~> 2.5.3'
-  spec.add_dependency 'term-ansicolor', '~> 1.2.2'
+  spec.add_dependency 'mail', '>= 2.5.3'
+  spec.add_dependency 'term-ansicolor', '>= 1.2.2'
 
-  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'bundler', '>= 1.3'
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'simplecov'
   spec.add_development_dependency 'rspec'

data/lib/imap_guard.rb

@@ -1,4 +1,3 @@
-require "imap_guard/version"
 require "imap_guard/guard"
 require "imap_guard/query"
 

data/lib/imap_guard/guard.rb

@@ -80,6 +80,23 @@ module ImapGuard
       process query, operation, &filter
     end
 
+    # Runs operation on messages matching the query
+    # @param query IMAP query
+    # @param opration Lambda to call on each message
+    # @return [void]
+    def each query
+      operation = lambda { |message_id| yield message_id }
+      process query, operation
+    end
+
+    # Fetches a message from its UID
+    # @return [Mail]
+    # @note We use "BODY.PEEK[]" to avoid setting the \Seen flag.
+    def fetch_mail message_id
+      msg = @imap.fetch(message_id, 'BODY.PEEK[]').first.attr['BODY[]']
+      Mail.read_from_string msg
+    end
+
     # @return [Array<String>] Sorted list of all mailboxes
     def list
       @imap.list("", "*").map(&:name).sort
@@ -127,23 +144,13 @@ module ImapGuard
           end
         end
 
-        if result
-          puts operation.call(message_id)
-        else
-          puts "ignored".green
-        end
+        puts result ? operation.call(message_id) : "ignored".green
       end
 
     ensure
       expunge
     end
 
-    # @note We use "BODY.PEEK[]" to avoid setting the \Seen flag.
-    def fetch_mail message_id
-      msg = @imap.fetch(message_id, 'BODY.PEEK[]').first.attr['BODY[]']
-      Mail.read_from_string msg
-    end
-
     def search query
       unless [Array, String].any? { |type| query.is_a? type }
         raise TypeError, "Query must be either a string holding the entire search string, or a single-dimension array of search keywords and arguments."

data/lib/imap_guard/query.rb

@@ -8,6 +8,12 @@ module ImapGuard
       self << 'SEEN'
     end
 
+    # Messages that do not have the +\Seen+ flag set.
+    # @return [self]
+    def unseen
+      self << 'UNSEEN'
+    end
+
     # Messages that do not have the +\Answered+ flag set.
     # @return [self]
     def unanswered
@@ -81,6 +87,13 @@ module ImapGuard
       self << 'TO' << string
     end
 
+    # Messages that contain the specified string in the envelope
+    # structure's CC field.
+    # @return [self]
+    def cc string
+      self << 'CC' << string
+    end
+
     # Messages whose internal date (disregarding time and timezone)
     # is earlier than the specified date.
     # @param date Depending of its type:

data/spec/imap_guard/guard_spec.rb

@@ -19,9 +19,9 @@ module ImapGuard
       }
     end
 
-    let(:imap) {
+    let(:imap) do
       double('Net::IMAP', search: [7, 28], expunge: nil, select: nil, list: [])
-    }
+    end
 
     def guard_instance custom_settings = {}
       guard = Guard.new(settings.merge(custom_settings))
@@ -171,6 +171,14 @@ module ImapGuard
       end
     end
 
+    describe "#each" do
+      it "iterates over messages without errors" do
+        guard_instance.each 'ALL' do |message_id|
+          # noop
+        end
+      end
+    end
+
     describe "#expunge" do
       it "expunges the folder" do
         imap.should_receive(:expunge)

data/spec/imap_guard/query_spec.rb

@@ -13,6 +13,13 @@ module ImapGuard
       end
     end
 
+    describe "#unseen" do
+      it "adds 'UNSEEN'" do
+        subject.unseen
+        subject.last.should eq 'UNSEEN'
+      end
+    end
+
     describe "#unanswered" do
       it "adds 'UNANSWERED'" do
         subject.unanswered
@@ -83,6 +90,13 @@ module ImapGuard
       end
     end
 
+    describe "#cc" do
+      it "adds the search value" do
+        subject.cc("root@example.net")
+        subject.last.should eq "root@example.net"
+      end
+    end
+
     describe "#not" do
       context "without a search key" do
         it "adds 'NOT'" do

metadata

@@ -1,55 +1,55 @@
 --- !ruby/object:Gem::Specification
 name: imap_guard
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 1.0.0
 platform: ruby
 authors:
 - Cédric Félizard
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-03 00:00:00.000000000 Z
+date: 2015-05-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mail
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.5.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.5.3
 - !ruby/object:Gem::Dependency
   name: term-ansicolor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.2.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.2.2
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
@@ -185,7 +185,6 @@ files:
 - lib/imap_guard.rb
 - lib/imap_guard/guard.rb
 - lib/imap_guard/query.rb
-- lib/imap_guard/version.rb
 - spec/imap_guard/guard_spec.rb
 - spec/imap_guard/query_spec.rb
 - spec/spec_helper.rb
@@ -209,7 +208,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.0
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
 summary: A guard for your IMAP server

data/lib/imap_guard/version.rb

@@ -1,4 +0,0 @@
-module ImapGuard
-  # [String] ImapGuard version
-  VERSION = "0.0.4"
-end