historiographer 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 86529a3c7a63d3e483af58e83afbef705db737e51b437b07ca37e4b4af02f288
+  data.tar.gz: 16ecaf9cfebadfe4446f6b79f121907abc25160d84d6dc57374b185989d755e2
+SHA512:
+  metadata.gz: 164aa52bbf3238314d5d5c32956f6392c5d447b1c8bff5b54ba83e10d431d6b90c786ee187ebea1df2b63a03e9694a67163418e05a0c350f088a64213332d383
+  data.tar.gz: d86e11e66229aca81eaca8291d23393c72873c1bf8d8c194030b087796a2f5ae8123f4361f9dff59e1884301f12d2b15f1f82e3cd51bef0e0194add2618abc21

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/.ruby-version

@@ -0,0 +1 @@
+2.6.3

data/.standalone_migrations

@@ -0,0 +1,6 @@
+db:
+  seeds: spec/db/seeds.rb
+  migrate: spec/db/migrate
+  schema: spec/db/schema.rb
+config:
+  database: spec/db/database.yml

data/Gemfile

@@ -0,0 +1,29 @@
+source "https://rubygems.org"
+ruby "2.6.3"
+
+gem "activerecord", "~> 5.1"
+gem "activesupport"
+gem "rollbar"
+
+group :development, :test do
+  gem "pg"
+  gem "pry"
+  gem "mysql2", "0.4.10"
+  gem "standalone_migrations"
+  gem "timecop"
+  gem "paranoia"
+end
+
+group :development do
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0"
+  gem "jeweler"
+  gem "simplecov", ">= 0"
+end
+
+group :test do
+  gem "rspec"
+  gem "guard"
+  gem "guard-rspec"
+  gem "database_cleaner"
+end

data/Gemfile.lock

@@ -0,0 +1,196 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionpack (5.2.3)
+      actionview (= 5.2.3)
+      activesupport (= 5.2.3)
+      rack (~> 2.0)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    actionview (5.2.3)
+      activesupport (= 5.2.3)
+      builder (~> 3.1)
+      erubi (~> 1.4)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.0.3)
+    activemodel (5.2.3)
+      activesupport (= 5.2.3)
+    activerecord (5.2.3)
+      activemodel (= 5.2.3)
+      activesupport (= 5.2.3)
+      arel (>= 9.0)
+    activesupport (5.2.3)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    addressable (2.4.0)
+    arel (9.0.0)
+    builder (3.2.3)
+    coderay (1.1.2)
+    concurrent-ruby (1.1.5)
+    crass (1.0.4)
+    database_cleaner (1.7.0)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.3)
+    docile (1.3.2)
+    erubi (1.8.0)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    ffi (1.11.1)
+    formatador (0.2.5)
+    git (1.5.0)
+    github_api (0.16.0)
+      addressable (~> 2.4.0)
+      descendants_tracker (~> 0.0.4)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 3.4)
+      mime-types (>= 1.16, < 3.0)
+      oauth2 (~> 1.0)
+    guard (2.15.0)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, < 4.0)
+      lumberjack (>= 1.0.12, < 2.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.7.3)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    hashie (3.6.0)
+    highline (2.0.2)
+    i18n (1.6.0)
+      concurrent-ruby (~> 1.0)
+    jeweler (2.3.9)
+      builder
+      bundler
+      git (>= 1.2.5)
+      github_api (~> 0.16.0)
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      psych
+      rake
+      rdoc
+      semver2
+    json (1.8.6)
+    jwt (2.2.1)
+    listen (3.1.5)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+      ruby_dep (~> 1.2)
+    loofah (2.2.3)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.5.9)
+    lumberjack (1.0.13)
+    method_source (0.9.2)
+    mime-types (2.99.3)
+    mini_portile2 (2.4.0)
+    minitest (5.11.3)
+    multi_json (1.13.1)
+    multi_xml (0.6.0)
+    multipart-post (2.1.1)
+    mysql2 (0.4.10)
+    nenv (0.3.0)
+    nokogiri (1.10.4)
+      mini_portile2 (~> 2.4.0)
+    notiffany (0.1.3)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    oauth2 (1.4.1)
+      faraday (>= 0.8, < 0.16.0)
+      jwt (>= 1.0, < 3.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (>= 1.2, < 3)
+    paranoia (2.4.2)
+      activerecord (>= 4.0, < 6.1)
+    pg (1.1.4)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    psych (3.1.0)
+    rack (2.0.7)
+    rack-test (1.1.0)
+      rack (>= 1.0, < 3)
+    rails-dom-testing (2.0.3)
+      activesupport (>= 4.2.0)
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.2.0)
+      loofah (~> 2.2, >= 2.2.2)
+    railties (5.2.3)
+      actionpack (= 5.2.3)
+      activesupport (= 5.2.3)
+      method_source
+      rake (>= 0.8.7)
+      thor (>= 0.19.0, < 2.0)
+    rake (12.3.3)
+    rb-fsevent (0.10.3)
+    rb-inotify (0.10.0)
+      ffi (~> 1.0)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rollbar (2.21.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.2)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.4)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.2)
+    ruby_dep (1.5.0)
+    semver2 (3.4.2)
+    shellany (0.0.1)
+    simplecov (0.17.0)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    standalone_migrations (5.2.7)
+      activerecord (>= 4.2.7, < 5.3.0)
+      railties (>= 4.2.7, < 5.3.0)
+      rake (>= 10.0)
+    thor (0.20.3)
+    thread_safe (0.3.6)
+    timecop (0.9.1)
+    tzinfo (1.2.5)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activerecord (~> 5.1)
+  activesupport
+  bundler (~> 1.0)
+  database_cleaner
+  guard
+  guard-rspec
+  jeweler
+  mysql2 (= 0.4.10)
+  paranoia
+  pg
+  pry
+  rdoc (~> 3.12)
+  rollbar
+  rspec
+  simplecov
+  standalone_migrations
+  timecop
+
+RUBY VERSION
+   ruby 2.6.3p62
+
+BUNDLED WITH
+   1.17.2

data/Guardfile

@@ -0,0 +1,70 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+## Uncomment and set this to only include directories you want to watch
+# directories %w(app lib config test spec features) \
+#  .select{|d| Dir.exists?(d) ? d : UI.warning("Directory #{d} does not exist")}
+
+## Note: if you are using the `directories` clause above and you are not
+## watching the project directory ('.'), then you will want to move
+## the Guardfile to a watched dir and symlink it back, e.g.
+#
+#  $ mkdir config
+#  $ mv Guardfile config/
+#  $ ln -s config/Guardfile .
+#
+# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
+
+# Note: The cmd option is now required due to the increasing number of ways
+#       rspec may be run, below are examples of the most common uses.
+#  * bundler: 'bundle exec rspec'
+#  * bundler binstubs: 'bin/rspec'
+#  * spring: 'bin/rspec' (This will use spring if running and you have
+#                          installed the spring binstubs per the docs)
+#  * zeus: 'zeus rspec' (requires the server to be started separately)
+#  * 'just' rspec: 'rspec'
+
+guard :rspec, cmd: "bundle exec rspec" do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # Feel free to open issues for suggestions and improvements
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+
+  # Rails files
+  rails = dsl.rails(view_extensions: %w(erb haml slim))
+  dsl.watch_spec_files_for(rails.app_files)
+  dsl.watch_spec_files_for(rails.views)
+
+  watch(rails.controllers) do |m|
+    [
+      rspec.spec.call("routing/#{m[1]}_routing"),
+      rspec.spec.call("controllers/#{m[1]}_controller"),
+      rspec.spec.call("acceptance/#{m[1]}")
+    ]
+  end
+
+  # Rails config changes
+  watch(rails.spec_helper)     { rspec.spec_dir }
+  watch(rails.routes)          { "#{rspec.spec_dir}/routing" }
+  watch(rails.app_controller)  { "#{rspec.spec_dir}/controllers" }
+
+  # Capybara features specs
+  watch(rails.view_dirs)     { |m| rspec.spec.call("features/#{m[1]}") }
+  watch(rails.layouts)       { |m| rspec.spec.call("features/#{m[1]}") }
+
+  # Turnip features and steps
+  watch(%r{^spec/acceptance/(.+)\.feature$})
+  watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$}) do |m|
+    Dir[File.join("**/#{m[1]}.feature")][0] || "spec/acceptance"
+  end
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2016 Brett Shollenberger
+
+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,124 @@
+# historiographer
+
+Losing data sucks. Every time you update a record in Rails, by default, you lose the old data.
+
+Supported for PostgreSQL and MySQL. If you need other adapters, help us make one!
+
+## Existing auditing gems for Rails suck
+
+The Audited gem has some serious flaws. 
+
+First, it only tracks a record of what changed, so there's no way to "go back in time" and see what the data looked like back when a problem occurred without replaying every single audit.
+
+Second, it tracks changes as JSON. While some data stores have JSON querying semantics, not all do, making it very hard to ask complex questions of your historical data -- that's the whole reason you're keeping it around.
+
+Third, it doesn't maintain efficient indexes on your data. If you maintain an index on the primary records, wouldn't you also want to look up historical records using the same columns? Historical data is MUCH larger than "latest snapshot" data, so, duh, of course you do.
+
+Finally, Audited creates one table for every audit. As mentioned before, historical data is big. It's not unusual for an audited gem table to get into the many millions of rows, and need to be constnatly partitioned to maintain any kind of efficiency.
+
+## How does Historiographer solve the problem?
+
+You have existing code written in Rails, so our existing queries need to Just Work.
+
+Moreover, there are benefits to the Active Record model of updating records in place: the latest snapshot is cached, and accessing it is efficient.
+
+So how can we get the benefits of caching but NOT losing data, and continue to create, update, and destroy like we normally would in Rails?
+
+Historiographer introduces the concept of *history tables:* tables that have the exact same structure as tables storing the latest snapshots of data. So if you have a `posts` table, you'll also have a `post_histories` table with all the same columns and indexes.
+
+Whenever you include the `Historiographer` gem in your ActiveRecord model, it allows you to insert, update, or delete data as you normally would. If the changes are successful, it also inserts a new history snapshot in the histories table--an exact snapshot of the data at that point in time.
+
+These tables feature two useful indexes: `history_started_at` and `history_ended_at`, which allow you to see what the data looked like and when. You can easily create views which show the total lifecycle of a piece of data, or restore earlier versions directly from these snapshots.
+
+And of course, it contains a migrations tool to help you write the same migrations you normally would without having to worry about also synchronizing histories tables.
+
+# basic use
+
+## migrations
+
+You need a separate table to store histories for each model.
+
+So if you have a Posts model:
+
+```ruby
+class CreatePosts < ActiveRecord::Migration
+  def change
+    create_table :posts do |t|
+      t.string :title, null: false
+      t.boolean :enabled
+    end
+    add_index :posts, :enabled
+  end
+end
+```
+
+You should create a model named *posts_histories*:
+
+```ruby
+require "historiographer/postgres_migration"
+class CreatePostHistories < ActiveRecord::Migration
+  def change
+    create_table :post_histories do |t|
+      t.histories
+    end
+  end
+end
+```
+
+The `t.histories` method will automatically create a table with the following columns:
+
+* `id` (because every model has a primary key)
+* `post\_id` (because this is the foreign key)
+* `title` (because it was on the original model)
+* `enabled` (because it was on the original model)
+* `history\_started\_at` (to denote when this history became the canonical version)
+* `history\_ended\_at` (to denote when this history was no longer the canonical version, if it has stopped being the canonical version)
+* `history\_user\_id` (to denote the user that made this change, if one is known)
+
+Additionally it will add indices on:
+
+* The same columns that had indices on the original model (e.g. `enabled`)
+* `history\_started\_at`, `history\_ended\_at`, and `history\_user\_id`
+
+## models
+
+The primary model should include `Historiographer`:
+
+```ruby
+class Post
+  include Historiographer
+end
+```
+
+You should also make a `PostHistory` class if you're going to query `PostHistory` from Rails:
+
+```ruby
+class PostHistory
+end
+```
+
+The `Posts` class will acquire a `histories` method, and the `PostHistory` model will gain a `post` method:
+
+```ruby
+p = Post.first
+p.histories.first.class
+
+# => "PostHistory"
+
+p.histories.first.post == p
+# => true
+```
+
+The `histories` classes have a `current` method, which only finds current history records. These records will also be the same as the data in the primary table.
+
+```ruby
+p = Post.first
+p.current_history
+
+PostHistory.current
+```
+
+== Copyright
+
+Copyright (c) 2016-2018 brettshollenberger. See LICENSE.txt for
+further details.

data/Rakefile

@@ -0,0 +1,54 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+require 'pry'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+require 'jeweler'
+
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://guides.rubygems.org/specification-reference/ for more options
+  gem.name = "historiographer"
+  gem.homepage = "http://github.com/brettshollenberger/historiographer"
+  gem.license = "MIT"
+  gem.summary = %Q{Create histories of your ActiveRecord tables}
+  gem.description = %Q{Creates separate tables for each history table}
+  gem.email = "brett.shollenberger@gmail.com"
+  gem.authors = ["brettshollenberger"]
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'spec'
+  test.pattern = 'rspec/**/*_spec.rb'
+  test.verbose = true
+end
+
+desc "Code coverage detail"
+task :simplecov do
+  ENV['COVERAGE'] = "true"
+  Rake::Task['test'].execute
+end
+
+task :default => :test
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "historiographer #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+require 'standalone_migrations'
+StandaloneMigrations::Tasks.load_tasks

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/historiographer.gemspec

@@ -0,0 +1,108 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: historiographer 1.0.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "historiographer".freeze
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib".freeze]
+  s.authors = ["brettshollenberger".freeze]
+  s.date = "2019-08-22"
+  s.description = "Creates separate tables for each history table".freeze
+  s.email = "brett.shollenberger@gmail.com".freeze
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    ".ruby-version",
+    ".standalone_migrations",
+    "Gemfile",
+    "Gemfile.lock",
+    "Guardfile",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "historiographer.gemspec",
+    "init.rb",
+    "lib/historiographer.rb",
+    "lib/historiographer/history.rb",
+    "lib/historiographer/history_migration.rb",
+    "lib/historiographer/history_migration_mysql.rb",
+    "lib/historiographer/mysql_migration.rb",
+    "lib/historiographer/postgres_migration.rb",
+    "lib/historiographer/safe.rb",
+    "spec/db/database.yml",
+    "spec/db/migrate/20161121212228_create_posts.rb",
+    "spec/db/migrate/20161121212229_create_post_histories.rb",
+    "spec/db/migrate/20161121212230_create_authors.rb",
+    "spec/db/migrate/20161121212231_create_author_histories.rb",
+    "spec/db/migrate/20161121212232_create_users.rb",
+    "spec/db/migrate/20171011194624_create_safe_posts.rb",
+    "spec/db/migrate/20171011194715_create_safe_post_histories.rb",
+    "spec/db/schema.rb",
+    "spec/examples.txt",
+    "spec/historiographer_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = "http://github.com/brettshollenberger/historiographer".freeze
+  s.licenses = ["MIT".freeze]
+  s.rubygems_version = "3.0.3".freeze
+  s.summary = "Create histories of your ActiveRecord tables".freeze
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activerecord>.freeze, ["~> 5.1"])
+      s.add_runtime_dependency(%q<activesupport>.freeze, [">= 0"])
+      s.add_runtime_dependency(%q<rollbar>.freeze, [">= 0"])
+      s.add_development_dependency(%q<pg>.freeze, [">= 0"])
+      s.add_development_dependency(%q<pry>.freeze, [">= 0"])
+      s.add_development_dependency(%q<mysql2>.freeze, ["= 0.4.10"])
+      s.add_development_dependency(%q<standalone_migrations>.freeze, [">= 0"])
+      s.add_development_dependency(%q<timecop>.freeze, [">= 0"])
+      s.add_development_dependency(%q<paranoia>.freeze, [">= 0"])
+      s.add_development_dependency(%q<rdoc>.freeze, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>.freeze, ["~> 1.0"])
+      s.add_development_dependency(%q<jeweler>.freeze, [">= 0"])
+      s.add_development_dependency(%q<simplecov>.freeze, [">= 0"])
+    else
+      s.add_dependency(%q<activerecord>.freeze, ["~> 5.1"])
+      s.add_dependency(%q<activesupport>.freeze, [">= 0"])
+      s.add_dependency(%q<rollbar>.freeze, [">= 0"])
+      s.add_dependency(%q<pg>.freeze, [">= 0"])
+      s.add_dependency(%q<pry>.freeze, [">= 0"])
+      s.add_dependency(%q<mysql2>.freeze, ["= 0.4.10"])
+      s.add_dependency(%q<standalone_migrations>.freeze, [">= 0"])
+      s.add_dependency(%q<timecop>.freeze, [">= 0"])
+      s.add_dependency(%q<paranoia>.freeze, [">= 0"])
+      s.add_dependency(%q<rdoc>.freeze, ["~> 3.12"])
+      s.add_dependency(%q<bundler>.freeze, ["~> 1.0"])
+      s.add_dependency(%q<jeweler>.freeze, [">= 0"])
+      s.add_dependency(%q<simplecov>.freeze, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activerecord>.freeze, ["~> 5.1"])
+    s.add_dependency(%q<activesupport>.freeze, [">= 0"])
+    s.add_dependency(%q<rollbar>.freeze, [">= 0"])
+    s.add_dependency(%q<pg>.freeze, [">= 0"])
+    s.add_dependency(%q<pry>.freeze, [">= 0"])
+    s.add_dependency(%q<mysql2>.freeze, ["= 0.4.10"])
+    s.add_dependency(%q<standalone_migrations>.freeze, [">= 0"])
+    s.add_dependency(%q<timecop>.freeze, [">= 0"])
+    s.add_dependency(%q<paranoia>.freeze, [">= 0"])
+    s.add_dependency(%q<rdoc>.freeze, ["~> 3.12"])
+    s.add_dependency(%q<bundler>.freeze, ["~> 1.0"])
+    s.add_dependency(%q<jeweler>.freeze, [">= 0"])
+    s.add_dependency(%q<simplecov>.freeze, [">= 0"])
+  end
+end
+

data/init.rb

@@ -0,0 +1,18 @@
+require "yaml"
+
+Bundler.require(:default, :development, :test)
+
+Dir.glob(File.expand_path("lib/**/*.rb")).each do |file|
+  require file
+end
+
+database_config = YAML.load(File.open(File.expand_path("spec/db/database.yml")).read)
+
+env = ENV["HISTORIOGRAPHER_ENV"] || "development"
+
+db_env_config = database_config[env]
+
+if defined?(ActiveRecord::Base)
+  # new settings as specified here: https://devcenter.heroku.com/articles/concurrency-and-database-connections
+  ActiveRecord::Base.establish_connection(db_env_config)
+end