oci8_simple 0.9.2 → 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d32480f3660c4a346625635ba296b9a907e6e841
+  data.tar.gz: de7df0bae58756a6bedf51045baca46fc4c11d3c
+SHA512:
+  metadata.gz: 6adb92f1399a73cb8abaacb05e1f41976cc99cd45d3584642a89a9298cca32f5814741bd5fa873b24eb5d0629d072b4ca8dda6869976c620c865c772b9dfa8a7
+  data.tar.gz: 998f2e0a74141370af21032ff3c5902a5e7442808b91d81f711b2cdcf6bf2e3a6b7da5a88c07b198dce5ee641697c67247a8e3254e60d89b37b6a46fd6f2b5bf

data/Gemfile

@@ -4,6 +4,5 @@ gemspec
 
 group :development do
   gem "shoulda", ">= 0"
-  gem "mocha", ">= 0"
   gem "pry"
 end

data/Gemfile.lock

@@ -1,43 +1,43 @@
 PATH
   remote: .
   specs:
-    oci8_simple (0.9.2)
+    oci8_simple (1.0.0)
       ruby-oci8 (~> 2.1.2)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (3.2.12)
-      i18n (~> 0.6)
-      multi_json (~> 1.0)
-    bourne (1.1.2)
-      mocha (= 0.10.5)
-    coderay (1.0.9)
-    i18n (0.6.1)
-    metaclass (0.0.1)
-    method_source (0.8.1)
-    mocha (0.10.5)
-      metaclass (~> 0.0.1)
-    multi_json (1.6.1)
-    pry (0.9.12)
-      coderay (~> 1.0.5)
-      method_source (~> 0.8)
+    activesupport (4.2.1)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    coderay (1.1.0)
+    i18n (0.7.0)
+    json (1.8.2)
+    method_source (0.8.2)
+    minitest (5.6.1)
+    pry (0.10.1)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
       slop (~> 3.4)
-    ruby-oci8 (2.1.4)
-    shoulda (3.3.2)
-      shoulda-context (~> 1.0.1)
-      shoulda-matchers (~> 1.4.1)
-    shoulda-context (1.0.2)
-    shoulda-matchers (1.4.2)
+    ruby-oci8 (2.1.8)
+    shoulda (3.5.0)
+      shoulda-context (~> 1.0, >= 1.0.1)
+      shoulda-matchers (>= 1.4.1, < 3.0)
+    shoulda-context (1.2.1)
+    shoulda-matchers (2.8.0)
       activesupport (>= 3.0.0)
-      bourne (~> 1.1.2)
-    slop (3.4.3)
+    slop (3.6.0)
+    thread_safe (0.3.5)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  mocha
   oci8_simple!
   pry
   shoulda

data/README.md

