copper-cti 2.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5cdd69afbbde6d1d1b50191f409c57627960fe85190d4f86ec5c1f94c334e0fa
+  data.tar.gz: 76969132610a3b8cedc70ffd088d75792dbaf90e74031432c4f1914a96c21065
+SHA512:
+  metadata.gz: 0cc2ea939f18e9a8e9d281551b138e955845b13cb70fee2f90deadf375b9b411a3dfb186983a6d69bd91303405b54f597a1f9be4d574a18cd5f0b35cac675bf2
+  data.tar.gz: 212f9c76afe757de47d15c9efdc307354dd0e638d57385e8aa44300ac06297512ee2461c2e6012ca6899b6f6cbff883b7a53fd612d9e46fa4809d71cb4d17172

data/src/code/CTI/Builder/FileBuilder.rb

@@ -0,0 +1,36 @@
+require File.expand_path('StreamBuilder', File.dirname(__FILE__))
+
+module CTI
+  module Builder
+=begin rdoc
+Version::   $Id: FileBuilder.rb 902 2013-04-23 05:07:04Z miyabe $
+
+ファイルに対して結果を構築するオブジェクトです。
+=end
+  class FileBuilder < StreamBuilder
+=begin rdoc
+結果構築オブジェクトを作成します。
+
+file:: 結果ファイル
+=end
+      def initialize(file)
+        super(nil)
+        @file = file
+      end
+
+      def serial_write(data)
+        @out = File.open(@file, 'wb') unless @out
+        @out.write(data)
+      end
+
+      def finish
+        unless @out
+          @out = File.open(@file, 'wb')
+          super
+        end
+        @out.close
+        @out = nil
+      end
+    end
+  end
+end

data/src/code/CTI/Builder/NullBuilder.rb

@@ -0,0 +1,29 @@
+module CTI
+  module Builder
+=begin rdoc
+このオブジェクトは結果を構築しません。
+=end
+    class NullBuilder
+      def add_block
+      end
+      
+      def insert_block_before (anchor_id)
+      end
+      
+      def write (id, data)
+      end
+      
+      def close_block (id)
+      end
+      
+      def serial_write (data)
+      end
+      
+      def finish
+      end
+      
+      def dispose
+      end
+    end
+  end
+end

data/src/code/CTI/Builder/StreamBuilder.rb

