fx 0.1.0 → 0.11.0

data/gemfiles/rails42.gemfile.lock

@@ -1,130 +0,0 @@
-PATH
-  remote: ../
-  specs:
-    fx (0.1.0)
-      activerecord (>= 4.0.0)
-      railties (>= 4.0.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    actionpack (4.2.6)
-      actionview (= 4.2.6)
-      activesupport (= 4.2.6)
-      rack (~> 1.6)
-      rack-test (~> 0.6.2)
-      rails-dom-testing (~> 1.0, >= 1.0.5)
-      rails-html-sanitizer (~> 1.0, >= 1.0.2)
-    actionview (4.2.6)
-      activesupport (= 4.2.6)
-      builder (~> 3.1)
-      erubis (~> 2.7.0)
-      rails-dom-testing (~> 1.0, >= 1.0.5)
-      rails-html-sanitizer (~> 1.0, >= 1.0.2)
-    activemodel (4.2.6)
-      activesupport (= 4.2.6)
-      builder (~> 3.1)
-    activerecord (4.2.6)
-      activemodel (= 4.2.6)
-      activesupport (= 4.2.6)
-      arel (~> 6.0)
-    activesupport (4.2.6)
-      i18n (~> 0.7)
-      json (~> 1.7, >= 1.7.7)
-      minitest (~> 5.1)
-      thread_safe (~> 0.3, >= 0.3.4)
-      tzinfo (~> 1.1)
-    ammeter (1.1.3)
-      activesupport (>= 3.0)
-      railties (>= 3.0)
-      rspec-rails (>= 2.2)
-    appraisal (2.1.0)
-      bundler
-      rake
-      thor (>= 0.14.0)
-    arel (6.0.3)
-    builder (3.2.2)
-    coderay (1.1.1)
-    database_cleaner (1.5.3)
-    diff-lcs (1.2.5)
-    erubis (2.7.0)
-    i18n (0.7.0)
-    json (1.8.3)
-    loofah (2.0.3)
-      nokogiri (>= 1.5.9)
-    method_source (0.8.2)
-    mini_portile2 (2.0.0)
-    minitest (5.9.0)
-    nokogiri (1.6.7.2)
-      mini_portile2 (~> 2.0.0.rc2)
-    pg (0.18.4)
-    pry (0.10.3)
-      coderay (~> 1.1.0)
-      method_source (~> 0.8.1)
-      slop (~> 3.4)
-    rack (1.6.4)
-    rack-test (0.6.3)
-      rack (>= 1.0)
-    rails-deprecated_sanitizer (1.0.3)
-      activesupport (>= 4.2.0.alpha)
-    rails-dom-testing (1.0.7)
-      activesupport (>= 4.2.0.beta, < 5.0)
-      nokogiri (~> 1.6.0)
-      rails-deprecated_sanitizer (>= 1.0.1)
-    rails-html-sanitizer (1.0.3)
-      loofah (~> 2.0)
-    railties (4.2.6)
-      actionpack (= 4.2.6)
-      activesupport (= 4.2.6)
-      rake (>= 0.8.7)
-      thor (>= 0.18.1, < 2.0)
-    rake (11.1.2)
-    redcarpet (3.3.4)
-    rspec (3.4.0)
-      rspec-core (~> 3.4.0)
-      rspec-expectations (~> 3.4.0)
-      rspec-mocks (~> 3.4.0)
-    rspec-core (3.4.4)
-      rspec-support (~> 3.4.0)
-    rspec-expectations (3.4.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.4.0)
-    rspec-mocks (3.4.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.4.0)
-    rspec-rails (3.4.2)
-      actionpack (>= 3.0, < 4.3)
-      activesupport (>= 3.0, < 4.3)
-      railties (>= 3.0, < 4.3)
-      rspec-core (~> 3.4.0)
-      rspec-expectations (~> 3.4.0)
-      rspec-mocks (~> 3.4.0)
-      rspec-support (~> 3.4.0)
-    rspec-support (3.4.1)
-    slop (3.6.0)
-    thor (0.19.1)
-    thread_safe (0.3.5)
-    tzinfo (1.2.2)
-      thread_safe (~> 0.1)
-    yard (0.8.7.6)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  activerecord (~> 4.2.0)
-  ammeter (>= 1.1.3)
-  appraisal
-  bundler (>= 1.5)
-  database_cleaner
-  fx!
-  pg
-  pry
-  railties (~> 4.2.0)
-  rake
-  redcarpet
-  rspec (>= 3.3)
-  yard
-
-BUNDLED WITH
-   1.12.4

data/gemfiles/rails50.gemfile

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

data/gemfiles/rails50.gemfile.lock

@@ -1,126 +0,0 @@
-PATH
-  remote: ../
-  specs:
-    fx (0.1.0)
-      activerecord (>= 4.0.0)
-      railties (>= 4.0.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    actionpack (5.0.0.1)
-      actionview (= 5.0.0.1)
-      activesupport (= 5.0.0.1)
-      rack (~> 2.0)
-      rack-test (~> 0.6.3)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.0, >= 1.0.2)
-    actionview (5.0.0.1)
-      activesupport (= 5.0.0.1)
-      builder (~> 3.1)
-      erubis (~> 2.7.0)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.0, >= 1.0.2)
-    activemodel (5.0.0.1)
-      activesupport (= 5.0.0.1)
-    activerecord (5.0.0.1)
-      activemodel (= 5.0.0.1)
-      activesupport (= 5.0.0.1)
-      arel (~> 7.0)
-    activesupport (5.0.0.1)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (~> 0.7)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-    ammeter (1.1.3)
-      activesupport (>= 3.0)
-      railties (>= 3.0)
-      rspec-rails (>= 2.2)
-    appraisal (2.1.0)
-      bundler
-      rake
-      thor (>= 0.14.0)
-    arel (7.1.4)
-    builder (3.2.2)
-    coderay (1.1.1)
-    concurrent-ruby (1.0.2)
-    database_cleaner (1.5.3)
-    diff-lcs (1.2.5)
-    erubis (2.7.0)
-    i18n (0.7.0)
-    loofah (2.0.3)
-      nokogiri (>= 1.5.9)
-    method_source (0.8.2)
-    mini_portile2 (2.1.0)
-    minitest (5.9.1)
-    nokogiri (1.6.8.1)
-      mini_portile2 (~> 2.1.0)
-    pg (0.18.4)
-    pry (0.10.3)
-      coderay (~> 1.1.0)
-      method_source (~> 0.8.1)
-      slop (~> 3.4)
-    rack (2.0.1)
-    rack-test (0.6.3)
-      rack (>= 1.0)
-    rails-dom-testing (2.0.1)
-      activesupport (>= 4.2.0, < 6.0)
-      nokogiri (~> 1.6.0)
-    rails-html-sanitizer (1.0.3)
-      loofah (~> 2.0)
-    railties (5.0.0.1)
-      actionpack (= 5.0.0.1)
-      activesupport (= 5.0.0.1)
-      method_source
-      rake (>= 0.8.7)
-      thor (>= 0.18.1, < 2.0)
-    rake (11.2.2)
-    redcarpet (3.3.4)
-    rspec (3.5.0)
-      rspec-core (~> 3.5.0)
-      rspec-expectations (~> 3.5.0)
-      rspec-mocks (~> 3.5.0)
-    rspec-core (3.5.4)
-      rspec-support (~> 3.5.0)
-    rspec-expectations (3.5.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.5.0)
-    rspec-mocks (3.5.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.5.0)
-    rspec-rails (3.5.2)
-      actionpack (>= 3.0)
-      activesupport (>= 3.0)
-      railties (>= 3.0)
-      rspec-core (~> 3.5.0)
-      rspec-expectations (~> 3.5.0)
-      rspec-mocks (~> 3.5.0)
-      rspec-support (~> 3.5.0)
-    rspec-support (3.5.0)
-    slop (3.6.0)
-    thor (0.19.1)
-    thread_safe (0.3.5)
-    tzinfo (1.2.2)
-      thread_safe (~> 0.1)
-    yard (0.8.7.6)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  activerecord (~> 5.0)
-  ammeter (>= 1.1.3)
-  appraisal
-  bundler (>= 1.5)
-  database_cleaner
-  fx!
-  pg
-  pry
-  railties (~> 5.0)
-  rake
-  redcarpet
-  rspec (>= 3.3)
-  yard
-
-BUNDLED WITH
-   1.13.3