@@ -0,0 +1,167 @@
+# oci8_simple
+This gem is a thin wrapper around the ruby-oci8 gem.  The client is intended
+to be used by simple  scripts to aid automation.  The code is intentionally
+light-weight and featureless, with very little startup time.  It is not meant
+to be a Ruby ORM for Oracle - if you want that, look at the
+OracleEnhancedAdapter.
+
+This gem installs a few command-line scripts:
+*   `oci8_simple`
+    *   a command to run arbitrary SQL
+
+*   `describe   `
+    *   a command to describe a table
+
+*   `show       `
+    *   a command to list things in the database (tables, views, etc.)
+
+
+You can also use oci8_simple in your Ruby scripts by creating an instance of
+`Oci8Simple::Client`  (see more below).
+
+## Prerequisites
+*   Oracle Instant Client
+    (http://www.oracle.com/technetwork/database/features/instant-client/index-
+    097480.html)
+*   ruby-oci8
+
+
+## Installation
+    gem install oci8_simple
+
+## Configuration
+Oci8Simple will look in three places for your database configuration, in the
+following order:
+*   Dir.pwd + database.yml
+*   Dir.pwd + config/database.yml
+*   ~/.oci8_simple/database.yml
+
+The database.yml format is compatible with the Rails format.
+
+    development:
+      database: oracle.hostname:1521/sid
+      username: foo_dev
+      password: OMG333
+    test:
+      database: oracle.hostname:1521/sid
+      username: foo_test
+      password: OMG333
+
+## Logging
+All logging is done to `~/.oci8_simple/oci8_simple.log`.
+
+## Command-Line Examples
+### oci8_simple
+This script allows you to run single statements against an  arbitrary Oracle
+schema via the command line.
+
+Run a query against development schema
+
+    oci8_simple "select id, name from flavors"
+
+Run a query against a different schema
+ 
+    oci8_simple "select id, name from flavors" -e int
+
+Help
+
+    oci8_simple --help
+
+### describe
+This script shows a description of a table, including the column names
+(sorted),  the type and size for each column, the nullable status of the
+column, and the default value, if any.
+
+Show column information for a table named "holidays"
+
+    describe holidays
+
+Help
+
+    describe --help
+
+### show
+This command can list the following items in the database:  functions,
+packages, procedures, sequences, synonyms, tables, types, and views.
+
+Show a list of all tables in the database
+
+    show tables
+
+Show a list of all views in the database
+
+    show views
+
+Show the DDL for a particular view
+
+    show view users_view
+
+Help
+
+    show --help
+
+## Code Examples
+Initialize a client against the development schema
+    
+    require 'rubygems'
+    require 'oci8_simple'
+    client = Oci8Simple::Client.new
+
+Run a simple select query against development schema
+    
+    client.run('select id, name from foos')                
+    #=> [[2, "lol"], [3, "hey"], ...]
+    client.run('select id, name from foos', :hash => true) 
+    #=> [{:id => 2, :name => "lol"}, {:id => 3, :name=>"hey"}, ...])
+
+Update something
+
+    client.run <<-SQL
+      UPDATE foos SET bar='baz' WHERE id=1233
+    SQL
+
+Run some DDL
+    
+    client.run <<-SQL
+      CREATE TABLE foos (
+         ID NUMBER(38) NOT NULL
+      )
+    SQL
+
+Run some PL/SQL
+    
+    client.run <<-SQL
+      DECLARE
+        a NUMBER;
+        b NUMBER;
+      BEGIN
+        SELECT e,f INTO a,b FROM T1 WHERE e>1;
+        INSERT INTO T1 VALUES(b,a);
+      END;
+    SQL
+
+Run a query against stage schema
+    
+    Oci8Simple::Client.new("stage").run('select id, name from foos') 
+    #=> [[2, "lol"], [3, "hey"], ...]
+
+
+## Contributing to oci8_simple
+
+*   Check out the latest master to make sure the feature hasn't been
+    implemented or the bug hasn't been fixed yet
+*   Check out the issue tracker to make sure someone already hasn't requested
+    it and/or contributed it
+*   Fork the project
+*   Start a feature/bugfix branch
+*   Commit and push until you are happy with your contribution
+*   Make sure to add tests for it. This is important so I don't break it in a
+    future version unintentionally.
+*   Please try not to mess with the Rakefile, version, or history. If you want
+    to have your own version, or is otherwise necessary, that is fine, but
+    please isolate to its own commit so I can cherry-pick around it.
+
+
+## Copyright
+
+Copyright (c) 2015 Billy Reisinger. See LICENSE.txt for further details.

data/Rakefile

@@ -36,9 +36,7 @@ end
 desc "Release the gem to rubygems.org"
 task :release => :build do
   version = File.read(File.expand_path("../VERSION", __FILE__)).strip
-  `git tag -a v#{version} -m "tagging #{version}"`
-  `git push --tags`
   ourgem = "oci8_simple-#{version}.gem"
-  `gem push #{ourgem}`
+  system "gem push #{ourgem}"
 end
 

data/VERSION

@@ -1 +1 @@
-0.9.2
+1.0.0

