isolated_server 0.4.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b2d7d8b108bb1695c895f2cca19133ba564e5f82
+  data.tar.gz: 7a84a2bfcaff968497b8905be18d419af9fd73e6
+SHA512:
+  metadata.gz: 0612f94c0a675cea739aa38f072392351b1be05d83ab9615f7789cefff73b7f54f98e265406b346982c3c497a4bb0b7e113d25f1c9971235be2abf9700af2f88
+  data.tar.gz: 75e455b4e6bf2143975f9d3dd5227b932ec7c5154459d248c645a44e74b1d854e897af6a3a30560550f5ed23d7e4d6fd8788766b5df1aacf9db86909270067e6

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+gemfiles/*.gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--warnings
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+gemfile:
+  - gemfiles/mongo_1.7.gemfile
+  - gemfiles/mongo_latest.gemfile
+rvm:
+  - 2.1.1
+  - 2.1.2
+

data/Appraisals

@@ -0,0 +1,7 @@
+appraise "mongo-1.7" do
+  gem "mongo", "~> 1.7.0"
+end
+
+appraise "mongo-latest" do
+  gem "mongo"
+end

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+gem "bump"
+gem "mysql2", "~> 0.3"
+gem "mongo", "~> 1.10"
+# Specify your gem's dependencies in isolated_server.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Ben Osheroff
+
+MIT License
+
+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,36 @@
+[![Build Status](https://travis-ci.org/gabetax/isolated_server.svg?branch=master)](https://travis-ci.org/gabetax/isolated_server)
+
+# Mysql Isolated Servers -- a gem for testing mysql stuff
+
+This gem provides functionality to quickly bring up and tear down mysql instances for the 
+purposes of testing code against more advanced mysql topologies -- replication, vertical
+partitions, etc.
+
+I developed this as part of my testing strategy for implementing http://github.com/osheroff/ar_mysql_flexmaster, but it's 
+been useful in developement of a couple of other projects too (http://github.com/osheroff/mmtop).
+
+## Usage
+
+```
+$mysql_master = IsolatedServer::Mysql.new(allow_output: false)
+$mysql_master.boot!
+
+puts "mysql master booted on port #{$mysql_master.port} -- access with mysql -uroot -h127.0.0.1 --port=#{$mysql_master.port} mysql"
+
+$mysql_slave = IsolatedServer::Mysql.new
+$mysql_slave.boot!
+
+puts "mysql slave booted on port #{$mysql_slave.port} -- access with mysql -uroot -h127.0.0.1 --port=#{$mysql_slave.port} mysql"
+
+$mysql_slave_2 = IsolatedServer::Mysql.new
+$mysql_slave_2.boot!
+
+puts "mysql chained slave booted on port #{$mysql_slave_2.port} -- access with mysql -uroot -h127.0.0.1 --port=#{$mysql_slave_2.port} mysql"
+
+$mysql_slave.make_slave_of($mysql_master)
+$mysql_slave_2.make_slave_of($mysql_slave)
+
+$mysql_slave.set_rw(false)
+sleep if __FILE__ == $0
+```
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "bump/tasks"
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec

data/bin/boot_isolated_mysql_server

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+$LOAD_PATH << File.dirname(__FILE__) + "/../lib"
+require 'rubygems'
+require 'isolated_server'
+require 'getoptlong'
+
+opts = GetoptLong.new(
+  [ '--log-bin', GetoptLong::REQUIRED_ARGUMENT ],
+  [ '--pid', GetoptLong::REQUIRED_ARGUMENT ]
+)
+
+options = {}
+opts.each do |opt, arg|
+  case opt
+    when '--log-bin'
+      options[:log_bin] = arg
+    when '--pid'
+      options[:pid] = arg.to_i
+    end
+end
+
+options[:params] = ARGV.join(' ')
+
+isolated_server = IsolatedServer::Mysql.new(options)
+isolated_server.boot!
+
+puts "dir: " + isolated_server.base
+puts "port: " + isolated_server.port.to_s
+STDOUT.flush

data/gemfiles/mongo_1.7.gemfile

@@ -0,0 +1,9 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "bump"
+gem "mysql2", "~> 0.3"
+gem "mongo", "~> 1.10"
+
+gemspec :path => "../"

data/gemfiles/mongo_latest.gemfile

@@ -0,0 +1,9 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "bump"
+gem "mysql2", "~> 0.3"
+gem "mongo", "~> 1.10"
+
+gemspec :path => "../"

data/isolated_server.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'isolated_server/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "isolated_server"
+  spec.version       = IsolatedServer::VERSION
+  spec.authors       = ["Ben Osheroff", "Gabe Martin-Dempesy"]
+  spec.email         = ["ben@zendesk.com", "gabe@zendesk.com"]
+  spec.description   = %q{A small library that allows you to easily spin up new local mysql servers for testing purposes.}
+  spec.summary       = %q{A small library that allows you to easily spin up new local mysql servers for testing purposes.}
+  spec.homepage      = "http://github.com/gabetax/isolated_server"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "appraisal"
+end

data/lib/isolated_server/base.rb

@@ -0,0 +1,117 @@
+require 'socket'
+
+module IsolatedServer
+  class Base
+    attr_reader :pid, :base, :port
+    attr_accessor :params
+
+    def initialize(options)
+      @base         = options[:base] || Dir.mktmpdir("isolated", "/tmp")
+      @params       = options[:params]
+      @port         = options[:port]
+      @allow_output = options[:allow_output]
+      @parent_pid   = options[:pid]
+    end
+
+    def locate_executable(*candidates)
+      output = `which #{candidates.shelljoin}`
+      raise "I couldn't find any of these: #{candidates.join(',')} in $PATH" if output.chomp.empty?
+      output.split("\n").first
+    end
+
+    def down!
+      Process.kill("HUP", @pid)
+      Process.wait
+      @cx = nil
+    end
+
+    def kill!
+      return unless @pid
+      Process.kill("TERM", @pid)
+    end
+
+    def cleanup!
+      system("rm -Rf #{base.shellescape}")
+    end
+
+    include Socket::Constants
+    def grab_free_port
+      while true
+        candidate=9000 + rand(50_000)
+
+        begin
+          socket = Socket.new(AF_INET, SOCK_STREAM, 0)
+          socket.bind(Socket.pack_sockaddr_in(candidate, '127.0.0.1'))
+          socket.close
+          return candidate
+        rescue Exception
+        end
+      end
+    end
+
+    def self.exec_wait(cmd, options = {})
+      allow_output = options[:allow_output] # default false
+      parent_pid = options[:parent_pid] || $$
+
+      fork do
+        exec_pid = fork do
+          if !allow_output
+            devnull = File.open("/dev/null", "w")
+            STDOUT.reopen(devnull)
+            STDERR.reopen(devnull)
+          end
+
+          exec(cmd)
+        end
+
+        # begin waiting for the parent (or mysql) to die; at_exit is hard to control when interacting with test/unit
+        # we can also be killed by our parent with down! and up!
+        #
+        ["TERM", "INT"].each do |sig|
+          trap(sig) do
+            if block_given?
+              yield(exec_pid)
+            else
+              Process.kill("KILL", exec_pid)
+            end
+
+            exit!
+          end
+        end
+
+        # HUP == down, but don't cleanup.
+        trap("HUP") do
+          Process.kill("KILL", exec_pid)
+          exit!
+        end
+
+        while true
+          begin
+            Process.kill(0, parent_pid)
+            Process.kill(0, exec_pid)
+          rescue Exception
+            if block_given?
+              yield(exec_pid)
+            else
+              Process.kill("KILL", exec_pid)
+            end
+
+            exit!
+          end
+
+          sleep 1
+        end
+      end
+    end
+
+    def exec_server(cmd)
+      cmd.strip!
+      cmd.gsub!(/\\\n/, ' ')
+
+      @pid = self.class.exec_wait(cmd, allow_output: @allow_output, parent_pid: @parent_pid) do |child_pid|
+        Process.kill("KILL", child_pid)
+        cleanup!
+      end
+    end
+  end
+end

data/lib/isolated_server/mongodb.rb

@@ -0,0 +1,61 @@
+require 'tmpdir'
+
+module IsolatedServer
+  class Mongodb < Base
+
+    attr_reader :dbpath, :port, :repl_set
+
+    def initialize(options = {})
+      super options
+      @dbpath         = FileUtils.mkdir("#{@base}/data").first
+    end
+
+    def boot!
+      @port ||= grab_free_port
+
+      up!
+    end
+
+    def up!
+      mongod = locate_executable("mongod")
+
+      exec_server([
+        mongod,
+        '--dbpath', @dbpath,
+        '--port', @port,
+        *@params
+      ].shelljoin)
+
+      until up?
+        sleep(0.1)
+      end
+    end
+
+    def up?
+      begin
+        connection.ping
+        true
+      rescue Mongo::ConnectionFailure
+        false
+      end
+    end
+
+    def connection
+      @connection ||= connection_klass.new('localhost', @port)
+    end
+
+    def connection_klass
+      if Kernel.const_defined?("Mongo::MongoClient")
+        # 1.8.0+
+        Mongo::MongoClient
+      else
+        # < 1.8.0
+        Mongo::Connection
+      end
+    end
+
+    def console
+      system(['mongo', '--port', @port].shelljoin)
+    end
+  end
+end

data/lib/isolated_server/mysql/jdbc_connection.rb

@@ -0,0 +1,52 @@
+require "java"
+java_import "java.sql.DriverManager"
+java_import "org.apache.commons.lang.StringEscapeUtils"
+
+module IsolatedServer
+  class Mysql < Base
+    class WrappedJDBCConnection
+      def initialize(port)
+        @cx ||= DriverManager.get_connection("jdbc:mysql://127.0.0.1:#{port}/mysql", "root", "")
+      end
+
+      def query(sql)
+        stmt = @cx.create_statement
+        if sql !~ /^select/i && sql !~ /^show/i
+          return stmt.execute(sql)
+        end
+
+        rs = stmt.execute_query(sql)
+
+        rows = []
+        while (rs.next)
+          meta_data = rs.get_meta_data
+          num_cols = meta_data.get_column_count
+
+          row = {}
+          1.upto(num_cols) do |col|
+            col_name = meta_data.get_column_label(col)
+            col_value = rs.get_object(col) # of meta_data.get_column_type(col)
+
+            row[col_name] = col_value
+          end
+
+          rows << row
+        end
+        rows
+      ensure
+        stmt.close if stmt
+        rs.close if rs
+      end
+
+      def escape(str)
+        StringEscapeUtils.escapeSql(str)
+      end
+    end
+
+    module DBConnection
+      def connection
+        @cx ||= WrappedJDBCConnection.new(@port)
+      end
+    end
+  end
+end

data/lib/isolated_server/mysql/mysql2_connection.rb

@@ -0,0 +1,10 @@
+module IsolatedServer
+  class Mysql < Base
+    module DBConnection
+      def connection
+        require 'mysql2'
+        @cx ||= Mysql2::Client.new(:host => "127.0.0.1", :port => @port, :username => "root", :password => "", :database => "mysql")
+      end
+    end
+  end
+end

data/lib/isolated_server/mysql.rb

@@ -0,0 +1,185 @@
+require 'isolated_server'
+
+if RUBY_PLATFORM == "java"
+  require 'isolated_server/mysql/jdbc_connection'
+else
+  require 'isolated_server/mysql/mysql2_connection'
+end
+
+require 'tmpdir'
+
+module IsolatedServer
+  class Mysql < Base
+
+    include DBConnection
+
+    attr_reader :server_id, :mysql_data_dir, :initial_binlog_file, :initial_binlog_pos
+
+    def initialize(options = {})
+      super options
+      @mysql_data_dir = "#{@base}/mysqld"
+      @mysql_socket   = "#{@mysql_data_dir}/mysqld.sock"
+      @load_data_path = options[:data_path]
+      @log_bin        = options[:log_bin] || "--log-bin"
+      @server_id      = rand(2**31)
+    end
+
+    # For JRuby
+    # @todo Extract and genericize more of this into `Base`
+    def self.thread_boot(*params)
+      bin = [File.dirname(__FILE__) + "/../bin/boot_isolated_mysql_server"]
+      mysql_dir, mysql_port = nil, nil
+      restore_env = {}
+
+      if `which ruby` =~ (/rvm/)
+        bin = ["rvm", "1.8.7", "do", "ruby"] + bin
+      end
+
+      params = ["--pid", $$.to_s] + params
+
+      Thread.abort_on_exception = true
+      Thread.new do
+        ENV.keys.grep(/GEM|BUNDLE|RUBYOPT/).each do |k|
+          restore_env[k] = ENV.delete(k)
+        end
+        IO.popen(bin + params, "r") do |pipe|
+          mysql_dir = pipe.readline.split(' ').last
+          mysql_port = pipe.readline.split(' ').last.to_i
+          sleep
+        end
+      end
+
+      while mysql_port.nil?
+        sleep 1
+      end
+      new(:port => mysql_port, :base => mysql_dir)
+    end
+
+    def boot!
+      @port ||= grab_free_port
+
+      setup_data_dir
+      setup_binlog
+      setup_tmp_dir
+
+      up!
+
+      record_initial_master_position
+
+      setup_time_zone
+      setup_server_id
+    end
+
+    def up!
+      exec_server([
+        locate_executable("mysqld"),
+        '--no-defaults',
+        '--default-storage-engine=innodb',
+        "--datadir=#{@mysql_data_dir}",
+        "--pid-file=#{@base}/mysqld.pid",
+        "--port=#{@port}",
+        "--socket=#{@mysql_data_dir}/mysql.sock",
+        @log_bin,
+        '--log-slave-updates',
+        *@params
+      ].shelljoin)
+
+      sleep(0.1) until up?
+    end
+
+    def up?
+      system("mysql -h127.0.0.1 --port=#{@port.to_s.shellescape} --database=mysql -u root -e 'select 1' >/dev/null 2>&1")
+    end
+
+    def console
+      system("mysql -uroot --port #{@port.to_s.shellescape} mysql --host 127.0.0.1")
+    end
+
+    def reconnect!
+      @cx = nil
+      connection
+    end
+
+    def make_slave_of(master)
+      binlog_file = master.initial_binlog_file || (@log_bin.split('/').last + ".000001")
+      binlog_pos = master.initial_binlog_pos || 4
+
+      connection.query(<<-EOL
+        CHANGE MASTER TO MASTER_HOST='127.0.0.1',
+                         MASTER_PORT=#{master.port},
+                         MASTER_USER='root', MASTER_PASSWORD='',
+                         MASTER_LOG_FILE='#{binlog_file}',
+                         MASTER_LOG_POS=#{binlog_pos}
+        EOL
+      )
+      connection.query("SLAVE START")
+      connection.query("SET GLOBAL READ_ONLY=1")
+    end
+
+    def set_rw(rw)
+      ro = rw ? 0 : 1
+      connection.query("SET GLOBAL READ_ONLY=#{ro}")
+    end
+
+    private
+
+    def setup_data_dir
+      system("rm -Rf #{@mysql_data_dir.shellescape}")
+      system("mkdir #{@mysql_data_dir.shellescape}")
+      if @load_data_path
+        system("cp -a #{@load_data_path.shellescape}/* #{@mysql_data_dir.shellescape}")
+        system("rm -f #{@mysql_data_dir.shellescape}/relay-log.info")
+      else
+        mysql_install_db = locate_executable("mysql_install_db")
+
+        idb_path = File.dirname(mysql_install_db)
+        system("(cd #{idb_path.shellescape}/..; mysql_install_db --datadir=#{@mysql_data_dir.shellescape} --user=`whoami`) >/dev/null 2>&1")
+        system("cp #{File.expand_path(File.dirname(__FILE__)).shellescape}/mysql/tables/user.* #{@mysql_data_dir.shellescape}/mysql")
+      end
+    end
+
+    def setup_binlog
+      if !@log_bin
+        @log_bin = "--log-bin"
+      else
+        if @log_bin[0] != '/'
+          binlog_dir = "#{@mysql_data_dir}/#{@log_bin}"
+        else
+          binlog_dir = @log_bin
+        end
+
+        system("mkdir -p #{binlog_dir.shellescape}")
+        @log_bin = "--log-bin=#{binlog_dir}"
+      end
+    end
+
+    # http://dev.mysql.com/doc/refman/5.0/en/temporary-files.html
+    def setup_tmp_dir
+      system("mkdir -p #{base.shellescape}/tmp")
+      system("chmod 0777 #{base.shellescape}/tmp")
+      ENV["TMPDIR"] = "#{base.shellescape}/tmp"
+    end
+
+    # http://dev.mysql.com/doc/refman/5.5/en/mysql-tzinfo-to-sql.html
+    def setup_time_zone
+      tzinfo_to_sql = locate_executable("mysql_tzinfo_to_sql5", "mysql_tzinfo_to_sql")
+      raise "could not find mysql_tzinfo_to_sql" unless tzinfo_to_sql
+      system("#{tzinfo_to_sql.shellescape} /usr/share/zoneinfo 2>/dev/null | mysql -h127.0.0.1 --database=mysql --port=#{@port.to_s.shellescape} -u root mysql")
+
+      begin
+        connection.query("SET GLOBAL time_zone='UTC'")
+      rescue Mysql2::Error
+        connection.query("SET GLOBAL time_zone='UTC'")
+      end
+    end
+
+    def setup_server_id
+      connection.query("SET GLOBAL server_id=#{@server_id}")
+    end
+
+    def record_initial_master_position
+      master_binlog_info = connection.query("show master status").first
+      @initial_binlog_file, @initial_binlog_pos = master_binlog_info.values_at('File', 'Position')
+    end
+  end
+end

data/lib/isolated_server/version.rb

@@ -0,0 +1,3 @@
+module IsolatedServer
+  VERSION = "0.4.2"
+end

data/lib/isolated_server.rb

@@ -0,0 +1,19 @@
+require 'isolated_server/base'
+require 'isolated_server/version'
+require 'shellwords'
+
+# Load support for databases if their corresponding gem is available
+begin
+  require 'mongo'
+  require 'isolated_server/mongodb'
+rescue LoadError
+end
+
+begin
+  require 'mysql2'
+  require 'isolated_server/mysql'
+rescue LoadError
+end
+
+module IsolatedServer
+end

data/spec/lib/isolated_server/mongodb_spec.rb

@@ -0,0 +1,25 @@
+require_relative '../../spec_helper'
+
+describe IsolatedServer::Mongodb do
+  subject { IsolatedServer::Mongodb.new }
+  let(:collection) { subject.connection['test_db']['test_col'] }
+  describe "#boot!" do
+    it "starts up a new server" do
+      subject.boot!
+      expect(subject.pid).to be_a_running_process
+
+      id = nil
+      expect { id = collection.insert(name: 'Bob') }.
+        to change { collection.count }.
+        from(0).
+        to(1)
+
+      result = collection.find_one(id)
+      expect(result['name']).to eq('Bob')
+
+      subject.down!
+      expect(subject.pid).not_to be_a_running_process
+      expect(subject).not_to be_up
+    end
+  end
+end

data/spec/lib/isolated_server/mysql_spec.rb

@@ -0,0 +1,79 @@
+require_relative '../../spec_helper'
+
+describe IsolatedServer::Mysql do
+  subject { IsolatedServer::Mysql.new }
+  describe "#boot!" do
+    it "starts up a new server" do
+      subject.boot!
+      expect(subject.pid).to be_a_running_process
+      expect(subject).to be_up
+
+      # Make sure we are connected, queryable, and reasonably confident that global variables match our expectations
+      expect(query_mysql_global_variable(subject, 'port').to_i).to          eq(subject.port)
+      expect(query_mysql_global_variable(subject, 'server_id').to_i).to     eq(subject.server_id)
+      expect(query_mysql_global_variable(subject, 'datadir').chomp('/')).to eq(subject.mysql_data_dir)
+      expect(query_mysql_global_variable(subject, 'time_zone')).to          eq('UTC')
+
+      expect { subject.set_rw(false) }.
+        to change { query_mysql_global_variable(subject, 'read_only') }.
+        from('OFF').
+        to('ON')
+
+      subject.down!
+      expect(subject.pid).not_to be_a_running_process
+      expect(subject).not_to be_up
+    end
+  end
+
+  describe "#make_slave_of" do
+    let(:master) { IsolatedServer::Mysql.new }
+    let(:slave)  { IsolatedServer::Mysql.new }
+    let(:db_name) { 'integration_test' }
+    let(:person_name) { 'Bob' }
+
+    it "sets establishes the relationship" do
+      master.boot!
+      slave.boot!
+
+      slave.make_slave_of(master)
+      sleep 0.1
+      expect(slave_status(slave)['Slave_IO_State']).to eq("Waiting for master to send event")
+
+      master.connection.query("CREATE DATABASE #{db_name}")
+      master.connection.select_db(db_name)
+      master.connection.query(create_table_sql)
+      master.connection.query("INSERT INTO people SET name = '#{person_name}'")
+      sleep 0.1
+
+      slave.connection.select_db(db_name)
+      slave_result = slave.connection.query('SELECT name FROM people').first
+      expect(slave_result['name']).to eq person_name
+
+      master.down!
+      slave.down!
+
+    end
+  end
+
+  def query_mysql_global_variable(isolated_database, key)
+    isolated_database.
+      connection.
+      query("SHOW GLOBAL VARIABLES LIKE '#{key}'").
+      first["Value"]
+  end
+
+  def slave_status(isolated_database)
+    isolated_database.connection.query('SHOW SLAVE STATUS').first
+  end
+
+    def create_table_sql
+      <<-eos
+CREATE TABLE `people` (
+  `id` int(11) NOT NULL AUTO_INCREMENT,
+  `name` varchar(255) DEFAULT NULL,
+  PRIMARY KEY (`id`)
+) ENGINE=InnoDB;
+eos
+    end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,83 @@
+require 'isolated_server'
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause this
+# file to always be loaded, without a need to explicitly require it in any files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, make a
+# separate helper file that requires this one and then use it only in the specs
+# that actually need it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+Dir[File.dirname(__FILE__) + "/support/**/*.rb"].sort.each { |f| require f }
+
+RSpec.configure do |config|
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+=begin
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # Enable only the newer, non-monkey-patching expect syntax.
+    # For more details, see:
+    #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+    expectations.syntax = :expect
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Enable only the newer, non-monkey-patching expect syntax.
+    # For more details, see:
+    #   - http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+    mocks.syntax = :expect
+
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended.
+    mocks.verify_partial_doubles = true
+  end
+=end
+end

