oracle_client_provision 1.0.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NWZiYzM5YWM1ZDhjN2U2MWQ1YzFkMjc0ZDA4NTFjY2FlOTYyZDMzMQ==
+  data.tar.gz: !binary |-
+    MWNhM2IxMzFjNzA3ZDA5YjQyM2ZkNWY3NzkzMWQ1ZWU5MzhjNTQyNw==
+SHA512:
+  metadata.gz: !binary |-
+    ZDA4MWM5NDQ0MGQzNjAzMDE4NmM1MzRiZmY0MjM4ZDI4MGI2MDNhMDY1M2Vh
+    YjViYzg2NDAwNWY4NWM3NTZkZjM5Mjg5OGUyODc4NzJjMTlkMmRhNmE4MDFk
+    ZWI5MjFhZjBlMmQ2NWE3OTc4NjhjZWM0ZGJkNzBkZTMzYmE1MTg=
+  data.tar.gz: !binary |-
+    NTExOGEwZDBiNDAwMTEzZGY0NjNmNmY4NDFiZTJmYmM1ZGFhMGM2NTQ0YmU5
+    MGEyYzM5ZTA5YmJlMTBkNDFhZTk4NzNmOTljOWU4OGY0MDZmYjE5MGEwZTlj
+    NGEwODQ0ZDE1YTIxMDAwOTY4ZTRmMWEyMDNiMGVjYTQ3NDUzZGU=

data/.gitignore

@@ -0,0 +1,35 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+/downloads/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.idea/.name

@@ -0,0 +1 @@
+oracle_client_provision

data/.idea/.rakeTasks

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Settings><!--This file was automatically generated by Ruby plugin.
+You are allowed to: 
+1. Remove rake task
+2. Add existing rake tasks
+To add existing rake tasks automatically delete this file and reload the project.
+--><RakeGroup description="" fullCmd="" taksId="rake"><RakeTask description="Installs oracle ruby-oci8 support" fullCmd="oracle_install" taksId="oracle_install" /><RakeTask description="Run RSpec code examples" fullCmd="spec" taksId="spec" /><RakeTask description="" fullCmd="build" taksId="build" /><RakeTask description="" fullCmd="gen" taksId="gen" /><RakeTask description="" fullCmd="install" taksId="install" /><RakeTask description="" fullCmd="release" taksId="release" /><RakeTask description="" fullCmd="uninstall" taksId="uninstall" /></RakeGroup></Settings>

data/.idea/encodings.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Encoding" useUTFGuessing="true" native2AsciiForPropertiesFiles="false" />
+</project>
+

data/.idea/misc.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" project-jdk-name="RVM: ruby-1.9.3-p545 [mutant_examples]" project-jdk-type="RUBY_SDK" />
+</project>
+

data/.idea/modules.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/oracle_client_provision.iml" filepath="$PROJECT_DIR$/.idea/oracle_client_provision.iml" />
+    </modules>
+  </component>
+</project>
+

data/.idea/oracle_client_provision.iml

