declare_schema 1.2.0 → 1.2.2.pre.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc7ce9fd6b89826b6a170f3a7cac65598170b96225b5e8957407558d5fbca61f
-  data.tar.gz: 5141c495a2b66ebd4e1d088f68f33f3ba85455827bb35437c96a2117e5c20127
+  metadata.gz: 845f78b84a0a36a5d218c35351b1445d669b512b96745ee7bf7ab6a2a0a97277
+  data.tar.gz: d983c4fb5d5e3bb123854a8dada61c02970de010331770f77ab3630c084c8a04
 SHA512:
-  metadata.gz: 1edff05f2f7b5efbf7eeb8ce56e27b87744866b0c788795eaab0bd228fa700869a4dd13c4e38f47df18ee0ac67bd5eb091ae4df799b94adb1970edf572801c9a
-  data.tar.gz: 5d0e4633314231757af2bd1ae519eaff9714a91d6af4ca535ada1e9467067046e14c3db0bd7363cd1b20c8647526d64e2ab3ebf6503206f17e440503b7ebed34
+  metadata.gz: 4bcf9de4ccb29f0679ebe15f3892858e628bda5ed4eb30b7d7860d687a2233df7b24d7a913772b8b4d312ab378bcdc4b2fa1675b17f9d69e20d166d1eb0f0dba
+  data.tar.gz: 8e21e6bc2a9d5dd6f3ab40b971cf6f31de66901049f28b17f927d40ae247ecd6c7af60bfe300f9f27b15af0e58df205a3de7e9f97a5dc4a94c8c5bf7b5602a8c

data/.github/workflows/declare_schema_build.yml

@@ -16,11 +16,6 @@ jobs:
         - gemfiles/rails_5_sqlite.gemfile
         - gemfiles/rails_6_mysql.gemfile
         - gemfiles/rails_6_sqlite.gemfile
-        include:
-        - gemfile: gemfiles/rails_5_mysql.gemfile
-          ruby: 2.5
-        - gemfile: gemfiles/rails_5_sqlite.gemfile
-          ruby: 2.5
         exclude:
         - ruby: '3.0'
           gemfile: gemfiles/rails_5_mysql.gemfile

data/CHANGELOG.md

@@ -4,6 +4,21 @@ Inspired by [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 Note: this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.2] - Unreleased
+### Changed
+- Documented `belongs_to` and `has_and_belongs_to_many` behavior
+- Documented configurable ignored tables behavior
+
+### Fixed
+- Ruby 3.x kwargs issue when calling `validates`
+
+### Removed
+- Ruby 2.5 from test matrix
+
+## [1.2.1] - 2022-09-25
+### Fixed
+- If Rails is defined, raise if `Rails.application` is `nil`.
+
 ## [1.2.0] - 2022-09-14
 ### Added
 - Added a rake task definition that can be optionally included into a non-Rails project to generate
@@ -238,6 +253,7 @@ using the appropriate Rails configuration attributes.
 ### Added
 - Initial version from https://github.com/Invoca/hobo_fields v4.1.0.
 
+[1.2.1]: https://github.com/Invoca/declare_schema/compare/v1.2.0...v1.2.1
 [1.2.0]: https://github.com/Invoca/declare_schema/compare/v1.1.0...v1.2.0
 [1.1.0]: https://github.com/Invoca/declare_schema/compare/v1.0.2...v1.1.0
 [1.0.2]: https://github.com/Invoca/declare_schema/compare/v1.0.1...v1.0.2

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    declare_schema (1.2.0)
+    declare_schema (1.2.2.pre.0)
       rails (>= 5.0)
 
 GEM

data/README.md

@@ -224,6 +224,40 @@ If your repo has a different command to run for migrations, you can configure it
 `DeclareSchema.db_migrate_command = "bundle exec rails db:migrate_immediate"`
 ```
 
+## The `belongs_to` Association
+The foreign key for a `belongs_to` association refers to the primary key of the associated model. The `belongs_to`
+association is outside of the `declare_schema do` block, so `declare_schema` intercepts the `belongs_to` macro to
+infer the foreign key column.
+
+By default, `declare_schema` creates an index for `belongs_to` relations. If this default index is not desired,
+you can use `index: false` in the `belongs_to` expression. This may be the case if for example a different index
+already accounts for it.
+
+## The `has_and_belongs_to_many` Association
+Like the `belongs_to` association, `has_and_belongs_to_many` is outside of the `declare_schema ` block. `declare_schema` similarly
+infers foreign keys (and the intersection table).
+
+## Ignored Tables
+If a table's schema or metadata are managed elsewhere, `declare_schema` probably should not alter it. Accordingly,
+`declare_schema` can be configured to ignore tables.
+
+`declare_schema` by default ignores these tables:
+- The ActiveRecord `schema_info` table
+- The ActiveRecord schema migrations table (generally named `schema_migrations`)
+- The ActiveRecord internal metadata table (generally named `ar_internal_metadata`)
+- If defined/configured, the CGI ActiveRecordStore session table
+
+Additional tables can be ignored by configuring `Generators::DeclareSchema::Migration::Migrator.ignore_tables`.
+For example:
+
+```ruby
+::Generators::DeclareSchema::Migration::Migrator.ignore_tables = [
+  "delayed_jobs",
+  "my_snowflake_table",
+  ...
+]
+```
+
 ## Declaring Character Set and Collation
 _Note: This feature currently only works for MySQL database configurations._
 

data/lib/declare_schema/model.rb

@@ -227,7 +227,7 @@ module DeclareSchema
         validates_uniqueness_of name, allow_nil: !:required.in?(args) if :unique.in?(args)
 
         if (validates_options = options[:validates])
-          validates name, validates_options
+          validates(name, **validates_options)
         end
 
         # Support for custom validations

data/lib/declare_schema/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DeclareSchema
-  VERSION = "1.2.0"
+  VERSION = "1.2.2.pre.0"
 end

data/lib/generators/declare_schema/migration/migrator.rb

@@ -55,6 +55,7 @@ module Generators
         def load_rails_models
           ActiveRecord::Migration.verbose = false
           if defined?(Rails)
+            Rails.application or raise "Rails is defined, so Rails.application must be set"
             Rails.application.eager_load!
             Rails::Engine.subclasses.each(&:eager_load!)
           end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: declare_schema
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.2.pre.0
 platform: ruby
 authors:
 - Invoca Development adapted from hobo_fields by Tom Locke
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-09-14 00:00:00.000000000 Z
+date: 2023-01-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails