pg_trunk 0.1.2 → 0.1.3

data/lib/pg_trunk/operations/rules/base.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: false
+
+module PGTrunk::Operations::Rules
+  # @abstract
+  # @private
+  # Base class for operations with rules
+  class Base < PGTrunk::Operation
+    attribute :command, :string
+    attribute :event, :pg_trunk_symbol
+    attribute :kind, :pg_trunk_symbol
+    attribute :replace_existing, :boolean
+    attribute :table, :pg_trunk_qualified_name
+    attribute :where, :string
+
+    # Generate missed name from table & expression
+    after_initialize { self.name = generated_name if name.blank? }
+
+    # Ensure correctness of present values
+    # The table must be defined because the name only
+    # is not enough to identify the constraint.
+    validates :if_not_exists, absence: true
+    validates :table, :name, presence: true
+    validates :kind, inclusion: { in: %i[instead also] }, allow_nil: true
+    validates :event, inclusion: { in: %i[insert update delete] }, allow_nil: true
+
+    # By default foreign keys are sorted by tables and names.
+    def <=>(other)
+      return unless other.is_a?(self.class)
+
+      result = table <=> other.table
+      result.zero? ? super : result
+    end
+
+    # Support `table` and `name` in positional arguments
+    # @example
+    #   create_rule :users, "_do_nothing"
+    ruby_params :table, :name
+
+    # Snippet to be used in all operations with rules
+    ruby_snippet do |s|
+      s.ruby_param(table.lean) if table.present?
+      s.ruby_param(name.name) if custom_name?
+      s.ruby_param(if_exists: true) if if_exists
+      s.ruby_param(replace_existing: true) if replace_existing
+      s.ruby_param(force: :cascade) if force == :cascade
+
+      s.ruby_line(:event, event) if event.present?
+      s.ruby_line(:kind, :instead) if kind == :instead
+      s.ruby_line(:where, where) if where.present?
+      s.ruby_line(:command, command) if command.present?
+      s.ruby_line(:comment, comment) if comment.present?
+    end
+
+    private
+
+    # *************************************************************************
+    # Helpers for operation definitions
+    # *************************************************************************
+
+    def generated_name
+      return @generated_name if instance_variable_defined?(:@generated_name)
+
+      @generated_name = begin
+        return if table.blank? || event.blank?
+
+        key_options = { event: event, kind: (kind || :also) }
+        identifier = "#{table.lean}_#{key_options}_rule"
+        hashed_identifier = Digest::SHA256.hexdigest(identifier).first(10)
+        PGTrunk::QualifiedName.wrap("rule_rails_#{hashed_identifier}")
+      end
+    end
+
+    def custom_name?(qname = name)
+      qname&.differs_from?(/^rule_rails_\w+$/)
+    end
+  end
+end

data/lib/pg_trunk/operations/rules/create_rule.rb

@@ -0,0 +1,155 @@
+# frozen_string_literal: false
+
+# @!parse
+#   class ActiveRecord::Migration
+#     # Create a rule
+#     #
+#     # @param [#to_s] table (nil) The qualified name of the table
+#     # @param [#to_s] name (nil) The name of the rule (unique within the table)
+#     # @option options [Boolean] :replace_existing (false) If the rule should overwrite an existing one
+#     # @option options [Symbol] :event (nil) The type of the query the rule is applied to.
+#     #   Supported values: :update, :insert, :delete
+#     # @option options [Symbol] :kind (:also) The kind of the rule (either :also or :instead).
+#     #   In case of `instead` the original query wouldn't be executed, only the `command` is.
+#     # @option options [String] :where (nil) The condition (SQL) for the rule to be applied.
+#     # @option options [String] :command (nil) The SQL command to be added by the rule.
+#     # @yield [r] the block with the rule's definition
+#     # @yieldparam Object receiver of methods specifying the procedure
+#     # @return [void]
+#     #
+#     # @notice `SELECT` rules are not supported by the gem.
+#     #
+#     # To create a rule you must define table, and event (operation) for the rule.
+#     # Usually you also supposed to define a command, but in case the `kind` is set
+#     # to `:instead`, missing the command would provide `INSTEAD DO NOTHING` rule.
+#     #
+#     # ```ruby
+#     # create_rule "users" do |r|
+#     #   r.event :insert
+#     #   r.kind :instead
+#     #   r.comment "Forbid insertion to the table"
+#     # SQL
+#     # ```
+#     #
+#     # By default the kind is set to `:also`, in this case the `command` is needed as well:
+#     #
+#     # ```ruby
+#     # create_rule "users", "_count_insertion" do |r|
+#     #   r.event :insert
+#     #   r.command <<~SQL
+#     #     UPDATE counters SET user_inserts = user_inserts + 1
+#     #   SQL
+#     #   r.comment "Count insertion to the table"
+#     # SQL
+#     # ```
+#     #
+#     # With a `when` option you can also specify a condition:
+#     #
+#     # ```ruby
+#     # create_rule "users", "_forbid_grants" do |r|
+#     #   r.event :update
+#     #   r.kind :instead
+#     #   r.where "NOT old.admin AND new.admin"
+#     #   r.comment "Forbid granting admin rights"
+#     # SQL
+#     # ```
+#     #
+#     # With a `replace_existing: true` option,
+#     # the rule will be created using the `CREATE OR REPLACE` clause.
+#     # In this case the migration is irreversible because we
+#     # don't know if and how to restore the previous definition.
+#     #
+#     # ```ruby
+#     # create_rule "users", "_forbid_insertion", replace_existing: true do |r|
+#     #   r.event :insert
+#     #   r.kind :instead
+#     #   r.comment "Forbid insertion to the table"
+#     # SQL
+#     # ```
+#     def create_rule(table, name = nil, **options, &block); end
+#   end
+module PGTrunk::Operations::Rules
+  # @private
+  class CreateRule < Base
+    validates :if_exists, :force, :new_name, absence: true
+    validates :event, presence: true
+    validate do
+      errors.add :command, :blank if kind != :instead && command.blank?
+    end
+
+    from_sql do |_server_version|
+      <<~SQL
+        SELECT
+          r.oid,
+          (c.relnamespace::regnamespace || '.' || c.relname) AS table,
+          r.rulename AS name,
+          (
+            CASE
+            WHEN r.ev_type = '1' THEN 'select'
+            WHEN r.ev_type = '2' THEN 'update'
+            WHEN r.ev_type = '3' THEN 'insert'
+            WHEN r.ev_type = '4' THEN 'delete'
+            END
+          ) AS event,
+          ( CASE WHEN r.is_instead THEN 'instead' ELSE 'also' END ) AS kind,
+          pg_get_expr(r.ev_qual, r.oid, true) AS "where",
+          regexp_replace(
+            regexp_replace(
+              pg_get_ruledef(r.oid, true),
+              '.+ DO +(INSTEAD +)?(ALSO +)?(NOTHING *)?| *;',
+              '',
+              'g'
+            ), '(\n|\s)+', ' ', 'g'
+          ) AS command,
+          d.description AS comment
+        FROM pg_rewrite r
+          JOIN pg_class c ON c.oid = r.ev_class
+          JOIN pg_trunk t ON t.oid = r.oid
+            AND t.classid = 'pg_rewrite'::regclass
+          LEFT JOIN pg_description d ON d.objoid = r.oid
+            AND d.classoid = 'pg_rewrite'::regclass
+      SQL
+    end
+
+    def to_sql(_server_version)
+      [create_rule, *comment_rule, register_rule].join(" ")
+    end
+
+    def invert
+      irreversible!("replace_existing: true") if replace_existing
+      DropRule.new(**to_h)
+    end
+
+    private
+
+    def create_rule
+      sql = "CREATE"
+      sql << " OR REPLACE" if replace_existing
+      sql << " RULE #{name.to_sql} AS ON #{event.to_s.upcase}"
+      sql << " TO #{table.to_sql}"
+      sql << " WHERE #{where}" if where.present?
+      sql << " DO #{kind == :instead ? 'INSTEAD' : 'ALSO'}"
+      sql << " #{command.presence || 'NOTHING'}"
+      sql << ";"
+    end
+
+    def comment_rule
+      <<~SQL.squish if comment.present?
+        COMMENT ON RULE #{name.to_sql} ON #{table.to_sql}#{' '}
+        IS $comment$#{comment}$comment$;
+      SQL
+    end
+
+    def register_rule
+      <<~SQL.squish
+        INSERT INTO pg_trunk (oid, classid)
+          SELECT r.oid, 'pg_rewrite'::regclass
+          FROM pg_rewrite r JOIN pg_class c ON c.oid = r.ev_class
+          WHERE r.rulename = #{name.quoted}
+            AND c.relname = '#{table.name}'
+            AND c.relnamespace = #{table.namespace}
+        ON CONFLICT DO NOTHING;
+      SQL
+    end
+  end
+end