data/lib/fx/command_recorder/arguments.rb

@@ -1,43 +0,0 @@
-module Fx
-  module CommandRecorder
-    # @api private
-    class Arguments
-      def initialize(args)
-        @args = args.freeze
-      end
-
-      def function
-        @args[0]
-      end
-
-      def version
-        options[:version]
-      end
-
-      def revert_to_version
-        options[:revert_to_version]
-      end
-
-      def invert_version
-        Arguments.new([function, options_for_revert])
-      end
-
-      def to_a
-        @args.to_a
-      end
-
-      private
-
-      def options
-        @options ||= @args[1] || {}
-      end
-
-      def options_for_revert
-        options.clone.tap do |revert_options|
-          revert_options[:version] = revert_to_version
-          revert_options.delete(:revert_to_version)
-        end
-      end
-    end
-  end
-end

data/lib/fx/command_recorder/function.rb

@@ -1,30 +0,0 @@
-module Fx
-  module CommandRecorder
-    # @api private
-    module Function
-      def create_function(*args)
-        record(:create_function, args)
-      end
-
-      def drop_function(*args)
-        record(:drop_function, args)
-      end
-
-      def update_function(*args)
-        record(:update_function, args)
-      end
-
-      def invert_create_function(args)
-        [:drop_function, args]
-      end
-
-      def invert_drop_function(args)
-        perform_inversion(:create_function, args)
-      end
-
-      def invert_update_function(args)
-        perform_inversion(:update_function, args)
-      end
-    end
-  end
-end

