connectator 0.0.1 → 0.0.2

data/lib/connectator/base/connection.rb

@@ -0,0 +1,75 @@
+require 'ostruct'
+
+module Connectator
+  module Base
+    class Connection
+      attr_reader :connection_error
+
+      def initialize(opts = {})
+        raise "Connection Options are required" if opts.empty?
+        connection_params.server   = opts[:server]
+        connection_params.instance = opts[:instance]
+        connection_params.port     = opts[:port]
+        connection_params.username = opts[:username]
+        connection_params.password = opts[:password]
+        return self
+      end
+
+      def connection_params
+        @connection_params ||= OpenStruct.new
+      end
+
+      def dbi
+        @dbi ||= open
+      end
+      
+      def close
+        dbi.disconnect
+      end
+
+      def valid?
+        ping? && valid_dbi?
+      end
+
+      def ping?
+        if Pinger.pong?(connection_params.server, 3)
+          true
+        else
+          @connection_error = "Could not ping: #{connection_params.server}"
+          false
+        end
+      end
+
+      def valid_dbi?
+        dbi
+        true
+      rescue DBI::DatabaseError => e
+        @connection_error = e.message
+        false
+      end
+
+      def method_missing(method, *args, &blk)
+        puts method
+        dbi.send(method, *args, &blk)
+      end
+      
+      def connection_string
+        raise 'Abstract Method'
+      end
+
+      private 
+      
+      def open
+        DBI.connect(connection_string)
+      end
+
+      def connection_params_list
+        connection_params_hash.map { |k,v| "#{k}=#{v}"}.join(';')
+      end
+      
+      def connection_params_hash
+        raise 'Abstract Method'
+      end
+    end
+  end
+end

data/lib/connectator/db2/connection.rb

@@ -0,0 +1,31 @@
+module Connectator
+  module DB2
+    class Connection < Base::Connection
+      
+      def initialize(opts = {})
+        connection_params.database = opts[:database]
+        connection_params.driver   = 'DB2' 
+        connection_params.protocol = 'TCPIP'
+        super(opts)
+      end
+      
+      def connection_string
+        "DBI:ODBC:#{connection_params_list}"
+      end
+    
+      private
+
+      def connection_params_hash
+        {
+         "DRIVER"      => connection_params.driver,
+         "PROTOCOL"    => connection_params.protocol,
+         "HOSTNAME"    => connection_params.server,
+         "Port"        => connection_params.port,
+         "DATABASE"    => connection_params.database,
+         "UID"         => connection_params.username,
+         "PWD"         => connection_params.password
+        }
+      end
+    end
+  end
+end

data/lib/connectator/factory.rb

@@ -0,0 +1,40 @@
+module Connectator
+  class Factory
+
+    # connectator_params object must respond to:
+    # * kind (Oracle, Sql, Sybase, DB2)
+    # * server
+    # * instance
+    # * port
+    # * username
+    # * password
+    #
+    def self.build(connectator_params)
+      return self.new(connectator_params).connection
+    end
+
+    attr_reader :connectator_params
+
+    def initialize(connectator_params)
+      @connectator_params = connectator_params
+    end
+
+    def connection(additional_params = {})
+      connection_class.new(extract_connectator_params.merge(additional_params))
+    end
+
+    def connection_class
+      "Connectator::#{connectator_params.kind}::Connection".constantize
+    end
+
+    def extract_connectator_params
+      {
+       :server   => connectator_params.server,
+       :instance => connectator_params.instance,
+       :port     => connectator_params.port,
+       :username => connectator_params.username,
+       :password => connectator_params.password
+      }
+    end
+  end
+end

data/lib/connectator/oracle/connection.rb

@@ -0,0 +1,20 @@
+module Connectator
+  module Oracle
+    class Connection < Base::Connection
+      
+      def connection_string
+        "DBI:OCI8://#{connection_params.server}:#{connection_params.port}/#{connection_params.instance}"
+      end
+
+      private
+
+      # This is overrides the Base open method, because username and password
+      # are passed in through the DBI OCI8 driver
+      def open
+        DBI.connect(connection_string,
+                    connection_params.username,
+                    connection_params.password)
+      end
+    end
+  end
+end

