Class: Mail::Retriever

Inherits:
Object show all
Defined in:
lib/mail/network/retriever_methods/base.rb

Direct Known Subclasses

IMAP, POP3, TestRetriever

Instance Method Summary collapse

Instance Method Details

#all(options = {}, &block) ⇒ Object

Get all emails.

Possible options:

order: order of emails returned. Possible values are :asc or :desc. Default value is :asc.



38
39
40
41
42
 
# File 'lib/mail/network/retriever_methods/base.rb', line 38

def all(options = {}, &block)
  options ||= {}
  options[:count] = :all
  find(options, &block)
end

#find_and_delete(options = {}, &block) ⇒ Object

Find emails in the mailbox, and then deletes them. Without any options, the five last received emails are returned.

Possible options:

what:  last or first emails. The default is :first.
order: order of emails returned. Possible values are :asc or :desc. Default value is :asc.
count: number of emails to retrieve. The default value is 10. A value of 1 returns an
       instance of Message, not an array of Message instances.
delete_after_find: flag for whether to delete each retreived email after find. Default
        is true. Call #find if you would like this to default to false.



55
56
57
58
59
 
# File 'lib/mail/network/retriever_methods/base.rb', line 55

def find_and_delete(options = {}, &block)
  options ||= {}
  options[:delete_after_find] ||= true
  find(options, &block)      
end

#first(options = {}, &block) ⇒ Object

Get the oldest received email(s)

Possible options:

count: number of emails to retrieve. The default value is 1.
order: order of emails returned. Possible values are :asc or :desc. Default value is :asc.



13
14
15
16
17
18
 
# File 'lib/mail/network/retriever_methods/base.rb', line 13

def first(options = {}, &block)
  options ||= {}
  options[:what] = :first
  options[:count] ||= 1
  find(options, &block)
end

#last(options = {}, &block) ⇒ Object

Get the most recent received email(s)

Possible options:

count: number of emails to retrieve. The default value is 1.
order: order of emails returned. Possible values are :asc or :desc. Default value is :asc.



26
27
28
29
30
31
 
# File 'lib/mail/network/retriever_methods/base.rb', line 26

def last(options = {}, &block)
  options ||= {}
  options[:what] = :last
  options[:count] ||= 1
  find(options, &block)
end