fx-sqlserver-adapter 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b8ad3b063af5510ece9b0e43abac26c1dcf9e704614722ad700f7ee677af7da5
+  data.tar.gz: c42e672daa3bc810c8318ad4386597cf769b51364fe50838672669326a9ae9e0
+SHA512:
+  metadata.gz: 703f7997526b87f34e9cbcff8808abca22f192cea53fb0b53b4ed63de417e02feaa32716649aec5bf13ff162b5bc8de55630466266dda66fdd170a0b2b0e5c14
+  data.tar.gz: ef61aa2b87bc31da67fe41d34df6907387c5411e1b829172543652e6320f9690fdd72b4ef4f2b8cabe2501267b8bd3aa00c5976d637f62a0564f61df68fa7aad

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/gemfiles/*.gemfile.lock
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,73 @@
+require:
+  - rubocop-performance
+  - rubocop-rspec
+
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 2.7
+  Exclude:
+    - '.bundle/*'
+    - '**.gem'
+    - '**.gemspec'
+    - 'Gemfile'
+    - 'Guardfile'
+    - 'Rakefile'
+    - '.**'
+    - 'bin/**/*'
+    - 'cache/ruby/**/*'
+    - 'coverage/**/*'
+    - 'docs/**/*'
+    - 'pkg/**/*'
+    - 'tmp/**'
+    - 'vendor/**/*'
+    - '**/*.tt'
+    - '**.yml'
+    - '**/**.bak'
+  UseCache: false
+
+Layout/EmptyLinesAroundAttributeAccessor:
+  Enabled: false
+Layout/LineLength:
+  AllowURI: true
+  Enabled: false
+Lint/DuplicateMethods:
+  Enabled: false
+Lint/NonDeterministicRequireOrder:
+  Enabled: false
+Metrics/AbcSize:
+  Max: 42
+  Enabled: false
+Metrics/ClassLength:
+  Enabled: false
+Metrics/CyclomaticComplexity:
+  Max: 12
+  Enabled: false
+Metrics/MethodLength:
+  CountComments: false
+  Max: 43
+Metrics/ModuleLength:
+  Max: 164
+Metrics/PerceivedComplexity:
+  Max: 18
+# Naming/AccessorMethodName is disabled because of overriding some default rails methods
+Naming/AccessorMethodName:
+  Enabled: false
+Naming/FileName:
+  Enabled: false
+Naming/MemoizedInstanceVariableName:
+  Enabled: false
+Style/Documentation:
+  Enabled: false
+Style/EmptyMethod:
+  EnforcedStyle: expanded
+Style/FrozenStringLiteralComment:
+  Description: ">- Apply frozen_string_literal to the top of ruby files\nThis is for transitioniting from Ruby 2.3 to Ruby 3.0"
+  Enabled: false
+Style/Lambda:
+  EnforcedStyle: line_count_dependent
+Style/RedundantBegin:
+  Enabled: false
+Style/RedundantSelf:
+  Enabled: false
+Style/RescueStandardError:
+  EnforcedStyle: implicit

data/CONTRIBUTING.md

@@ -0,0 +1,14 @@
+# Contributing
+
+1. Fork the repository.
+2. Run `bin/setup`, which will install dependencies and create the dummy
+   application database.
+3. Run `rspec` to verify that the tests pass.
+4. Make your change with new passing tests, following the existing style.
+5. Write a [good commit message], push your fork, and submit a pull request.
+
+[good commit message]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
+
+Others will give constructive feedback.  This is a time for discussion and
+improvements, and making the necessary changes will be required before we can
+merge the contribution.