data/lib/fx/command_recorder/trigger.rb

@@ -1,30 +0,0 @@
-module Fx
-  module CommandRecorder
-    # @api private
-    module Trigger
-      def create_trigger(*args)
-        record(:create_trigger, args)
-      end
-
-      def drop_trigger(*args)
-        record(:drop_trigger, args)
-      end
-
-      def update_trigger(*args)
-        record(:update_trigger, args)
-      end
-
-      def invert_create_trigger(args)
-        [:drop_trigger, args]
-      end
-
-      def invert_drop_trigger(args)
-        perform_inversion(:create_trigger, args)
-      end
-
-      def invert_update_trigger(args)
-        perform_inversion(:update_trigger, args)
-      end
-    end
-  end
-end

data/lib/fx/schema_dumper/function.rb

@@ -1,29 +0,0 @@
-require "rails"
-
-module Fx
-  module SchemaDumper
-    # @api private
-    module Function
-      def tables(stream)
-        super
-        functions(stream)
-      end
-
-      def functions(stream)
-        if dumpable_functions_in_database.any?
-          stream.puts
-        end
-
-        dumpable_functions_in_database.each do |function|
-          stream.puts(function.to_schema)
-        end
-      end
-
-      private
-
-      def dumpable_functions_in_database
-        @_dumpable_functions_in_database ||= Fx.database.functions
-      end
-    end
-  end
-end

data/lib/fx/schema_dumper/trigger.rb

@@ -1,29 +0,0 @@
-require "rails"
-
-module Fx
-  module SchemaDumper
-    # @api private
-    module Trigger
-      def tables(stream)
-        super
-        triggers(stream)
-      end
-
-      def triggers(stream)
-        if dumpable_triggers_in_database.any?
-          stream.puts
-        end
-
-        dumpable_triggers_in_database.each do |trigger|
-          stream.puts(trigger.to_schema)
-        end
-      end
-
-      private
-
-      def dumpable_triggers_in_database
-        @_dumpable_triggers_in_database ||= Fx.database.triggers
-      end
-    end
-  end
-end

data/lib/fx/statements/function.rb

@@ -1,105 +0,0 @@
-require "rails"
-
-module Fx
-  module Statements
-    # Methods that are made available in migrations for managing Fx functions.
-    module Function
-      # Create a new database function.
-      #
-      # @param name [String, Symbol] The name of the database function.
-      # @param version [Fixnum] The version number of the function, used to
-      #   find the definition file in `db/functions`. This defaults to `1` if
-      #   not provided.
-      # @param sql_definition [String] The SQL query for the function schema.
-      #   If both `sql_defintion` and `version` are provided,
-      #   `sql_definition` takes prescedence.
-      # @return The database response from executing the create statement.
-      #
-      # @example Create from `db/functions/uppercase_users_name_v02.sql`
-      #   create_function(:uppercase_users_name, version: 2)
-      #
-      # @example Create from provided SQL string
-      #   create_function(:uppercase_users_name, sql_definition: <<-SQL)
-      #     CREATE OR REPLACE FUNCTION uppercase_users_name()
-      #     RETURNS trigger AS $$
-      #     BEGIN
-      #       NEW.upper_name = UPPER(NEW.name);
-      #       RETURN NEW;
-      #     END;
-      #     $$ LANGUAGE plpgsql;
-      #   SQL
-      #
-      def create_function(name, version: 1, sql_definition: nil)
-        if version.nil? && sql_definition.nil?
-          raise(
-            ArgumentError,
-            "version or sql_definition must be specified",
-          )
-        end
-        sql_definition ||= Fx::Definition.new(name: name, version: version).to_sql
-
-        Fx.database.create_function(sql_definition)
-      end
-
-      # Drop a database function by name.
-      #
-      # @param name [String, Symbol] The name of the database function.
-      # @param revert_to_version [Fixnum] Used to reverse the `drop_function`
-      #   command on `rake db:rollback`. The provided version will be passed as
-      #   the `version` argument to {#create_function}.
-      # @return The database response from executing the drop statement.
-      #
-      # @example Drop a function, rolling back to version 3 on rollback
-      #   drop_function(:uppercase_users_name, on: :users, revert_to_version: 3)
-      #
-      def drop_function(name, revert_to_version: nil)
-        Fx.database.drop_function(name)
-      end
-
-      # Update a database function.
-      #
-      # @param name [String, Symbol] The name of the database function.
-      # @param version [Fixnum] The version number of the function, used to
-      #   find the definition file in `db/functions`. This defaults to `1` if
-      #   not provided.
-      # @param sql_definition [String] The SQL query for the function schema.
-      #   If both `sql_defintion` and `version` are provided,
-      #   `sql_definition` takes prescedence.
-      # @return The database response from executing the create statement.
-      #
-      # @example Update function to a given version
-      #   update_function(
-      #     :uppercase_users_name,
-      #     version: 3,
-      #     revert_to_version: 2,
-      #   )
-      #
-      # @example Update function from provided SQL string
-      #   update_function(:uppercase_users_name, sql_definition: <<-SQL)
-      #     CREATE OR REPLACE FUNCTION uppercase_users_name()
-      #     RETURNS trigger AS $$
-      #     BEGIN
-      #       NEW.upper_name = UPPER(NEW.name);
-      #       RETURN NEW;
-      #     END;
-      #     $$ LANGUAGE plpgsql;
-      #   SQL
-      #
-      def update_function(name, version: nil, sql_definition: nil, revert_to_version: nil)
-        if version.nil? && sql_definition.nil?
-          raise(
-            ArgumentError,
-            "version or sql_definition must be specified",
-          )
-        end
-
-        sql_definition ||= Fx::Definition.new(
-          name: name,
-          version: version,
-        ).to_sql
-
-        Fx.database.update_function(name, sql_definition)
-      end
-    end
-  end
-end

data/lib/fx/statements/trigger.rb

