penwellr-RubyTSQL 1.0.19 → 1.0.21

data/lib/tsql.rb

@@ -0,0 +1,14 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+module RubyTSQL; end
+
+require 'tsql/connection_string'
+require 'tsql/tds_packet'
+require 'tsql/tds_token'
+require 'tsql/tds_core'
+require 'tsql/connection'
+require 'tsql/parameter'
+require 'tsql/parameter_collection'
+require 'tsql/command'
+require 'tsql/data_reader'

data/lib/tsql/command.rb

@@ -0,0 +1,21 @@
+class RubyTSQL::Command
+  attr_accessor :parameters
+  
+  def initialize(connection)
+    @connection = connection
+    parameters = RubyTSQL::ParameterCollection.new
+  end
+  
+  def execute_non_query
+  end
+  
+  def execute_reader
+    
+  end
+  
+  def execute_scaler
+  end
+  
+  def execute_tuple
+  end
+end

data/lib/tsql/connection.rb

@@ -0,0 +1,8 @@
+class RubyTSQL::Connection
+  
+  @data_reader = nil
+  
+  def create_command
+    RubyTSQL::Command.new(self)
+  end
+end

data/lib/tsql/connection_string.rb

@@ -0,0 +1,2 @@
+class RubyTSQL::ConnectionString
+end

data/lib/tsql/data_reader.rb

@@ -0,0 +1,3 @@
+class RubyTSQL::DataReader
+  
+end

data/lib/tsql/parameter.rb

@@ -0,0 +1,2 @@
+class RubyTSQL::Parameter
+end

data/lib/tsql/parameter_collection.rb

@@ -0,0 +1,4 @@
+class RubyTSQL::ParameterCollection
+  def add_with_value(parameter_name, value, type = nil)
+  end
+end

data/lib/tsql/tds_core.rb

@@ -0,0 +1,21 @@
+
+class RubyTSQL::TdsCore
+  PACKET_VERSION = [9, 0, 0, 0, 0, 0]
+  ENCRYPTION_OFF = 0
+  ENCRYPTION_ON = 1
+  ENCRYPTION_NOT_SUPPORTED = 2
+  ENCRYPTION_REQUIRED = 3
+  
+  def create_prelogin_packet
+    packet = RubyTSQL::TdsPacket.new(RubyTSQL::TdsPacket::PACKET_TYPE_PRELOGIN)
+    packet.end_of_message = true
+    
+    packet.add_token RubyTSQL::TdsToken::TOKEN_PRELOGIN_VERSION, PACKET_VERSION
+    packet.add_token RubyTSQL::TdsToken::TOKEN_PRELOGIN_ENCRYPTION, [ENCRYPTION_NOT_SUPPORTED]
+    packet.add_token RubyTSQL::TdsToken::TOKEN_PRELOGIN_INSTOPT, 0
+    packet.add_token RubyTSQL::TdsToken::TOKEN_PRELOGIN_THREADID, [0, 0, 0, 0]
+    packet.add_token RubyTSQL::TdsToken::TOKEN_PRELOGIN_MARS, false
+    
+    packet
+  end
+end

data/lib/tsql/tds_packet.rb

@@ -0,0 +1,55 @@
+class RubyTSQL::TdsPacket
+  PACKET_TYPE_BATCH = 1
+  PACKET_TYPE_RESPONSE = 4
+  PACKET_TYPE_ATTENTION = 6
+  PACKET_TYPE_LOGIN = 16
+  PACKET_TYPE_SSPI = 17
+  PACKET_TYPE_PRELOGIN = 18
+  
+  attr_accessor :end_of_message
+  
+  def initialize(packet_type)
+    @packet_type = packet_type
+    @tokens = []
+  end
+  
+  def add_token(token_type, value, length = nil)
+    @tokens << RubyTSQL::TdsToken.new(token_type, value, length)
+    @data = ''
+  end
+  
+  def to_s
+    packet_header = [@packet_type, get_status, calculate_length].pack("CCvxxxx")
+    
+    if not @tokens.empty? then
+      token_header = ''
+      data = ''
+      position = 8
+      @tokens.each do |token|
+        position += token.header_size
+      end
+      
+      @tokens.each do |token|
+        single_token_header = token.token_header position
+        position += token.length
+        token_header << single_token_header
+        data << token.data
+      end
+      
+      token_header << 0xFF
+    else
+      token_header = ''
+    end
+    
+    return packet_header + token_header + (data || @data || '')
+  end
+  
+  private
+  def get_status
+    @end_of_message ? 1 : 0
+  end
+  
+  def calculate_length
+    8
+  end
+end