@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="CompassSettings">
+    <option name="compassSupportEnabled" value="true" />
+  </component>
+  <component name="FacetManager">
+    <facet type="gem" name="Ruby Gem">
+      <configuration>
+        <option name="GEM_APP_ROOT_PATH" value="$MODULE_DIR$" />
+        <option name="GEM_APP_TEST_PATH" value="" />
+        <option name="GEM_APP_LIB_PATH" value="$MODULE_DIR$/lib" />
+      </configuration>
+    </facet>
+  </component>
+  <component name="ModuleRunConfigurationManager">
+    <configuration default="false" name="OracleClientProvision#install calls install method: oracle_client_provision" type="RSpecRunConfigurationType" factoryName="RSpec" temporary="true">
+      <predefined_log_file id="RUBY_RSPEC" enabled="true" />
+      <module name="oracle_client_provision" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="-e $stdout.sync=true;$stderr.sync=true;load($0=ARGV.shift)" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="WORK DIR" VALUE="$MODULE_DIR$" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SHOULD_USE_SDK" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ALTERN_SDK_NAME" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="myPassParentEnvs" VALUE="true" />
+      <envs>
+        <env name="JRUBY_OPTS" value="-X+O" />
+      </envs>
+      <EXTENSION ID="BundlerRunConfigurationExtension" bundleExecEnabled="true" />
+      <EXTENSION ID="JRubyRunConfigurationExtension" NailgunExecEnabled="false" />
+      <EXTENSION ID="RubyCoverageRunConfigurationExtension" enabled="false" sample_coverage="true" track_test_folders="true" runner="rcov">
+        <COVERAGE_PATTERN ENABLED="true">
+          <PATTERN REGEXPS="/.rvm/" INCLUDED="false" />
+        </COVERAGE_PATTERN>
+      </EXTENSION>
+      <EXTENSION ID="org.jetbrains.plugins.ruby.motion.run.MotionSimulatorRunExtension" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TESTS_FOLDER_PATH" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="$MODULE_DIR$/spec/oracle_client_provision_spec.rb" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_RUNNER_PATH" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_FILE_MASK" VALUE="**/*_spec.rb" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_EXAMPLE_NAME" VALUE="OracleClientProvision#install calls install method" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_TEST_TYPE" VALUE="TEST_SCRIPT" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_ARGS" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUNNER_VERSION" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="USE_CUSTOM_SPEC_RUNNER" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="DRB" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ZEUS" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPRING" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="FULL_BACKTRACE" VALUE="false" />
+      <RunnerSettings RunnerId="RubyRunner" />
+      <ConfigurationWrapper RunnerId="RubyRunner" />
+      <method />
+    </configuration>
+  </component>
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="jdk" jdkName="RVM: ruby-1.9.3-p545 [oracle_client_provision]" jdkType="RUBY_SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v1.6.2, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="diff-lcs (v1.2.5, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="file_utils (v1.0.7, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="gemcutter (v0.7.1, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="gemspec_deps_gen (v1.1.2, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="highline (v1.6.21, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="json_pure (v1.8.1, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="metaclass (v0.0.4, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="mocha (v1.1.0, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="net-ssh (v2.9.1, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec (v3.0.0, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="script_executor (v1.5.2, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="text-interpolator (v1.1.6, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="thor (v0.19.1, RVM: ruby-1.9.3-p545 [oracle_client_provision]) [gem]" level="application" />
+  </component>
+</module>
+

data/.idea/scopes/scope_settings.xml

@@ -0,0 +1,5 @@
+<component name="DependencyValidationManager">
+  <state>
+    <option name="SKIP_IMPORT_STATEMENTS" value="false" />
+  </state>
+</component>

data/.idea/vcs.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>
+

data/.oracle_client_provision.json

@@ -0,0 +1,32 @@
+{
+
+  "node": {
+    "domain": "127.0.0.1",
+    "user": "ENV['USER']",
+    "home": "ENV['HOME']",
+    "port": "",
+    "remote": false
+  },
+
+  "project": {
+    "home": "#{node.home}/oracle_client_provision",
+    "ruby_home": "ENV['MY_RUBY_HOME']"
+  },
+
+  "instant_client": {
+    "src_dir": "./downloads",
+    "dest_dir": "#{oracle.oracle_base}/instantclient_11_2",
+
+    "basic_zip": "#{instant_client.src_dir}/instantclient-basic-macos.x64-#{oracle.oracle_version}.zip",
+    "sdk_zip": "#{instant_client.src_dir}/instantclient-sdk-macos.x64-#{oracle.oracle_version}.zip",
+    "sqlplus_zip": "#{instant_client.src_dir}/instantclient-sqlplus-macos.x64-#{oracle.oracle_version}.zip"
+  },
+
+  "oracle": {
+    "oracle_base": "/usr/local/oracle",
+    "oracle_version": "11.2.0.4.0",
+    "ruby_oci_version": "2.1.7",
+    "tns_admin_dir": "#{oracle.oracle_base}/network/admin"
+  }
+
+}

data/.ruby-gemset

@@ -0,0 +1 @@
+oracle_client_provision

data/.ruby-version

@@ -0,0 +1 @@
+1.9.3

data/CHANGES

@@ -0,0 +1,5 @@
+= Oracle Instant Client Provision Changelog
+
+== Version 1.0.0
+
+* Initial release.

data/Gemfile

@@ -0,0 +1,24 @@
+source "https://rubygems.org"
+
+# Run "bundle install --without=oracle" to install gems without ruby-oci8 driver
+
+group :default do
+  gem "text-interpolator", "~>1.1"
+  gem "script_executor", "~>1.5"
+  gem "thor", "~>0.19"
+  gem "json_pure", "~>1.8"
+end
+
+group :development do
+  gem "gemspec_deps_gen", "~>1.1"
+  gem "gemcutter", "~>0.7"
+end
+
+group :oracle do
+  gem "ruby-oci8", "2.1.7"
+end
+
+group :test do
+  gem "rspec"
+  gem "mocha"
+end

data/Gemfile.lock

@@ -0,0 +1,49 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.2.5)
+    file_utils (1.0.7)
+    gemcutter (0.7.1)
+    gemspec_deps_gen (1.1.2)
+      bundler
+      file_utils
+    highline (1.6.21)
+    json_pure (1.8.1)
+    metaclass (0.0.4)
+    mocha (1.1.0)
+      metaclass (~> 0.0.1)
+    net-ssh (2.9.1)
+    rspec (3.0.0)
+      rspec-core (~> 3.0.0)
+      rspec-expectations (~> 3.0.0)
+      rspec-mocks (~> 3.0.0)
+    rspec-core (3.0.4)
+      rspec-support (~> 3.0.0)
+    rspec-expectations (3.0.4)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.0.0)
+    rspec-mocks (3.0.4)
+      rspec-support (~> 3.0.0)
+    rspec-support (3.0.4)
+    ruby-oci8 (2.1.7)
+    script_executor (1.5.2)
+      highline (~> 1.6)
+      json_pure (~> 1.8)
+      net-ssh (~> 2.8)
+      text-interpolator (~> 1.0)
+    text-interpolator (1.1.6)
+    thor (0.19.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  gemcutter (~> 0.7)
+  gemspec_deps_gen (~> 1.1)
+  json_pure (~> 1.8)
+  mocha
+  rspec
+  ruby-oci8 (= 2.1.7)
+  script_executor (~> 1.5)
+  text-interpolator (~> 1.1)
+  thor (~> 0.19)

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Alexander Shvets
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,213 @@
+# Oracle Client Provision - thor-based tasks for facilitating Oracle Instant Client installation
+
+## Introduction
+
+Installing database driver for Oracle (activerecord-oracle_enhanced-adapter) is not a simple process.
+
+- First, you need to install Oracle Instant Client.
+- Second, you have to install ruby wrapper around Instant Client (ruby-oci8 gem). On some platforms it
+requires compiling source code.
+
+Only after that you can install oracle database driver.
+
+Here we discuss how to do it for OSX 10 operating system.
+
+## Create new gem group
+
+Create separate group (e.g. "oracle") in Gemfile for oracle ruby-oci8 client wrapper. You have to keep
+this gem in separate group because it requires special steps to be done before database driver
+can be installed.
+
+```ruby
+# Gemfile
+
+group :oracle do
+  gem "ruby-oci8", "2.1.7"
+end
+```
+
+## Install gems for the project (except ruby-oci8 gem)
+
+Install ruby gems for your project with bundler tool. You have to bypass oracle client wrapper installation:
+
+```bash
+bundle install --without=oracle
+```
+
+**without** parameter will exclude **oracle** bundler group from the execution.
+
+Check that you don't have ruby-oci8 installed yet:
+
+```bash
+gem list
+```
+
+## Download Oracle Instant Client
+
+Download Oracle Instant Client packages and save them locally (e.g. in "downloads" folder). You can find
+installation packages on **www.oracle.com** web site (you have to be registered user though).
+
+## Configuration file
+
+Create configuration file for the installation (.oracle\_client\_provision.json) in the root of your project.
+It will define where you have downloaded files and some other parameters:
+
+```json
+{
+
+  "node": {
+    "domain": "127.0.0.1",
+    "user": "ENV['USER']",
+    "home": "ENV['HOME']",
+    "port": "",
+    "remote": false
+  }
+
+  "project": {
+    "home": "#{node.home}/my_project_with_oracle_driver",
+    "ruby_home": "ENV['MY_RUBY_HOME']"
+  },
+
+  "instant_client": {
+    "src_dir": "#{project.home}/downloads",
+    "dest_dir": "#{oracle.oracle_base}/instantclient_11_2",
+
+    "basic_zip": "#{instant_client.src_dir}/instantclient-basic-macos.x64-#{oracle.oracle_version}.zip",
+    "sdk_zip": "#{instant_client.src_dir}/instantclient-sdk-macos.x64-#{oracle.oracle_version}.zip",
+    "sqlplus_zip": "#{instant_client.src_dir}/instantclient-sqlplus-macos.x64-#{oracle.oracle_version}.zip"
+  },
+
+  "oracle": {
+    "oracle_base": "/usr/local/oracle",
+    "oracle_version": "11.2.0.4.0",
+    "ruby_oci_version": "2.1.7",
+    "tns_admin_dir": "#{oracle.oracle_base}/network/admin"
+  }
+
+}
+```
+
+We are going to run ruby from **project.ruby_home** on behalf of the **node.user** and we will use specific versions
+of **oracle** client and **ruby-oci8** gem. We also specify where to look for installation packages (instant_client.src\_dir)
+and where to install Instant Client (instant_client.dest\_dir). Also, as you can see, we are using **macos** as a platform
+and **x64** as an architecture.
+
+## Provide execution script
+
+Library itself if written in ruby, but for launching its code you have to use **rake** or **thor**. Here I provide
+thor script as an example:
+
+```ruby
+require 'thor'
+require 'oracle_client_provision'
+
+class OracleClient < Thor
+  @installer = OracleClientProvision.new self, ".oracle_client_provision.json"
+
+  class << self
+    attr_reader :installer
+  end
+
+  desc "install", "Installs Oracle Instant Client"
+  def install
+    OracleClient.installer.install
+  end
+
+  desc "uninstall", "Uninstalls Oracle Instant Client"
+  def uninstall
+    OracleClient.installer.uninstall
+  end
+
+  desc "verify", "Verifies Oracle Instant Client connection"
+  def verify
+    username = "scott"
+    password = "tiger"
+    schema   = "ORCL"
+    sql      = "SELECT * FROM emp where rownum <= 10"
+
+    OracleClient.installer.verify do
+      "require 'oci8'; OCI8.new('#{username}','#{password}','#{schema}').exec('#{sql}') do |r| puts r.join(','); end"
+    end
+  end
+
+end
+```
+
+## Install Oracle Instant Client
+
+Run this **thor** command:
+
+```bash
+thor oracle_client:install
+```
+
+After execution all Instant Client packages (basic, sdk and sqlplus) will be installed at the right location
+(instant_client.dest\_dir) on your computer.
+
+## Again: install gems for the project, now with ruby-oci8 gem
+
+Remove .bundle folder in order to include "oracle" group into bundle execution and
+then run bundler with "oracle" group:
+
+```bash
+rm -rf .bundle
+
+bundle
+```
+
+## Verify the installation
+
+If you have Oracle installed locally with **scott/tiger/ORCL**, you can test it now:
+
+```bash
+thor oracle_client:verify
+```
+
+If you have oracle installed somewhere on the network, you can add TNS names inside your
+**tnsnames.ora** file located inside **/usr/local/oracle/network/admin** folder. You can set up
+this location via **tns\_admin\_dir** property inside your configuration file.
+
+tnsnames.ora file will have this section:
+
+```
+MY_ORCL=
+  (DESCRIPTION=
+    (ADDRESS=
+      (PROTOCOL=TCP)
+      (HOST=db.your_host.com)
+      (PORT=1521)
+  )
+  (CONNECT_DATA=
+      (SID=MY_ORCL)
+    )
+  )
+```
+
+where you define **MY\_ORCL** schema on **db.your\_host.com** running on port **1521**.
+
+In order to use oracle driver inside rails application, you have to include it into your Gemfile:
+
+```ruby
+# Gemfile
+
+group :oracle do
+  ...
+  gem 'activerecord-oracle_enhanced-adapter', '1.5.5'
+end
+```
+
+# Summary: all steps all together
+
+```bash
+bundle install --without=oracle
+
+thor oracle_client:install
+
+rm -rf .bundle
+
+bundle
+
+thor oracle_client:verify
+```
+
+

data/Rakefile

@@ -0,0 +1,51 @@
+#!/usr/bin/env rake
+
+include Rake::DSL
+
+$LOAD_PATH.unshift File.expand_path("lib", File.dirname(__FILE__))
+
+require "rspec/core/rake_task"
+require "oracle_client_provision/version"
+require "gemspec_deps_gen/gemspec_deps_gen"
+
+version = OracleClientProvision::VERSION
+project_name = File.basename(Dir.pwd)
+
+task :gen do
+  generator = GemspecDepsGen.new
+
+  generator.generate_dependencies "spec", "#{project_name}.gemspec.erb", "#{project_name}.gemspec"
+end
+
+task :build => :gen do
+  system "gem build #{project_name}.gemspec"
+end
+
+task :install do
+  system "gem install #{project_name}-#{version}.gem"
+end
+
+task :uninstall do
+  system "gem uninstall #{project_name}"
+end
+
+task :release => :build do
+  system "gem push #{project_name}-#{version}.gem"
+end
+
+RSpec::Core::RakeTask.new do |task|
+  task.pattern = 'spec/**/*_spec.rb'
+  task.verbose = false
+end
+
+desc 'Installs oracle ruby-oci8 support'
+task :oracle_install do
+  system "bundle install --without=oracle"
+
+  system "rm -rf .bundle"
+
+  system "thor oracle_client:install"
+
+  system "thor oracle_client:verify"
+end
+

data/Thorfile

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+unless defined? Thor::Runner
+  require 'bundler'
+
+  gems = Bundler::Definition.build(Bundler.default_gemfile, Bundler.default_lockfile, nil).requested_specs
+
+  gem = gems.find { |gem| gem.name == 'thor'}
+
+  load "#{ENV['GEM_HOME']}/gems/#{gem.name}-#{gem.version}/bin/thor"
+end
+
+require 'thor'
+
+Dir.glob("thor/**/*.thor") do |name|
+  Thor::Util.load_thorfile(name)
+end

data/lib/oracle_client_provision.rb

@@ -0,0 +1 @@
+require 'oracle_client_provision/oracle_client_provision'

data/lib/oracle_client_provision/oracle_client_provision.rb

@@ -0,0 +1,30 @@
+require 'script_executor/base_provision'
+
+class OracleClientProvision < BaseProvision
+  include Executable, ScriptLocator
+
+  def initialize parent_class, config_file_name=".oracle_client_provision.json", scripts_file_names=[]
+    scripts_file_names.unshift(File.expand_path("oracle_client_provision_scripts.sh", File.dirname(__FILE__))) # make it first
+
+    super
+  end
+
+  def install
+    puts "ruby home: #{env[:project][:ruby_home]}"
+    puts "ruby_oci_version: #{env[:oracle][:ruby_oci_version]}"
+    puts "user: #{env[:node][:user]}"
+
+    run(server_info.merge({:sudo => true, :capture_output => true}), "install_client", env)
+
+    run(server_info, "install-ruby-oci8", env)
+  end
+
+  def uninstall
+    run({:sudo => true}, "uninstall", env)
+  end
+
+  def verify &code
+    run(server_info, "verify_install", env.merge(:cmd => code.call))
+  end
+
+end

data/lib/oracle_client_provision/oracle_client_provision_scripts.sh

@@ -0,0 +1,83 @@
+#!/bin/sh
+
+[install_client]
+
+echo "Removing Oracle instant client..."
+
+rm -rf #{instant_client.dest_dir}
+
+echo "Creating required directories for Oracle instant client..."
+
+mkdir -p #{oracle.oracle_base}
+mkdir -p #{oracle.tns_admin_dir}
+mkdir -p #{instant_client.dest_dir}
+
+echo "Unzipping Oracle instant client..."
+
+cp #{instant_client.basic_zip} #{oracle.oracle_base}
+cp #{instant_client.sdk_zip} #{oracle.oracle_base}
+cp #{instant_client.sqlplus_zip} #{oracle.oracle_base}
+
+unzip -o #{instant_client.basic_zip} -d #{oracle.oracle_base}
+unzip -o #{instant_client.sdk_zip} -d #{oracle.oracle_base}
+unzip -o #{instant_client.sqlplus_zip} -d #{oracle.oracle_base}
+
+echo "Creating soft links..."
+
+ln -sF #{instant_client.dest_dir}/libclntsh.dylib.11.1 #{instant_client.dest_dir}/libclntsh.dylib
+
+
+[install-ruby-oci8]
+
+echo "Installing ruby-oci8 gem..."
+
+ORACLE_BASE="#{oracle.oracle_base}"
+DYLD_LIBRARY_PATH="#{instant_client.dest_dir}"
+TNS_ADMIN="#{oracle.tns_admin_dir}"
+NLS_LANG=".UTF8"
+
+ENV_VARS="ORACLE_BASE=$ORACLE_BASE DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH TNS_ADMIN=$TNS_ADMIN NLS_LANG=$NLS_LANG"
+
+env $ENV_VARS bash -c 'gem install ruby-oci8 -v #{oracle.ruby_oci_version}'
+
+
+[uninstall]
+
+echo "Removing Oracle instant client..."
+
+rm -rf #{instant_client.dest_dir}
+
+echo "Creating required directories for Oracle instant client..."
+
+mkdir -p #{oracle.oracle_base}
+mkdir -p #{oracle.tns_admin_dir}
+mkdir -p #{instant_client.dest_dir}
+
+echo "Unzipping Oracle instant client..."
+
+cp #{instant_client.basic_zip} #{oracle.oracle_base}
+cp #{instant_client.sdk_zip} #{oracle.oracle_base}
+cp #{instant_client.sqlplus_zip} #{oracle.oracle_base}
+
+unzip -o #{instant_client.basic_zip} -d #{oracle.oracle_base}
+unzip -o #{instant_client.sdk_zip} -d #{oracle.oracle_base}
+unzip -o #{instant_client.sqlplus_zip} -d #{oracle.oracle_base}
+
+echo "Creating soft links..."
+
+ln -sF #{instant_client.dest_dir}/libclntsh.dylib.11.1 #{instant_client.dest_dir}/libclntsh.dylib
+
+
+[verify_install]
+
+echo "Testing Instant Client installation..."
+
+RUBY="#{project.ruby_home}/bin/ruby"
+ORACLE_BASE="#{oracle.oracle_base}"
+DYLD_LIBRARY_PATH="#{instant_client.dest_dir}"
+TNS_ADMIN="#{oracle.tns_admin_dir}"
+NLS_LANG='.UTF8'
+
+ENV_VARS="ORACLE_BASE=$ORACLE_BASE DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH TNS_ADMIN=$TNS_ADMIN NLS_LANG=$NLS_LANG"
+
+env $ENV_VARS $RUBY -e "#{cmd}"