data/lib/connectator/sql/connection/server_instance_string.rb

@@ -0,0 +1,30 @@
+module Connectator
+  module Sql
+    class Connection < Base::Connection
+      class ServerInstanceString
+        def self.build(server, instance)
+          new(server, instance).server_string
+        end
+
+        def initialize(server, instance)
+          @server   = server
+          @instance = instance
+        end        
+
+        def server_string
+          "#{@server}#{server_instance}"
+        end
+        
+        private
+
+        def server_instance
+          "\\#{instance_name}" unless instance_name.to_s.strip.empty?
+        end
+
+        def instance_name
+          @instance =~ /\w+\\([\w\$]+)$/; $1
+        end
+      end        
+    end
+  end
+end

data/lib/connectator/sql/connection.rb

@@ -0,0 +1,35 @@
+module Connectator
+  module Sql
+    class Connection < Base::Connection
+    
+      def initialize(opts = {})
+        connection_params.tds_version = '8.0'
+        connection_params.database    = 'master' 
+        connection_params.driver      = 'FreeTDS' 
+        super(opts)
+      end
+      
+      def connection_string
+        "DBI:ODBC:#{connection_params_list}"
+      end
+
+      private
+
+      def server_instance_string
+        ServerInstanceString.build(connection_params.server, connection_params.instance)
+      end
+
+      def connection_params_hash
+        {
+         "DRIVER"      => connection_params.driver,
+         "TDS_Version" => connection_params.tds_version,
+         "SERVER"      => server_instance_string,
+         "Port"        => connection_params.port,
+         "DATABASE"    => connection_params.database,
+         "UID"         => connection_params.username,
+         "PWD"         => connection_params.password
+        }
+      end
+    end
+  end
+end

data/lib/connectator/sybase/connection.rb

@@ -0,0 +1,31 @@
+module Connectator
+  module Sybase 
+    class Connection < Base::Connection
+
+      def initialize(opts = {})
+        connection_params.tds_version = '5.0'
+        connection_params.database    = 'master'
+        connection_params.driver      = 'FreeTDS' 
+        super(opts)
+      end
+      
+      def connection_string
+        "DBI:ODBC:#{connection_params_list}"
+      end
+
+      private
+     
+      def connection_params_hash
+        {
+         "DRIVER"      => connection_params.driver,
+         "TDS_Version" => connection_params.tds_version,
+         "SERVER"      => connection_params.server,
+         "Port"        => connection_params.port,
+         "DATABASE"    => connection_params.database,
+         "UID"         => connection_params.username,
+         "PWD"         => connection_params.password
+        }
+      end
+    end
+  end
+end

metadata

@@ -1,78 +1,105 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: connectator
-version: !ruby/object:Gem::Version
-  version: 0.0.1
+version: !ruby/object:Gem::Version 
+  hash: 27
   prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
 platform: ruby
-authors:
+authors: 
 - Benjamin Wagaman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-14 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
+
+date: 2013-02-14 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
   name: dbi
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 0.4.5
-  type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 0
+        - 4
+        - 5
         version: 0.4.5
-- !ruby/object:Gem::Dependency
-  name: dbd-odbc
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 0.2.5
   type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: dbd-odbc
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 29
+        segments: 
+        - 0
+        - 2
+        - 5
         version: 0.2.5
-description: This gem lets you make connections to multiple kinds of DBMS systems
-  through DBI
+  type: :runtime
+  version_requirements: *id002
+description: This gem lets you make connections to multiple kinds of DBMS systems through DBI
 email: ben@wagaman.org
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
 - lib/connectator.rb
+- lib/connectator/factory.rb
+- lib/connectator/oracle/connection.rb
+- lib/connectator/base/connection.rb
+- lib/connectator/db2/connection.rb
+- lib/connectator/sybase/connection.rb
+- lib/connectator/sql/connection.rb
+- lib/connectator/sql/connection/server_instance_string.rb
+has_rdoc: true
 homepage: http://rubygems.org/gems/connecator
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
 requirements: []
+
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 1.5.3
 signing_key: 
 specification_version: 3
 summary: Multi DBMS connection abstraction
 test_files: []
+