data/lib/tsql/tds_token.rb

@@ -0,0 +1,78 @@
+class RubyTSQL::TdsToken
+  TOKEN_PRELOGIN_VERSION = 0
+  TOKEN_PRELOGIN_ENCRYPTION = 1
+  TOKEN_PRELOGIN_INSTOPT = 2
+  TOKEN_PRELOGIN_THREADID = 3
+  TOKEN_PRELOGIN_MARS = 4
+  
+  TOKEN_TERMINATOR = 0xFF
+  
+  attr_accessor :type
+  attr_accessor :length
+  attr_accessor :data
+  
+  def initialize(token_type, value = [], length = nil)
+    @type = token_type
+    if value.is_a? Array then
+      @length = value.length
+      value = value.pack('C' * @length)
+    end
+    if value.is_a? Integer then
+      if not length then @length = 1 else @length = length end
+
+      case @length
+      when 1
+        value = [value].pack('C')
+      when 2
+        value = [value].pack('n')
+      when 4
+        value = [value].pack('I')
+      end
+    end
+    
+    if (value.is_a? TrueClass) then
+      @length = 1
+      value = [1].pack('C')
+    end
+    
+    if (value.is_a? FalseClass) then
+      @length = 1
+      value = [0].pack('C')
+    end
+    
+    @length ||= 0
+    @data = value
+  end
+  
+  def token_header(data_position)
+    [@type, data_position, @length].pack('Cnn')
+  end
+  
+  def header_size
+    token_header(0).length
+  end
+  
+  private
+  def token_type_value
+    case self.type
+    when :zero_length
+      return 0b00010000
+    when :fixed_length
+      length = self.length
+      result_flag = 0b00110000
+      case length
+      when 2
+        result_flag &= 0b00000100
+      when 4
+        result_flag &= 0b00001000
+      when 8
+        result_flag &= 0b00001100
+      end
+      return result_flag
+    when :variable_length
+      
+    when :variable_count
+      return 0b00000000
+    end
+  end
+end

data/spec/lib/connection_spec.rb

@@ -0,0 +1,8 @@
+require File.join(File.dirname(__FILE__), '../spec_helper.rb')
+
+describe RubyTSQL::Connection do
+  it "should be able to be created"
+  it "should connect to the server"
+  it "should close connection with the server"
+  it "should create a command"
+end

data/spec/lib/connection_string_spec.rb

@@ -0,0 +1,15 @@
+require File.join(File.dirname(__FILE__), '../spec_helper.rb')
+
+# Time to add your specs!
+# http://rspec.info/
+describe RubyTSQL::ConnectionString do
+  it "should be able to be created"
+  it "should correctly parse the server name of (local) with no instance"
+  it "should correctly parse the server name of (local) with an instance" 
+  it "should correctly parse the instance name of MSSQLSERVER with no instance"
+  it "should correctly parse the instance name equal to default when it is not specified"
+  it "should correctly parse the instance name with an instance"
+  it "should should not be connected when created"
+  it "should connect without raising an error"
+  it "should be connected after connecting"
+end

data/spec/lib/parameter_spec.rb

@@ -0,0 +1,14 @@
+require File.join(File.dirname(__FILE__), '../spec_helper.rb')
+
+describe RubyTSQL::Parameter do
+  it "should be able to be created with a type and no value"
+  it "should be able to be created with a value and no type"
+  it "should not be able to be created without a value or a type"
+  it "should be able to be assigned after being created without a value"
+  it "should be able to be assigned after being created with a value"
+  it "should ensure that when it is translated to sql that the parameter has an 'at' sign"
+  it "should infer the type of a textual input"
+  it "should infer the type of an integer input"
+  it "should infer the type of a boolean input"
+  it "should infer the type of a decimal input"
+end