data/lib/pg_trunk/operations/rules/drop_rule.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: false
+
+# @!parse
+#   class ActiveRecord::Migration
+#     # Drop a rule
+#     #
+#     # @param [#to_s] table (nil) The qualified name of the table
+#     # @param [#to_s] name (nil) The name of the rule (unique within the table)
+#     # @option options [Boolean] :if_exists (false) Suppress the error when the rule is absent.
+#     # @option options [Symbol] :force (:restrict) Define how to process dependent objects
+#     #   Supported values: :restrict (default), :cascade (for cascade deletion)
+#     # @option options [Symbol] :event (nil) The type of the query the rule is applied to.
+#     #   Supported values: :update, :insert, :delete
+#     # @option options [Symbol] :kind (:also) The kind of the rule (either :also or :instead).
+#     #   In case of `instead` the original query wouldn't be executed, only the `command` is.
+#     # @option options [String] :where (nil) The condition (SQL) for the rule to be applied.
+#     # @option options [String] :command (nil) The SQL command to be added by the rule.
+#     # @yield [r] the block with the rule's definition
+#     # @yieldparam Object receiver of methods specifying the procedure
+#     # @return [void]
+#     #
+#     # The rule can be identified by the table and explicit name
+#     #
+#     # ```ruby
+#     # drop_rule :users, "_forbid_insertion"
+#     # ```
+#     #
+#     # Alternatively the name can be got from kind and event.
+#     #
+#     # ```ruby
+#     # drop_rule :users do |r|
+#     #   r.event :insert
+#     #   r.kind :instead
+#     #   r.comment "Forbid insertion to the table"
+#     # end
+#     # ```
+#     #
+#     # To made operation reversible all the necessary parameters must be provided
+#     # like in the `create_rule` operation:
+#     #
+#     # ```ruby
+#     # drop_rule "users", "_count_insertion" do |r|
+#     #   r.event :insert
+#     #   r.command <<~SQL
+#     #     UPDATE counters SET user_inserts = user_inserts + 1
+#     #   SQL
+#     #   r.comment "Count insertion to the table"
+#     # SQL
+#     # ```
+#     #
+#     # The operation can be called with `if_exists` option.
+#     #
+#     # ```ruby
+#     # drop_rule :users, if_exists: true do |r|
+#     #   # event and kind here are used to define a name
+#     #   r.event :insert
+#     #   r.kind :instead
+#     # end
+#     # ```
+#     #
+#     # With the `force: :cascade` option the operation would remove
+#     # all the objects that use the type.
+#     #
+#     # ```ruby
+#     # drop_rule :users, force: :cascade do |r|
+#     #   r.event :insert
+#     #   r.kind :instead
+#     # end
+#     # ```
+#     #
+#     # In both cases the operation becomes irreversible due to
+#     # uncertainty of the previous state of the database.
+#     def drop_rule(table, name = nil, **options, &block); end
+#   end
+module PGTrunk::Operations::Rules
+  # @private
+  class DropRule < Base
+    validates :replace_existing, :new_name, absence: true
+
+    def to_sql(_version)
+      sql = "DROP RULE"
+      sql << " IF EXISTS" if if_exists
+      sql << " #{name.name.inspect} ON #{table.to_sql}"
+      sql << " CASCADE" if force == :cascade
+      sql << ";"
+    end
+
+    def invert
+      irreversible!("if_exists: true") if if_exists
+      irreversible!("force: :cascade") if force == :cascade
+      CreateRule.new(**to_h.except(:force))
+    end
+  end
+end

data/lib/pg_trunk/operations/rules/rename_rule.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: false
+
+# @!parse
+#   class ActiveRecord::Migration
+#     # Rename a rule
+#     #
+#     # @param [#to_s] table (nil) The qualified name of the table
+#     # @param [#to_s] name (nil) The current name of the rule
+#     # @option options [#to_s] :to (nil) The new name for the rule
+#     # @yield [c] the block with the constraint's definition
+#     # @yieldparam Object receiver of methods specifying the constraint
+#     # @return [void]
+#     #
+#     # A constraint can be identified by the table and explicit name
+#     #
+#     # ```ruby
+#     # rename_rule :users, "_forbid_insertion", to: "_skip_insertion"
+#     # ```
+#     #
+#     # Alternatively the name can be got from the event and kind.
+#     #
+#     # ```ruby
+#     # rename_rule :users, to: "_skip_insertion" do |r|
+#     #   r.event :insert
+#     #   r.kind :instead
+#     # end
+#     # ```
+#     #
+#     # The name can be reset to auto-generated when
+#     # the `:to` option is missed or blank:
+#     #
+#     # ```ruby
+#     # rename_rule :users, "_skip_insertion" do |r|
+#     #   r.event :insert
+#     #   r.kind :instead
+#     # end
+#     # ```
+#     #
+#     # The operation is always reversible.
+#     def rename_rule(table, name = nil, **options, &block); end
+#   end
+module PGTrunk::Operations::Rules
+  # @private
+  class RenameRule < Base
+    after_initialize { self.new_name = generated_name if new_name.blank? }
+
+    validates :new_name, presence: true
+    validates :where, :command, :replace_existing, :force, :if_exists,
+              absence: true
+
+    def to_sql(_version)
+      <<~SQL
+        ALTER RULE #{name.to_sql} ON #{table.to_sql}
+        RENAME TO #{new_name.to_sql};
+      SQL
+    end
+
+    def invert
+      self.class.new(**to_h, name: new_name, to: name)
+    end
+  end
+end

data/lib/pg_trunk/operations/rules.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# nodoc
+module PGTrunk::Rules
+  # @private
+  # Namespace for operations with rules
+  module Rules
+    require_relative "rules/base"
+    require_relative "rules/create_rule"
+    require_relative "rules/drop_rule"
+    require_relative "rules/rename_rule"
+  end
+end

data/lib/pg_trunk/operations/statistics/create_statistics.rb

@@ -5,14 +5,14 @@
 #     # Create a custom statistics
 #     #
 #     # @param [#to_s] name (nil) The qualified name of the statistics
-#     # @option [Boolean] :if_not_exists (false)
+#     # @option options [Boolean] :if_not_exists (false)
 #     #   Suppress the error when the statistics is already exist
-#     # @option [#to_s] table (nil)
+#     # @option options [#to_s] table (nil)
 #     #   The qualified name of the table whose statistics will be collected
-#     # @option [Array<Symbol>] kinds ([:dependencies, :mcv, :ndistinct])
+#     # @option options [Array<Symbol>] kinds ([:dependencies, :mcv, :ndistinct])
 #     #   The kinds of statistics to be collected (all by default).
 #     #   Supported values in the array: :dependencies, :mcv, :ndistinct
-#     # @option [#to_s] :comment The description of the statistics
+#     # @option options [#to_s] :comment The description of the statistics
 #     # @yield [s] the block with the statistics' definition
 #     # @yieldparam Object receiver of methods specifying the statistics
 #     # @return [void]

data/lib/pg_trunk/operations/statistics/drop_statistics.rb

@@ -5,14 +5,14 @@
 #     # Drop a custom statistics
 #     #
 #     # @param [#to_s] name (nil) The qualified name of the statistics
-#     # @option [Boolean] :if_exists (false) Suppress the error when the statistics is absent
-#     # @option [Symbol] :force (:restrict) How to process dependent objects (`:cascade` or `:restrict`)
-#     # @option [#to_s] table (nil)
+#     # @option options [Boolean] :if_exists (false) Suppress the error when the statistics is absent
+#     # @option options [Symbol] :force (:restrict) How to process dependent objects (`:cascade` or `:restrict`)
+#     # @option options [#to_s] table (nil)
 #     #   The qualified name of the table whose statistics will be collected
-#     # @option [Array<Symbol>] kinds ([:dependencies, :mcv, :ndistinct])
+#     # @option options [Array<Symbol>] kinds ([:dependencies, :mcv, :ndistinct])
 #     #   The kinds of statistics to be collected (all by default).
 #     #   Supported values in the array: :dependencies, :mcv, :ndistinct
-#     # @option [#to_s] :comment The description of the statistics
+#     # @option options [#to_s] :comment The description of the statistics
 #     # @yield [s] the block with the statistics' definition
 #     # @yieldparam Object receiver of methods specifying the statistics
 #     # @return [void]

data/lib/pg_trunk/operations/statistics/rename_statistics.rb

@@ -5,7 +5,7 @@
 #     # Change the name and/or schema of a statistics
 #     #
 #     # @param [#to_s] :name (nil) The qualified name of the statistics
-#     # @option [#to_s] :to (nil) The new qualified name for the statistics
+#     # @option options [#to_s] :to (nil) The new qualified name for the statistics
 #     # @return [void]
 #     #
 #     # A custom statistics can be renamed by changing both the name

data/lib/pg_trunk/operations/triggers/change_trigger.rb

@@ -6,7 +6,7 @@
 #     #
 #     # @param [#to_s] table (nil) The qualified name of the table
 #     # @param [#to_s] name (nil) The name of the trigger
-#     # @option [Boolean] :if_exists (false) Suppress the error when the trigger is absent
+#     # @option options [Boolean] :if_exists (false) Suppress the error when the trigger is absent
 #     # @yield [t] the block with the trigger's definition
 #     # @yieldparam Object receiver of methods specifying the trigger
 #     # @return [void]

data/lib/pg_trunk/operations/triggers/create_trigger.rb

@@ -6,19 +6,19 @@
 #     #
 #     # @param [#to_s] table (nil) The qualified name of the table
 #     # @param [#to_s] name (nil) The name of the trigger
-#     # @option [Boolean] :replace_existing (false) If the trigger should overwrite an existing one
-#     # @option [#to_s] :function (nil) The qualified name of the function to be called
-#     # @option [Symbol] :type (nil) When the trigger should be run
+#     # @option options [Boolean] :replace_existing (false) If the trigger should overwrite an existing one
+#     # @option options [#to_s] :function (nil) The qualified name of the function to be called
+#     # @option options [Symbol] :type (nil) When the trigger should be run
 #     #   Supported values: :before, :after, :instead_of
-#     # @option [Array<Symbol>] :events List of events running the trigger
+#     # @option options [Array<Symbol>] :events List of events running the trigger
 #     #   Supported values in the array: :insert, :update, :delete, :truncate
-#     # @option [Boolean] :constraint (false) If the trigger is a constraint
-#     # @option [Symbol] :initially (:immediate) If the constraint check should be deferred
+#     # @option options [Boolean] :constraint (false) If the trigger is a constraint
+#     # @option options [Symbol] :initially (:immediate) If the constraint check should be deferred
 #     #   Supported values: :immediate (default), :deferred
-#     # @option [#to_s] :when (nil) The SQL snippet definiing a condition for the trigger
-#     # @option [Symbol] :for_each (:statement) Define if a trigger should be run for every row
+#     # @option options [#to_s] :when (nil) The SQL snippet definiing a condition for the trigger
+#     # @option options [Symbol] :for_each (:statement) Define if a trigger should be run for every row
 #     #   Supported values: :statement (default), :row
-#     # @option [#to_s] :comment (nil) The commend describing the trigger
+#     # @option options [#to_s] :comment (nil) The commend describing the trigger
 #     # @yield [t] the block with the trigger's definition
 #     # @yieldparam Object receiver of methods specifying the trigger
 #     # @return [void]

data/lib/pg_trunk/operations/triggers/drop_trigger.rb