@@ -0,0 +1,212 @@
+require 'tempfile'
+
+module CTI
+=begin rdoc
+このモジュールのクラスは、１つの出力結果を構築するためのものです。
+=end
+  module Builder
+    class Fragment
+      def initialize(id)
+        @id = id
+        @prev = nil
+        @nxt = nil
+        @length = 0
+        @buffer = ''
+      end
+
+      def id
+        @id
+      end
+
+      def prev=(prev)
+        @prev = prev
+      end
+
+      def prev
+        @prev
+      end
+
+      def nxt=(nxt)
+        @nxt = nxt
+      end
+
+      def nxt
+        @nxt
+      end
+
+=begin
+フラグメントにデータを書き込みます。
+
+tempFile:: 一時ファイル
+onMemory:: メモリ上に置かれたデータの合計サイズ
+segment:: セグメント番号シーケンス
+bytes:: データ
+
+戻り値:: 書き込んだバイト数
+=end
+
+      def write(tempFile, onMemory, segment, bytes)
+        len = bytes.bytesize
+        if (!@segments &&
+        @length + len <= CTIP2::FRG_MEM_SIZE &&
+        onMemory + len <= CTIP2::ON_MEMORY)
+          @buffer += bytes
+          onMemory += len
+        else
+          if @buffer
+            segment, wlen = raf_write(tempFile, segment, @buffer)
+            onMemory -= wlen
+            @buffer = nil
+          end
+          segment, len = raf_write(tempFile, segment, bytes)
+        end
+        @length += len
+        return onMemory, segment, len
+      end
+
+=begin
+フラグメントの内容を吐き出して、フラグメントを破棄します。
+
+tempFile:: 一時ファイル
+out:: 出力先ストリーム( IO )
+=end
+
+      def flush(tempFile, out)
+        unless @segments
+          out.write(@buffer)
+          @buffer = nil
+        else
+          segcount = @segments.size
+          for seg in @segments
+            tempFile.pos = seg * CTIP2::SEGMENT_SIZE
+            buff = tempFile.read(seg == @segments.last ? @segLen : CTIP2::SEGMENT_SIZE)
+            out.write(buff)
+          end
+        end
+      end
+
+      private
+=begin
+一時ファイルに書き込みます。
+
+tempFile:: 一時ファイル
+segment:: セグメント番号シーケンス
+bytes:: データ
+
+戻り値:: 書き込んだバイト数
+=end
+
+      def raf_write(tempFile, segment, bytes)
+        unless @segments
+          @segments = [segment]
+          segment += 1
+          @segLen = 0
+        end
+        written = 0
+        while (len = bytes.bytesize) > 0
+          if @segLen == CTIP2::SEGMENT_SIZE
+            @segments << segment
+            segment += 1
+            @segLen = 0
+          end
+          seg = @segments.last
+          wlen = [len, CTIP2::SEGMENT_SIZE - @segLen].min
+          wpos = seg * CTIP2::SEGMENT_SIZE + @segLen
+          tempFile.pos = wpos
+          data = bytes.slice!(0, wlen)
+          tempFile.write(data)
+          @segLen += wlen
+          written += wlen
+        end
+        return segment, written
+      end
+    end
+=begin rdoc
+Version::   $Id: StreamBuilder.rb 902 2013-04-23 05:07:04Z miyabe $
+
+ストリームに対して結果を構築するオブジェクトです。
+=end
+
+    class StreamBuilder
+=begin rdoc
+結果構築オブジェクトを作成します。
+
+out:: 出力先ストリーム
+&finish:: 結果を実際に出力する前に呼び出されるブロック。引数として結果のバイト数が渡されます
+
+例:
+    SingleResult.new(StreamBuilder.new($stdout) do |length|
+      print "Content-Length: #{length}\r\n\r\n"
+    end) do |opts|
+      print "Content-Type: #{opts['mime_type']}\r\n"
+    end
+=end
+      def initialize(out, &finish)
+        @tempFile = Tempfile.open(['cti', '.tmp'])
+        @tempFile.binmode
+        @out = out
+        @finish = finish
+        @frgs = []
+        @first = nil
+        @last = nil
+        @onMemory = 0
+        @length = 0
+        @segment = 0
+      end
+
+      def add_block
+        id = @frgs.size
+        frg = Fragment.new(id)
+        @frgs[id] = frg
+        unless @first
+          @first = frg
+        else
+          @last.nxt = frg
+          frg.prev = @last
+        end
+        @last = frg
+      end
+
+      def insert_block_before(anchor_id)
+        id = @frgs.size
+        anchor = @frgs[anchor_id]
+        frg = Fragment.new(id)
+        @frgs[id] = frg
+        frg.prev = anchor.prev
+        frg.nxt = anchor
+        anchor.prev.nxt = frg
+        anchor.prev = frg
+        @first = frg if @first.id == anchor.id
+      end
+
+      def write(id, data)
+        frg = @frgs[id]
+        @onMemory, @segment, len = frg.write(@tempFile, @onMemory, @segment, data)
+        @length += len
+      end
+
+      def close_block(id)
+      end
+
+      def serial_write(data)
+        @out.write(data)
+      end
+
+      def finish
+        begin
+          @finish.call(@length) if @finish
+          frg = @first
+          while frg
+            frg.flush(@tempFile, @out)
+            frg = frg.nxt
+          end
+        ensure
+          @tempFile.close
+        end
+      end
+
+      def dispose
+      end
+    end
+  end
+end

data/src/code/CTI/CTIP2/CTIP2.rb

