pg_trunk 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 98c9050bc62e8f9a33f87ff77a836189fca018a968ff1fd487f1e5b613b1278f
-  data.tar.gz: 30bcc2a1d61cc3343a95e752d8307c20b1326b57969ac0479a3e4ef161026747
+  metadata.gz: 27719617c7b0d1c1fbd927d07012f218a48a6a02183334766f4defde22c3a7eb
+  data.tar.gz: 8c1d90a98ea419a38a1f0971c5d122432488e7677872c79f637e3d99c93e9a85
 SHA512:
-  metadata.gz: a4ba64e08cb9a12ce958e1a4a13a88370e4a20e8fe25cf9da19731c5e77ea8d952decabaebd89c6c0af545f34e955f274a768ad28282345e0365ef57f314d69b
-  data.tar.gz: 62289de65886d00d28a979149909839f237afdd9e1144f61710306f4da4258e9487da36e07ef21f46e90b86f63cd6b18a17db59317728eac56ce37524cdbc60a
+  metadata.gz: 787ec0229602b9abf5d31e684175a44dd5dfb3c4ccb449dc3145eee365bed8e0ac0c7c8f18def6251b0fa2c51ea550cf2ae204b22a63bd1c347c03938376cf11
+  data.tar.gz: 46bf35d7204f8497622168743cbd1ade98d63802d33f5634109df45b2e25d34f070922c2d00dd45926e033f066f9b0fe412bbe7257a1af14a8f38eb9abd6c459

data/CHANGELOG.md

@@ -4,6 +4,10 @@ The noteworthy changes for each PGTrunk version are included here.
 The format is based on [Keep a Changelog] and this project adheres to [Semantic Versioning].
 For a complete changelog, see the [commits] for each version via the version links.
 
+## [0.1.1] (2022-01-16)
+
+* Fix inline documentation for methods added to ActiveRecord::Migration
+
 ## [0.1.0] (2022-01-14)
 
 This is a first public release (nepalez)
@@ -24,6 +28,7 @@ Supported features:
 - composite types
 - domains types
 
+[0.1.1]: https://github.com/nepalez/pg_trunk/releases/tag/v0.1.1
 [0.1.0]: https://github.com/nepalez/pg_trunk/releases/tag/v0.1.0
 
 [Keep a Changelog]: http://keepachangelog.com/

data/lib/pg_trunk/operations/check_constraints/add_check_constraint.rb

@@ -1,39 +1,42 @@
 # frozen_string_literal: false
 
-# @!method ActiveRecord::Migration#add_check_constraint(table, expression = nil, **options, &block)
-# Add a check constraint to the table
-#
-# @param [#to_s] table (nil) The qualified name of the table
-# @param [#to_s] expression (nil) The SQL expression
-# @option [#to_s] :name (nil) The optional name of the constraint
-# @option [Boolean] :inherit (true) If the constraint should be inherited by subtables
-# @option [#to_s] :comment (nil) The comment describing the constraint
-# @yield [Proc] the block with the constraint's definition
-# @yieldparam The receiver of methods specifying the constraint
-#
-# The name of the new constraint can be set explicitly
-#
-#   add_check_constraint :users, "length(phone) > 10",
-#                        name: "phone_is_long_enough",
-#                        inherit: false,
-#                        comment: "Phone is 10+ chars long"
-#
-# The name can also be skipped (it will be generated by default):
-#
-#   add_check_constraint :users, "length(phone) > 1"
-#
-# The block syntax can be used for any argument as usual:
-#
-#   add_check_constraint do |c|
-#     c.table "users"
-#     c.expression "length(phone) > 10"
-#     c.name "phone_is_long_enough"
-#     c.inherit false
-#     c.comment "Phone is 10+ chars long"
+# @!parse
+#   class ActiveRecord::Migration
+#     # Add a check constraint to the table
+#     #
+#     # @param [#to_s] table (nil) The qualified name of the table
+#     # @param [#to_s] expression (nil) The SQL expression
+#     # @option [#to_s] :name (nil) The optional name of the constraint
+#     # @option [Boolean] :inherit (true) If the constraint should be inherited by subtables
+#     # @option [#to_s] :comment (nil) The comment describing the constraint
+#     # @yield [c] the block with the constraint's definition
+#     # @yieldparam Object receiver of methods specifying the constraint
+#     # @return [void]
+#     #
+#     # The name of the new constraint can be set explicitly
+#     #
+#     #   add_check_constraint :users, "length(phone) > 10",
+#     #                        name: "phone_is_long_enough",
+#     #                        inherit: false,
+#     #                        comment: "Phone is 10+ chars long"
+#     #
+#     # The name can also be skipped (it will be generated by default):
+#     #
+#     #   add_check_constraint :users, "length(phone) > 1"
+#     #
+#     # The block syntax can be used for any argument as usual:
+#     #
+#     #   add_check_constraint do |c|
+#     #     c.table "users"
+#     #     c.expression "length(phone) > 10"
+#     #     c.name "phone_is_long_enough"
+#     #     c.inherit false
+#     #     c.comment "Phone is 10+ chars long"
+#     #   end
+#     #
+#     # The operation is always reversible.
+#     def add_check_constraint(table, expression = nil, **options, &block); end
 #   end
-#
-# The operation is always reversible.
-
 module PGTrunk::Operations::CheckConstraints
   # @private
   class AddCheckConstraint < Base

data/lib/pg_trunk/operations/check_constraints/drop_check_constraint.rb

@@ -1,46 +1,49 @@
 # frozen_string_literal: false
 
-# @!method ActiveRecord::Migration#drop_check_constraint(table, expression = nil, **options, &block)
-# Remove a check constraint from the table
-#
-# @param [#to_s] table (nil) The qualified name of the table
-# @param [#to_s] expression (nil) The SQL expression
-# @option [Boolean] :if_exists (false) Suppress the error when the constraint is absent
-# @option [#to_s] :name (nil) The optional name of the constraint
-# @option [Boolean] :inherit (true) If the constraint should be inherited by subtables
-# @option [#to_s] :comment (nil) The comment describing the constraint
-# @yield [Proc] the block with the constraint's definition
-# @yieldparam The receiver of methods specifying the constraint
-#
-# Definition for the `drop_check_constraint` operation
-#
-# The constraint can be identified by the table and explicit name
-#
-#   drop_check_constraint :users, name: "phone_is_long_enough"
-#
-# Alternatively the name can be got from the expression.
-# Be careful! the expression must have exactly the same form
-# as stored in the database:
-#
-#   drop_check_constraint :users, "length((phone::text) > 10)"
-#
-# To made operation reversible the expression must be provided:
-#
-#   drop_check_constraint "users" do |c|
-#     c.expression "length((phone::text) > 10)"
-#     c.inherit false
-#     c.comment "The phone is 10+ chars long"
+# @!parse
+#   class ActiveRecord::Migration
+#     # Remove a check constraint from the table
+#     #
+#     # @param [#to_s] table (nil) The qualified name of the table
+#     # @param [#to_s] expression (nil) The SQL expression
+#     # @option [Boolean] :if_exists (false) Suppress the error when the constraint is absent
+#     # @option [#to_s] :name (nil) The optional name of the constraint
+#     # @option [Boolean] :inherit (true) If the constraint should be inherited by subtables
+#     # @option [#to_s] :comment (nil) The comment describing the constraint
+#     # @yield [c] the block with the constraint's definition
+#     # @yieldparam Object receiver of methods specifying the constraint
+#     # @return [void]
+#     #
+#     # Definition for the `drop_check_constraint` operation
+#     #
+#     # The constraint can be identified by the table and explicit name
+#     #
+#     #   drop_check_constraint :users, name: "phone_is_long_enough"
+#     #
+#     # Alternatively the name can be got from the expression.
+#     # Be careful! the expression must have exactly the same form
+#     # as stored in the database:
+#     #
+#     #   drop_check_constraint :users, "length((phone::text) > 10)"
+#     #
+#     # To made operation reversible the expression must be provided:
+#     #
+#     #   drop_check_constraint "users" do |c|
+#     #     c.expression "length((phone::text) > 10)"
+#     #     c.inherit false
+#     #     c.comment "The phone is 10+ chars long"
+#     #   end
+#     #
+#     # The operation can be called with `if_exists` option.
+#     #
+#     #   drop_check_constraint :users,
+#     #                         name: "phone_is_long_enough",
+#     #                         if_exists: true
+#     #
+#     # In this case the operation is always irreversible due to
+#     # uncertainty of the previous state of the database.
+#     def drop_check_constraint(table, expression = nil, **options, &block); end
 #   end
-#
-# The operation can be called with `if_exists` option.
-#
-#   drop_check_constraint :users,
-#                         name: "phone_is_long_enough",
-#                         if_exists: true
-#
-# In this case the operation is always irreversible due to
-# uncertainty of the previous state of the database.
-
 module PGTrunk::Operations::CheckConstraints
   # @private
   class DropCheckConstraint < Base

data/lib/pg_trunk/operations/check_constraints/rename_check_constraint.rb

@@ -1,35 +1,38 @@
 # frozen_string_literal: false
 
-# @!method ActiveRecord::Migration#rename_check_constraint(table, expression = nil, **options, &block)
-# Rename a check constraint
-#
-# @param [#to_s] table (nil) The qualified name of the table
-# @param [#to_s] expression (nil) The SQL expression
-# @option [#to_s] :name (nil) The current name of the constraint
-# @option [#to_s] :to (nil) The new name for the constraint
-# @yield [Proc] the block with the constraint's definition
-# @yieldparam The receiver of methods specifying the constraint
-#
-# A constraint can be identified by the table and explicit name
-#
-#   rename_check_constraint :users,
-#                           name: "phone_is_long_enough",
-#                           to: "phones.long_enough"
-#
-# Alternatively the name can be got from the expression.
-# Be careful! the expression must have exactly the same form
-# as stored in the database:
-#
-#   rename_check_constraint :users, "length((phone::text) > 10)",
-#                           to: "long_enough"
-#
-# The name can be reset to auto-generated when
-# the `:to` option is missed or blank:
-#
-#   rename_check_constraint :users, "phone_is_long_enough"
-#
-# The operation is always reversible.
-
+# @!parse
+#   class ActiveRecord::Migration
+#     # Rename a check constraint
+#     #
+#     # @param [#to_s] table (nil) The qualified name of the table
+#     # @param [#to_s] expression (nil) The SQL expression
+#     # @option [#to_s] :name (nil) The current name of the constraint
+#     # @option [#to_s] :to (nil) The new name for the constraint
+#     # @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
+#     #
+#     #   rename_check_constraint :users,
+#     #                           name: "phone_is_long_enough",
+#     #                           to: "phones.long_enough"
+#     #
+#     # Alternatively the name can be got from the expression.
+#     # Be careful! the expression must have exactly the same form
+#     # as stored in the database:
+#     #
+#     #   rename_check_constraint :users, "length((phone::text) > 10)",
+#     #                           to: "long_enough"
+#     #
+#     # The name can be reset to auto-generated when
+#     # the `:to` option is missed or blank:
+#     #
+#     #   rename_check_constraint :users, "phone_is_long_enough"
+#     #
+#     # The operation is always reversible.
+#     def rename_check_constraint(table, expression = nil, **options, &block); end
+#   end
 module PGTrunk::Operations::CheckConstraints
   # @private
   class RenameCheckConstraint < Base

data/lib/pg_trunk/operations/check_constraints/validate_check_constraint.rb

@@ -1,26 +1,29 @@
 # frozen_string_literal: false
 
-# @!method ActiveRecord::Migration#validate_check_constraint(table, expression = nil, **options, &block)
-# Validate an invalid check constraint
-#
-# @param [#to_s] table (nil) The qualified name of the table
-# @param [#to_s] expression (nil) The SQL expression
-# @option [#to_s] :name (nil) The optional name of the constraint
-# @yield [Proc] the block with the constraint's definition
-# @yieldparam The receiver of methods specifying the constraint
-#
-# The invalid constraint can be identified by table and explicit name:
-#
-#   validate_check_constraint :users, name: "phone_is_long_enough"
-#
-# Alternatively it can be specified by expression. In this case
-# you must ensure the expression has the same form as it is stored
-# in the database (after parsing the source).
-#
-#   validate_check_constraint :users, "length((phone::text) > 10)"
-#
-# Notice that it is invertible but the inverted operation does nothing.
-
+# @!parse
+#   class ActiveRecord::Migration
+#     # Validate an invalid check constraint
+#     #
+#     # @param [#to_s] table (nil) The qualified name of the table
+#     # @param [#to_s] expression (nil) The SQL expression
+#     # @option [#to_s] :name (nil) The optional name of the constraint
+#     # @yield [c] the block with the constraint's definition
+#     # @yieldparam Object receiver of methods specifying the constraint
+#     # @return [void]
+#     #
+#     # The invalid constraint can be identified by table and explicit name:
+#     #
+#     #   validate_check_constraint :users, name: "phone_is_long_enough"
+#     #
+#     # Alternatively it can be specified by expression. In this case
+#     # you must ensure the expression has the same form as it is stored
+#     # in the database (after parsing the source).
+#     #
+#     #   validate_check_constraint :users, "length((phone::text) > 10)"
+#     #
+#     # Notice that it is invertible but the inverted operation does nothing.
+#     def validate_check_constraint(table, expression = nil, **options, &block); end
+#   end
 module PGTrunk::Operations::CheckConstraints
   # @private
   class ValidateCheckConstraint < Base

data/lib/pg_trunk/operations/composite_types/change_composite_type.rb

@@ -1,56 +1,59 @@
 # frozen_string_literal: false
 
-# @!method ActiveRecord::Migration#change_composite_type(name, **options, &block)
-# Modify a composite type
-#
-# @param [#to_s] name (nil) The qualified name of the type
-# @option [Symbol] :force (:restrict) How to process dependent objects (`:cascade` or `:restrict`)
-# @option [#to_s] :comment (nil) The comment describing the constraint
-# @yield [Proc] the block with the type's definition
-# @yieldparam The receiver of methods specifying the type
-#
-# The operation can be used to add, drop, rename or change columns.
-# The comment can be changed as well.
-#
-# Providing a type "paint.colored_point":
-#
-#   create_composite_type "paint.colored_point" do |t|
-#     t.column "color", "text", collation: "en_US"
-#     t.column "x", "integer"
-#     t.column "z", "integer"
+# @!parse
+#   class ActiveRecord::Migration
+#     # Modify a composite type
+#     #
+#     # @param [#to_s] name (nil) The qualified name of the type
+#     # @option [Symbol] :force (:restrict) How to process dependent objects (`:cascade` or `:restrict`)
+#     # @option [#to_s] :comment (nil) The comment describing the constraint
+#     # @yield [t] the block with the type's definition
+#     # @yieldparam Object receiver of methods specifying the type
+#     # @return [void]
+#     #
+#     # The operation can be used to add, drop, rename or change columns.
+#     # The comment can be changed as well.
+#     #
+#     # Providing a type "paint.colored_point":
+#     #
+#     #   create_composite_type "paint.colored_point" do |t|
+#     #     t.column "color", "text", collation: "en_US"
+#     #     t.column "x", "integer"
+#     #     t.column "z", "integer"
+#     #   end
+#     #
+#     # After the following change:
+#     #
+#     #   change_composite_type "paint.colored_point" do |t|
+#     #     t.change_column "color", "text", collation: "ru_RU", from_collation: "en_US"
+#     #     t.change_column "x", "bigint", from_type: "integer"
+#     #     t.drop_column "z", "integer"
+#     #     t.add_column "Y", "bigint"
+#     #     t.rename_column "x", to: "X"
+#     #     t.comment "2D point with a color", from: "2D point"
+#     #   end
+#     #
+#     # The definition became:
+#     #
+#     #   create_composite_type "paint.colored_point" do |t|
+#     #     t.column "color", "text", collation: "ru_RU"
+#     #     t.column "X", "bigint"
+#     #     t.column "Y", "integer"
+#     #   end
+#     #
+#     # Notice, that all renames will be done AFTER other changes,
+#     # so in `change_column` you should use the old names.
+#     #
+#     # In several cases the operation is not invertible:
+#     #
+#     # - when a column was dropped
+#     # - when `force: :cascade` option is used (to update
+#     #   objects that use the type)
+#     # - when `if_exists: true` is added to the `drop_column` clause
+#     # - when a previous state of the column type, collation or comment
+#     #   is not specified.
+#     def change_composite_type(name, **options, &block); end
 #   end
-#
-# After the following change:
-#
-#   change_composite_type "paint.colored_point" do |t|
-#     t.change_column "color", "text", collation: "ru_RU", from_collation: "en_US"
-#     t.change_column "x", "bigint", from_type: "integer"
-#     t.drop_column "z", "integer"
-#     t.add_column "Y", "bigint"
-#     t.rename_column "x", to: "X"
-#     t.comment "2D point with a color", from: "2D point"
-#   end
-#
-# The definition became:
-#
-#   create_composite_type "paint.colored_point" do |t|
-#     t.column "color", "text", collation: "ru_RU"
-#     t.column "X", "bigint"
-#     t.column "Y", "integer"
-#   end
-#
-# Notice, that all renames will be done AFTER other changes,
-# so in `change_column` you should use the old names.
-#
-# In several cases the operation is not invertible:
-#
-# - when a column was dropped
-# - when `force: :cascade` option is used (to update
-#   objects that use the type)
-# - when `if_exists: true` is added to the `drop_column` clause
-# - when a previous state of the column type, collation or comment
-#   is not specified.
-
 module PGTrunk::Operations::CompositeTypes
   # @private
   class ChangeCompositeType < Base

data/lib/pg_trunk/operations/composite_types/create_composite_type.rb

@@ -1,25 +1,28 @@
 # frozen_string_literal: false
 
-# @!method ActiveRecord::Migration#create_composite_type(name, **options, &block)
-# Create a composite type
-#
-# @param [#to_s] name (nil) The qualified name of the type
-# @option [#to_s] :comment (nil) The comment describing the constraint
-# @yield [Proc] the block with the type's definition
-# @yieldparam The receiver of methods specifying the type
-#
-# @example
-#   create_composite_type "paint.colored_point" do |d|
-#     d.column "x", "integer"
-#     d.column "y", "integer"
-#     d.column "color", "text", collation: "en_US"
-#     d.comment <<~COMMENT
-#       2D point with color
-#     COMMENT
+# @!parse
+#   class ActiveRecord::Migration
+#     # Create a composite type
+#     #
+#     # @param [#to_s] name (nil) The qualified name of the type
+#     # @option [#to_s] :comment (nil) The comment describing the constraint
+#     # @yield [t] the block with the type's definition
+#     # @yieldparam Object receiver of methods specifying the type
+#     # @return [void]
+#     #
+#     # @example
+#     #   create_composite_type "paint.colored_point" do |d|
+#     #     d.column "x", "integer"
+#     #     d.column "y", "integer"
+#     #     d.column "color", "text", collation: "en_US"
+#     #     d.comment <<~COMMENT
+#     #       2D point with color
+#     #     COMMENT
+#     #   end
+#     #
+#     # It is always reversible.
+#     def create_composite_type(name, **options, &block); end
 #   end
-#
-# It is always reversible.
-
 module PGTrunk::Operations::CompositeTypes
   # @private
   class CreateCompositeType < Base

data/lib/pg_trunk/operations/composite_types/drop_composite_type.rb

@@ -1,49 +1,52 @@
 # frozen_string_literal: false
 
-# @!method ActiveRecord::Migration#drop_composite_type(name, **options, &block)
-# Drop a composite type
-#
-# @param [#to_s] name (nil) The qualified name of the type
-# @option [Boolean] :if_exists (false) Suppress the error when the type is absent
-# @option [Symbol] :force (:restrict) How to process dependent objects (`:cascade` or `:restrict`)
-# @option [#to_s] :comment (nil) The comment describing the constraint
-# @yield [Proc] the block with the type's definition
-# @yieldparam The receiver of methods specifying the type
-#
-# The operation drops a composite_type type identified by its
-# qualified name (it can include a schema).
-#
-# For inversion use the same options as in the
-# `create_composite_type` operation.
-#
-#   drop_composite_type "paint.colored_point" do |d|
-#     d.column "x", "integer"
-#     d.column "y", "integer"
-#     d.column "color", "text", collation: "en_US"
-#     d.comment <<~COMMENT
-#       2D point with color
-#     COMMENT
+# @!parse
+#   class ActiveRecord::Migration
+#     # Drop a composite type
+#     #
+#     # @param [#to_s] name (nil) The qualified name of the type
+#     # @option [Boolean] :if_exists (false) Suppress the error when the type is absent
+#     # @option [Symbol] :force (:restrict) How to process dependent objects (`:cascade` or `:restrict`)
+#     # @option [#to_s] :comment (nil) The comment describing the constraint
+#     # @yield [t] the block with the type's definition
+#     # @yieldparam Object receiver of methods specifying the type
+#     # @return [void]
+#     #
+#     # The operation drops a composite_type type identified by its
+#     # qualified name (it can include a schema).
+#     #
+#     # For inversion use the same options as in the
+#     # `create_composite_type` operation.
+#     #
+#     #   drop_composite_type "paint.colored_point" do |d|
+#     #     d.column "x", "integer"
+#     #     d.column "y", "integer"
+#     #     d.column "color", "text", collation: "en_US"
+#     #     d.comment <<~COMMENT
+#     #       2D point with color
+#     #     COMMENT
+#     #   end
+#     #
+#     # Notice, that the composite type creation can use no attributes.
+#     # That's why dropping it is always reversible; though the reversion
+#     # would provide a type without columns:
+#     #
+#     #   drop_composite_type "paint.colored_point"
+#     #
+#     # With the `force: :cascade` option the operation would remove
+#     # all objects using the type.
+#     #
+#     #   drop_composite_type "paint.colored_point", force: :cascade
+#     #
+#     # With the `if_exists: true` option the operation won't fail
+#     # even when the view was absent in the database.
+#     #
+#     #   drop_composite_type "paint.colored_point", if_exists: true
+#     #
+#     # Both options make a migration irreversible due to uncertainty
+#     # of the previous state of the database.
+#     def drop_composite_type(name, **options, &block); end
 #   end
-#
-# Notice, that the composite type creation can use no attributes.
-# That's why dropping it is always reversible; though the reversion
-# would provide a type without columns:
-#
-#   drop_composite_type "paint.colored_point"
-#
-# With the `force: :cascade` option the operation would remove
-# all objects using the type.
-#
-#   drop_composite_type "paint.colored_point", force: :cascade
-#
-# With the `if_exists: true` option the operation won't fail
-# even when the view was absent in the database.
-#
-#   drop_composite_type "paint.colored_point", if_exists: true
-#
-# Both options make a migration irreversible due to uncertainty
-# of the previous state of the database.
-
 module PGTrunk::Operations::CompositeTypes
   # @private
   class DropCompositeType < Base

data/lib/pg_trunk/operations/composite_types/rename_composite_type.rb

@@ -1,17 +1,20 @@
 # frozen_string_literal: false
 
-# @!method ActiveRecord::Migration#rename_composite_type(name, to:)
-# Change the name and/or schema of a composite type
-#
-# @param [#to_s] name (nil) The qualified name of the type
-# @option [#to_s] :to (nil) The new qualified name for the type
-#
-# @example
-#
-#   rename_composite_type "point", to: "paint.colored_point"
-#
-# The operation is always reversible.
-
+# @!parse
+#   class ActiveRecord::Migration
+#     # Change the name and/or schema of a composite type
+#     #
+#     # @param [#to_s] name (nil) The qualified name of the type
+#     # @option [#to_s] :to (nil) The new qualified name for the type
+#     # @return [void]
+#     #
+#     # @example
+#     #
+#     #   rename_composite_type "point", to: "paint.colored_point"
+#     #
+#     # The operation is always reversible.
+#     def rename_composite_type(name, to:); end
+#   end
 module PGTrunk::Operations::CompositeTypes
   # @private
   class RenameCompositeType < Base