packwerk 2.2.0 → 2.2.1

data/sorbet/rbi/gems/net-pop@0.1.1.rbi

@@ -0,0 +1,926 @@
+# typed: true
+
+# DO NOT EDIT MANUALLY
+# This is an autogenerated file for types exported from the `net-pop` gem.
+# Please instead update this file by running `bin/tapioca gem net-pop`.
+
+# This class is equivalent to POP3, except that it uses APOP authentication.
+#
+# source://net-pop-0.1.1/lib/net/pop.rb:727
+class Net::APOP < ::Net::POP3
+  # Always returns true.
+  #
+  # @return [Boolean]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:728
+  def apop?; end
+end
+
+# class aliases
+#
+# source://net-pop-0.1.1/lib/net/pop.rb:734
+Net::APOPSession = Net::APOP
+
+# class aliases
+#
+# source://net-pop-0.1.1/lib/net/pop.rb:719
+Net::POP = Net::POP3
+
+# == What is This Library?
+#
+# This library provides functionality for retrieving
+# email via POP3, the Post Office Protocol version 3. For details
+# of POP3, see [RFC1939] (http://www.ietf.org/rfc/rfc1939.txt).
+#
+# == Examples
+#
+# === Retrieving Messages
+#
+# This example retrieves messages from the server and deletes them
+# on the server.
+#
+# Messages are written to files named 'inbox/1', 'inbox/2', ....
+# Replace 'pop.example.com' with your POP3 server address, and
+# 'YourAccount' and 'YourPassword' with the appropriate account
+# details.
+#
+#     require 'net/pop'
+#
+#     pop = Net::POP3.new('pop.example.com')
+#     pop.start('YourAccount', 'YourPassword')             # (1)
+#     if pop.mails.empty?
+#       puts 'No mail.'
+#     else
+#       i = 0
+#       pop.each_mail do |m|   # or "pop.mails.each ..."   # (2)
+#         File.open("inbox/#{i}", 'w') do |f|
+#           f.write m.pop
+#         end
+#         m.delete
+#         i += 1
+#       end
+#       puts "#{pop.mails.size} mails popped."
+#     end
+#     pop.finish                                           # (3)
+#
+# 1. Call Net::POP3#start and start POP session.
+# 2. Access messages by using POP3#each_mail and/or POP3#mails.
+# 3. Close POP session by calling POP3#finish or use the block form of #start.
+#
+# === Shortened Code
+#
+# The example above is very verbose. You can shorten the code by using
+# some utility methods. First, the block form of Net::POP3.start can
+# be used instead of POP3.new, POP3#start and POP3#finish.
+#
+#     require 'net/pop'
+#
+#     Net::POP3.start('pop.example.com', 110,
+#                     'YourAccount', 'YourPassword') do |pop|
+#       if pop.mails.empty?
+#         puts 'No mail.'
+#       else
+#         i = 0
+#         pop.each_mail do |m|   # or "pop.mails.each ..."
+#           File.open("inbox/#{i}", 'w') do |f|
+#             f.write m.pop
+#           end
+#           m.delete
+#           i += 1
+#         end
+#         puts "#{pop.mails.size} mails popped."
+#       end
+#     end
+#
+# POP3#delete_all is an alternative for #each_mail and #delete.
+#
+#     require 'net/pop'
+#
+#     Net::POP3.start('pop.example.com', 110,
+#                     'YourAccount', 'YourPassword') do |pop|
+#       if pop.mails.empty?
+#         puts 'No mail.'
+#       else
+#         i = 1
+#         pop.delete_all do |m|
+#           File.open("inbox/#{i}", 'w') do |f|
+#             f.write m.pop
+#           end
+#           i += 1
+#         end
+#       end
+#     end
+#
+# And here is an even shorter example.
+#
+#     require 'net/pop'
+#
+#     i = 0
+#     Net::POP3.delete_all('pop.example.com', 110,
+#                          'YourAccount', 'YourPassword') do |m|
+#       File.open("inbox/#{i}", 'w') do |f|
+#         f.write m.pop
+#       end
+#       i += 1
+#     end
+#
+# === Memory Space Issues
+#
+# All the examples above get each message as one big string.
+# This example avoids this.
+#
+#     require 'net/pop'
+#
+#     i = 1
+#     Net::POP3.delete_all('pop.example.com', 110,
+#                          'YourAccount', 'YourPassword') do |m|
+#       File.open("inbox/#{i}", 'w') do |f|
+#         m.pop do |chunk|    # get a message little by little.
+#           f.write chunk
+#         end
+#         i += 1
+#       end
+#     end
+#
+# === Using APOP
+#
+# The net/pop library supports APOP authentication.
+# To use APOP, use the Net::APOP class instead of the Net::POP3 class.
+# You can use the utility method, Net::POP3.APOP(). For example:
+#
+#     require 'net/pop'
+#
+#     # Use APOP authentication if $isapop == true
+#     pop = Net::POP3.APOP($isapop).new('apop.example.com', 110)
+#     pop.start('YourAccount', 'YourPassword') do |pop|
+#       # Rest of the code is the same.
+#     end
+#
+# === Fetch Only Selected Mail Using 'UIDL' POP Command
+#
+# If your POP server provides UIDL functionality,
+# you can grab only selected mails from the POP server.
+# e.g.
+#
+#     def need_pop?( id )
+#       # determine if we need pop this mail...
+#     end
+#
+#     Net::POP3.start('pop.example.com', 110,
+#                     'Your account', 'Your password') do |pop|
+#       pop.mails.select { |m| need_pop?(m.unique_id) }.each do |m|
+#         do_something(m.pop)
+#       end
+#     end
+#
+# The POPMail#unique_id() method returns the unique-id of the message as a
+# String. Normally the unique-id is a hash of the message.
+#
+# source://net-pop-0.1.1/lib/net/pop.rb:197
+class Net::POP3 < ::Net::Protocol
+  # Creates a new POP3 object.
+  #
+  # +address+ is the hostname or ip address of your POP3 server.
+  #
+  # The optional +port+ is the port to connect to.
+  #
+  # The optional +isapop+ specifies whether this connection is going
+  # to use APOP authentication; it defaults to +false+.
+  #
+  # This method does *not* open the TCP connection.
+  #
+  # @return [POP3] a new instance of POP3
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:417
+  def initialize(addr, port = T.unsafe(nil), isapop = T.unsafe(nil)); end
+
+  # +true+ if the POP3 session has started.
+  #
+  # @return [Boolean]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:514
+  def active?; end
+
+  # The address to connect to.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:490
+  def address; end
+
+  # Does this instance use APOP authentication?
+  #
+  # @return [Boolean]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:436
+  def apop?; end
+
+  # Starts a pop3 session, attempts authentication, and quits.
+  # This method must not be called while POP3 session is opened.
+  # This method raises POPAuthenticationError if authentication fails.
+  #
+  # @raise [IOError]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:314
+  def auth_only(account, password); end
+
+  # Deletes all messages on the server.
+  #
+  # If called with a block, yields each message in turn before deleting it.
+  #
+  # === Example
+  #
+  #     n = 1
+  #     pop.delete_all do |m|
+  #       File.open("inbox/#{n}") do |f|
+  #         f.write m.pop
+  #       end
+  #       n += 1
+  #     end
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:687
+  def delete_all; end
+
+  # Disable SSL for all new instances.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:463
+  def disable_ssl; end
+
+  # Yields each message to the passed-in block in turn.
+  # Equivalent to:
+  #
+  #   pop3.mails.each do |popmail|
+  #     ....
+  #   end
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:665
+  def each(&block); end
+
+  # Yields each message to the passed-in block in turn.
+  # Equivalent to:
+  #
+  #   pop3.mails.each do |popmail|
+  #     ....
+  #   end
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:665
+  def each_mail(&block); end
+
+  # :call-seq:
+  #    Net::POP#enable_ssl(params = {})
+  #
+  # Enables SSL for this instance.  Must be called before the connection is
+  # established to have any effect.
+  # +params[:port]+ is port to establish the SSL connection on; Defaults to 995.
+  # +params+ (except :port) is passed to OpenSSL::SSLContext#set_params.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:452
+  def enable_ssl(verify_or_params = T.unsafe(nil), certs = T.unsafe(nil), port = T.unsafe(nil)); end
+
+  # Finishes a POP3 session and closes TCP connection.
+  #
+  # @raise [IOError]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:586
+  def finish; end
+
+  # Provide human-readable stringification of class state.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:468
+  def inspect; end
+
+  # debugging output for +msg+
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:712
+  def logging(msg); end
+
+  # Returns an array of Net::POPMail objects, representing all the
+  # messages on the server.  This array is renewed when the session
+  # restarts; otherwise, it is fetched from the server the first time
+  # this method is called (directly or indirectly) and cached.
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:643
+  def mails; end
+
+  # Returns the total size in bytes of all the messages on the POP server.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:631
+  def n_bytes; end
+
+  # Returns the number of messages on the POP server.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:624
+  def n_mails; end
+
+  # Seconds to wait until a connection is opened.
+  # If the POP3 object cannot open a connection within this time,
+  # it raises a Net::OpenTimeout exception. The default value is 30 seconds.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:500
+  def open_timeout; end
+
+  # Seconds to wait until a connection is opened.
+  # If the POP3 object cannot open a connection within this time,
+  # it raises a Net::OpenTimeout exception. The default value is 30 seconds.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:500
+  def open_timeout=(_arg0); end
+
+  # The port number to connect to.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:493
+  def port; end
+
+  # Seconds to wait until reading one block (by one read(1) call).
+  # If the POP3 object cannot complete a read() within this time,
+  # it raises a Net::ReadTimeout exception. The default value is 60 seconds.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:505
+  def read_timeout; end
+
+  # Set the read timeout.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:508
+  def read_timeout=(sec); end
+
+  # Resets the session.  This clears all "deleted" marks from messages.
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:697
+  def reset; end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:706
+  def set_all_uids; end
+
+  # *WARNING*: This method causes a serious security hole.
+  # Use this method only for debugging.
+  #
+  # Set an output stream for debugging.
+  #
+  # === Example
+  #
+  #   pop = Net::POP.new(addr, port)
+  #   pop.set_debug_output $stderr
+  #   pop.start(account, passwd) do |pop|
+  #     ....
+  #   end
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:485
+  def set_debug_output(arg); end
+
+  # Starts a POP3 session.
+  #
+  # When called with block, gives a POP3 object to the block and
+  # closes the session after block call finishes.
+  #
+  # This method raises a POPAuthenticationError if authentication fails.
+  #
+  # @raise [IOError]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:526
+  def start(account, password); end
+
+  # +true+ if the POP3 session has started.
+  #
+  # @return [Boolean]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:514
+  def started?; end
+
+  # does this instance use SSL?
+  #
+  # @return [Boolean]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:441
+  def use_ssl?; end
+
+  private
+
+  # Returns the current command.
+  #
+  # Raises IOError if there is no active socket
+  #
+  # @raise [IOError]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:612
+  def command; end
+
+  # nil's out the:
+  # - mails
+  # - number counter for mails
+  # - number counter for bytes
+  # - quits the current command, if any
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:596
+  def do_finish; end
+
+  # internal method for Net::POP3.start
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:542
+  def do_start(account, password); end
+
+  # Does nothing
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:581
+  def on_connect; end
+
+  class << self
+    # Returns the APOP class if +isapop+ is true; otherwise, returns
+    # the POP class.  For example:
+    #
+    #     # Example 1
+    #     pop = Net::POP3::APOP($is_apop).new(addr, port)
+    #
+    #     # Example 2
+    #     Net::POP3::APOP($is_apop).start(addr, port) do |pop|
+    #       ....
+    #     end
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:238
+    def APOP(isapop); end
+
+    # Opens a POP3 session, attempts authentication, and quits.
+    #
+    # This method raises POPAuthenticationError if authentication fails.
+    #
+    # === Example: normal POP3
+    #
+    #     Net::POP3.auth_only('pop.example.com', 110,
+    #                         'YourAccount', 'YourPassword')
+    #
+    # === Example: APOP
+    #
+    #     Net::POP3.auth_only('pop.example.com', 110,
+    #                         'YourAccount', 'YourPassword', true)
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:305
+    def auth_only(address, port = T.unsafe(nil), account = T.unsafe(nil), password = T.unsafe(nil), isapop = T.unsafe(nil)); end
+
+    # returns the :ca_file or :ca_path from POP3.ssl_params
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:377
+    def certs; end
+
+    # Constructs proper parameters from arguments
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:337
+    def create_ssl_params(verify_or_params = T.unsafe(nil), certs = T.unsafe(nil)); end
+
+    # The default port for POP3 connections, port 110
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:210
+    def default_pop3_port; end
+
+    # The default port for POP3S connections, port 995
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:215
+    def default_pop3s_port; end
+
+    # returns the port for POP3
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:205
+    def default_port; end
+
+    # Starts a POP3 session and deletes all messages on the server.
+    # If a block is given, each POPMail object is yielded to it before
+    # being deleted.
+    #
+    # This method raises a POPAuthenticationError if authentication fails.
+    #
+    # === Example
+    #
+    #     Net::POP3.delete_all('pop.example.com', 110,
+    #                          'YourAccount', 'YourPassword') do |m|
+    #       file.write m.pop
+    #     end
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:283
+    def delete_all(address, port = T.unsafe(nil), account = T.unsafe(nil), password = T.unsafe(nil), isapop = T.unsafe(nil), &block); end
+
+    # Disable SSL for all new instances.
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:355
+    def disable_ssl; end
+
+    # :call-seq:
+    #    Net::POP.enable_ssl(params = {})
+    #
+    # Enable SSL for all new instances.
+    # +params+ is passed to OpenSSL::SSLContext#set_params.
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:332
+    def enable_ssl(*args); end
+
+    # Starts a POP3 session and iterates over each POPMail object,
+    # yielding it to the +block+.
+    # This method is equivalent to:
+    #
+    #     Net::POP3.start(address, port, account, password) do |pop|
+    #       pop.each_mail do |m|
+    #         yield m
+    #       end
+    #     end
+    #
+    # This method raises a POPAuthenticationError if authentication fails.
+    #
+    # === Example
+    #
+    #     Net::POP3.foreach('pop.example.com', 110,
+    #                       'YourAccount', 'YourPassword') do |m|
+    #       file.write m.pop
+    #       m.delete if $DELETE
+    #     end
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:262
+    def foreach(address, port = T.unsafe(nil), account = T.unsafe(nil), password = T.unsafe(nil), isapop = T.unsafe(nil), &block); end
+
+    # source://net-pop-0.1.1/lib/net/pop.rb:219
+    def socket_type; end
+
+    # returns the SSL Parameters
+    #
+    # see also POP3.enable_ssl
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:362
+    def ssl_params; end
+
+    # Creates a new POP3 object and open the connection.  Equivalent to
+    #
+    #   Net::POP3.new(address, port, isapop).start(account, password)
+    #
+    # If +block+ is provided, yields the newly-opened POP3 object to it,
+    # and automatically closes it at the end of the session.
+    #
+    # === Example
+    #
+    #    Net::POP3.start(addr, port, account, password) do |pop|
+    #      pop.each_mail do |m|
+    #        file.write m.pop
+    #        m.delete
+    #      end
+    #    end
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:401
+    def start(address, port = T.unsafe(nil), account = T.unsafe(nil), password = T.unsafe(nil), isapop = T.unsafe(nil), &block); end
+
+    # returns +true+ if POP3.ssl_params is set
+    #
+    # @return [Boolean]
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:367
+    def use_ssl?; end
+
+    # returns whether verify_mode is enable from POP3.ssl_params
+    #
+    # source://net-pop-0.1.1/lib/net/pop.rb:372
+    def verify; end
+  end
+end
+
+# version of this library
+#
+# source://net-pop-0.1.1/lib/net/pop.rb:198
+Net::POP3::VERSION = T.let(T.unsafe(nil), String)
+
+# source://net-pop-0.1.1/lib/net/pop.rb:889
+class Net::POP3Command
+  # @return [POP3Command] a new instance of POP3Command
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:891
+  def initialize(sock); end
+
+  # @raise [POPAuthenticationError]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:911
+  def apop(account, password); end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:904
+  def auth(account, password); end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:959
+  def dele(num); end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:900
+  def inspect; end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:921
+  def list; end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:980
+  def quit; end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:952
+  def retr(num, &block); end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:941
+  def rset; end
+
+  # Returns the value of attribute socket.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:898
+  def socket; end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:934
+  def stat; end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:945
+  def top(num, lines = T.unsafe(nil), &block); end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:963
+  def uidl(num = T.unsafe(nil)); end
+
+  private
+
+  # @raise [POPError]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:1000
+  def check_response(res); end
+
+  # @raise [POPAuthenticationError]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:1005
+  def check_response_auth(res); end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:1010
+  def critical; end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:991
+  def get_response(fmt, *fargs); end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:986
+  def getok(fmt, *fargs); end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:996
+  def recv_response; end
+end
+
+# source://net-pop-0.1.1/lib/net/pop.rb:721
+Net::POP3Session = Net::POP3
+
+# POP3 authentication error.
+#
+# source://net-pop-0.1.1/lib/net/pop.rb:40
+class Net::POPAuthenticationError < ::Net::ProtoAuthError; end
+
+# Unexpected response from the server.
+#
+# source://net-pop-0.1.1/lib/net/pop.rb:43
+class Net::POPBadResponse < ::Net::POPError; end
+
+# Non-authentication POP3 protocol error
+# (reply code "-ERR", except authentication).
+#
+# source://net-pop-0.1.1/lib/net/pop.rb:37
+class Net::POPError < ::Net::ProtocolError; end
+
+# This class represents a message which exists on the POP server.
+# Instances of this class are created by the POP3 class; they should
+# not be directly created by the user.
+#
+# source://net-pop-0.1.1/lib/net/pop.rb:741
+class Net::POPMail
+  # @return [POPMail] a new instance of POPMail
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:743
+  def initialize(num, len, pop, cmd); end
+
+  # This method fetches the message.  If called with a block, the
+  # message is yielded to the block one chunk at a time.  If called
+  # without a block, the message is returned as a String.  The optional
+  # +dest+ argument will be prepended to the returned String; this
+  # argument is essentially obsolete.
+  #
+  # === Example without block
+  #
+  #     POP3.start('pop.example.com', 110,
+  #                'YourAccount', 'YourPassword') do |pop|
+  #       n = 1
+  #       pop.mails.each do |popmail|
+  #         File.open("inbox/#{n}", 'w') do |f|
+  #           f.write popmail.pop
+  #         end
+  #         popmail.delete
+  #         n += 1
+  #       end
+  #     end
+  #
+  # === Example with block
+  #
+  #     POP3.start('pop.example.com', 110,
+  #                'YourAccount', 'YourPassword') do |pop|
+  #       n = 1
+  #       pop.mails.each do |popmail|
+  #         File.open("inbox/#{n}", 'w') do |f|
+  #           popmail.pop do |chunk|            ####
+  #             f.write chunk
+  #           end
+  #         end
+  #         n += 1
+  #       end
+  #     end
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:802
+  def all(dest = T.unsafe(nil), &block); end
+
+  # Marks a message for deletion on the server.  Deletion does not
+  # actually occur until the end of the session; deletion may be
+  # cancelled for _all_ marked messages by calling POP3#reset().
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # === Example
+  #
+  #     POP3.start('pop.example.com', 110,
+  #                'YourAccount', 'YourPassword') do |pop|
+  #       n = 1
+  #       pop.mails.each do |popmail|
+  #         File.open("inbox/#{n}", 'w') do |f|
+  #           f.write popmail.pop
+  #         end
+  #         popmail.delete         ####
+  #         n += 1
+  #       end
+  #     end
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:858
+  def delete; end
+
+  # Marks a message for deletion on the server.  Deletion does not
+  # actually occur until the end of the session; deletion may be
+  # cancelled for _all_ marked messages by calling POP3#reset().
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # === Example
+  #
+  #     POP3.start('pop.example.com', 110,
+  #                'YourAccount', 'YourPassword') do |pop|
+  #       n = 1
+  #       pop.mails.each do |popmail|
+  #         File.open("inbox/#{n}", 'w') do |f|
+  #           f.write popmail.pop
+  #         end
+  #         popmail.delete         ####
+  #         n += 1
+  #       end
+  #     end
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:858
+  def delete!; end
+
+  # True if the mail has been deleted.
+  #
+  # @return [Boolean]
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:866
+  def deleted?; end
+
+  # Fetches the message header.
+  #
+  # The optional +dest+ argument is obsolete.
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:834
+  def header(dest = T.unsafe(nil)); end
+
+  # Provide human-readable stringification of class state.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:760
+  def inspect; end
+
+  # The length of the message in octets.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:756
+  def length; end
+
+  # This method fetches the message.  If called with a block, the
+  # message is yielded to the block one chunk at a time.  If called
+  # without a block, the message is returned as a String.  The optional
+  # +dest+ argument will be prepended to the returned String; this
+  # argument is essentially obsolete.
+  #
+  # === Example without block
+  #
+  #     POP3.start('pop.example.com', 110,
+  #                'YourAccount', 'YourPassword') do |pop|
+  #       n = 1
+  #       pop.mails.each do |popmail|
+  #         File.open("inbox/#{n}", 'w') do |f|
+  #           f.write popmail.pop
+  #         end
+  #         popmail.delete
+  #         n += 1
+  #       end
+  #     end
+  #
+  # === Example with block
+  #
+  #     POP3.start('pop.example.com', 110,
+  #                'YourAccount', 'YourPassword') do |pop|
+  #       n = 1
+  #       pop.mails.each do |popmail|
+  #         File.open("inbox/#{n}", 'w') do |f|
+  #           popmail.pop do |chunk|            ####
+  #             f.write chunk
+  #           end
+  #         end
+  #         n += 1
+  #       end
+  #     end
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:802
+  def mail(dest = T.unsafe(nil), &block); end
+
+  # The sequence number of the message on the server.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:753
+  def number; end
+
+  # This method fetches the message.  If called with a block, the
+  # message is yielded to the block one chunk at a time.  If called
+  # without a block, the message is returned as a String.  The optional
+  # +dest+ argument will be prepended to the returned String; this
+  # argument is essentially obsolete.
+  #
+  # === Example without block
+  #
+  #     POP3.start('pop.example.com', 110,
+  #                'YourAccount', 'YourPassword') do |pop|
+  #       n = 1
+  #       pop.mails.each do |popmail|
+  #         File.open("inbox/#{n}", 'w') do |f|
+  #           f.write popmail.pop
+  #         end
+  #         popmail.delete
+  #         n += 1
+  #       end
+  #     end
+  #
+  # === Example with block
+  #
+  #     POP3.start('pop.example.com', 110,
+  #                'YourAccount', 'YourPassword') do |pop|
+  #       n = 1
+  #       pop.mails.each do |popmail|
+  #         File.open("inbox/#{n}", 'w') do |f|
+  #           popmail.pop do |chunk|            ####
+  #             f.write chunk
+  #           end
+  #         end
+  #         n += 1
+  #       end
+  #     end
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:802
+  def pop(dest = T.unsafe(nil), &block); end
+
+  # The length of the message in octets.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:756
+  def size; end
+
+  # Fetches the message header and +lines+ lines of body.
+  #
+  # The optional +dest+ argument is obsolete.
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:822
+  def top(lines, dest = T.unsafe(nil)); end
+
+  # source://net-pop-0.1.1/lib/net/pop.rb:882
+  def uid=(uid); end
+
+  # Returns the unique-id of the message.
+  # Normally the unique-id is a hash string of the message.
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:874
+  def uidl; end
+
+  # Returns the unique-id of the message.
+  # Normally the unique-id is a hash string of the message.
+  #
+  # This method raises a POPError if an error occurs.
+  #
+  # source://net-pop-0.1.1/lib/net/pop.rb:874
+  def unique_id; end
+end
+
+# source://net-pop-0.1.1/lib/net/pop.rb:720
+Net::POPSession = Net::POP3