data/spec/lib/tds_core_spec.rb

@@ -0,0 +1,32 @@
+require File.join(File.dirname(__FILE__), '../spec_helper.rb')
+
+describe RubyTSQL::TdsCore do
+  
+  def print_binary(input)
+    input = input.to_s unless input.kind_of? String
+    output = ''
+    
+    input.each_byte do |char|
+      output += char.to_i.to_s + ' '
+    end
+    
+    p output
+  end
+  
+  before(:all) do
+    @core = RubyTSQL::TdsCore.new
+  end
+  
+  it "should generate a pre-login packet" do
+    @core.create_prelogin_packet.should_not be_nil
+  end
+  
+  it "should have created a pre-login packet with a length of 47" do
+    packet = @core.create_prelogin_packet
+    packet.to_s.length.should == 47
+  end
+  
+  it "should parse a pre-login response"
+  it "should generate a login packet"
+  it "should parse a login response"
+end

data/spec/lib/tds_packet_spec.rb

@@ -0,0 +1,63 @@
+require File.join(File.dirname(__FILE__), '../spec_helper.rb')
+
+describe RubyTSQL::TdsPacket do
+  it "should be able to be created given a packet type" do
+    packet = RubyTSQL::TdsPacket.new(RubyTSQL::TdsPacket::PACKET_TYPE_PRELOGIN)
+  end
+  
+  it "should be able to be set as end of message" do
+    packet = RubyTSQL::TdsPacket.new(RubyTSQL::TdsPacket::PACKET_TYPE_PRELOGIN)
+    packet.end_of_message = true
+    packet.end_of_message.should be_true
+  end
+  
+  it "should produce an eight byte header when no data is attached" do
+    packet = RubyTSQL::TdsPacket.new(RubyTSQL::TdsPacket::PACKET_TYPE_PRELOGIN)
+    packet.end_of_message = true
+    
+    packet.to_s.length.should == 8
+  end
+  
+  it "should have the correct packet type in the first field" do
+    packet = RubyTSQL::TdsPacket.new(RubyTSQL::TdsPacket::PACKET_TYPE_PRELOGIN)
+    packet.end_of_message = true
+    
+    packet.to_s[0].should == RubyTSQL::TdsPacket::PACKET_TYPE_PRELOGIN
+  end
+  
+  it "should have a length of 8 in the header for an empty packet" do
+    packet = RubyTSQL::TdsPacket.new(RubyTSQL::TdsPacket::PACKET_TYPE_PRELOGIN)
+    packet.end_of_message = true
+    
+    result_value = packet.to_s
+    result_value.unpack('@2v')[0].should == 8
+  end
+  
+  it "should have zeros in the remaining fields of the header" do
+    packet = RubyTSQL::TdsPacket.new(RubyTSQL::TdsPacket::PACKET_TYPE_PRELOGIN)
+    packet.end_of_message = true
+    
+    result_value = packet.to_s
+    (4..7).each do |field|
+      result_value[field].should == 0
+    end
+  end
+  
+  it "should have the end of message bit set when end of message is true" do
+    packet = RubyTSQL::TdsPacket.new(RubyTSQL::TdsPacket::PACKET_TYPE_PRELOGIN)
+    packet.end_of_message = true
+    
+    packet.to_s[1].should satisfy {|n| (n & 1) != 0}
+  end
+  
+  it "should not have the end of message bit set when end of message is false" do
+    packet = RubyTSQL::TdsPacket.new(RubyTSQL::TdsPacket::PACKET_TYPE_PRELOGIN)
+    packet.end_of_message = false
+    
+    packet.to_s[1].should_not satisfy {|n| (n & 1) != 0}
+  end
+  
+  it "should error when there is no packet type given" do
+    lambda { packet = RubyTSQL::TdsPacket.new }.should raise_error
+  end
+end

data/spec/lib/tds_token_spec.rb