data/lib/oracle_client_provision/version.rb

@@ -0,0 +1,3 @@
+class OracleClientProvision
+  VERSION = "1.0.0"
+end

data/oracle_client_provision.gemspec.erb

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+
+require File.expand_path(File.dirname(__FILE__) + '/lib/oracle_client_provision/version')
+
+Gem::Specification.new do |spec|
+  spec.name          = "oracle_client_provision"
+  spec.summary       = %q{Thor-based tasks for installing oracle client}
+  spec.description   = %q{Thor-based tasks for installing oracle client.}
+  spec.email         = "alexander.shvets@gmail.com"
+  spec.authors       = ["Alexander Shvets"]
+  spec.homepage      = "http://github.com/shvets/oracle_client_provision"
+
+  spec.files         = `git ls-files`.split($\)
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+  spec.version       = OracleClientProvision::VERSION
+  spec.license       = "MIT"
+
+  <%= project_dependencies %>
+end
+

data/spec/oracle_client_provision_spec.rb

@@ -0,0 +1,16 @@
+require File.expand_path('spec_helper', File.dirname(__FILE__))
+
+require 'oracle_client_provision'
+
+describe OracleClientProvision do
+  subject { OracleClientProvision.new self.class, ".oracle_client_provision.json"}
+
+  describe "#install" do
+    it "calls install method" do
+      expect(subject).to receive(:run).exactly(2).times
+
+      subject.install
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+$: << File.expand_path('../lib', File.dirname(__FILE__))
+
+# RSpec.configure do |config|
+#   config.mock_with :mocha
+# end
+

