Class: Net::InternetMessageIO

Inherits:
BufferedIO show all
Defined in:
lib/net/protocol.rb

Overview

:nodoc: internal use only

Instance Attribute Summary

Attributes inherited from BufferedIO

#continue_timeout, #debug_output, #io, #read_timeout, #write_timeout

Instance Method Summary collapse

Methods inherited from BufferedIO

#close, #closed?, #eof?, #inspect, #read, #read_all, #readline, #readuntil, #write, #writeline

Constructor Details

#initializeInternetMessageIO

Returns a new instance of InternetMessageIO.


325
326
327
328
# File 'lib/net/protocol.rb', line 325

def initialize(*, **)
  super
  @wbuf = nil
end

Instance Method Details

#each_list_itemObject

*library private* (cannot handle 'break')


347
348
349
350
351
# File 'lib/net/protocol.rb', line 347

def each_list_item
  while (str = readuntil("\r\n")) != ".\r\n"
    yield str.chop
  end
end

#each_message_chunkObject

Read


334
335
336
337
338
339
340
341
342
343
344
# File 'lib/net/protocol.rb', line 334

def each_message_chunk
  LOG 'reading message...'
  LOG_off()
  read_bytes = 0
  while (line = readuntil("\r\n")) != ".\r\n"
    read_bytes += line.size
    yield line.delete_prefix('.')
  end
  LOG_on()
  LOG "read message (#{read_bytes} bytes)"
end

#write_message(src) ⇒ Object

Write


365
366
367
368
369
370
371
372
373
374
375
376
# File 'lib/net/protocol.rb', line 365

def write_message(src)
  LOG "writing message from #{src.class}"
  LOG_off()
  len = writing {
    using_each_crlf_line {
      write_message_0 src
    }
  }
  LOG_on()
  LOG "wrote #{len} bytes"
  len
end

#write_message_0(src) ⇒ Object


353
354
355
356
357
358
359
# File 'lib/net/protocol.rb', line 353

def write_message_0(src)
  prev = @written_bytes
  each_crlf_line(src) do |line|
    write0 dot_stuff(line)
  end
  @written_bytes - prev
end

#write_message_by_block(&block) ⇒ Object


378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
# File 'lib/net/protocol.rb', line 378

def write_message_by_block(&block)
  LOG 'writing message from block'
  LOG_off()
  len = writing {
    using_each_crlf_line {
      begin
        block.call(WriteAdapter.new(self, :write_message_0))
      rescue LocalJumpError        # allow `break' from writer block

      end
    }
  }
  LOG_on()
  LOG "wrote #{len} bytes"
  len
end