data/lib/oci8_simple/cli.rb

@@ -31,7 +31,7 @@ module Oci8Simple
     end
     
     def self.usage
-      "Usage: #{$0} \"SQL\" [ENV]"
+      "Usage: #{$0} [-e ENV] \"SQL\""
     end
     
     def self.run_from_argv
@@ -39,9 +39,9 @@ module Oci8Simple
       if(ARGV[0].nil?)
         puts o
       else
-        puts self.new(ARGV[1]).run(ARGV[0], @options)
+        puts self.new(@options[:environment]).run(ARGV[0], @options)
       end
     end
     
   end
-end
+end

data/lib/oci8_simple/client.rb

@@ -36,19 +36,23 @@ module Oci8Simple
   #     SQL
   class Client
     USER_DIR = File.join(ENV["HOME"], ".oci8_simple")
-    LOG_FILE = File.join(USER_DIR, "oci8_simple.log")
-  
-    attr_accessor :log_file, :env
+    LOG_FILE_PATH = File.join(USER_DIR, "oci8_simple.log")
   
+    attr_accessor :log_file, :log_file_path, :env
+    
+    def log_file_path
+      @log_file_path || LOG_FILE_PATH
+    end
+
     # * env is the environment heading in your database.yml file
     def initialize(env=nil)
       self.env = env || "development"
     end
 
     def log_file
-      @log_file ||= File.open(LOG_FILE, 'a')
-    rescue Errno::EACCES => e
-      raise LogError.new("Cannot write to #{LOG_FILE}... be sure you have write permissions to #{USER_DIR}")
+      @log_file ||= File.open(log_file_path, 'a')
+    rescue Errno::EACCES, Errno::ENOENT => e
+      raise LogError.new("Cannot write to #{log_file_path}")
     end
   
     # sql - a query
@@ -117,4 +121,4 @@ module Oci8Simple
       log_file.puts "#{Time.now} - #{@env} - #{str}"
     end
   end
-end
+end

data/lib/oci8_simple/command.rb

@@ -8,12 +8,15 @@ module Oci8Simple
       
       # Returns an OptionParser object. 
       def parse_options(banner)
-        @options= {}
+        @options= {:environment => "development"}
         o = OptionParser.new do |opt|
           opt.banner = banner
           opt.on("-c", "--show_column_names", "Show column names for each result") do
             @options[:hash] = true
           end
+          opt.on("-e", "--environment ENV", "Set environment. Defaults to development") do |e|
+            @options[:environment] = e
+          end
           opt.on("-v", "--version", "Show version") do
             puts "#{self.to_s} #{Oci8Simple::VERSION}"
             exit
@@ -25,4 +28,4 @@ module Oci8Simple
       
     end
   end
-end
+end

data/lib/oci8_simple/config.rb

@@ -19,8 +19,10 @@ module Oci8Simple
     def database_yaml_path
       path = File.join(Dir.pwd, "database.yml")
       return path if File.exists?(path)
+
       path = File.join(Dir.pwd, "config", "database.yml")
       return path if File.exists?(path)
+      
       File.join(USER_DIR, "database.yml")
     end
 
@@ -41,4 +43,4 @@ ERR
       end
     end
   end
-end
+end

data/lib/oci8_simple/describe.rb

@@ -45,7 +45,7 @@ module Oci8Simple
       if(ARGV[0].nil?)
         puts o
       else
-        puts self.new(ARGV[1]).run(ARGV[0])
+        puts self.new(@options[:environment]).run(ARGV[0])
       end
     end
   
@@ -123,4 +123,4 @@ module Oci8Simple
       @client ||= Oci8Simple::Client.new(@env)
     end
   end
-end
+end

data/lib/oci8_simple/show.rb

@@ -1,4 +1,10 @@
 module Oci8Simple
+  ##
+  # Examples: show tables
+  #           show table users  # gets ddl for table
+  #           show packages
+  #           show package do_stuff # gets ddl for do_stuff
+  #
   class Show
     include Command
     