data/thor/oracle_client.thor

@@ -0,0 +1,35 @@
+$: << File.expand_path(File.dirname(__FILE__) + '/../lib')
+
+require 'oracle_client_provision'
+
+class OracleClient < Thor
+  @installer = OracleClientProvision.new self, ".oracle_client_provision.json"
+
+  class << self
+    attr_reader :installer
+  end
+
+  desc "install", "Installs Oracle Instant Client"
+  def install
+    OracleClient.installer.install
+  end
+
+  desc "uninstall", "Uninstalls Oracle Instant Client"
+  def uninstall
+    OracleClient.installer.uninstall
+  end
+
+  desc "verify", "Verifies Oracle Instant Client connection"
+  def verify
+    username = "scott"
+    password = "tiger"
+    schema   = "ORCL"
+    sql      = "SELECT * FROM emp where rownum <= 10"
+
+    OracleClient.installer.verify do
+      "require 'oci8'; OCI8.new('#{username}','#{password}','#{schema}').exec('#{sql}') do |r| puts r.join(','); end"
+    end
+  end
+
+end
+

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification
+name: oracle_client_provision
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Alexander Shvets
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: text-interpolator
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: script_executor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: json_pure
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: gemspec_deps_gen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: gemcutter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+description: Thor-based tasks for installing oracle client.
+email: alexander.shvets@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .idea/.name
+- .idea/.rakeTasks
+- .idea/encodings.xml
+- .idea/misc.xml
+- .idea/modules.xml
+- .idea/oracle_client_provision.iml
+- .idea/scopes/scope_settings.xml
+- .idea/vcs.xml
+- .oracle_client_provision.json
+- .ruby-gemset
+- .ruby-version
+- CHANGES
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- Thorfile
+- lib/oracle_client_provision.rb
+- lib/oracle_client_provision/oracle_client_provision.rb
+- lib/oracle_client_provision/oracle_client_provision_scripts.sh
+- lib/oracle_client_provision/version.rb
+- oracle_client_provision.gemspec.erb
+- spec/oracle_client_provision_spec.rb
+- spec/spec_helper.rb
+- thor/oracle_client.thor
+homepage: http://github.com/shvets/oracle_client_provision
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Thor-based tasks for installing oracle client
+test_files:
+- spec/oracle_client_provision_spec.rb
+- spec/spec_helper.rb