dynamic-active-model-rails 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2df8e51695a6a96f2fc32f697985e96e6ae201bf52af9acffad5877d25128751
-  data.tar.gz: 3ac8715b733383d6160bf229cb234b0df74e6edb1c9220d2caeb95132e1292db
+  metadata.gz: 5a7327d58f230e0a97c0f8f16bffd96668a739ec899cbee6fae940ce3df021d4
+  data.tar.gz: 377c2ad16ae2e2f8044f382852c4771c655ea81e11985f1560c64c6d8a26acca
 SHA512:
-  metadata.gz: b605039cf58e47a07283d309dcc0dcbabe890314f94ee6c881b1825c26d6714ecbbc00814e119d14fcf7f3ca54b082a4ec7a1592005e39e556b57a155f5337e7
-  data.tar.gz: 660965617e683a0ae03a1b1f053590262953d5ea6cb664eeff623c6daeff5b16ed6ab41eb8b7eacdbc07c072657ee6e18fc532254a60c50258397ae721f121b5
+  metadata.gz: e2fcb3f0522925d95fedb76004ea695c13b618b525d22dff9726ac56c965811ceb2ef74ee8017d214b598a1e3c3201d5e088806ce54c1eab2ced77ce303715d2
+  data.tar.gz: d3dccaaf31a98ed51d446e27c5c5e7bcd6a728fb4d88c89b5aef4f2c35980a297096f08587cf38e010af035efa5d4e69131cd02b46a294db0a16358aaaa321ce

data/README.md

@@ -29,6 +29,24 @@ bin/rails generate dynamic_active_model:extension grant_db users       # app/mod
 
 `--connection NAME` points the database at a `database.yml` entry. `--replica NAME` adds a reading role through `connects_to` and requires `--connection`. The generators warn if the current environment has no such entry. Without `--connection`, the database shares `ApplicationRecord`'s connection.
 
+## Rake Tasks
+
+```bash
+bin/rails dynamic_active_model:models                 # each database with its models and associations
+bin/rails dynamic_active_model:export DIR=tmp/models  # a class file per model (default tmp/dynamic_active_model)
+```
+
+`models` shows what the gem generated, without opening a console:
+
+```
+GrantDB (shares ApplicationRecord's connection), 31 models
+  GrantDB::Role (roles)
+    has_many :user_roles -> GrantDB::UserRole
+    has_many :users -> GrantDB::User, through: :user_roles
+```
+
+Connections given as a URL or config hash are shown as "custom connection", so credentials never appear in the output. `export` writes `DIR/<namespace>/<model>.rb` for every model. Use it to read the generated associations, or as a starting point when a table needs a hand-written model.
+
 ## Configuration
 
 ```ruby

data/lib/dynamic-active-model/rails/model_export.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module DynamicActiveModel
+  module Rails
+    # Writes a class file per model (TemplateClassFile) for every declared
+    # database, for bin/rails dynamic_active_model:export. Useful to read what
+    # the gem generates, or as a starting point for a hand-written model.
+    class ModelExport
+      # @param loaders [Array<DatabaseLoader>]
+      def initialize(loaders)
+        @loaders = loaders
+      end
+
+      # @param dir [String] Output directory; files land in dir/<namespace>/<model>.rb
+      # @return [Array<String>] Paths written
+      def export!(dir)
+        @loaders.flat_map { |loader| loader.load!.models }.map do |model|
+          DynamicActiveModel::TemplateClassFile.new(model).create_template!(dir)
+          File.join(dir, "#{model.name.underscore}.rb")
+        end
+      end
+    end
+  end
+end

data/lib/dynamic-active-model/rails/model_report.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module DynamicActiveModel
+  module Rails
+    # A plain-text listing of each declared database's models and associations,
+    # for bin/rails dynamic_active_model:models. Builds the databases it lists.
+    #
+    # @example
+    #   GrantDB (shares ApplicationRecord's connection), 2 models
+    #     GrantDB::Role (roles)
+    #       has_many :users -> GrantDB::User, through: :user_roles
+    class ModelReport
+      # @param loaders [Array<DatabaseLoader>]
+      def initialize(loaders)
+        @loaders = loaders
+      end
+
+      # @return [String]
+      def to_s
+        @loaders.map { |loader| database_section(loader) }.join("\n")
+      end
+
+      private
+
+      # @param loader [DatabaseLoader]
+      # @return [String]
+      def database_section(loader)
+        models = loader.load!.models.sort_by(&:name)
+        lines = ["#{loader.definition.module_name} (#{connection_description(loader.definition)}), " \
+                 "#{models.size} #{models.size == 1 ? 'model' : 'models'}"]
+        models.each { |model| lines.concat(model_lines(model)) }
+        "#{lines.join("\n")}\n"
+      end
+
+      # Describes the connection without printing URLs or config hashes, which
+      # can hold passwords
+      # @param definition [DatabaseDefinition]
+      # @return [String]
+      def connection_description(definition)
+        return "connects_to: #{definition.connects_to.inspect}" if definition.connects_to
+        return "connection: #{definition.connection.inspect}" if definition.connection.is_a?(Symbol)
+        return 'custom connection' if definition.connection
+
+        "shares #{definition.parent_class_name}'s connection"
+      end
+
+      # @param model [Class]
+      # @return [Array<String>]
+      def model_lines(model)
+        ["  #{model.name} (#{model.table_name})"] +
+          model.reflect_on_all_associations.sort_by { |reflection| reflection.name.to_s }.map do |reflection|
+            "    #{association_line(reflection)}"
+          end
+      end
+
+      # @param reflection [ActiveRecord::Reflection::AssociationReflection]
+      # @return [String] e.g. "has_many :users -> GrantDB::User, through: :user_roles"
+      def association_line(reflection)
+        line = "#{reflection.macro} #{reflection.name.inspect} -> #{reflection.klass.name}"
+        reflection.options[:through] ? "#{line}, through: #{reflection.options[:through].inspect}" : line
+      end
+    end
+  end
+end

data/lib/dynamic-active-model/rails/railtie.rb

@@ -7,6 +7,10 @@ module DynamicActiveModel
     class Railtie < ::Rails::Railtie
       config.eager_load_namespaces << DynamicActiveModel::Rails
 
+      rake_tasks do
+        load File.expand_path('tasks/dynamic_active_model.rake', __dir__)
+      end
+
       # so config.active_support.deprecation (log, raise in tests, ...) applies
       initializer 'dynamic_active_model.deprecator' do |app|
         app.deprecators[:dynamic_active_model] = DynamicActiveModel.deprecator

data/lib/dynamic-active-model/rails/tasks/dynamic_active_model.rake

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+namespace :dynamic_active_model do
+  desc 'List each declared database with its models and associations'
+  task models: :environment do
+    puts DynamicActiveModel::Rails::ModelReport.new(DynamicActiveModel::Rails.loaders)
+  end
+
+  desc 'Write a class file per model to DIR (default tmp/dynamic_active_model)'
+  task export: :environment do
+    dir = ENV.fetch('DIR') { Rails.root.join('tmp', 'dynamic_active_model').to_s }
+    files = DynamicActiveModel::Rails::ModelExport.new(DynamicActiveModel::Rails.loaders).export!(dir)
+    puts "Wrote #{files.size} class files to #{dir}"
+  end
+end

data/lib/dynamic-active-model/rails.rb

@@ -21,6 +21,8 @@ module DynamicActiveModel
     autoload :DatabaseDefinition, 'dynamic-active-model/rails/database_definition'
     autoload :DatabaseLoader, 'dynamic-active-model/rails/database_loader'
     autoload :LazyNamespace, 'dynamic-active-model/rails/lazy_namespace'
+    autoload :ModelExport, 'dynamic-active-model/rails/model_export'
+    autoload :ModelReport, 'dynamic-active-model/rails/model_report'
     autoload :SchemaChangeHook, 'dynamic-active-model/rails/schema_change_hook'
 
     class << self

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dynamic-active-model-rails
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Doug Youch
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.2.0
+        version: 1.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.2.0
+        version: 1.3.0
 - !ruby/object:Gem::Dependency
   name: railties
   requirement: !ruby/object:Gem::Requirement
@@ -67,8 +67,11 @@ files:
 - lib/dynamic-active-model/rails/database_definition.rb
 - lib/dynamic-active-model/rails/database_loader.rb
 - lib/dynamic-active-model/rails/lazy_namespace.rb
+- lib/dynamic-active-model/rails/model_export.rb
+- lib/dynamic-active-model/rails/model_report.rb
 - lib/dynamic-active-model/rails/railtie.rb
 - lib/dynamic-active-model/rails/schema_change_hook.rb
+- lib/dynamic-active-model/rails/tasks/dynamic_active_model.rake
 - lib/generators/dynamic_active_model/database/database_generator.rb
 - lib/generators/dynamic_active_model/database_arguments.rb
 - lib/generators/dynamic_active_model/extension/extension_generator.rb