@@ -0,0 +1,396 @@
+require File.expand_path('Utils', File.dirname(__FILE__))
+
+module CTI
+=begin rdoc
+Version::   $Id: CTIP2.rb 902 2013-04-23 05:07:04Z miyabe $
+
+通信プロトコルに関連する各操作です。
+
+このモジュールに所属するメソッドは、 IO に対するものです。
+=end
+  module CTIP2
+    REQ_PROPERTY = 0x01
+    REQ_START_MAIN = 0x02
+    REQ_SERVER_MAIN = 0x03
+    REQ_CLIENT_RESOURCE = 0x04
+    REQ_CONTINUOUS = 0x05
+    REQ_DATA = 0x11
+    REQ_START_RESOURCE = 0x21
+    REQ_MISSING_RESOURCE = 0x22
+    REQ_EOF = 0x31
+    REQ_ABORT = 0x32
+    REQ_JOIN = 0x33
+    REQ_RESET = 0x41
+    REQ_CLOSE = 0x42
+    REQ_SERVER_INFO = 0x51
+
+    RES_START_DATA = 0x01
+    RES_BLOCK_DATA = 0x11
+    RES_ADD_BLOCK = 0x12
+    RES_INSERT_BLOCK = 0x13
+    RES_MESSAGE = 0x14
+    RES_MAIN_LENGTH = 0x15
+    RES_MAIN_READ = 0x16
+    RES_DATA = 0x17
+    RES_CLOSE_BLOCK = 0x18
+    RES_RESOURCE_REQUEST = 0x21
+    RES_EOF = 0x31
+    RES_ABORT = 0x32
+    RES_NEXT = 0x33
+    
+=begin rdoc
+パケットの送信に使うバッファのサイズです。
+=end
+    CTI_BUFFER_SIZE = 1024
+
+=begin rdoc
+メモリ上のフラグメントの最大サイズです。
+
+フラグメントがこの大きさを超えるとディスクに書き込みます。
+=end
+    FRG_MEM_SIZE = 256
+
+=begin rdoc
+メモリ上に置かれるデータの最大サイズです。
+
+メモリ上のデータがこのサイズを超えると、
+FRG_MEM_SIZEとは無関係にディスクに書き込まれます。
+=end
+    ON_MEMORY = 1024 * 1024
+
+=begin rdoc
+一時ファイルのセグメントサイズです。
+=end
+    SEGMENT_SIZE = 8192
+
+=begin rdoc
+セッションを開始します。
+
+encoding:: 通信に用いるエンコーディング
+=end
+    def cti_connect(encoding)
+      self.write("CTIP/2.0 #{encoding}\n")
+    end
+
+=begin rdoc
+サーバー情報を要求します。
+
+uri:: URI
+=end
+
+    def req_server_info(uri)
+      payload = 1 + 2 + uri.bytesize
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_SERVER_INFO)
+      self.write_bytes(uri)
+      self.flush
+    end
+
+=begin rdoc
+サーバーからクライアントのリソースを要求するモードを切り替えます。
+
+mode:: 0=off, 1=on
+=end
+
+    def req_client_resource(mode)
+      payload = 2
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_CLIENT_RESOURCE)
+      self.write_byte(mode)
+      self.flush
+    end
+
+=begin rdoc
+複数の結果を結合するモードを切り替えます。
+
+mode:: 0=off, 1=on
+=end
+
+    def req_continuous(mode)
+      payload = 2
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_CONTINUOUS)
+      self.write_byte(mode)
+      self.flush
+    end
+
+=begin rdoc
+リソースの不存在を通知します。
+
+uri:: URI
+=end
+
+    def req_missing_resource(uri)
+      payload = 1 + 2 + uri.bytesize
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_MISSING_RESOURCE)
+      self.write_bytes(uri)
+      self.flush
+    end
+
+=begin rdoc
+状態のリセットを要求します。
+=end
+
+    def req_reset
+      payload = 1
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_RESET)
+      self.flush
+    end
+
+=begin rdoc
+変換処理の中断を要求します。
+
+mode::  0=生成済みのデータを出力して中断, 1=即時中断
+=end
+
+    def req_abort(mode)
+      payload = 2
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_ABORT)
+      self.write_byte(mode)
+      self.flush
+    end
+
+=begin rdoc
+変換結果を結合します。
+=end
+
+    def req_join
+      payload = 1
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_JOIN)
+      self.flush
+    end
+
+=begin rdoc
+終了を通知します。
+=end
+
+    def req_eof
+      payload = 1
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_EOF)
+      self.flush
+    end
+
+=begin rdoc
+プロパティを送ります。
+
+name:: 名前
+value:: 値
+=end
+
+    def req_property(name, value)
+      payload = name.bytesize + value.bytesize + 5
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_PROPERTY)
+      self.write_bytes(name)
+      self.write_bytes(value)
+      self.flush
+    end
+
+=begin rdoc
+サーバー側データの変換を要求します。
+
+uri:: URI
+=end
+
+    def req_server_main(uri)
+      payload = uri.bytesize + 3
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_SERVER_MAIN)
+      self.write_bytes(uri)
+      self.flush
+    end
+
+=begin rdoc
+リソースの開始を通知します。
+
+uri:: URI
+mime_type:: MIME型
+encoding:: エンコーディング
+length:: 長さ
+=end
+
+    def req_resource(uri, mime_type = 'text/css', encoding = '', length = -1)
+      payload = uri.bytesize + mime_type.bytesize + encoding.bytesize + 7 + 8
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_START_RESOURCE)
+      self.write_bytes(uri)
+      self.write_bytes(mime_type)
+      self.write_bytes(encoding)
+      self.write_long(length)
+      self.flush
+    end
+
+=begin rdoc
+本体の開始を通知します。
+
+uri:: URI
+mime_type:: MIME型
+encoding:: エンコーディング
+length:: 長さ
+=end
+
+    def req_start_main(uri, mime_type = 'text/html', encoding = '', length = -1)
+      payload = uri.bytesize + mime_type.bytesize + encoding.bytesize + 7 + 8
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_START_MAIN)
+      self.write_bytes(uri)
+      self.write_bytes(mime_type)
+      self.write_bytes(encoding)
+      self.write_long(length)
+      self.flush
+    end
+
+=begin rdoc
+データを送ります。
+
+b:: データ
+=end
+
+    def req_write(b)
+      payload = b.bytesize + 1
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_DATA)
+      self.write(b)
+      self.flush
+    end
+
+=begin rdoc
+通信を終了します。
+=end
+
+    def req_close
+      payload = 1
+      self.write_int(payload)
+      self.write_byte(CTIP2::REQ_CLOSE)
+      self.flush
+    end
+
+=begin rdoc
+次のレスポンスを取得します。
+
+結果ハッシュには次のデータが含まれます。
+
+- 'type' レスポンスタイプ
+- 'anchorId' 挿入する場所の直後のフラグメントID
+- 'level' エラーレベル
+- 'error' エラーメッセージ
+- 'id' 断片ID
+- 'progress' 処理済バイト数
+- 'bytes' データのバイト列
+
+戻り値:: レスポンス
+=end
+
+    def res_next
+      payload = self.read_int
+      type = self.read_byte
+
+      case type
+      when CTIP2::RES_ADD_BLOCK, CTIP2::RES_EOF, CTIP2::RES_NEXT
+        return {
+          'type' => type,
+        }
+
+      when CTIP2::RES_START_DATA
+        uri = self.read_bytes
+        mime_type = self.read_bytes
+        encoding = self.read_bytes
+        length = self.read_long
+        return {
+          'type' => type,
+          'uri' => uri,
+          'mime_type' => mime_type,
+          'encoding' => encoding,
+          'length' => length
+        }
+
+      when CTIP2::RES_MAIN_LENGTH, CTIP2::RES_MAIN_READ
+        length = self.read_long
+        return {
+          'type' => type,
+          'length' => length
+        }
+
+      when CTIP2::RES_INSERT_BLOCK, CTIP2::RES_CLOSE_BLOCK
+        block_id = self.read_int
+        return {
+          'type' => type,
+          'block_id' => block_id
+        }
+
+      when CTIP2::RES_MESSAGE
+        code = self.read_short
+        payload -= 1 + 2
+        message = self.read_bytes
+        payload -= 2 + message.bytesize
+        args = []
+        while payload > 0
+          arg = self.read_bytes
+          payload -= 2 + arg.bytesize
+          args << arg
+        end
+        return {
+          'type' => type,
+          'code' => code,
+          'message' => message,
+          'args' => args
+        }
+
+      when CTIP2::RES_BLOCK_DATA
+        length = payload - 5
+        block_id = self.read_int
+        bytes = self.read(length)
+        return {
+          'type' => type,
+          'block_id' => block_id,
+          'bytes' => bytes,
+          'length' => length
+        }
+
+      when CTIP2::RES_DATA
+        length = payload - 1
+        bytes = self.read(length)
+        return {
+          'type' => type,
+          'bytes' => bytes,
+          'length' => length
+        }
+
+      when CTIP2::RES_RESOURCE_REQUEST
+        uri = self.read_bytes
+        return {
+          'type' => type,
+          'uri' => uri
+        }
+
+      when CTIP2::RES_ABORT
+        mode = self.read_byte
+        code = self.read_short
+        payload -= 1 + 1 + 2
+        message = self.read_bytes
+        payload -= 2 + message.bytesize
+        args = []
+        while payload > 0
+          arg = self.read_bytes
+          payload -= 2 + arg.bytesize
+          args << arg
+        end
+        return {
+          'type' => type,
+          'mode' => mode,
+          'code' => code,
+          'message' => message,
+          'args' => args
+        }
+
+      else
+        raise "Bad response type:#{type}"
+      end
+    end
+  end
+end