@@ -0,0 +1,68 @@
+require File.join(File.dirname(__FILE__), '../spec_helper.rb')
+
+describe RubyTSQL::TdsToken do
+  
+  it "should be able to be created" do
+    token = RubyTSQL::TdsToken.new(0)
+  end
+  
+  it "should return a proper header value" do
+    token = RubyTSQL::TdsToken.new(10)
+    header = token.token_header(8)
+    header.unpack('U*').should == [10, 0, 8, 0, 0]
+  end
+  
+  it "should return a proper header value when there is a non-zero length" do
+    token = RubyTSQL::TdsToken.new(10, [0, 1, 0])
+    header = token.token_header(8)
+    header.length.should == 5
+    header.unpack('U*').should == [10, 0, 8, 0, 3]
+  end
+  
+  it "should parse boolean true values" do
+    token = RubyTSQL::TdsToken.new(10, true)
+    header = token.token_header(8)
+    header.length.should == 5
+    header.unpack('U*').should == [10, 0, 8, 0, 1]
+    token.data.unpack('U*').should == [1]
+  end
+  
+  it "should parse boolean false values" do
+    token = RubyTSQL::TdsToken.new(10, false)
+    header = token.token_header(8)
+    header.length.should == 5
+    header.unpack('U*').should == [10, 0, 8, 0, 1]
+    token.data.unpack('U*').should == [0]
+  end
+    
+  it "should parse an arbratary byte array" do
+    token = RubyTSQL::TdsToken.new(10, [1, 2, 3, 4, 5])
+    header = token.token_header(8)
+    header.length.should == 5
+    header.unpack('U*').should == [10, 0, 8, 0, 5]
+    token.data.unpack('U*').should == [1, 2, 3, 4, 5]
+  end
+  
+  it "should parse a numeric defaulting to byte" do
+    token = RubyTSQL::TdsToken.new(10, 80)
+    header = token.token_header(8)
+    header.length.should == 5
+    header.unpack('U*').should == [10, 0, 8, 0, 1]
+    token.data.unpack('U*').should == [80]
+  end
+  
+  it "should parse a numeric with a specificed length" do
+    token = RubyTSQL::TdsToken.new(10, 80, 2)
+    header = token.token_header(8)
+    header.length.should == 5
+    header.unpack('U*').should == [10, 0, 8, 0, 2]
+    token.data.unpack('U*').should == [00, 80]
+  end
+  
+  it "should calculate token length" do
+    token = RubyTSQL::TdsToken.new(10, true)
+    header = token.token_header(8)
+    header.length.should == 5
+  end
+  
+end

data/spec/lib/tsql_spec.rb

@@ -0,0 +1,9 @@
+require File.join(File.dirname(__FILE__), '../spec_helper.rb')
+
+# Time to add your specs!
+# http://rspec.info/
+describe "TSQL" do
+  
+  it "should work"
+  
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: penwellr-RubyTSQL
 version: !ruby/object:Gem::Version 
-  version: 1.0.19
+  version: 1.0.21
 platform: ruby
 authors: 
 - Richard Penwell
@@ -21,8 +21,7 @@ executables: []
 extensions: []
 
 extra_rdoc_files: 
-- History.txt
-- Manifest.txt
+- README.rdoc
 files: 
 - History.txt
 - Manifest.txt
@@ -34,6 +33,23 @@ files:
 - tasks/rspec.rake
 - spec/spec.opts
 - spec/spec_helper.rb
+- lib/tsql/command.rb
+- lib/tsql/connection.rb
+- lib/tsql/connection_string.rb
+- lib/tsql/data_reader.rb
+- lib/tsql/parameter.rb
+- lib/tsql/parameter_collection.rb
+- lib/tsql/tds_core.rb
+- lib/tsql/tds_packet.rb
+- lib/tsql/tds_token.rb
+- lib/tsql.rb
+- spec/lib/connection_spec.rb
+- spec/lib/connection_string_spec.rb
+- spec/lib/parameter_spec.rb
+- spec/lib/tds_core_spec.rb
+- spec/lib/tds_packet_spec.rb
+- spec/lib/tds_token_spec.rb
+- spec/lib/tsql_spec.rb
 has_rdoc: false
 homepage: http://github.com/penwellr/rb-tsql
 licenses: