fx 0.7.0 → 0.9.0

data/Appraisals

@@ -1,45 +0,0 @@
-if RUBY_VERSION < "2.6.0"
-  appraise "rails42" do
-    gem "activerecord", "~> 4.2.0"
-    gem "railties", "~> 4.2.0"
-    gem "pg", "~> 0.15.0"
-    gem "bigdecimal", "1.3.5"
-  end
-end
-
-if RUBY_VERSION >= "2.2.0" and RUBY_VERSION < "3.0.0"
-  appraise "rails50" do
-    gem "activerecord", "~> 5.0.0"
-    gem "railties", "~> 5.0.0"
-  end
-
-  appraise "rails51" do
-    gem "activerecord", "~> 5.1.0"
-    gem "railties", "~> 5.1.0"
-  end
-
-  appraise "rails52" do
-    gem "activerecord", "~> 5.2.0"
-    gem "railties", "~> 5.2.0"
-  end
-
-end
-
-if RUBY_VERSION >= "2.5.0"
-  appraise "rails60" do
-    gem "activerecord", "~> 6.0.0"
-    gem "railties", "~> 6.0.0"
-  end
-
-  appraise "rails61" do
-    gem "activerecord", "~> 6.1.0"
-    gem "railties", "~> 6.1.0"
-  end
-end
-
-if RUBY_VERSION >= "2.7.0"
-  appraise "rails-edge" do
-    gem "rails", github: "rails/rails", branch: "main"
-    gem "arel", :github => "rails/arel"
-  end
-end

data/bin/appraisal

@@ -1,17 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-#
-# This file was generated by Bundler.
-#
-# The application 'appraisal' is installed as part of a gem, and
-# this file is here to facilitate running it.
-#
-
-require "pathname"
-ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
-  Pathname.new(__FILE__).realpath)
-
-require "rubygems"
-require "bundler/setup"
-
-load Gem.bin_path("appraisal", "appraisal")

data/gemfiles/rails42.gemfile

@@ -1,10 +0,0 @@
-# This file was generated by Appraisal
-
-source "https://rubygems.org"
-
-gem "activerecord", "~> 4.2.0"
-gem "railties", "~> 4.2.0"
-gem "pg", "~> 0.15.0"
-gem "bigdecimal", "1.3.5"
-
-gemspec path: "../"

data/gemfiles/rails50.gemfile

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

data/gemfiles/rails51.gemfile

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

data/gemfiles/rails52.gemfile

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

data/gemfiles/rails60.gemfile

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

data/gemfiles/rails61.gemfile

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

data/gemfiles/rails_edge.gemfile