@@ -12,11 +18,18 @@ module Oci8Simple
       "types" =>      "Type",
       "views" =>      "View"
     }
-    
-    def run(type)
-      clazz = eval("OCI8::Metadata::#{TYPES[type]}")
-      objects = client.send(:conn).describe_schema(client.config["username"]).all_objects.find_all{|f| f.class == clazz}
-      objects.map(&:obj_name).map(&:downcase).sort
+
+    def run(type, thing = nil)
+      if thing.nil?
+        raise "Unknown type: #{type.inspect}" unless TYPES.has_key?(type)
+        clazz = eval("OCI8::Metadata::#{TYPES[type]}")
+        objects = client.send(:conn).describe_schema(client.config["username"]).all_objects.find_all{|f| f.class == clazz}
+        objects.map(&:obj_name).map(&:downcase).sort
+      else
+        cursor = client.send(:conn).exec("SELECT dbms_metadata.get_ddl('#{type.upcase}', '#{thing.upcase}') from dual")
+        result = cursor.fetch
+        result[0] ? result[0].read : ""
+      end
     end
     
     def initialize(env=nil)
@@ -25,10 +38,10 @@ module Oci8Simple
     
     def self.run_from_argv
       o = parse_options(self.usage)
-      if(ARGV[0].nil? || TYPES[ARGV[0]].nil?)
+      if(ARGV[0].nil?)
         puts o
       else
-        puts self.new(ARGV[1]).run(ARGV[0])
+        puts self.new(@options[:environment]).run(*ARGV)
       end
     end
     
@@ -46,4 +59,4 @@ STR
       @client ||= Oci8Simple::Client.new(@env)
     end
   end
-end
+end

data/oci8_simple.gemspec

