Net::POP3

 
               # File net/pop.rb, line 238
def POP3.APOP(isapop)
  isapop ? APOP : POP3
end
            

 
               # File net/pop.rb, line 305
def POP3.auth_only(address, port = nil,
                   account = nil, password = nil,
                   isapop = false)
  new(address, port, isapop).auth_only account, password
end
            

 
               # File net/pop.rb, line 377
def POP3.certs
  return @ssl_params[:ca_file] || @ssl_params[:ca_path]
end
            

 
               # File net/pop.rb, line 337
def POP3.create_ssl_params(verify_or_params = {}, certs = nil)
  begin
    params = verify_or_params.to_hash
  rescue NoMethodError
    params = {}
    params[:verify_mode] = verify_or_params
    if certs
      if File.file?(certs)
        params[:ca_file] = certs
      elsif File.directory?(certs)
        params[:ca_path] = certs
      end
    end
  end
  return params
end
            

 
               # File net/pop.rb, line 210
def POP3.default_pop3_port
  110
end
            

 
               # File net/pop.rb, line 215
def POP3.default_pop3s_port
  995
end
            

 
               # File net/pop.rb, line 205
def POP3.default_port
  default_pop3_port()
end
            

 
               # File net/pop.rb, line 283
def POP3.delete_all(address, port = nil,
                    account = nil, password = nil,
                    isapop = false, &block)
  start(address, port, account, password, isapop) {|pop|
    pop.delete_all(&block)
  }
end
            

 
               # File net/pop.rb, line 355
def POP3.disable_ssl
  @ssl_params = nil
end
            

 
               # File net/pop.rb, line 332
def POP3.enable_ssl(*args)
  @ssl_params = create_ssl_params(*args)
end
            

 
               # File net/pop.rb, line 262
def POP3.foreach(address, port = nil,
                 account = nil, password = nil,
                 isapop = false, &block)  # :yields: message
  start(address, port, account, password, isapop) {|pop|
    pop.each_mail(&block)
  }
end
            

 
               # File net/pop.rb, line 417
def initialize(addr, port = nil, isapop = false)
  @address = addr
  @ssl_params = POP3.ssl_params
  @port = port
  @apop = isapop

  @command = nil
  @socket = nil
  @started = false
  @open_timeout = 30
  @read_timeout = 60
  @debug_output = nil

  @mails = nil
  @n_mails = nil
  @n_bytes = nil
end
            

 
               # File net/pop.rb, line 362
def POP3.ssl_params
  return @ssl_params
end
            

 
               # File net/pop.rb, line 401
def POP3.start(address, port = nil,
               account = nil, password = nil,
               isapop = false, &block)   # :yield: pop
  new(address, port, isapop).start(account, password, &block)
end
            

 
               # File net/pop.rb, line 367
def POP3.use_ssl?
  return !@ssl_params.nil?
end
            

 
               # File net/pop.rb, line 372
def POP3.verify
  return @ssl_params[:verify_mode]
end
            

 
               # File net/pop.rb, line 436
def apop?
  @apop
end
            

 
               # File net/pop.rb, line 314
def auth_only(account, password)
  raise IOError, 'opening previously opened POP session' if started?
  start(account, password) {
    ;
  }
end
            

 
               # File net/pop.rb, line 686
def delete_all # :yield: message
  mails().each do |m|
    yield m if block_given?
    m.delete unless m.deleted?
  end
end
            

 
               # File net/pop.rb, line 463
def disable_ssl
  @ssl_params = nil
end
            

 
               # File net/pop.rb, line 664
def each_mail(&block)  # :yield: message
  mails().each(&block)
end
            

 
               # File net/pop.rb, line 452
def enable_ssl(verify_or_params = {}, certs = nil, port = nil)
  begin
    @ssl_params = verify_or_params.to_hash.dup
    @port = @ssl_params.delete(:port) || @port
  rescue NoMethodError
    @ssl_params = POP3.create_ssl_params(verify_or_params, certs)
    @port = port || @port
  end
end
            

 
               # File net/pop.rb, line 585
def finish
  raise IOError, 'POP session not yet started' unless started?
  do_finish
end
            

 
               # File net/pop.rb, line 468
def inspect
  +"#<#{self.class} #{@address}:#{@port} open=#{@started}>"
end
            

 
               # File net/pop.rb, line 711
def logging(msg)
  @debug_output << msg + "\n" if @debug_output
end
            

 
               # File net/pop.rb, line 642
def mails
  return @mails.dup if @mails
  if n_mails() == 0
    # some popd raises error for LIST on the empty mailbox.
    @mails = []
    return []
  end

  @mails = command().list.map {|num, size|
    POPMail.new(num, size, self, command())
  }
  @mails.dup
end
            

 
               # File net/pop.rb, line 630
def n_bytes
  return @n_bytes if @n_bytes
  @n_mails, @n_bytes = command().stat
  @n_bytes
end
            

 
               # File net/pop.rb, line 623
def n_mails
  return @n_mails if @n_mails
  @n_mails, @n_bytes = command().stat
  @n_mails
end
            

 
               # File net/pop.rb, line 493
def port
  return @port || (use_ssl? ? POP3.default_pop3s_port : POP3.default_pop3_port)
end
            

 
               # File net/pop.rb, line 508
def read_timeout=(sec)
  @command.socket.read_timeout = sec if @command
  @read_timeout = sec
end
            

 
               # File net/pop.rb, line 696
def reset
  command().rset
  mails().each do |m|
    m.instance_eval {
      @deleted = false
    }
  end
end
            

 
               # File net/pop.rb, line 485
def set_debug_output(arg)
  @debug_output = arg
end
            

 
               # File net/pop.rb, line 526
def start(account, password) # :yield: pop
  raise IOError, 'POP session already started' if @started
  if block_given?
    begin
      do_start account, password
      return yield(self)
    ensure
      do_finish
    end
  else
    do_start account, password
    return self
  end
end
            

 
               # File net/pop.rb, line 514
def started?
  @started
end
            

 
               # File net/pop.rb, line 441
def use_ssl?
  return !@ssl_params.nil?
end