@@ -6,19 +6,19 @@
 #     #
 #     # @param [#to_s] table (nil) The qualified name of the table
 #     # @param [#to_s] name (nil) The name of the trigger
-#     # @option [Boolean] :if_exists (false) Suppress the error when the trigger is absent
-#     # @option [#to_s] :function (nil) The qualified name of the function to be called
-#     # @option [Symbol] :type (nil) When the trigger should be run
+#     # @option options [Boolean] :if_exists (false) Suppress the error when the trigger is absent
+#     # @option options [#to_s] :function (nil) The qualified name of the function to be called
+#     # @option options [Symbol] :type (nil) When the trigger should be run
 #     #   Supported values: :before, :after, :instead_of
-#     # @option [Array<Symbol>] :events List of events running the trigger
+#     # @option options [Array<Symbol>] :events List of events running the trigger
 #     #   Supported values in the array: :insert, :update, :delete, :truncate
-#     # @option [Boolean] :constraint (false) If the trigger is a constraint
-#     # @option [Symbol] :initially (:immediate) If the constraint check should be deferred
+#     # @option options [Boolean] :constraint (false) If the trigger is a constraint
+#     # @option options [Symbol] :initially (:immediate) If the constraint check should be deferred
 #     #   Supported values: :immediate (default), :deferred
-#     # @option [#to_s] :when (nil) The SQL snippet definiing a condition for the trigger
-#     # @option [Symbol] :for_each (:statement) Define if a trigger should be run for every row
+#     # @option options [#to_s] :when (nil) The SQL snippet definiing a condition for the trigger
+#     # @option options [Symbol] :for_each (:statement) Define if a trigger should be run for every row
 #     #   Supported values: :statement (default), :row
-#     # @option [#to_s] :comment (nil) The commend describing the trigger
+#     # @option options [#to_s] :comment (nil) The commend describing the trigger
 #     # @yield [t] the block with the trigger's definition
 #     # @yieldparam Object receiver of methods specifying the trigger
 #     # @return [void]

data/lib/pg_trunk/operations/triggers/rename_trigger.rb

@@ -6,16 +6,16 @@
 #     #
 #     # @param [#to_s] table (nil) The qualified name of the table
 #     # @param [#to_s] name (nil) The name of the trigger
-#     # @option [#to_s] :to (nil) The new name of the trigger
+#     # @option options [#to_s] :to (nil) The new name of the trigger
 #     # @param [#to_s] table (nil) The qualified name of the table
 #     # @param [#to_s] name (nil) The current name of the trigger
-#     # @option [#to_s] :to (nil) The new name for the trigger
-#     # @option [#to_s] :function (nil) The qualified name of the function to be called
-#     # @option [Symbol] :type (nil) When the trigger should be run
+#     # @option options [#to_s] :to (nil) The new name for the trigger
+#     # @option options [#to_s] :function (nil) The qualified name of the function to be called
+#     # @option options [Symbol] :type (nil) When the trigger should be run
 #     #   Supported values: :before, :after, :instead_of
-#     # @option [Array<Symbol>] :events List of events running the trigger
+#     # @option options [Array<Symbol>] :events List of events running the trigger
 #     #   Supported values in the array: :insert, :update, :delete, :truncate
-#     # @option [Symbol] :for_each (:statement) Define if a trigger should be run for every row
+#     # @option options [Symbol] :for_each (:statement) Define if a trigger should be run for every row
 #     #   Supported values: :statement (default), :row
 #     # @yield [t] the block with the trigger's definition
 #     # @yieldparam Object receiver of methods specifying the trigger

data/lib/pg_trunk/operations/views/change_view.rb

@@ -5,7 +5,7 @@
 #     # Modify a view
 #     #
 #     # @param [#to_s] name (nil) The qualified name of the view
-#     # @option [Boolean] :if_exists (false) Suppress the error when the view is absent
+#     # @option options [Boolean] :if_exists (false) Suppress the error when the view is absent
 #     # @yield [v] the block with the view's definition
 #     # @yieldparam Object receiver of methods specifying the view
 #     # @return [void]

data/lib/pg_trunk/operations/views/create_view.rb

@@ -5,13 +5,13 @@
 #     # Create a view
 #     #
 #     # @param [#to_s] name (nil) The qualified name of the view
