chrono_model 1.2.2 → 2.0.0

data/.travis.yml

@@ -1,41 +0,0 @@
-sudo: false
-
-language: ruby
-cache: bundler
-
-rvm:
-  - 2.3
-  - 2.4
-  - 2.5
-
-gemfile:
-  - gemfiles/rails_5.0.gemfile
-  - gemfiles/rails_5.1.gemfile
-  - gemfiles/rails_5.2.gemfile
-
-addons:
-  code_climate:
-    repo_token: dedfb7472ee410eec459bff3681d9a8fd8dd237e9bd7e8675a7c8eb7e253bba9
-
-  postgresql: "10"
-  apt:
-    packages:
-      - postgresql-10
-      - postgresql-client-10
-
-before_install:
-  - sudo sed -i -e '/local.*peer/s/postgres/all/' -e 's/peer\|md5/trust/g' /etc/postgresql/*/main/pg_hba.conf
-  - sudo /etc/init.d/postgresql restart
-  - sleep 2
-  - psql -c "CREATE DATABASE chronomodel;" -U postgres
-  - psql -c "CREATE DATABASE chronomodel_railsapp;" -U postgres
-
-env:
-  global:
-    - PGPORT=5433
-
-script:
-  - bundle exec rake TEST_CONFIG=./spec/config.travis.yml
-
-after_success:
-  - bundle exec codeclimate-test-reporter

data/Gemfile

@@ -1,4 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in chrono_model.gemspec
-gemspec

data/README.sql

@@ -1,161 +0,0 @@
-------------------------------------------------------
--- Temporal schema for an example "countries" relation
---
--- http://github.com/ifad/chronomodel
---
-create schema temporal; -- schema containing all temporal tables
-create schema history;  -- schema containing all history tables
-
--- Current countries data - nothing special
---
-create table temporal.countries (
-  id         serial primary key,
-  name       varchar,
-  updated_at timestamptz
-);
-
--- Countries historical data.
---
--- Inheritance is used to avoid duplicating the schema from the main table.
--- Please note that columns on the main table cannot be dropped, and other caveats
--- http://www.postgresql.org/docs/9.0/static/ddl-inherit.html#DDL-INHERIT-CAVEATS
---
-create table history.countries (
-  hid         serial primary key,
-  validity    tsrange,
-  recorded_at timestamp not null default timezone('UTC', now()),
-
-  constraint overlapping_times exclude using gist ( id with =, validity with && )
-
-) inherits ( temporal.countries );
-
--- Inherited primary key
-create index country_inherit_pkey on history.countries ( id );
-
--- Snapshot of data at a specific point in time
-create index country_snapshot on history.countries USING gist ( validity );
-
--- Used by the trigger functions when UPDATE'ing and DELETE'ing
-create index country_lower_validity on history.countries ( lower(validity) )
-create index country_upper_validity on history.countries ( upper(validity) )
-create index country_recorded_at    on history.countries ( id, valid_to )
-
--- Single instance whole history
-create index country_instance_history on history.countries ( id, recorded_at )
-
-
--- The countries view, what the Rails' application ORM will actually CRUD on,
--- and the entry point of the temporal triggers.
---
--- SELECT - return only current data
---
-create view public.countries as select * from only temporal.countries;
-
--- INSERT - insert data both in the current data table and in the history one.
---
-create or replace function public.chronomodel_countries_insert() returns trigger as $$
-  begin
-    if new.id is null then
-      new.id = nextval('temporal.countries_id_seq');
-    end if;
-
-    insert into temporal.countries ( id, name, updated_at )
-    values ( new.id, new.name, new.updated_at );
-
-    insert into history.countries (id, name, updated_at, validity )
-    values ( new.id, new.name, new.updated_at, tsrange(timezone('utc', now()), null) );
-
-    return new;
-  end;
-$$ language plpgsql;
-
-create trigger chronomodel_insert
-  instead of insert on public.countries
-  for each row execute procedure public.chronomodel_countries_insert();
-
--- UPDATE - set the last history entry validity to now, save the current data
--- in a new history entry and update the temporal table with the new data.
---
--- If a row in the history with the current ID and current timestamp already
--- exists, update it with new data. This logic makes possible to "squash"
--- together changes made in a transaction in a single history row.
---
--- If the update doesn't change the data, it is skipped and the trigger
--- returns NULL.
---
--- By default, history is not recorded if only the updated_at field
--- is changed.
---
-create function chronomodel_countries_update() returns trigger as $$
-  declare _now timestamp;
-  declare _hid integer;
-  declare _old record;
-  declare _new record;
-  begin
-  
-    if old is not distinct from new then
-      return null;
-    end if;
-
-    _old := row(old.name);
-    _new := row(new.name);
-
-    if _old is not distinct from new then
-      update only temporal.countries set ( name, updated_at ) = ( new.name, new.updated_at ) where id = old.id
-      return new;
-    end if;
-
-    _now := timezone('utc', now());
-    _hid := null;
-
-    select hid into _hid from history.countries where id = old.id and lower(validity) = _now;
-
-    if _hid is not null then
-      update history.countries set ( name, updated_at ) = ( new.name ) where hid = _hid;
-    else
-      update history.countries set validity = tsrange(lower(validity), _now)
-      where id = old.id and upper_inf(validity);
-
-      insert into history.countries ( id, name, updated_at, validity )
-      values ( old.id, new.name, new.updated_at, tsrange(_now, null) );
-    end if;
-
-    update only temporal.countries set ( name ) = ( new.name ) where id = old.id;
-
-    return new;
-  end;
-$$ language plpgsql;
-
-create trigger chronomodel_update
-  instead of update on temporal.countries
-  for each row execute procedure chronomodel_countries_update();
-
--- DELETE - save the current data in the history and eventually delete the
--- data from the temporal table.
---
--- The first DELETE is required to remove history for records INSERTed and
--- DELETEd in the same transaction.
---
-create or replace function chronomodel_countries_delete() returns trigger as $$
-  declare _now timestamp;
-  begin
-    _now := timezone('utc', now());
-
-    delete from history.countries
-    where id = old.id and validity = tsrange(_now, null);
-
-    update history.countries set valid_to = _now
-    where id = old.id and upper_inf(validity);
-
-    delete from only temporal.countries
-    where temporal.id = old.id;
-
-    return old;
-  end;
-$$ language plpgsql;
-
-create trigger chronomodel_delete
-  instead of delete on temporal.countries
-  for each row execute procedure chronomodel_countries_delete();
-
--- EOF

data/Rakefile

@@ -1,25 +0,0 @@
-#!/usr/bin/env rake
-require "bundler/gem_tasks"
-
-# RSpec
-require 'rspec/core/rake_task'
-RSpec::Core::RakeTask.new do |spec|
-  spec.rspec_opts = '-f doc'
-end
-task :default => ['testapp:create', :spec]
-
-# Create a test Rails app in tmp/railsapp for testing the rake
-# tasks and overall Rails integration with Aruba.
-#
-namespace :testapp do
-  desc 'Create a dummy rails application for testing in /tmp'
-  task :create do
-    FileUtils.mkdir_p('tmp/aruba')
-    Dir.chdir('tmp') do
-      FileUtils.rm_rf('railsapp')
-      sh 'rails new railsapp --skip-bundle'
-    end
-    FileUtils.cp_r('spec/aruba/fixtures/railsapp/.', 'tmp/railsapp/')
-    FileUtils.rm('tmp/railsapp/Gemfile')
-  end
-end

data/chrono_model.gemspec

@@ -1,33 +0,0 @@
-# -*- encoding: utf-8 -*-
-require File.expand_path('../lib/chrono_model/version', __FILE__)
-
-Gem::Specification.new do |gem|
-  gem.authors       = ['Marcello Barnaba', 'Peter Joseph Brindisi']
-  gem.email         = ['vjt@openssl.it', 'p.brindisi@ifad.org']
-  gem.description   = %q{Give your models as-of date temporal extensions. Built entirely for PostgreSQL >= 9.3}
-  gem.summary       = %q{Temporal extensions (SCD Type II) for Active Record}
-  gem.homepage      = 'https://github.com/ifad/chronomodel'
-
-  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  gem.files         = `git ls-files`.split("\n")
-  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  gem.name          = "chrono_model"
-  gem.require_paths = ["lib"]
-  gem.version       = ChronoModel::VERSION
-
-  gem.add_dependency 'activerecord', '>= 5.0.0'
-  gem.add_dependency "pg"
-  gem.add_dependency "multi_json"
-
-  gem.add_development_dependency 'rails'
-  gem.add_development_dependency 'aruba'
-  gem.add_development_dependency 'pry'
-  gem.add_development_dependency 'hirb'
-  gem.add_development_dependency 'byebug'
-  gem.add_development_dependency 'rspec'
-  gem.add_development_dependency 'rake'
-  gem.add_development_dependency 'fuubar'
-  gem.add_development_dependency 'simplecov'
-  gem.add_development_dependency 'codeclimate-test-reporter'
-end
-

data/gemfiles/rails_5.0.gemfile

@@ -1,6 +0,0 @@
-source "https://rubygems.org"
-
-gem "activerecord", "~> 5.0.0"
-gem "rails", "~> 5.0.0"
-
-gemspec :path => "../"

data/gemfiles/rails_5.1.gemfile

@@ -1,6 +0,0 @@
-source "https://rubygems.org"
-
-gem "activerecord", "~> 5.1.0"
-gem "rails", "~> 5.1.0"
-
-gemspec :path => "../"

data/gemfiles/rails_5.2.gemfile

@@ -1,6 +0,0 @@
-source "https://rubygems.org"
-
-gem "activerecord", "~> 5.2.0"
-gem "rails", "~> 5.2.0"
-
-gemspec :path => "../"

data/spec/aruba/dbconsole_spec.rb

@@ -1,25 +0,0 @@
-# The db consle does not work on Rails 5.0
-#
-unless Bundler.default_gemfile.to_s =~ /rails_5.0/
-
-
-require 'spec_helper'
-
-describe 'rails dbconsole' do
-  before do
-    write_file(
-      'config/database.yml',
-      File.read(File.expand_path('fixtures/database_without_username_and_password.yml', __dir__)))
-  end
-
-  describe 'rails dbconsole', type: :aruba do
-    let(:action) { run_command("bash -c \"echo 'select 1 as foo_column; \\q' | bundle exec rails db\"") }
-    let(:last_command) { action && last_command_started }
-
-    specify { expect(last_command).to be_successfully_executed }
-    specify { expect(last_command).to have_output(/\bfoo_column\b/) }
-  end
-end
-
-
-end

data/spec/aruba/fixtures/database_with_default_username_and_password.yml

@@ -1,14 +0,0 @@
-default: &default
-  username: postgres
-  password: ""
-  adapter: chronomodel
-  encoding: unicode
-  pool: 20
-  database: chronomodel_railsapp
-
-development:
-  <<: *default
-
-test:
-  <<: *default
-

data/spec/aruba/fixtures/database_without_username_and_password.yml

@@ -1,11 +0,0 @@
-default: &default
-  adapter: chronomodel
-  encoding: unicode
-  pool: 20
-  database: chronomodel_railsapp
-
-development:
-  <<: *default
-
-test:
-  <<: *default

data/spec/aruba/fixtures/empty_structure.sql

@@ -1,27 +0,0 @@
-SET statement_timeout = 0;
-SET lock_timeout = 0;
-SET client_encoding = 'UTF8';
-SET standard_conforming_strings = on;
-SET check_function_bodies = false;
-SET client_min_messages = warning;
-
---
--- Name: plpgsql; Type: EXTENSION; Schema: -; Owner: -
---
-
-CREATE EXTENSION IF NOT EXISTS plpgsql WITH SCHEMA pg_catalog;
-
-
---
--- Name: EXTENSION plpgsql; Type: COMMENT; Schema: -; Owner: -
---
-
-COMMENT ON EXTENSION plpgsql IS 'PL/pgSQL procedural language';
-
-
---
--- PostgreSQL database dump complete
---
-
-SET search_path TO "$user", public;
-

data/spec/aruba/fixtures/migrations/56/20160812190335_create_impressions.rb

@@ -1,10 +0,0 @@
-class CreateImpressions < ActiveRecord::Migration[5.0]
-  def change
-    create_table :impressions do |t|
-      t.integer :response
-      t.decimal :amount
-
-      t.timestamps
-    end
-  end
-end

data/spec/aruba/fixtures/migrations/56/20171115195229_add_temporal_extension_to_impressions.rb

@@ -1,10 +0,0 @@
-class AddTemporalExtensionToImpressions < ActiveRecord::Migration[5.0]
-  def self.up
-    enable_extension 'btree_gist' unless extension_enabled?('btree_gist')
-    change_table :impressions, temporal: true, copy_data: true
-  end
-
-  def self.down
-    change_table :impressions, temporal: false
-  end
-end

data/spec/aruba/fixtures/railsapp/config/application.rb

@@ -1,17 +0,0 @@
-require_relative 'boot'
-
-require 'rails/all'
-
-# Require the gems listed in Gemfile, including any gems
-# you've limited to :test, :development, or :production.
-Bundler.require(*Rails.groups)
-
-module Railsapp
-  class Application < Rails::Application
-    # Initialize configuration defaults for originally generated Rails version.
-    config.active_record.schema_format = :sql
-    # Settings in config/environments/* take precedence over those specified here.
-    # Application configuration should go into files in config/initializers
-    # -- all .rb files in that directory are automatically loaded.
-  end
-end

data/spec/aruba/fixtures/railsapp/config/boot.rb

@@ -1,5 +0,0 @@
-# Set up gems listed in the Gemfile.
-ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../../Gemfile', __dir__)
-
-require 'bundler/setup' if File.exist?(ENV['BUNDLE_GEMFILE'])
-$LOAD_PATH.unshift File.expand_path('../../../lib', __dir__)

data/spec/aruba/fixtures/railsapp/config/environments/development.rb

@@ -1,38 +0,0 @@
-Rails.application.configure do
-  # Settings specified here will take precedence over those in config/application.rb.
-
-  # In the development environment your application's code is reloaded on
-  # every request. This slows down response time but is perfect for development
-  # since you don't have to restart the web server when you make code changes.
-  config.cache_classes = false
-
-  # Do not eager load code on boot.
-  config.eager_load = false
-
-  # Show full error reports.
-  config.consider_all_requests_local = true
-
-  # Don't care if the mailer can't send.
-  config.action_mailer.raise_delivery_errors = false
-
-  # Print deprecation notices to the Rails logger.
-  config.active_support.deprecation = :log
-
-  # Raise an error on page load if there are pending migrations.
-  config.active_record.migration_error = :page_load
-
-  # Debug mode disables concatenation and preprocessing of assets.
-  # This option may cause significant delays in view rendering with a large
-  # number of complex assets.
-  config.assets.debug = true
-
-  # Suppress logger output for asset requests.
-  config.assets.quiet = true
-
-  # Raises error for missing translations
-  # config.action_view.raise_on_missing_translations = true
-
-  # Use an evented file watcher to asynchronously detect changes in source code,
-  # routes, locales, etc. This feature depends on the listen gem.
-  # config.file_watcher = ActiveSupport::EventedFileUpdateChecker
-end

data/spec/aruba/migrations_spec.rb

@@ -1,48 +0,0 @@
-require 'spec_helper'
-
-describe 'database migrations', type: :aruba do
-  context 'after a migration was generated' do
-    before { write_file('config/database.yml',
-      File.read(File.expand_path('fixtures/database_without_username_and_password.yml', __dir__))) }
-
-    before { run_command_and_stop('bundle exec rails g migration CreateModels name:string') }
-
-    describe 'bundle exec rake db:migrate' do
-      let(:action) { run_command('bundle exec rake db:migrate') }
-      let(:last_command) { action && last_command_started }
-
-      specify { expect(last_command).to be_successfully_executed }
-      specify { expect(last_command).to have_output(/CreateModels: migrated/) }
-    end
-  end
-
-
-  describe 'rerun bundle exec rake db:drop db:create db:migrate', issue: 56 do
-    let(:command) { 'bundle exec rake db:drop db:create db:migrate' }
-    before do
-      copy(
-        '../../spec/aruba/fixtures/database_without_username_and_password.yml',
-        'config/database.yml'
-      )
-      copy(
-        '../../spec/aruba/fixtures/migrations/56/',
-        'db/migrate'
-      )
-    end
-
-    let(:action) { run_command(command) }
-    let(:regex) { /-- change_table\(:impressions, {:temporal=>true, :copy_data=>true}\)/ }
-
-    describe 'once' do
-      let(:last_command) { action && last_command_started }
-      specify { expect(last_command).to be_successfully_executed }
-      specify { expect(last_command).to have_output(regex) }
-    end
-
-    describe 'twice' do
-      let(:last_command) { run_command_and_stop(command) && action && last_command_started }
-      specify { expect(last_command).to be_successfully_executed }
-      specify { expect(last_command).to have_output(regex) }
-    end
-  end
-end

data/spec/aruba/rake_task_spec.rb

@@ -1,71 +0,0 @@
-require 'spec_helper'
-
-# add :announce_stdout, :announce_stderr, before the type: aruba tag in order
-# to see the commmands' stdout and stderr output.
-#
-describe 'rake tasks', type: :aruba do
-  describe 'bundle exec rake -T' do
-    before { run_command_and_stop('bundle exec rake -T') }
-    subject { last_command_started }
-
-    it { is_expected.to have_output(/db:structure:load/) }
-  end
-
-  describe 'db:structure:load' do
-    let(:action) { run_command('bundle exec rake db:structure:load') }
-    let(:last_command) { action && last_command_started }
-
-    context 'given a file db/structure.sql' do
-      let(:structure_sql) { 'fixtures/empty_structure.sql' }
-      before { write_file('db/structure.sql', File.read(File.expand_path(structure_sql, __dir__))) }
-      before { write_file('config/database.yml', File.read(File.expand_path(database_yml, __dir__))) }
-
-      subject { expect(last_command).to be_successfully_executed }
-
-      context 'with default username and password', issue: 55 do
-        let(:database_yml) { 'fixtures/database_with_default_username_and_password.yml' }
-
-        # Handle Homebrew on MacOS, whose database superuser name is
-        # equal to the name of the current user.
-        #
-        before do
-          if which 'brew'
-            file_mangle!('config/database.yml') do |contents|
-              contents.sub('username: postgres', "username: #{Etc.getlogin}")
-            end
-          end
-        end
-
-        specify { subject }
-      end
-
-      context 'without a specified username and password', issue: 55 do
-        let(:database_yml) { 'fixtures/database_without_username_and_password.yml' }
-
-        specify { subject }
-      end
-    end
-  end
-
-  describe 'db:data:dump' do
-    let(:database_yml) { 'fixtures/database_without_username_and_password.yml' }
-    before { write_file('config/database.yml', File.read(File.expand_path(database_yml, __dir__))) }
-
-    before { run_command_and_stop('bundle exec rake db:data:dump DUMP=db/test.sql') }
-
-    it { expect(last_command_started).to be_successfully_executed }
-    it { expect('db/test.sql').to be_an_existing_file }
-  end
-
-  describe 'db:data:load' do
-    let(:database_yml) { 'fixtures/database_without_username_and_password.yml' }
-    before { write_file('config/database.yml', File.read(File.expand_path(database_yml, __dir__))) }
-
-    let(:structure_sql) { 'fixtures/empty_structure.sql' }
-    before { write_file('db/test.sql', File.read(File.expand_path(structure_sql, __dir__))) }
-
-    before { run_command_and_stop('bundle exec rake db:data:load DUMP=db/test.sql') }
-
-    it { expect(last_command_started).to be_successfully_executed }
-  end
-end