data/Gemfile

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in healthicons.gemspec
+gemspec
+
+gem 'rake', '~> 13.0'
+
+group :development do
+  gem 'fasterer'
+  gem 'rubocop', '>= 0.89', require: false
+  gem 'rubocop-performance'
+  gem 'rubocop-rspec'
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Brandon Hicks
+
+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,48 @@
+# F(x) Sqlserver Adapter
+
+A Sqlserver adapter for [fx](https://github.com/teoljungberg/fx) gem
+
+## Features
+
+This adapter makes possible to use sqlserver database functions/procedures _(under functions)_ and triggers with active record migrations and schema dump for them.
+
+## Installation
+
+Add this line to gemfile
+
+```ruby
+gem 'fx'
+gem 'fx-sqlserver-adapter'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install fx-sqlserver-adapter
+
+## Usage
+
+After that, you will need to tell F(x) to use this adapter in an initializer `config/initializer/fx.rb`:
+
+```ruby
+# frozen_string_litearl: true
+
+require 'fx/adapters/sqlserver'
+if defined?(Fx)
+  Fx.configuration.database = Fx::Adapters::Sqlserver.new
+end
+```
+
+The generators for this gem still uses generators from the original [fx](https://github.com/teoljungberg/fx#great-how-do-i-create-a-trigger-and-a-function) gem.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/tarellel/fx-sqlserver-adapter.
+This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org/) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'fx/adapters/sqlserver'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start

data/bin/rake

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' 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("rake", "rake")

data/bin/rspec

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' 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("rspec-core", "rspec")

data/bin/setup

@@ -0,0 +1,9 @@
+#!/bin/sh
+
+set -e
+
+gem install bundler --conservative
+bundle check || bundle install
+
+bundle exec rake dummy:db:drop
+bundle exec rake dummy:db:create

data/fx-sqlserver-adapter.gemspec

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fx/sqlserver_adapter/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'fx-sqlserver-adapter'
+  spec.version       = Fx::SqlserverAdapter::VERSION
+  spec.authors       = ['Brandon Hicks']
+  spec.email         = ['tarellel@gmail.com']
+  spec.summary       = %q{SqlServer/MsSQL adapter for Fx gem}
+  spec.description   = <<-DESCRIPTION
+    Adds sqlserver adapter to Fx gem to enable database migrations and schema
+    to work with functions and triggers on applications using
+    sqlserver as database
+  DESCRIPTION
+  spec.homepage      = 'https://github.com/tarellel/fx-sqlserver-adapter'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.test_files    = spec.files.grep(%r{^spec/})
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '>= 1.5'
+  spec.add_development_dependency 'database_cleaner'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec', '>= 3.3'
+  spec.add_development_dependency 'tiny_tds', '>= 2.0'
+  spec.add_development_dependency 'pry'
+
+  spec.add_dependency 'activerecord', '>= 6.0.0'
+  spec.add_dependency 'railties', '>= 6.0.0'
+  spec.add_dependency 'fx', '~> 0.6.2'
+
+  spec.required_ruby_version = '>= 2.7'
+end

data/lib/fx/adapters/sqlserver/connection.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Fx
+  module Adapters
+    class Sqlserver
+      # Decorates an ActiveRecord connection with methods that help determine
+      # the connections capabilities.
+      #
+      # Every attempt is made to use the versions of these methods defined by
+      # Rails where they are available and public before falling back to our own
+      # implementations for older Rails versions.
+      #
+      # @api private
+      class Connection < SimpleDelegator
+      end
+    end
+  end
+end

data/lib/fx/adapters/sqlserver/functions.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require 'fx/function'
+
+module Fx
+  module Adapters
+    class Sqlserver
+      # Fetches defined functions from the sqlserver connection.
+      # @api private
+      class Functions
+        # The SQL query used by F(x) to retrieve the functions considered
+        # dumpable into `db/schema.rb`.
+        FUNCTIONS_WITH_DEFINITIONS_QUERY = <<-STR
+          SELECT
+            routine_name AS name,
+            routine_definition AS definition
+          FROM INFORMATION_SCHEMA.ROUTINES
+          WHERE routine_type = 'FUNCTION'
+        STR
+
+        # Wraps #all as a static facade.
+        #
+        # @return [Array<Fx::Function>]
+        def self.all(*args)
+          new(*args).all
+        end
+
+        def initialize(connection)
+          @connection = connection
+        end
+
+        # All of the functions that this connection has defined.
+        #
+        # @return [Array<Fx::Function>]
+        def all
+          functions_from_sqlserver.map { |function| to_fx_function(function) }
+        end
+
+        private
+
+        attr_reader :connection
+
+        def functions_from_sqlserver
+          connection.exec_query(FUNCTIONS_WITH_DEFINITIONS_QUERY)
+        end
+
+        def to_fx_function(result)
+          Fx::Function.new(result)
+        end
+      end
+    end
+  end
+end

data/lib/fx/adapters/sqlserver/triggers.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'fx/trigger'
+
+module Fx
+  module Adapters
+    class Sqlserver
+      # Fetches defined triggers from the sqlserver connection.
+      # @api private
+      class Triggers
+        # The query must return two attributes, name and definition
+        TRIGGERS_WITH_DEFINITIONS_QUERY = <<-STR
+          SELECT
+            t.name AS name,
+            m.definition AS definition
+          FROM sys.triggers t,
+              sys.sql_modules m
+          WHERE
+            t.type = 'TR'
+            AND t.object_id = m.object_id
+        STR
+
+        # Wraps #all as a static facade.
+        #
+        # @return [Array<Fx::Trigger>]
+        def self.all(*args)
+          new(*args).all
+        end
+
+        def initialize(connection)
+          @connection = connection
+        end
+
+        # All of the triggers that this connection has defined.
+        #
+        # @return [Array<Fx::Trigger>]
+        def all
+          triggers_from_sqlserver.map { |trigger| to_fx_trigger(trigger) }
+        end
+
+        private
+
+        attr_reader :connection
+
+        def triggers_from_sqlserver
+          connection.exec_query(TRIGGERS_WITH_DEFINITIONS_QUERY)
+        end
+
+        def to_fx_trigger(result)
+          Fx::Trigger.new(result)
+        end
+      end
+    end
+  end
+end

data/lib/fx/adapters/sqlserver.rb

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+require_relative 'sqlserver/connection'
+require_relative 'sqlserver/functions'
+require_relative 'sqlserver/triggers'
+
+module Fx
+  # F(x) database adapters.
+  #
+  module Adapters
+    # Sqlserver adapter class to be used with F(x)
+    #
+    class Sqlserver
+      # Creates an instance of the F(x) Sqlserver adapter.
+      #
+      # To use this adapter is required to configure via {Fx.configure},
+      # explicitly setting it accordingly with the example below.
+      #
+      # @param [#connection] connectable An object that returns the connection
+      #   for F(x) to use. Defaults to `ActiveRecord::Base`.
+      #
+      # @example
+      #  Fx.configure do |config|
+      #    config.adapter = Fx::Adapters::Sqlserver.new
+      #  end
+      def initialize(connectable = ActiveRecord::Base)
+        @connectable = connectable
+      end
+
+      # Returns an array of functions in the database.
+      #
+      # This collection of functions is used by the [Fx::SchemaDumper] to
+      # populate the `schema.rb` file.
+      #
+      # @return [Array<Fx::Function>]
+      def functions
+        Functions.all(connection)
+      end
+
+      # Returns an array of triggers in the database.
+      #
+      # This collection of triggers is used by the [Fx::SchemaDumper] to
+      # populate the `schema.rb` file.
+      #
+      # @return [Array<Fx::Trigger>]
+      def triggers
+        Triggers.all(connection)
+      end
+
+      # Creates a function in the database.
+      #
+      # This is typically called in a migration via
+      # {Fx::Statements::Function#create_function}.
+      #
+      # @param sql_definition The SQL schema for the function.
+      #
+      # @return [void]
+      def create_function(sql_definition)
+        execute sql_definition
+      end
+
+      # Creates a trigger in the database.
+      #
+      # This is typically called in a migration via
+      # {Fx::Statements::Trigger#create_trigger}.
+      #
+      # @param sql_definition The SQL schema for the trigger.
+      #
+      # @return [void]
+      def create_trigger(sql_definition)
+        execute sql_definition
+      end
+
+      # Updates a function in the database.
+      #
+      # This is typically called in a migration via
+      # {Fx::Statements::Function#update_function}.
+      #
+      # @param name The name of the function.
+      # @param sql_definition The SQL schema for the function.
+      #
+      # @return [void]
+      def update_function(name, sql_definition)
+        drop_function(name)
+        create_function(sql_definition)
+      end
+
+      # Updates a trigger in the database.
+      #
+      # The existing trigger is dropped and recreated using the supplied `on`
+      # and `version` parameter.
+      #
+      # This is typically called in a migration via
+      # {Fx::Statements::Function#update_trigger}.
+      #
+      # @param name The name of the trigger.
+      # @param on The associated table for the trigger to drop
+      # @param sql_definition The SQL schema for the function.
+      #
+      # @return [void]
+      def update_trigger(name, on:, sql_definition:)
+        drop_trigger(name, on: on)
+        create_trigger(sql_definition)
+      end
+
+      # Drops the function from the database
+      #
+      # This is typically called in a migration via
+      # {Fx::Statements::Function#drop_function}.
+      #
+      # @param name The name of the function to drop
+      #
+      # @return [void]
+      def drop_function(name, *_opts, on: '', **_options)
+        execute <<~SQL
+          DROP FUNCTION IF EXISTS #{name};
+          DROP PROCEDURE IF EXISTS #{name};
+        SQL
+      end
+
+      # Drops the trigger from the database
+      #
+      # This is typically called in a migration via
+      # {Fx::Statements::Trigger#drop_trigger}.
+      #
+      # @param name The name of the trigger to drop
+      # @param on The associated table for the trigger to drop
+      #
+      # @return [void]
+      def drop_trigger(name, *_opts, on: '', **_options)
+        execute <<~SQL
+          DROP TRIGGER IF EXISTS #{name};
+          GO
+        SQL
+      end
+
+      private
+
+      attr_reader :connectable
+
+      delegate :execute, to: :connection
+
+      def connection
+        Connection.new(connectable.connection)
+      end
+    end
+  end
+end

data/lib/fx/sqlserver_adapter/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Fx
+  module SqlserverAdapter
+    VERSION = '0.0.1'
+  end
+end

data/lib/fx/sqlserver_adapter.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'fx'
+require 'fx/adapters/sqlserver'
+
+module Fx
+  module SqlserverAdapter
+  end
+end

data/lib/fx/statements/function.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+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, on: '', version: 1, sql_definition: nil)
+        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, *_opts, revert_to_version: nil, **_options)
+        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 = 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

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+module Fx
+  module Statements
+    # Methods that are made available in migrations for managing Fx triggers.
+    module Trigger
+      # @api private
+      DEFINTION_TYPE = 'trigger'
+
+      # 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 = sql_definition.strip_heredoc if sql_definition
+        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, *_opts, 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
+
+        raise ArgumentError, 'on is required' if on.nil?
+
+        sql_definition = sql_definition.strip_heredoc if sql_definition
+        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

metadata

@@ -0,0 +1,193 @@
+--- !ruby/object:Gem::Specification
+name: fx-sqlserver-adapter
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Brandon Hicks
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-12-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: database_cleaner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: tiny_tds
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.0.0
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.0.0
+- !ruby/object:Gem::Dependency
+  name: fx
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.2
+description: |2
+      Adds sqlserver adapter to Fx gem to enable database migrations and schema
+      to work with functions and triggers on applications using
+      sqlserver as database
+email:
+- tarellel@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/rake
+- bin/rspec
+- bin/setup
+- fx-sqlserver-adapter.gemspec
+- lib/fx/adapters/sqlserver.rb
+- lib/fx/adapters/sqlserver/connection.rb
+- lib/fx/adapters/sqlserver/functions.rb
+- lib/fx/adapters/sqlserver/triggers.rb
+- lib/fx/sqlserver_adapter.rb
+- lib/fx/sqlserver_adapter/version.rb
+- lib/fx/statements/function.rb
+- lib/fx/statements/trigger.rb
+homepage: https://github.com/tarellel/fx-sqlserver-adapter
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.32
+signing_key:
+specification_version: 4
+summary: SqlServer/MsSQL adapter for Fx gem
+test_files: []