-#     # @option [Boolean] :replace_existing (false) If the view should overwrite an existing one
-#     # @option [#to_s] :sql_definition (nil) The snippet containing the query
-#     # @option [#to_i] :version (nil)
+#     # @option options [Boolean] :replace_existing (false) If the view should overwrite an existing one
+#     # @option options [#to_s] :sql_definition (nil) The snippet containing the query
+#     # @option options [#to_i] :version (nil)
 #     #   The alternative way to set sql_definition by referencing to a file containing the snippet
-#     # @option [#to_s] :check (nil) Controls the behavior of automatically updatable views
+#     # @option options [#to_s] :check (nil) Controls the behavior of automatically updatable views
 #     #   Supported values: :local, :cascaded
-#     # @option [#to_s] :comment (nil) The comment describing the view
+#     # @option options [#to_s] :comment (nil) The comment describing the view
 #     # @yield [v] the block with the view's definition
 #     # @yieldparam Object receiver of methods specifying the view
 #     # @return [void]

data/lib/pg_trunk/operations/views/drop_view.rb

@@ -5,15 +5,15 @@
 #     # Drop a view
 #     #
 #     # @param [#to_s] name (nil) The qualified name of the view
-#     # @option [Boolean] :replace_existing (false) If the view should overwrite an existing one
-#     # @option [Boolean] :if_exists (false) Suppress the error when the view is absent
-#     # @option [Symbol] :force (:restrict) How to process dependent objects (`:cascade` or `:restrict`)
-#     # @option [#to_s] :sql_definition (nil) The snippet containing the query
-#     # @option [#to_i] :revert_to_version (nil)
+#     # @option options [Boolean] :replace_existing (false) If the view should overwrite an existing one
+#     # @option options [Boolean] :if_exists (false) Suppress the error when the view is absent
+#     # @option options [Symbol] :force (:restrict) How to process dependent objects (`:cascade` or `:restrict`)
+#     # @option options [#to_s] :sql_definition (nil) The snippet containing the query
+#     # @option options [#to_i] :revert_to_version (nil)
 #     #   The alternative way to set sql_definition by referencing to a file containing the snippet
-#     # @option [#to_s] :check (nil) Controls the behavior of automatically updatable views
+#     # @option options [#to_s] :check (nil) Controls the behavior of automatically updatable views
 #     #   Supported values: :local, :cascaded
-#     # @option [#to_s] :comment (nil) The comment describing the view
+#     # @option options [#to_s] :comment (nil) The comment describing the view
 #     # @yield [v] the block with the view's definition
 #     # @yieldparam Object receiver of methods specifying the view
 #     # @return [void]

data/lib/pg_trunk/operations/views/rename_view.rb

@@ -5,8 +5,8 @@
 #     # Change the name and/or schema of a view
 #     #
 #     # @param [#to_s] :name (nil) The qualified name of the view
-#     # @option [#to_s] :to (nil) The new qualified name for the view
-#     # @option [Boolean] :if_exists (false) Suppress the error when the view is absent
+#     # @option options [#to_s] :to (nil) The new qualified name for the view
+#     # @option options [Boolean] :if_exists (false) Suppress the error when the view is absent
 #     # @return [void]
 #     #
 #     # A view can be renamed by changing both the name

data/lib/pg_trunk/operations.rb

@@ -18,6 +18,7 @@ module PGTrunk
     require_relative "operations/foreign_keys"
     require_relative "operations/procedures"
     require_relative "operations/triggers"
+    require_relative "operations/rules"
     require_relative "operations/statistics"
   end
 end

data/lib/pg_trunk/version.rb

@@ -2,5 +2,5 @@
 
 module PGTrunk
   # @private
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

data/pg_trunk.gemspec

@@ -23,7 +23,6 @@ Gem::Specification.new do |spec|
   spec.metadata["rubygems_mfa_required"] = "true"
 
   spec.files = `git ls-files -z`.split("\x0")
-  spec.test_files = spec.files.grep(%r{^spec/})
   spec.require_paths = ["lib"]
 
   spec.add_dependency "activerecord", ">= 4.0.0"