@@ -1,8 +0,0 @@
-# This file was generated by Appraisal
-
-source "https://rubygems.org"
-
-gem "rails", github: "rails/rails", branch: "main"
-gem "arel", github: "rails/arel"
-
-gemspec path: "../"

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,38 +0,0 @@
-require "rails"
-
-module Fx
-  module SchemaDumper
-    # @api private
-    module Function
-      def tables(stream)
-        if Fx.configuration.dump_functions_at_beginning_of_schema
-          functions(stream)
-          empty_line(stream)
-        end
-
-        super
-
-        unless Fx.configuration.dump_functions_at_beginning_of_schema
-          functions(stream)
-          empty_line(stream)
-        end
-      end
-
-      def empty_line(stream)
-        stream.puts if dumpable_functions_in_database.any?
-      end
-
-      def functions(stream)
-        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,115 +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_definition` 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, options = {})
-        version = options.fetch(:version, 1)
-        sql_definition = options[:sql_definition]
-
-        if version.nil? && sql_definition.nil?
-          raise(
-            ArgumentError,
-            "version or sql_definition must be specified",
-          )
-        end
-        sql_definition = sql_definition.strip_heredoc if sql_definition
-        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 2 on rollback
-      #   drop_function(:uppercase_users_name, revert_to_version: 2)
-      #
-      def drop_function(name, options = {})
-        revert_to_version = options[:revert_to_version]
-        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_definition` 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, options = {})
-        version = options[:version]
-        sql_definition = options[:sql_definition]
-        revert_to_version = options[:revert_to_version]
-
-        if version.nil? && sql_definition.nil?
-          raise(
-            ArgumentError,
-            "version or sql_definition must be specified",
-          )
-        end
-
-        sql_definition = sql_definition.strip_heredoc if sql_definition
-        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,146 +0,0 @@
-module Fx
-  module Statements
-    # Methods that are made available in migrations for managing Fx triggers.
-    module Trigger
-      # @api private
-      DEFINITION_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, options = {})
-        version = options[:version]
-        _on = options[:on]
-        sql_definition = options[:sql_definition]
-
-        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 = sql_definition.strip_heredoc if sql_definition
-        sql_definition ||= Fx::Definition.new(
-          name: name,
-          version: version,
-          type: DEFINITION_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, options = {})
-        on = options.fetch(:on)
-        revert_to_version = options[:revert_to_version]
-        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, options = {})
-        version = options[:version]
-        on = options[:on]
-        sql_definition = options[:sql_definition]
-        revert_to_version = options[:revert_to_version]
-
-        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 = sql_definition.strip_heredoc if sql_definition
-        sql_definition ||= Fx::Definition.new(
-          name: name,
-          version: version,
-          type: DEFINITION_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

data/spec/fx/schema_dumper/function_spec.rb

@@ -1,80 +0,0 @@
-require "spec_helper"
-
-describe Fx::SchemaDumper::Function, :db do
-  it "dumps a create_function for a function in the database" do
-    sql_definition = <<-EOS
-      CREATE OR REPLACE FUNCTION my_function()
-      RETURNS text AS $$
-      BEGIN
-          RETURN 'test';
-      END;
-      $$ LANGUAGE plpgsql;
-    EOS
-    connection.create_function :my_function, sql_definition: sql_definition
-    connection.create_table :my_table
-    stream = StringIO.new
-    output = stream.string
-
-    ActiveRecord::SchemaDumper.dump(connection, stream)
-
-    expect(output).to(
-      match(/table "my_table".*function :my_function.*RETURN 'test';/m),
-    )
-  end
-
-  it "dumps a create_function for a function in the database" do
-    begin
-      Fx.configuration.dump_functions_at_beginning_of_schema = true
-      sql_definition = <<-EOS
-        CREATE OR REPLACE FUNCTION my_function()
-        RETURNS text AS $$
-        BEGIN
-            RETURN 'test';
-        END;
-        $$ LANGUAGE plpgsql;
-      EOS
-      connection.create_function :my_function, sql_definition: sql_definition
-      connection.create_table :my_table
-      stream = StringIO.new
-      output = stream.string
-
-      ActiveRecord::SchemaDumper.dump(connection, stream)
-
-      expect(output).to(
-        match(/function :my_function.*RETURN 'test';.*table "my_table"/m),
-      )
-    ensure
-      Fx.configuration.dump_functions_at_beginning_of_schema = false
-    end
-  end
-
-  it "does not dump a create_function for aggregates in the database" do
-    sql_definition = <<-EOS
-      CREATE OR REPLACE FUNCTION test(text, text)
-      RETURNS text AS $$
-      BEGIN
-          RETURN 'test';
-      END;
-      $$ LANGUAGE plpgsql;
-    EOS
-
-    aggregate_sql_definition = <<-EOS
-      CREATE AGGREGATE aggregate_test(text)
-      (
-          sfunc = test,
-          stype = text
-      );
-    EOS
-
-    connection.create_function :test, sql_definition: sql_definition
-    connection.execute aggregate_sql_definition
-    stream = StringIO.new
-
-    ActiveRecord::SchemaDumper.dump(connection, stream)
-
-    output = stream.string
-    expect(output).to include "create_function :test, sql_definition: <<-'SQL'"
-    expect(output).to include "RETURN 'test';"
-    expect(output).not_to include "aggregate_test"
-  end
-end