fourthbase 2.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: bd2be60c1af12221277dfb4b05e54f06cfd84b8f
+  data.tar.gz: 420abbcb178d8ae078f5d11695fe8779f018c9aa
+SHA512:
+  metadata.gz: 9f678a82670b1a1c8884b88601bce4b3b90e94d4306c6b4db46b1a8984ca936c85fc3aa777ccb546e305678cd3779ca2c0e315e006114e43d46d887807e12956
+  data.tar.gz: 84ed1db17d83f2074da8dee51ace04c151c7089e161f8289ee20efef7e68826927c39b9a1c36663e575e7598398ae7ee4beab41d8fa92e4402964939f134cbd3

data/.gitignore

@@ -0,0 +1,11 @@
+doc/
+yard/
+.yardoc/
+vendor/
+pkg/
+.bundle/
+Gemfile.lock
+*.gemfile.lock
+*.log
+.idea
+.DS_Store

data/.travis.yml

@@ -0,0 +1,24 @@
+sudo: false
+cache: bundler
+rvm:
+  - 2.0
+  - 2.1
+  - 2.2.2
+  - 2.3.1
+gemfile:
+  - gemfiles/rails40.gemfile
+  - gemfiles/rails41.gemfile
+  - gemfiles/rails42.gemfile
+  - gemfiles/rails50.gemfile
+install:
+  - gem install bundler
+  - bundle --version
+  - bundle install
+script:
+  - bundle exec rake test
+matrix:
+  exclude:
+    - rvm: 2.0
+      gemfile: gemfiles/rails50.gemfile
+    - rvm: 2.1
+      gemfile: gemfiles/rails50.gemfile

data/.yardopts

@@ -0,0 +1 @@
+--exclude test/**/*.rb

data/Appraisals

@@ -0,0 +1,19 @@
+appraise 'rails40' do
+  gem 'rails', '~> 4.0.0'
+  gem 'mysql'
+end
+
+appraise 'rails41' do
+  gem 'rails', '~> 4.1.0'
+  gem 'mysql'
+end
+
+appraise 'rails42' do
+  gem 'rails', '~> 4.2.0'
+  gem 'mysql'
+end
+
+appraise 'rails50' do
+  gem 'rails', '~> 5.0.0.rc2'
+  gem 'mysql2'
+end

data/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Change Log
+
+Please follow the format set down in http://keepachangelog.com
+
+## 2.1.1
+
+Test updates to track rails 5 rc2.
+
+## 2.1.0
+
+Added the ability to disable the database task patching (thanks [@agrberg](https://github.com/agrberg))
+
+## 2.0.0
+
+Added Rails 5 support.
+
+## v1.0.1
+
+#### Fixed
+
+* Fix base Rails migration generator. Fixes #25.
+
+
+## v1.0
+
+Initial re-write supporting Rails 4.x. Please see README.md for full details.
+
+
+## v0.6
+
+Support for Rails 3.x. For 2.x support, check out the branch `rails_2_3` or version v0.5 of the gem.
+
+#### Fixed
+
+ * The `has_and_belongs_to_many` associations, for FourthBase models.
+ * Patched `ActiveRecord::TestFixtures` so that transactional fixture support is respected for the FourthBase.
+ * Reorganized monkey patches to make it easier to work in fixes for different versions of Rails.

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+Copyright (c) 2010 Karle Durante
+Copyright (c) 2016 CustomInk.com
+
+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,191 @@
+
+![FourthBase Logo](https://cloud.githubusercontent.com/assets/2381/12219457/5a5aab4e-b712-11e5-92e1-de6487aa0809.png)
+<hr>
+Seamless fourth database integration for Rails. FourthBase provides support for Rails to manage dual databases by extending ActiveRecord tasks that create, migrate, and test your databases.
+
+* [Using FourthBase To Provide Some Level Of Sanity](http://technology.customink.com/blog/2016/01/10/two-headed-cat-using-secondbase-to-provide-some-level-of-sanity-in-a-two-database-rails-application/)
+* [Rails Multi-Database Best Practices Roundup](http://technology.customink.com/blog/2015/06/22/rails-multi-database-best-practices-roundup/)
+
+[![Gem Version](https://badge.fury.io/rb/secondbase.png)](http://badge.fury.io/rb/secondbase)
+[![Build Status](https://travis-ci.org/customink/secondbase.svg?branch=master)](https://travis-ci.org/customink/secondbase)
+
+
+## Usage
+
+To get started with your new fourth database, update your database.yml to include a `fourthbase` config key. All FourthBase configurations per Rails environment go under this config key.
+
+```yaml
+# Default configurations:
+development:
+  adapter: sqlserver
+  database: myapp_development
+test:
+  adapter: sqlserver
+  database: myapp_test
+# FourthBase configurations:
+fourthbase:
+  development:
+    adapter: mysql
+    database: myapp_development
+  test:
+    adapter: mysql
+    database: myapp_test
+```
+
+#### Database Tasks
+
+FourthBase aims to work seamlessly within your Rails application. When it makes sense, we run a mirrored `db:fourth_base` task for matching ActiveRecord base database task. These can all be deactivated by setting `config.fourth_base.run_with_db_tasks = false` in your Application's configuration. For example:
+
+```shell
+$ rake db:create
+```
+
+This will not only create your base development database, but it will also create your fourth database as specified by the configuration within the `:fourthbase` section of your database.yml. Below is a complete list of `:db` tasks that automatically run a mirrored `:db:fourth_base` task. Some private or over lapping tasks, like schema dump/loading or `db:setup`, are not listed.
+
+* db:create
+* db:create:all
+* db:drop
+* db:drop:all
+* db:purge
+* db:purge:all
+* db:migrate
+* db:test:purge
+* db:test:prepare
+
+Not all base database tasks make sense to run a mirrored FourthBase task. These include tasks that move a single migration up/down, reporting on your database's current status/version, and others. These tasks have to be run explicitly and only operate on your FourthBase database. Each support any feature that their matching `:db` task has. For example, using `VERSION=123` to target a specific migration.
+
+* db:fourth_base:migrate:up
+* db:fourth_base:migrate:down
+* db:fourth_base:migrate:reset
+* db:fourth_base:migrate:redo
+* db:fourth_base:migrate:status
+* db:fourth_base:rollback
+* db:fourth_base:forward
+* db:fourth_base:version
+
+#### Migration Generator
+
+FourthBase migrations are stored in your application's `db/fourthbase/migrate` directory. Likewise, FourthBase will also dump your schema/structure file into the `db/fourthbase` directory. Full support for ActiveRecord's schema format being set to either `:ruby` or `:sql` is supported.
+
+Migrations can be generated using the `fourth_base:migration` name. Our generator is a subclass of ActiveRecord's. This means the FourthBase migration generator supports whatever features and arguments are supported by your current Rails version. For example:
+
+```shell
+$ rails generate fourth_base:migration CreateWidgetsTable
+$ rails generate fourth_base:migration AddTitleBodyToPost title:string body:text
+```
+
+#### Models
+
+Any model who's table resides in your fourth database needs to inherit from `FourthBase::Base`. ActiveRecord associations will still work between your base ActiveRecord and FourthBase models!
+
+```ruby
+class Widget < FourthBase::Base
+
+end
+
+class User < ActiveRecord::Base
+  has_many :widgets
+end
+```
+
+#### Forced Connections
+
+Sometimes you want to force a model that inherits from `ActiveRecord::Base` to use the `FourthBase::Base` connection. Using the `FourthBase::Forced` module is a great way to accomplish this. By using this module, we do all the work to ensure the connection, management, and pool are properly freedom patched.
+
+We recomend forcing modules using a Rails initializer. This example below forces both the [DelayedJob ActiveRecord Backend](https://github.com/collectiveidea/delayed_job_active_record) and ActiveRecord session store to use your FourthBase database.
+
+```ruby
+# In config/initializers/fourth_base.rb
+Delayed::Backend::ActiveRecord::Job.extend FourthBase::Forced
+ActiveRecord::SessionStore::Session.extend FourthBase::Forced
+```
+
+#### Testing & DB Synchronization
+
+Rails 4.2 brought about a new way to keep your test database in sync by checking schema migrations. Where previously forcing a full test database schema load, Rails 4.2 and up is able to run your tests much faster. In order for FourthBase to take advantage of this, you will need to include our test help file directly following the Rails one. Open your `test_helper.rb` and add our `fourth_base/test_help` after `rails/test_help`.
+
+```ruby
+ENV["RAILS_ENV"] = "test"
+require File.expand_path('../../config/environment', __FILE__)
+require 'rails/test_help'
+require 'fourth_base/test_help'
+```
+
+#### Configurations
+
+All FourthBase railtie settings are best done in a `config/application.rb` file. We support the following configurations:
+
+```ruby
+config.fourth_base.path        # Default: 'db/fourthbase'
+config.fourth_base.config_key  # Default: 'fourthbase'
+```
+
+* `path` - Used as location for migrations & schema. Path is relative to application root.
+* `config_key` - The key to in database.yml/configurations to search for FourthBase configs.
+
+
+## Advanced Usage
+
+#### Twelve-Factor & DATABASE_URL
+
+We love the [Twelve Factors](http://12factor.net) principals and using tools like Dotenv with Rails. Using FourthBase does not mean you have to abandon these best practices. You will however need to take advantage of a [new feature](https://github.com/rails/rails/pull/14633) in Rails 4.1 and upward that allows database.yml configurations to leverage a `:url` key that will resolve and merge the same connection string format consumed by `DATABASE_URL`. For example: 
+
+```yaml
+development:
+  database: encom-pg_development
+  url: <%= ENV.fetch('DATABASE_URL') %>
+test:
+  database: encom-pg_test
+  url: <%= ENV.fetch('DATABASE_URL') %>
+production:
+  url: <%= ENV.fetch('DATABASE_URL') %>
+
+fourthbase:
+  development:
+    database: encom-mysql_development
+    url: <%= ENV.fetch('DATABASE_URL_FOURTHBASE') %>
+  test:
+    database: encom-mysql_test
+    url: <%= ENV.fetch('DATABASE_URL_FOURTHBASE') %>
+  production:
+    url: <%= ENV.fetch('DATABASE_URL_FOURTHBASE') %>
+```
+
+There are many ways to use Dotenv and enviornment variables. This is only one example and we hope it helps you decide on which is best for you.
+
+#### The ActiveRecord Query Cache
+
+Rails only knows about your base connection for the Rack-based query cache. In order to take advantage of this feature for your FourthBase, you will need to set an arround filter in your controller.
+
+```ruby
+class ApplicationController < ActionController::Base
+  around_filter :query_cache_fourthBase
+  private
+  def query_cache_fourthBase
+    FourthBase::Base.connection.cache { yield }
+  end
+end
+```
+
+
+## Versions
+
+The current master branch is for Rails v4.0.0 and up and. We have older work in previous v1.0 releases which partial work for Rails 3.2 or lower. These old versions are feature incomplete and are not supported.
+
+
+## Contributing
+
+We use the [Appraisal](https://github.com/thoughtbot/appraisal) gem from Thoughtbot to help us test different versions of Rails. The `rake appraisal test` command actually runs our test suite against all Rails versions in our `Appraisal` file. So after cloning the repo, running the following commands.
+
+```shell
+$ bundle install
+$ bundle exec appraisal update
+$ bundle exec appraisal rake test
+```
+
+If you want to run the tests for a specific Rails version, use one of the appraisal names found in our `Appraisals` file. For example, the following will run our tests suite for Rails 4.1.x.
+
+```shell
+$ bundle exec appraisal rails41 rake test
+```
+

data/Rakefile

@@ -0,0 +1,24 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs = ['lib','test']
+  t.test_files = FileList['test/**/*_test.rb']
+  t.verbose = true
+end
+
+desc "Bootstrap development/test DB setup."
+task :bootstrap do
+  # ENV['DATBASE_URL'] = 'mysql://root@localhost/fourthbase_url'
+  require_relative './test/dummy_app/init'
+  require_relative './test/test_helpers/dummy_app_helpers'
+  include FourthBase::DummyAppHelpers
+  # dummy_root = File.expand_path "#{__dir__}/test/dummy_app"
+  Dir.chdir(dummy_root) { `rake db:create` }
+  delete_dummy_files
+end
+
+task :default do
+  Kernel.system 'appraisal update'
+  Kernel.system 'appraisal rake test'
+end

data/VERSION

@@ -0,0 +1 @@
+2.1.2

data/fourthbase.gemspec

@@ -0,0 +1,25 @@
+$:.push File.expand_path('../lib', __FILE__)
+require 'fourth_base/version'
+
+Gem::Specification.new do |s|
+  s.name          = 'fourthbase'
+  s.version       = FourthBase::VERSION
+  s.platform      = Gem::Platform::RUBY
+  s.authors       = ['Karle Durante', 'Hunter Madison', 'Ken Collins']
+  s.email         = ['kdurante@customink.com', 'hunterglenmadison@icloud.com', 'ken@metaskills.net']
+  s.homepage      = 'http://github.com/tommyalvarez/fourthbase'
+  s.summary       = 'Seamless fourth database integration for Rails.'
+  s.description   = "FourthBase provides support for Rails to manage dual databases by extending ActiveRecord tasks that create, migrate, and test your databases."
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
+  s.rdoc_options  = ['--charset=UTF-8']
+  s.license       = 'MIT'
+  s.add_runtime_dependency     'rails', '>= 4.0'
+  s.add_development_dependency 'appraisal'
+  s.add_development_dependency 'pry'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'sqlite3'
+  s.add_development_dependency 'yard'
+end

data/gemfiles/rails40.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 4.0.0"
+gem "mysql"
+
+gemspec :path => "../"

data/gemfiles/rails41.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 4.1.0"
+gem "mysql"
+
+gemspec :path => "../"

data/gemfiles/rails42.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 4.2.0"
+gem "mysql"
+
+gemspec :path => "../"

data/gemfiles/rails50.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 5.0.0.rc2"
+gem "mysql2"
+
+gemspec :path => "../"

data/lib/fourth_base.rb

@@ -0,0 +1,20 @@
+require 'rails'
+require 'active_record'
+require 'active_record/railtie'
+require 'fourth_base/version'
+require 'fourth_base/railtie'
+require 'fourth_base/on_base'
+require 'fourth_base/forced'
+
+module FourthBase
+
+  extend ActiveSupport::Autoload
+
+  autoload :Base
+
+  def self.config(env = nil)
+    config = ActiveRecord::Base.configurations[Railtie.config_key]
+    config ? config[env || Rails.env] : nil
+  end
+
+end