@@ -1,133 +0,0 @@
-module Fx
-  module Statements
-    # Methods that are made available in migrations for managing Fx triggers.
-    module Trigger
-      # @api private
-      DEFINTION_TYPE = "trigger".freeze
-
-      # Create a new database trigger.
-      #
-      # @param name [String, Symbol] The name of the database trigger.
-      # @param version [Fixnum] The version number of the trigger, used to
-      #   find the definition file in `db/triggers`. This defaults to `1` if
-      #   not provided.
-      # @param sql_definition [String] The SQL query for the function. An error
-      #   will be raised if `sql_definition` and `version` are both set,
-      #   as they are mutually exclusive.
-      # @return The database response from executing the create statement.
-      #
-      # @example Create trigger from `db/triggers/uppercase_users_name_v01.sql`
-      #   create_trigger(:uppercase_users_name, version: 1)
-      #
-      # @example Create trigger from provided SQL string
-      #   create_trigger(:uppercase_users_name, sql_definition: <<-SQL)
-      #     CREATE TRIGGER uppercase_users_name
-      #         BEFORE INSERT ON users
-      #         FOR EACH ROW
-      #         EXECUTE PROCEDURE uppercase_users_name();
-      #    SQL
-      #
-      def create_trigger(name, version: nil, on: nil, sql_definition: nil)
-        if version.present? && sql_definition.present?
-          raise(
-            ArgumentError,
-            "sql_definition and version cannot both be set",
-          )
-        end
-
-        if version.nil?
-          version = 1
-        end
-
-        sql_definition ||= Fx::Definition.new(
-          name: name,
-          version: version,
-          type: DEFINTION_TYPE,
-        ).to_sql
-
-        Fx.database.create_trigger(sql_definition)
-      end
-
-      # Drop a database trigger by name.
-      #
-      # @param name [String, Symbol] The name of the database trigger.
-      # @param on [String, Symbol] The name of the table the database trigger
-      #   is associated with.
-      # @param revert_to_version [Fixnum] Used to reverse the `drop_trigger`
-      #   command on `rake db:rollback`. The provided version will be passed as
-      #   the `version` argument to {#create_trigger}.
-      # @return The database response from executing the drop statement.
-      #
-      # @example Drop a trigger, rolling back to version 3 on rollback
-      #   drop_trigger(:log_inserts, on: :users, revert_to_version: 3)
-      #
-      def drop_trigger(name, on:, revert_to_version: nil)
-        Fx.database.drop_trigger(name, on: on)
-      end
-
-      # Update a database trigger to a new version.
-      #
-      # The existing trigger is dropped and recreated using the supplied `on`
-      # and `version` parameter.
-      #
-      # @param name [String, Symbol] The name of the database trigger.
-      # @param version [Fixnum] The version number of the trigger.
-      # @param on [String, Symbol] The name of the table the database trigger
-      #   is associated with.
-      # @param sql_definition [String] The SQL query for the function. An error
-      #   will be raised if `sql_definition` and `version` are both set,
-      #   as they are mutually exclusive.
-      # @param revert_to_version [Fixnum] The version number to rollback to on
-      #   `rake db rollback`
-      # @return The database response from executing the create statement.
-      #
-      # @example Update trigger to a given version
-      #   update_trigger(
-      #     :log_inserts,
-      #     on: :users,
-      #     version: 3,
-      #     revert_to_version: 2,
-      #   )
-      #
-      # @example Update trigger from provided SQL string
-      #   update_trigger(:uppercase_users_name, sql_definition: <<-SQL)
-      #     CREATE TRIGGER uppercase_users_name
-      #         BEFORE INSERT ON users
-      #         FOR EACH ROW
-      #         EXECUTE PROCEDURE uppercase_users_name();
-      #    SQL
-      #
-      def update_trigger(name, version: nil, on: nil, sql_definition: nil, revert_to_version: nil)
-        if version.nil? && sql_definition.nil?
-          raise(
-            ArgumentError,
-            "version or sql_definition must be specified",
-          )
-        end
-
-        if version.present? && sql_definition.present?
-          raise(
-            ArgumentError,
-            "sql_definition and version cannot both be set",
-          )
-        end
-
-        if on.nil?
-          raise ArgumentError, "on is required"
-        end
-
-        sql_definition ||= Fx::Definition.new(
-          name: name,
-          version: version,
-          type: DEFINTION_TYPE,
-        ).to_sql
-
-        Fx.database.update_trigger(
-          name,
-          on: on,
-          sql_definition: sql_definition,
-        )
-      end
-    end
-  end
-end

data/spec/fx/command_recorder/arguments_spec.rb

@@ -1,41 +0,0 @@
-require "spec_helper"
-
-module Fx::CommandRecorder
-  describe Arguments do
-    describe "#function" do
-      it "returns the function name" do
-        raw_args = [:spaceships, { foo: :bar }]
-        args = Arguments.new(raw_args)
-
-        expect(args.function).to eq :spaceships
-      end
-    end
-
-    describe "#revert_to_version" do
-      it "is the revert_to_version from the keyword arguments" do
-        raw_args = [:spaceships, { revert_to_version: 42 }]
-        args = Arguments.new(raw_args)
-
-        expect(args.revert_to_version).to eq 42
-      end
-
-      it "is nil if the revert_to_version was not supplied" do
-        raw_args = [:spaceships, { foo: :bar }]
-        args = Arguments.new(raw_args)
-
-        expect(args.revert_to_version).to be nil
-      end
-    end
-
-    describe "#invert_version" do
-      it "returns object with version set to revert_to_version" do
-        raw_args = [:meatballs, { version: 42, revert_to_version: 15 }]
-
-        inverted_args = Arguments.new(raw_args).invert_version
-
-        expect(inverted_args.version).to eq 15
-        expect(inverted_args.revert_to_version).to be nil
-      end
-    end
-  end
-end