data/spec/support/process_matcher.rb

@@ -0,0 +1,12 @@
+require 'rspec/expectations'
+
+RSpec::Matchers.define :be_a_running_process do
+  match do |pid|
+    begin
+      Process.kill 0, pid
+      true
+    rescue Errno::EPERM, Errno::ESRCH
+      false
+    end
+  end
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification
+name: isolated_server
+version: !ruby/object:Gem::Version
+  version: 0.4.2
+platform: ruby
+authors:
+- Ben Osheroff
+- Gabe Martin-Dempesy
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A small library that allows you to easily spin up new local mysql servers
+  for testing purposes.
+email:
+- ben@zendesk.com
+- gabe@zendesk.com
+executables:
+- boot_isolated_mysql_server
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Appraisals
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/boot_isolated_mysql_server
+- gemfiles/mongo_1.7.gemfile
+- gemfiles/mongo_latest.gemfile
+- isolated_server.gemspec
+- lib/isolated_server.rb
+- lib/isolated_server/base.rb
+- lib/isolated_server/mongodb.rb
+- lib/isolated_server/mysql.rb
+- lib/isolated_server/mysql/jdbc_connection.rb
+- lib/isolated_server/mysql/mysql2_connection.rb
+- lib/isolated_server/mysql/tables/user.MYD
+- lib/isolated_server/mysql/tables/user.MYI
+- lib/isolated_server/mysql/tables/user.frm
+- lib/isolated_server/version.rb
+- spec/lib/isolated_server/mongodb_spec.rb
+- spec/lib/isolated_server/mysql_spec.rb
+- spec/spec_helper.rb
+- spec/support/process_matcher.rb
+homepage: http://github.com/gabetax/isolated_server
+licenses: []
+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: A small library that allows you to easily spin up new local mysql servers
+  for testing purposes.
+test_files:
+- spec/lib/isolated_server/mongodb_spec.rb
+- spec/lib/isolated_server/mysql_spec.rb
+- spec/spec_helper.rb
+- spec/support/process_matcher.rb