@@ -10,14 +10,14 @@ Gem::Specification.new do |s|
   s.email = %q{billy.reisinger@gmail.com}
   s.executables = ["oci8_simple", "show", "describe"]
   s.extra_rdoc_files = [
-    "README.rdoc"
+    "README.md"
   ]
   s.files = [
     ".document",
     "Gemfile",
     "Gemfile.lock",
     "LICENSE.txt",
-    "README.rdoc",
+    "README.md",
     "Rakefile",
     "VERSION",
     "bin/describe",

data/test/cli_test.rb

@@ -1,5 +1,5 @@
 require File.join(File.dirname(__FILE__), 'helper')
-class CliTest < Test::Unit::TestCase
+class CliTest < Minitest::Test
   context "Given a table and some data" do
     setup do
       @client = Oci8Simple::Client.new("test")

data/test/client_test.rb

@@ -1,6 +1,6 @@
 require File.join(File.dirname(__FILE__), 'helper')
 
-class ClientTest < Test::Unit::TestCase
+class ClientTest < Minitest::Test
   context "A client" do
     setup do
       @client = Oci8Simple::Client.new
@@ -10,36 +10,21 @@ class ClientTest < Test::Unit::TestCase
     end
     context "with a bad log file" do
       setup do
-        File.expects(:open).with(Oci8Simple::Client::LOG_FILE, 'a').raises(Errno::EACCES.new("no permission"))
+        @client.log_file_path = "/bridge/to/nowhere"
       end
       should "raise custom error" do
-        assert_raise Oci8Simple::LogError do
+        assert_raises Oci8Simple::LogError do
           @client.log_file
         end
       end
     end
-    context "with no database.yml" do
-      setup do
-        fake_file = "/flkjlkj/flkjljk/flklkj"
-        Oci8Simple::Config.any_instance.expects(:database_yaml_path).returns(fake_file)
-        YAML.expects(:load_file).with(fake_file).raises(Errno::ENOENT.new)
-      end
-      should "raise a custom error" do
-        assert_raise Oci8Simple::ConfigError do
-          @client.config
-        end
-      end
-    end
   end
   context "Running a procedure with nil return" do
     setup do
       @client = Oci8Simple::Client.new("test")
-      @client.conn.expects(:exec).yields(nil)
     end
     should "not raise an exception" do
-      assert_nothing_raised do
-        @client.run("A NOOP")
-      end
+      @client.run("SELECT NULL FROM DUAL")
     end
   end
 
@@ -74,13 +59,13 @@ class ClientTest < Test::Unit::TestCase
       end
     
       should "have logged something" do
-        File.unlink(Oci8Simple::Client::LOG_FILE)
-        assert(!File.exists?(Oci8Simple::Client::LOG_FILE))
+        File.unlink(Oci8Simple::Client::LOG_FILE_PATH)
+        assert(!File.exists?(Oci8Simple::Client::LOG_FILE_PATH))
         @client = Oci8Simple::Client.new("test")
         @client.run "select NULL from dual"
         @client.log_file.close
-        assert(File.exists?(Oci8Simple::Client::LOG_FILE))
-        assert(!(0 == File.size(Oci8Simple::Client::LOG_FILE)))
+        assert(File.exists?(Oci8Simple::Client::LOG_FILE_PATH))
+        assert(!(0 == File.size(Oci8Simple::Client::LOG_FILE_PATH)))
       end
     end
   end

data/test/describe_test.rb

@@ -1,5 +1,5 @@
 require File.join(File.dirname(__FILE__), 'helper')
-class DescribeTest < Test::Unit::TestCase
+class DescribeTest < Minitest::Test
   context "Given a table and some data" do
     setup do
       @client = Oci8Simple::Client.new("test")

data/test/helper.rb

@@ -7,14 +7,13 @@ rescue Bundler::BundlerError => e
   $stderr.puts "Run `bundle install` to install missing gems"
   exit e.status_code
 end
-require 'test/unit'
+require 'minitest/autorun'
 require 'shoulda'
-require 'mocha'
 require 'pry'
 
 $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
 $LOAD_PATH.unshift(File.dirname(__FILE__))
 require 'oci8_simple'
 
-class Test::Unit::TestCase
+class Minitest::Test
 end

data/test/show_test.rb

@@ -1,5 +1,5 @@
 require File.join(File.dirname(__FILE__), 'helper')
-class ShowTest < Test::Unit::TestCase
+class ShowTest < Minitest::Test
   def setup
     @client = Oci8Simple::Client.new("test")
     @show =   Oci8Simple::Show.new("test")
@@ -19,15 +19,14 @@ class ShowTest < Test::Unit::TestCase
       SQL
     end
     should "list the tables" do
-      assert_equal ["oci8_simple_test","oci8_simple_test_2"], @show.run("tables")
+      assert((["oci8_simple_test", "oci8_simple_test_2"] - @show.run("tables")).empty?)
     end
   end
   
   context "Show functions" do
     setup do
-      @client.run "drop function oci8_simple_function" rescue nil
-      @client.run <<-SQL
-        CREATE FUNCTION oci8_simple_function 
+      @fct = <<-SQL
+        CREATE OR REPLACE FUNCTION \"#{@client.config["username"]}\".\"OCI8_SIMPLE_FUNCTION\"
         RETURN NUMBER 
         IS num NUMBER(1,0);
         BEGIN 
@@ -35,24 +34,33 @@ class ShowTest < Test::Unit::TestCase
           RETURN(num); 
         END
       SQL
+      @client.run "drop function oci8_simple_function" rescue nil
+      @client.run @fct
     end
     should "list the functions" do
-      assert_equal ["oci8_simple_function"], @show.run("functions")
+      assert((["oci8_simple_function"] - @show.run("functions")).empty?)
+    end
+    should "show the function" do
+      assert_equal @fct.gsub(/\s+/,' '), @show.run("function", "oci8_simple_function").gsub(/\s+/,' ')
     end
   end
   
   context "Show packages" do
     setup do
-      @client.run "drop package oci8_simple_package" rescue nil
-      @client.run <<-SQL
-        CREATE OR REPLACE PACKAGE oci8_simple_package AS 
+      @pkg = <<-SQL
+        CREATE OR REPLACE PACKAGE \"#{@client.config["username"]}\".\"OCI8_SIMPLE_PACKAGE\" AS 
            FUNCTION something(id NUMBER, foo NUMBER) 
               RETURN NUMBER; 
-        END oci8_simple_package
+        END OCI8_SIMPLE_PACKAGE
       SQL
+      @client.run "drop package oci8_simple_package" rescue nil
+      @client.run @pkg
     end
     should "list the packages" do
-      assert_equal ["oci8_simple_package"], @show.run("packages")
+      assert((["oci8_simple_package"] - @show.run("packages")).empty?)
+    end
+    should "show the package" do
+      assert_equal @pkg.gsub(/\s+/,' '), @show.run("package", "oci8_simple_package").gsub(/\s+/,' ')
     end
   end
   
@@ -67,7 +75,7 @@ class ShowTest < Test::Unit::TestCase
       SQL
     end
     should "list the procedures" do
-      assert_equal ["oci8_simple_procedure"], @show.run("procedures")
+      assert((["oci8_simple_procedure"] - @show.run("procedures")).empty?)
     end
   end
   
@@ -79,7 +87,7 @@ class ShowTest < Test::Unit::TestCase
       SQL
     end
     should "list the sequences" do
-      assert_equal ["oci8_simple_sequence"], @show.run("sequences")
+      assert((["oci8_simple_sequence"] - @show.run("sequences")).empty?)
     end
   end
   
@@ -92,7 +100,7 @@ class ShowTest < Test::Unit::TestCase
       SQL
     end
     should "list the synonyms" do
-      assert_equal ["oci8_simple_synonym"], @show.run("synonyms")
+      assert((["oci8_simple_synonym"] - @show.run("synonyms")).empty?)
     end
   end
   
@@ -105,7 +113,7 @@ class ShowTest < Test::Unit::TestCase
       SQL
     end
     should "list the types" do
-      assert_equal ["oci8_simple_type"], @show.run("types")
+      assert((["oci8_simple_type"] - @show.run("types")).empty?)
     end
   end
   
@@ -118,7 +126,7 @@ class ShowTest < Test::Unit::TestCase
       SQL
     end
     should "list the views" do
-      assert_equal ["oci8_simple_view"], @show.run("views")
+      assert((["oci8_simple_view"] - @show.run("views")).empty?)
     end
   end
-end
+end

metadata

@@ -1,33 +1,30 @@
 --- !ruby/object:Gem::Specification
 name: oci8_simple
 version: !ruby/object:Gem::Version
-  version: 0.9.2
-  prerelease: 
+  version: 1.0.0
 platform: ruby
 authors:
 - Billy Reisinger
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-27 00:00:00.000000000 Z
+date: 2015-05-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-oci8
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 2.1.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 2.1.2
-description: ! "Command-line tools for interacting with an Oracle database. This client
+description: "Command-line tools for interacting with an Oracle database. This client
   is intended to be used \n  to aid development and automation.  This is *not* meant
   to replace an ORM such as ActiveRecord + OracleEnhancedAdapter.\n  The only prerequisite
   to running this code is that you have installed the ruby-oci8 gem on your machine."
@@ -38,13 +35,13 @@ executables:
 - describe
 extensions: []
 extra_rdoc_files:
-- README.rdoc
+- README.md
 files:
-- .document
+- ".document"
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
-- README.rdoc
+- README.md
 - Rakefile
 - VERSION
 - bin/describe
@@ -66,31 +63,24 @@ files:
 homepage: http://github.com/unclebilly/oci8_simple
 licenses:
 - MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -4565524330145410759
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -4565524330145410759
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.25
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 3
 summary: Command-line tools for interacting with an Oracle database.

data/README.rdoc

@@ -1,124 +0,0 @@
-= oci8_simple
-This gem is a thin wrapper around the ruby-oci8 gem.  The client is intended to be used by simple 
-scripts to aid automation.  The code is intentionally light-weight and featureless, with very little startup time. 
-It is not meant to be a Ruby ORM for Oracle - if you want that, look at the OracleEnhancedAdapter. 
-
-This gem installs a few command-line scripts: 
-* <code>oci8_simple</code>
-  * a command to run arbitrary SQL
-* <code>describe   </code>
-  * a command to describe a table
-* <code>show       </code>
-  * a command to list things in the database (tables, views, etc.)
-You can also use oci8_simple in your Ruby scripts by creating an instance of <code>Oci8Simple::Client</code> 
-(see more below).
-
-== Prerequisites 
-* Oracle Instant Client (http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html)
-* ruby-oci8
-  
-== Installation
-  gem install oci8_simple
-
-== Configuration
-Oci8Simple will look in three places for your database configuration, in the following order:
-* Dir.pwd + database.yml
-* Dir.pwd + config/database.yml
-* ~/.oci8_simple/database.yml
-The database.yml format is compatible with the Rails format.
-  development:
-    database: oracle.hostname:1521/sid
-    username: foo_dev
-    password: OMG333
-  test:
-    database: oracle.hostname:1521/sid
-    username: foo_test
-    password: OMG333
-
-== Logging
-All logging is done to <code>~/.oci8_simple/oci8_simple.log</code>.
-
-== Command-Line Examples
-=== oci8_simple
-This script allows you to run single statements against an 
-arbitrary Oracle schema via the command line.
-
-  Run a query against development schema
-    oci8_simple "select id, name from flavors" 
-  
-  Run a query against a different schema
-    oci8_simple "select id, name from flavors" int
-  
-  Help
-    oci8_simple --help
-
-=== describe
-This script shows a description of a table, including the column names (sorted), 
-the type and size for each column, the nullable status of the column, and the default
-value, if any.
-
-  Show column information for a table named "holidays"
-    describe holidays
-  
-  Help
-    describe --help
-    
-=== show
-This command can list the following items in the database: 
-functions, packages, procedures, sequences, synonyms, tables, types, and views.
-
-  Show a list of all tables in the database
-    show tables
-    
-  Show a list of all views in the database
-    show views
-  
-  Help
-    show --help
-    
-== Code Examples 
-* Initialize a client against the development schema
-    require 'rubygems'
-    require 'oci8_simple'
-    client = Oci8Simple::Client.new
-* Run a simple select query against development schema
-    client.run('select id, name from foos')                => [[2, "lol"], [3, "hey"], ...]
-    client.run('select id, name from foos', :hash => true) => [{:id => 2, :name => "lol"}, {:id => 3, :name=>"hey"}, ...])
-* Update something
-    client.run <<-SQL
-      UPDATE foos SET bar='baz' WHERE id=1233
-    SQL
-* Run some DDL
-    client.run <<-SQL
-      CREATE TABLE foos (
-         ID NUMBER(38) NOT NULL
-      )
-    SQL
-* Run some PL/SQL
-    client.run <<-SQL
-      DECLARE
-        a NUMBER;
-        b NUMBER;
-      BEGIN
-        SELECT e,f INTO a,b FROM T1 WHERE e>1;
-        INSERT INTO T1 VALUES(b,a);
-      END;
-    SQL
-* Run a query against stage schema
-    Oci8Simple::Client.new("stage").run('select id, name from foos') => [[2, "lol"], [3, "hey"], ...]  
-    
-== Contributing to oci8_simple
- 
-* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
-* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
-* Fork the project
-* Start a feature/bugfix branch
-* Commit and push until you are happy with your contribution
-* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
-
-== Copyright
-
-Copyright (c) 2011 Billy Reisinger. See LICENSE.txt for
-further details.
-