net-imap 0.2.5 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c96e58708687b3fb8ded9def89a66e3ca9d1d83717c76c1579928ed60fb2b52
-  data.tar.gz: 56c64b20eab875d49b03e7a18f46988850e38865fbd756b0e6db3d7ecaec5975
+  metadata.gz: a91d908ae16db12c507a6cf5c0e5eef57e18c97473b2a13a0ab14cf655e9bcb7
+  data.tar.gz: 1bdab36cf0779d14e2f414e00aee90d95d2584bfc8d591c11d5104b4071bebb8
 SHA512:
-  metadata.gz: 6dc72eab65ac59b09328cad6d1ad9bcc86e4565f05416b6b7de952d2d9d4634f8f272b6e2bf36a0f386ae0acb46de506d28c3856e1a53058fa83f30edfd7275c
-  data.tar.gz: 6deb8133dd67519bd082ba287db7eda44500048ef30f6e25f43e6955ed4b82f96c690633375dad56af8590b578ea6df846422a8ae54d40e359bfd2795f2d4125
+  metadata.gz: 65133026b0746efbdc55a64bd1091da0524e5b922672767f334cec1d0357b31b973380bc8e787ff2430b831375f52050004d718b6308fa9203c9f6710ac2444b
+  data.tar.gz: 7e5e9fcac352549585e38b5a86b0198cc1c5996ad129cf9e53ca92f2ef63ea4b37d26ab8c5efd641b19711b2ea04e42622ead203c3afcaa8d420ceaaaa9893c8

data/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: 'github-actions'
+    directory: '/'
+    schedule:
+      interval: 'weekly'

data/.github/workflows/test.yml

@@ -7,7 +7,7 @@ jobs:
     name: build (${{ matrix.ruby }} / ${{ matrix.os }})
     strategy:
       matrix:
-        ruby: [ head, '3.3', '3.2', '3.1', '3.0', '2.7' ]
+        ruby: [ head, '3.1', '3.0', '2.7' ]
         os: [ ubuntu-latest, macos-latest ]
         experimental: [false]
         include:
@@ -20,7 +20,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     continue-on-error: ${{ matrix.experimental }}
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: Set up Ruby
       uses: ruby/setup-ruby@v1
       with:

data/LICENSE.txt

@@ -20,3 +20,65 @@ HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 SUCH DAMAGE.
+
+-------------------------------------------------------------------------
+
+This software includes documentation which has been copied from the relevant
+RFCs.  The copied documentation is covered by the following licenses:
+
+RFC 3501 (Editor: M. Crispin)
+Full Copyright Statement
+
+   Copyright (C) The Internet Society (2003).  All Rights Reserved.
+
+   This document and translations of it may be copied and furnished to
+   others, and derivative works that comment on or otherwise explain it
+   or assist in its implementation may be prepared, copied, published
+   and distributed, in whole or in part, without restriction of any
+   kind, provided that the above copyright notice and this paragraph are
+   included on all such copies and derivative works.  However, this
+   document itself may not be modified in any way, such as by removing
+   the copyright notice or references to the Internet Society or other
+   Internet organizations, except as needed for the purpose of
+   developing Internet standards in which case the procedures for
+   copyrights defined in the Internet Standards process must be
+   followed, or as required to translate it into languages other than
+   English.
+
+   The limited permissions granted above are perpetual and will not be
+   revoked by the Internet Society or its successors or assigns.  v This
+   document and the information contained herein is provided on an "AS
+   IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK
+   FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+   LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL
+   NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY
+   OR FITNESS FOR A PARTICULAR PURPOSE.
+
+
+RFC9051 (Editors: A. Melnikov, B. Leiba)
+Copyright Notice
+
+   Copyright (c) 2021 IETF Trust and the persons identified as the
+   document authors.  All rights reserved.
+
+   This document is subject to BCP 78 and the IETF Trust's Legal
+   Provisions Relating to IETF Documents
+   (https://trustee.ietf.org/license-info) in effect on the date of
+   publication of this document.  Please review these documents
+   carefully, as they describe your rights and restrictions with respect
+   to this document.  Code Components extracted from this document must
+   include Simplified BSD License text as described in Section 4.e of
+   the Trust Legal Provisions and are provided without warranty as
+   described in the Simplified BSD License.
+
+   This document may contain material from IETF Documents or IETF
+   Contributions published or made publicly available before November
+   10, 2008.  The person(s) controlling the copyright in some of this
+   material may not have granted the IETF Trust the right to allow
+   modifications of such material outside the IETF Standards Process.
+   Without obtaining an adequate license from the person(s) controlling
+   the copyright in such materials, this document may not be modified
+   outside the IETF Standards Process, and derivative works of it may
+   not be created outside the IETF Standards Process, except to format
+   it for publication as an RFC or to translate it into languages other
+   than English.

data/lib/net/imap/authenticators/cram_md5.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "digest/md5"
-
 # Authenticator for the "+CRAM-MD5+" SASL mechanism, specified in
 # RFC2195[https://tools.ietf.org/html/rfc2195].  See Net::IMAP#authenticate.
 #
@@ -23,7 +21,11 @@ class Net::IMAP::CramMD5Authenticator
 
   private
 
-  def initialize(user, password)
+  def initialize(user, password, warn_deprecation: true, **_ignored)
+    if warn_deprecation
+      warn "WARNING: CRAM-MD5 mechanism is deprecated." # TODO: recommend SCRAM
+    end
+    require "digest/md5"
     @user = user
     @password = password
   end

data/lib/net/imap/authenticators/digest_md5.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require "digest/md5"
-require "strscan"
-
 # Net::IMAP authenticator for the "`DIGEST-MD5`" SASL mechanism type, specified
 # in RFC2831(https://tools.ietf.org/html/rfc2831).  See Net::IMAP#authenticate.
 #
@@ -29,8 +26,8 @@ class Net::IMAP::DigestMD5Authenticator
         sparams[k] = v
       end
 
-      raise DataFormatError, "Bad Challenge: '#{challenge}'" unless c.rest.size == 0
-      raise Error, "Server does not support auth (qop = #{sparams['qop'].join(',')})" unless sparams['qop'].include?("auth")
+      raise Net::IMAP::DataFormatError, "Bad Challenge: '#{challenge}'" unless c.eos?
+      raise Net::IMAP::Error, "Server does not support auth (qop = #{sparams['qop'].join(',')})" unless sparams['qop'].include?("auth")
 
       response = {
         :nonce => sparams['nonce'],
@@ -77,11 +74,18 @@ class Net::IMAP::DigestMD5Authenticator
     end
   end
 
-  def initialize(user, password, authname = nil)
+  def initialize(user, password, authname = nil, warn_deprecation: true)
+    if warn_deprecation
+      warn "WARNING: DIGEST-MD5 SASL mechanism was deprecated by RFC6331."
+      # TODO: recommend SCRAM instead.
+    end
+    require "digest/md5"
+    require "strscan"
     @user, @password, @authname = user, password, authname
     @nc, @stage = {}, STAGE_ONE
   end
 
+
   private
 
   STAGE_ONE = :stage_one
@@ -100,7 +104,7 @@ class Net::IMAP::DigestMD5Authenticator
   def qdval(k, v)
     return if k.nil? or v.nil?
     if %w"username authzid realm nonce cnonce digest-uri qop".include? k
-      v.gsub!(/([\\"])/, "\\\1")
+      v = v.gsub(/([\\"])/, "\\\1")
       return '%s="%s"' % [k, v]
     else
       return '%s=%s' % [k, v]

data/lib/net/imap/authenticators/login.rb

@@ -33,7 +33,10 @@ class Net::IMAP::LoginAuthenticator
   STATE_USER = :USER
   STATE_PASSWORD = :PASSWORD
 
-  def initialize(user, password)
+  def initialize(user, password, warn_deprecation: true, **_ignored)
+    if warn_deprecation
+      warn "WARNING: LOGIN SASL mechanism is deprecated. Use PLAIN instead."
+    end
     @user = user
     @password = password
     @state = STATE_USER

data/lib/net/imap/authenticators.rb

@@ -19,13 +19,15 @@ module Net::IMAP::Authenticators
 
   # Builds an authenticator for Net::IMAP#authenticate.  +args+ will be passed
   # directly to the chosen authenticator's +#initialize+.
-  def authenticator(auth_type, *args)
-    auth_type = auth_type.upcase
-    unless authenticators.has_key?(auth_type)
-      raise ArgumentError,
-        format('unknown auth type - "%s"', auth_type)
+  def authenticator(mechanism, *authargs, **properties, &callback)
+    authenticator = authenticators.fetch(mechanism.upcase) do
+      raise ArgumentError, 'unknown auth type - "%s"' % mechanism
+    end
+    if authenticator.respond_to?(:new)
+      authenticator.new(*authargs, **properties, &callback)
+    else
+      authenticator.call(*authargs, **properties, &callback)
     end
-    authenticators[auth_type].new(*args)
   end
 
   private
@@ -38,7 +40,8 @@ end
 
 Net::IMAP.extend Net::IMAP::Authenticators
 
-require_relative "authenticators/login"
 require_relative "authenticators/plain"
+
+require_relative "authenticators/login"
 require_relative "authenticators/cram_md5"
 require_relative "authenticators/digest_md5"

data/lib/net/imap/errors.rb

@@ -11,40 +11,6 @@ module Net
     class DataFormatError < Error
     end
 
-    # Error raised when the socket cannot be read, due to a configured limit.
-    class ResponseReadError < Error
-    end
-
-    # Error raised when a response is larger than IMAP#max_response_size.
-    class ResponseTooLargeError < ResponseReadError
-      attr_reader :bytes_read, :literal_size
-      attr_reader :max_response_size
-
-      def initialize(msg = nil, *args,
-                     bytes_read:        nil,
-                     literal_size:      nil,
-                     max_response_size: nil,
-                     **kwargs)
-        @bytes_read        = bytes_read
-        @literal_size      = literal_size
-        @max_response_size = max_response_size
-        msg ||= [
-          "Response size", response_size_msg, "exceeds max_response_size",
-          max_response_size && "(#{max_response_size}B)",
-        ].compact.join(" ")
-        return super(msg, *args) if kwargs.empty? # ruby 2.6 compatibility
-        super(msg, *args, **kwargs)
-      end
-
-      private
-
-      def response_size_msg
-        if bytes_read && literal_size
-          "(#{bytes_read}B read + #{literal_size}B literal)"
-        end
-      end
-    end
-
     # Error raised when a response from the server is non-parseable.
     class ResponseParseError < Error
     end

data/lib/net/imap.rb

@@ -106,41 +106,6 @@ module Net
   #
   # This script invokes the FETCH command and the SEARCH command concurrently.
   #
-  # When running multiple commands, care must be taken to avoid ambiguity.  For
-  # example, SEARCH responses are ambiguous about which command they are
-  # responding to, so search commands should not run simultaneously, unless the
-  # server supports +ESEARCH+ {[RFC4731]}[https://rfc-editor.org/rfc/rfc4731] or
-  # IMAP4rev2[https://www.rfc-editor.org/rfc/rfc9051].  See {RFC9051
-  # §5.5}[https://www.rfc-editor.org/rfc/rfc9051.html#section-5.5] for
-  # other examples of command sequences which should not be pipelined.
-  #
-  # == Unbounded memory use
-  #
-  # Net::IMAP reads server responses in a separate receiver thread per client.
-  # Unhandled response data is saved to #responses, and response_handlers run
-  # inside the receiver thread.  See the list of methods for {handling server
-  # responses}[rdoc-ref:Net::IMAP@Handling+server+responses], below.
-  #
-  # Because the receiver thread continuously reads and saves new responses, some
-  # scenarios must be careful to avoid unbounded memory use:
-  #
-  # * Commands such as #list or #fetch can have an enormous number of responses.
-  # * Commands such as #fetch can result in an enormous size per response.
-  # * Long-lived connections will gradually accumulate unsolicited server
-  #   responses, especially +EXISTS+, +FETCH+, and +EXPUNGE+ responses.
-  # * A buggy or untrusted server could send inappropriate responses, which
-  #   could be very numerous, very large, and very rapid.
-  #
-  # Use paginated or limited versions of commands whenever possible.
-  #
-  # Use #max_response_size to impose a limit on incoming server responses
-  # as they are being read.  <em>This is especially important for untrusted
-  # servers.</em>
-  #
-  # Use #add_response_handler to handle responses after each one is received.
-  # Use the +response_handlers+ argument to ::new to assign response handlers
-  # before the receiver thread is started.
-  #
   # == Errors
   #
   # An IMAP server can send three different types of responses to indicate
@@ -255,9 +220,7 @@ module Net
   #    Unicode", RFC-2152[https://tools.ietf.org/html/rfc2152], May 1997.
   #
   class IMAP < Protocol
-    VERSION = "0.2.5"
-
-    autoload :ResponseReader, File.expand_path("imap/response_reader", __dir__)
+    VERSION = "0.3.0"
 
     include MonitorMixin
     if defined?(OpenSSL::SSL)
@@ -288,40 +251,6 @@ module Net
     # Seconds to wait until an IDLE response is received.
     attr_reader :idle_response_timeout
 
-    # The maximum allowed server response size.  When +nil+, there is no limit
-    # on response size.
-    #
-    # The default value is _unlimited_ (after +v0.5.8+, the default is 512 MiB).
-    # A _much_ lower value should be used with untrusted servers (for example,
-    # when connecting to a user-provided hostname).  When using a lower limit,
-    # message bodies should be fetched in chunks rather than all at once.
-    #
-    # <em>Please Note:</em> this only limits the size per response.  It does
-    # not prevent a flood of individual responses and it does not limit how
-    # many unhandled responses may be stored on the responses hash.  See
-    # Net::IMAP@Unbounded+memory+use.
-    #
-    # Socket reads are limited to the maximum remaining bytes for the current
-    # response: max_response_size minus the bytes that have already been read.
-    # When the limit is reached, or reading a +literal+ _would_ go over the
-    # limit, ResponseTooLargeError is raised and the connection is closed.
-    # See also #socket_read_limit.
-    #
-    # Note that changes will not take effect immediately, because the receiver
-    # thread may already be waiting for the next response using the previous
-    # value.  Net::IMAP#noop can force a response and enforce the new setting
-    # immediately.
-    #
-    # ==== Versioned Defaults
-    #
-    # Net::IMAP#max_response_size <em>was added in +v0.2.5+ and +v0.3.9+ as an
-    # attr_accessor, and in +v0.4.20+ and +v0.5.7+ as a delegator to a config
-    # attribute.</em>
-    #
-    # * original: +nil+ <em>(no limit)</em>
-    # * +0.5+: 512 MiB
-    attr_accessor :max_response_size
-
     # The thread to receive exceptions.
     attr_accessor :client_thread
 
@@ -449,28 +378,37 @@ module Net
     # Sends an AUTHENTICATE command to authenticate the client.
     # The +auth_type+ parameter is a string that represents
     # the authentication mechanism to be used. Currently Net::IMAP
-    # supports the authentication mechanisms:
-    #
-    #   LOGIN:: login using cleartext user and password.
-    #   CRAM-MD5:: login with cleartext user and encrypted password
-    #              (see [RFC-2195] for a full description).  This
-    #              mechanism requires that the server have the user's
-    #              password stored in clear-text password.
-    #
-    # For both of these mechanisms, there should be two +args+: username
-    # and (cleartext) password.  A server may not support one or the other
-    # of these mechanisms; check #capability for a capability of
-    # the form "AUTH=LOGIN" or "AUTH=CRAM-MD5".
-    #
-    # Authentication is done using the appropriate authenticator object:
-    # see +add_authenticator+ for more information on plugging in your own
-    # authenticator.
+    # supports the following mechanisms:
+    #
+    # PLAIN:: Login using cleartext user and password.  Secure with TLS.
+    #         See Net::IMAP::PlainAuthenticator.
+    # CRAM-MD5::   DEPRECATED: Use PLAIN (or DIGEST-MD5) with TLS.
+    # DIGEST-MD5:: DEPRECATED by RFC6331. Must be secured using TLS.
+    #              See Net::IMAP::DigestMD5Authenticator.
+    # LOGIN::      DEPRECATED: Use PLAIN.
+    #
+    # Most mechanisms require two args: authentication identity (e.g. username)
+    # and credentials (e.g. a password).  But each mechanism requires and allows
+    # different arguments; please consult the documentation for the specific
+    # mechanisms you are using.  <em>Several obsolete mechanisms are available
+    # for backwards compatibility.  Using deprecated mechanisms will issue
+    # warnings.</em>
+    #
+    # Servers do not support all mechanisms and clients must not attempt to use
+    # a mechanism unless "AUTH=#{mechanism}" is listed as a #capability.
+    # Clients must not attempt to authenticate or #login when +LOGINDISABLED+ is
+    # listed with the capabilities.  Server capabilities, especially auth
+    # mechanisms, do change after calling #starttls so they need to be checked
+    # again.
     #
     # For example:
     #
-    #    imap.authenticate('LOGIN', user, password)
+    #    imap.authenticate('PLAIN', user, password)
     #
     # A Net::IMAP::NoResponseError is raised if authentication fails.
+    #
+    # See +Net::IMAP::Authenticators+ for more information on plugging in your
+    # own authenticator.
     def authenticate(auth_type, *args)
       authenticator = self.class.authenticator(auth_type, *args)
       send_command("AUTHENTICATE", auth_type) do |resp|
@@ -1026,11 +964,6 @@ module Net
     #     end
     #   }
     #
-    # Response handlers can also be added when the client is created before the
-    # receiver thread is started, by the +response_handlers+ argument to ::new.
-    # This ensures every server response is handled, including the #greeting.
-    #
-    # Related: #remove_response_handler, #response_handlers
     def add_response_handler(handler = nil, &block)
       raise ArgumentError, "two Procs are passed" if handler && block
       @response_handlers.push(block || handler)
@@ -1146,13 +1079,6 @@ module Net
     #         OpenSSL::SSL::SSLContext#set_params as parameters.
     # open_timeout:: Seconds to wait until a connection is opened
     # idle_response_timeout:: Seconds to wait until an IDLE response is received
-    # response_handlers:: A list of response handlers to be added before the
-    #                     receiver thread is started.  This ensures every server
-    #                     response is handled, including the #greeting.  Note
-    #                     that the greeting is handled in the current thread,
-    #                     but all other responses are handled in the receiver
-    #                     thread.
-    # max_response_size:: See #max_response_size.
     #
     # The most common errors are:
     #
@@ -1183,10 +1109,8 @@ module Net
       @tagno = 0
       @open_timeout = options[:open_timeout] || 30
       @idle_response_timeout = options[:idle_response_timeout] || 5
-      @max_response_size     = options[:max_response_size]
       @parser = ResponseParser.new
       @sock = tcp_socket(@host, @port)
-      @reader = ResponseReader.new(self, @sock)
       begin
         if options[:ssl]
           start_tls_session(options[:ssl])
@@ -1197,7 +1121,6 @@ module Net
         @responses = Hash.new([].freeze)
         @tagged_responses = {}
         @response_handlers = []
-        options[:response_handlers]&.each do |h| add_response_handler(h) end
         @tagged_response_arrival = new_cond
         @continued_command_tag = nil
         @continuation_request_arrival = new_cond
@@ -1214,7 +1137,6 @@ module Net
         if @greeting.name == "BYE"
           raise ByeResponseError, @greeting
         end
-        @response_handlers.each do |handler| handler.call(@greeting) end
 
         @client_thread = Thread.current
         @receiver_thread = Thread.start {
@@ -1338,14 +1260,25 @@ module Net
     end
 
     def get_response
-      buff = @reader.read_response_buffer
+      buff = String.new
+      while true
+        s = @sock.gets(CRLF)
+        break unless s
+        buff.concat(s)
+        if /\{(\d+)\}\r\n/n =~ s
+          s = @sock.read($1.to_i)
+          buff.concat(s)
+        else
+          break
+        end
+      end
       return nil if buff.length == 0
-      $stderr.print(buff.gsub(/^/n, "S: ")) if @@debug
-      @parser.parse(buff)
+      if @@debug
+        $stderr.print(buff.gsub(/^/n, "S: "))
+      end
+      return @parser.parse(buff)
     end
 
-    #############################
-
     def record_response(name, data)
       unless @responses.has_key?(name)
         @responses[name] = []
@@ -1523,7 +1456,6 @@ module Net
         context.verify_callback = VerifyCallbackProc
       end
       @sock = SSLSocket.new(@sock, context)
-      @reader = ResponseReader.new(self, @sock)
       @sock.sync_close = true
       @sock.hostname = @host if @sock.respond_to? :hostname=
       ssl_socket_connect(@sock, @open_timeout)

data/net-imap.gemspec

@@ -10,8 +10,8 @@ end
 Gem::Specification.new do |spec|
   spec.name          = name
   spec.version       = version
-  spec.authors       = ["Shugo Maeda"]
-  spec.email         = ["shugo@ruby-lang.org"]
+  spec.authors       = ["Shugo Maeda", "nicholas a. evans"]
+  spec.email         = ["shugo@ruby-lang.org", "nick@ekenosen.net"]
 
   spec.summary       = %q{Ruby client api for Internet Message Access Protocol}
   spec.description   = %q{Ruby client api for Internet Message Access Protocol}
@@ -32,6 +32,6 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "net-protocol"
-  spec.add_dependency "digest"
-  spec.add_dependency "strscan"
+  spec.add_development_dependency "digest"
+  spec.add_development_dependency "strscan"
 end

metadata

@@ -1,13 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: net-imap
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.3.0
 platform: ruby
 authors:
 - Shugo Maeda
+- nicholas a. evans
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2022-09-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-protocol
@@ -30,7 +32,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -44,7 +46,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -54,10 +56,12 @@ dependencies:
 description: Ruby client api for Internet Message Access Protocol
 email:
 - shugo@ruby-lang.org
+- nick@ekenosen.net
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/dependabot.yml"
 - ".github/workflows/test.yml"
 - ".gitignore"
 - Gemfile
@@ -76,7 +80,6 @@ files:
 - lib/net/imap/flags.rb
 - lib/net/imap/response_data.rb
 - lib/net/imap/response_parser.rb
-- lib/net/imap/response_reader.rb
 - net-imap.gemspec
 homepage: https://github.com/ruby/net-imap
 licenses:
@@ -85,6 +88,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/ruby/net-imap
   source_code_uri: https://github.com/ruby/net-imap
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -99,7 +103,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.8
+rubygems_version: 3.4.0.dev
+signing_key:
 specification_version: 4
 summary: Ruby client api for Internet Message Access Protocol
 test_files: []

data/lib/net/imap/response_reader.rb

@@ -1,75 +0,0 @@
-# frozen_string_literal: true
-
-module Net
-  class IMAP
-    # See https://www.rfc-editor.org/rfc/rfc9051#section-2.2.2
-    class ResponseReader # :nodoc:
-      attr_reader :client
-
-      def initialize(client, sock)
-        @client, @sock = client, sock
-      end
-
-      def read_response_buffer
-        @buff = String.new
-        catch :eof do
-          while true
-            read_line
-            break unless (@literal_size = get_literal_size)
-            read_literal
-          end
-        end
-        buff
-      ensure
-        @buff = nil
-      end
-
-      private
-
-      attr_reader :buff, :literal_size
-
-      def bytes_read;       buff.bytesize                         end
-      def empty?;           buff.empty?                           end
-      def done?;            line_done? && !get_literal_size       end
-      def line_done?;       buff.end_with?(CRLF)                  end
-      def get_literal_size; /\{(\d+)\}\r\n\z/n =~ buff && $1.to_i end
-
-      def read_line
-        buff << (@sock.gets(CRLF, read_limit) or throw :eof)
-        max_response_remaining! unless line_done?
-      end
-
-      def read_literal
-        # check before allocating memory for literal
-        max_response_remaining!
-        literal = String.new(capacity: literal_size)
-        buff << (@sock.read(read_limit(literal_size), literal) or throw :eof)
-      ensure
-        @literal_size = nil
-      end
-
-      def read_limit(limit = nil)
-        [limit, max_response_remaining!].compact.min
-      end
-
-      def max_response_size;      client.max_response_size                end
-      def max_response_remaining; max_response_size &.- bytes_read        end
-      def response_too_large?;    max_response_size &.< min_response_size end
-      def min_response_size;      bytes_read + min_response_remaining     end
-
-      def min_response_remaining
-        empty? ? 3 : done? ? 0 : (literal_size || 0) + 2
-      end
-
-      def max_response_remaining!
-        return max_response_remaining unless response_too_large?
-        raise ResponseTooLargeError.new(
-          max_response_size: max_response_size,
-          bytes_read:        bytes_read,
-          literal_size:      literal_size,
-        )
-      end
-
-    end
-  end
-end