packwerk 1.4.0 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d150d89ede62e601246e2ff0290ecda4aab883a7c8b8be02feb86760ad26b72
-  data.tar.gz: 33b088b3387b8fdfe694967f20529fb8795dec8572dc9e036cb4979402f19c5b
+  metadata.gz: e0270de859808f51bbfa45a7140813744da0555c57d9d60432ba4e166ab63c4a
+  data.tar.gz: 90465398a3e04f83ba4c0e3b290dca72677b166003640504c7470b181e556d73
 SHA512:
-  metadata.gz: 102154447670b85dc4e0825dcdf1ec11cd0fd291ffc1c7230b98da2208b0a39c38d2c8726a33226aeea68082e16a24917db7ad3380c871b9b02b0d76c8ac69fc
-  data.tar.gz: 666e3745e9167028e5d3901d74400848c87c1b8a64a7487d3e4bfe13916e2902990633db7c448057b8106fd4b6b5c5de08c697c88151a305c92d34259266448f
+  metadata.gz: 86e386674412f99d605013799ebd09bbff4d9e0dd2718de534db33e71c148fd0b8aa2ec905ca96c34c48ce85e31e922eae41352c05676de8f4af6baea749c03e
+  data.tar.gz: 6406b7ddbcac8c91f3e51660d5c5e111145b6f8f01ef6ca2bfc1797cdec39b13cb0db1e3d8d04026bc59835bb67e9e8acb41a5edbd0cd207f609bbb532ffa067

data/CHANGELOG.md

@@ -0,0 +1 @@
+See https://github.com/Shopify/packwerk/releases.

data/Gemfile.lock

@@ -87,12 +87,13 @@ GIT
 PATH
   remote: .
   specs:
-    packwerk (1.4.0)
+    packwerk (2.1.1)
       activesupport (>= 5.2)
       ast
       better_html
       bundler
       constant_resolver
+      digest
       parallel
       parser
       sorbet-runtime
@@ -118,6 +119,7 @@ GEM
     concurrent-ruby (1.1.8)
     constant_resolver (0.1.5)
     crass (1.0.6)
+    digest (3.1.0)
     erubi (1.10.0)
     globalid (0.4.2)
       activesupport (>= 4.2.0)
@@ -136,16 +138,16 @@ GEM
     marcel (1.0.0)
     method_source (1.0.0)
     mini_mime (1.0.3)
-    mini_portile2 (2.6.1)
+    mini_portile2 (2.8.0)
     minitest (5.14.4)
     minitest-focus (1.2.1)
       minitest (>= 4, < 6)
     mocha (1.12.0)
     nio4r (2.5.7)
-    nokogiri (1.12.5)
-      mini_portile2 (~> 2.6.1)
+    nokogiri (1.13.3)
+      mini_portile2 (~> 2.8.0)
       racc (~> 1.4)
-    nokogiri (1.12.5-x86_64-darwin)
+    nokogiri (1.13.3-x86_64-darwin)
       racc (~> 1.4)
     parallel (1.20.1)
     parlour (6.0.0)
@@ -159,7 +161,7 @@ GEM
       coderay (~> 1.1)
       method_source (~> 1.0)
     psych (3.3.2)
-    racc (1.5.2)
+    racc (1.6.0)
     rack (2.2.3)
     rack-test (1.1.0)
       rack (>= 1.0, < 3)
@@ -191,18 +193,19 @@ GEM
     rubocop-sorbet (0.6.1)
       rubocop
     ruby-progressbar (1.11.0)
-    smart_properties (1.16.3)
-    sorbet (0.5.6360)
-      sorbet-static (= 0.5.6360)
-    sorbet-runtime (0.5.6360)
-    sorbet-static (0.5.6360-universal-darwin-14)
-    sorbet-static (0.5.6360-universal-darwin-15)
-    sorbet-static (0.5.6360-universal-darwin-16)
-    sorbet-static (0.5.6360-universal-darwin-17)
-    sorbet-static (0.5.6360-universal-darwin-18)
-    sorbet-static (0.5.6360-universal-darwin-19)
-    sorbet-static (0.5.6360-universal-darwin-20)
-    sorbet-static (0.5.6360-x86_64-linux)
+    smart_properties (1.17.0)
+    sorbet (0.5.9538)
+      sorbet-static (= 0.5.9538)
+    sorbet-runtime (0.5.9538)
+    sorbet-static (0.5.9538-universal-darwin-14)
+    sorbet-static (0.5.9538-universal-darwin-15)
+    sorbet-static (0.5.9538-universal-darwin-16)
+    sorbet-static (0.5.9538-universal-darwin-17)
+    sorbet-static (0.5.9538-universal-darwin-18)
+    sorbet-static (0.5.9538-universal-darwin-19)
+    sorbet-static (0.5.9538-universal-darwin-20)
+    sorbet-static (0.5.9538-universal-darwin-21)
+    sorbet-static (0.5.9538-x86_64-linux)
     spoom (1.1.0)
       colorize
       sorbet (>= 0.5.6347)
@@ -257,4 +260,4 @@ DEPENDENCIES
   tapioca
 
 BUNDLED WITH
-   2.2.22
+   2.3.4

data/README.md

@@ -35,8 +35,6 @@ Watch a [1-minute video demo](https://www.youtube.com/watch?v=NwqlyBAxVpQ&featur
 gem 'packwerk'
 ```
 
-_Note: Packwerk has to be grouped in production environment within the Gemfile if your Rails app has custom inflections._
-
 2. Install the gem
 
 Execute:
@@ -58,6 +56,13 @@ Read [USAGE.md](USAGE.md) for usage once Packwerk is installed on your project.
 
 "Packwerk" is pronounced [[ˈpakvɛʁk]](https://cdn.shopify.com/s/files/1/0258/7469/files/packwerk.mp3).
 
+## Ecosystem
+
+You can use these third party tools to enhance your packwerk experience:
+
+- https://github.com/bellroy/graphwerk draws a graph of your package dependencies
+- https://github.com/Gusto/packwerk-vscode integrates packwerk into Visual Studio Code so you can see violations right in your editor
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/UPGRADING.md

@@ -0,0 +1,54 @@
+# Upgrading from 1.x to 2.0
+
+With Packwerk 2.0, we made a few changes to simplify the setup. Updating will require removing some previously necessary files and configuration.
+
+## Gem group
+
+Because packwerk is no longer involved in specifying the application's inflections, it doesn't have to live in the `production` group in your `Gemfile` anymore. We recommend moving it to the `development` group.
+
+## Removing application config caches
+
+### Load paths
+We no longer require the `load_paths` key in `packwerk.yml`. You can simply delete the load_paths key as it will not be read anymore. Instead, Packwerk will ask Rails for load paths. If you're using spring, make sure to properly set up spring (see [USAGE.md](USAGE.md#setting-up-spring)) to keep packwerk fast.
+
+### Inflections
+We no longer require a custom `inflections.yml` file. Instead, you'll want to revert BACK to using the `inflections.rb` initializer as you would have done prior to adopting packwerk. To do this, you'll want to convert back to using the plain [ActiveSupport Inflections API](https://api.rubyonrails.org/classes/ActiveSupport/Inflector/Inflections.html).
+
+
+Given the following example `inflections.yml`, here is an example `inflections.rb` that would follow. Tip: if you're using git, you can run `git log config/inflections.yml`, find the first commit that introduced `inflections.yml`, find the COMMIT_SHA, and then run `git show COMMIT_SHA` to see what your inflections file looked like before (note that you may have changed `inflections.yml` since then, though).
+
+`config/inflections.yml`
+```yml
+# List your inflections in this file instead of `inflections.rb`
+# See steps to set up custom inflections:
+# https://github.com/Shopify/packwerk/blob/main/USAGE.md#Inflections
+
+acronym:
+ - 'HTML'
+ - 'API'
+
+singular:
+ - ['oxen', 'oxen']
+
+irregular:
+ - ['person', 'people']
+
+uncountable:
+ - 'fish'
+ - 'sheep'
+```
+
+`config/initializers/inflections.rb`
+```ruby
+ActiveSupport::Inflector.inflections(:en) do |inflect|
+  inflect.acronym('HTML')
+  inflect.acronym('API')
+
+  inflect.singular('oxen', 'oxen')
+
+  inflect.irregular('person', 'people')
+
+  inflect.uncountable('fish')
+  inflect.uncountable('sheep')
+ end
+```

data/USAGE.md

@@ -9,7 +9,6 @@
   * [Setting up Spring](#setting-up-spring)
 * [Configuring Packwerk](#configuring-packwerk)
   * [Using a custom ERB parser](#using-a-custom-erb-parser)
-  * [Inflections](#inflections)
 * [Validating the package system](#validating-the-package-system)
 * [Defining packages](#defining-packages)
   * [Package metadata](#package-metadata)
@@ -57,7 +56,6 @@ Here is a list of files generated:
 |-----------------------------|--------------|------------|
 | Packwerk configuration      | packwerk.yml | See [Setting up the configuration file](#Setting-up-the-configuration-file) |
 | Root package                | package.yml  | A package for the root folder |
-| Custom inflections          | config/inflections.yml | A custom inflections file is only required if you have custom inflections in `inflections.rb`, see [Inflections](#Inflections) |
 
 After that, you may begin creating packages for your application. See [Defining packages](#Defining-packages)
 
@@ -77,9 +75,10 @@ Packwerk reads from the `packwerk.yml` configuration file in the root directory.
 | include              | **/*.{rb,rake,erb}                        | list of patterns for folder paths to include |
 | exclude              | {bin,node_modules,script,tmp,vendor}/**/* | list of patterns for folder paths to exclude |
 | package_paths        | **/                                       | a single pattern or a list of patterns to find package configuration files, see: [Defining packages](#Defining-packages) |
-| load_paths           | All application autoload paths            | list of load paths |
 | custom_associations  | N/A                                       | list of custom associations, if any |
 | parallel             | true                                      | when true, fork code parsing out to subprocesses |
+| cache                | false                                     | when true, caches the results of parsing files |
+| cache_directory      | tmp/cache/packwerk                        | the directory that will hold the packwerk cache |
 
 ### Using a custom ERB parser
 
@@ -103,44 +102,10 @@ end
 Packwerk::Parsers::Factory.instance.erb_parser_class = CustomParser
 ```
 
-### Inflections
+## Using the cache
+Packwerk ships with an cache to help speed up file parsing. You can turn this on by setting `cache: true` in `packwerk.yml`.
 
-Packwerk requires custom inflections to be defined in `inflections.yml` instead of the traditional `inflections.rb`. This is because Packwerk accounts for custom inflections, such as acronyms, when resolving constants. Additionally, Packwerk interprets Active Record associations as references to constants. For example, `has_many :birds` is a reference to the `Bird` constant.
-
-In order to make your custom inflections compatible with Active Support and Packwerk, you must create a `config/inflections.yml` file and point `ActiveSupport::Inflector` to that file.
-
-In `inflections.rb`, add:
-
-```rb
-require "packwerk/inflections/custom"
-
-ActiveSupport::Inflector.inflections do |inflect|
-  # please add all custom inflections in the file below.
-  Packwerk::Inflections::Custom.new(
-    Rails.root.join("config", "inflections.yml")
-  ).apply_to(inflect)
-end
-```
-
-_Note: Packwerk has to be grouped in production environment within the Gemfile if you have custom inflections._
-
-Next, move your existing custom inflections into `config/inflections.yml`:
-
-```yaml
-acronym:
-  - 'GraphQL'
-  - 'MRuby'
-  - 'TOS'
-irregular:
-  - ['analysis', 'analyses']
-  - ['reserve', 'reserves']
-uncountable:
-  - 'payment_details'
-singular:
-  - [!ruby/regexp /status$/, 'status']
-```
-
-Any new inflectors should be added to `config/inflections.yml`.
+This will write to `tmp/cache/packwerk`.
 
 ## Validating the package system
 

data/lib/packwerk/application_validator.rb

@@ -1,7 +1,6 @@
-# typed: true
+# typed: strict
 # frozen_string_literal: true
 
-require "active_support/inflector/inflections"
 require "constant_resolver"
 require "pathname"
 require "yaml"
@@ -10,23 +9,41 @@ module Packwerk
   # Checks the structure of the application and its packwerk configuration to make sure we can run a check and deliver
   # correct results.
   class ApplicationValidator
+    extend T::Sig
+
+    sig do
+      params(
+        config_file_path: String,
+        configuration: Configuration,
+        environment: String
+      ).void
+    end
     def initialize(config_file_path:, configuration:, environment:)
       @config_file_path = config_file_path
       @configuration = configuration
       @environment = environment
-
-      @application_load_paths = ApplicationLoadPaths.extract_relevant_paths(configuration.root_path, environment)
+      @package_set = T.let(PackageSet.load_all_from(@configuration.root_path, package_pathspec: package_glob),
+        PackageSet)
     end
 
-    Result = Struct.new(:ok?, :error_value)
+    class Result < T::Struct
+      extend T::Sig
+
+      const :ok, T::Boolean
+      const :error_value, T.nilable(String)
 
+      sig { returns(T::Boolean) }
+      def ok?
+        ok
+      end
+    end
+
+    sig { returns(Result) }
     def check_all
       results = [
-        check_autoload_path_cache,
         check_package_manifests_for_privacy,
         check_package_manifest_syntax,
         check_application_structure,
-        check_inflection_file,
         check_acyclic_graph,
         check_package_manifest_paths,
         check_valid_package_dependencies,
@@ -36,21 +53,7 @@ module Packwerk
       merge_results(results)
     end
 
-    def check_autoload_path_cache
-      expected = Set.new(@application_load_paths)
-      actual = Set.new(@configuration.load_paths)
-      if expected == actual
-        Result.new(true)
-      else
-        Result.new(
-          false,
-          "Load path cache in #{@config_file_path} incorrect!\n"\
-          "Paths missing from file:\n#{format_yaml_strings(expected - actual)}\n"\
-          "Extraneous load paths in file:\n#{format_yaml_strings(actual - expected)}"
-        )
-      end
-    end
-
+    sig { returns(Result) }
     def check_package_manifests_for_privacy
       privacy_settings = package_manifests_settings_for("enforce_privacy")
 
@@ -59,13 +62,13 @@ module Packwerk
         load_paths: @configuration.load_paths
       )
 
-      results = []
+      results = T.let([], T::Array[Result])
 
       privacy_settings.each do |config_file_path, setting|
         next unless setting.is_a?(Array)
         constants = setting
 
-        assert_constants_can_be_loaded(constants)
+        results += assert_constants_can_be_loaded(constants, config_file_path)
 
         constant_locations = constants.map { |c| [c, resolver.resolve(c)&.location] }
 
@@ -81,6 +84,7 @@ module Packwerk
       merge_results(results, separator: "\n---\n")
     end
 
+    sig { returns(Result) }
     def check_package_manifest_syntax
       errors = []
 
@@ -122,12 +126,13 @@ module Packwerk
       end
 
       if errors.empty?
-        Result.new(true)
+        Result.new(ok: true)
       else
-        Result.new(false, errors.join("\n---\n"))
+        Result.new(ok: false, error_value: errors.join("\n---\n"))
       end
     end
 
+    sig { returns(Result) }
     def check_application_structure
       resolver = ConstantResolver.new(
         root_path: @configuration.root_path.to_s,
@@ -136,59 +141,27 @@ module Packwerk
 
       begin
         resolver.file_map
-        Result.new(true)
+        Result.new(ok: true)
       rescue => e
-        Result.new(false, e.message)
-      end
-    end
-
-    def check_inflection_file
-      inflections_file = @configuration.inflections_file
-
-      application_inflections = ActiveSupport::Inflector.inflections
-      packwerk_inflections = Packwerk::Inflector.from_file(inflections_file).inflections
-
-      results = %i(plurals singulars uncountables humans acronyms).map do |type|
-        expected = application_inflections.public_send(type).to_set
-        actual = packwerk_inflections.public_send(type).to_set
-
-        if expected == actual
-          Result.new(true)
-        else
-          missing_msg = unless (expected - actual).empty?
-            "Expected #{type} to be specified in file: #{expected - actual}"
-          end
-          extraneous_msg = unless (actual - expected).empty?
-            "Extraneous #{type} was specified in file: #{actual - expected}"
-          end
-          Result.new(
-            false,
-            [missing_msg, extraneous_msg].join("\n")
-          )
-        end
+        Result.new(ok: false, error_value: e.message)
       end
-
-      merge_results(
-        results,
-        separator: "\n",
-        errors_headline: "Inflections specified in #{inflections_file} don't line up with application!\n"
-      )
     end
 
+    sig { returns(Result) }
     def check_acyclic_graph
-      edges = package_set.flat_map do |package|
-        package.dependencies.map { |dependency| [package, package_set.fetch(dependency)] }
+      edges = @package_set.flat_map do |package|
+        package.dependencies.map { |dependency| [package, @package_set.fetch(dependency)] }
       end
-      dependency_graph = Packwerk::Graph.new(*T.unsafe(edges))
+      dependency_graph = Graph.new(*T.unsafe(edges))
 
       cycle_strings = build_cycle_strings(dependency_graph.cycles)
 
       if dependency_graph.acyclic?
-        Result.new(true)
+        Result.new(ok: true)
       else
         Result.new(
-          false,
-          <<~EOS
+          ok: false,
+          error_value: <<~EOS
             Expected the package dependency graph to be acyclic, but it contains the following cycles:
 
             #{cycle_strings.join("\n")}
@@ -197,6 +170,7 @@ module Packwerk
       end
     end
 
+    sig { returns(Result) }
     def check_package_manifest_paths
       all_package_manifests = package_manifests("**/")
       package_paths_package_manifests = package_manifests(package_glob)
@@ -204,11 +178,11 @@ module Packwerk
       difference = all_package_manifests - package_paths_package_manifests
 
       if difference.empty?
-        Result.new(true)
+        Result.new(ok: true)
       else
         Result.new(
-          false,
-          <<~EOS
+          ok: false,
+          error_value: <<~EOS
             Expected package paths for all package.ymls to be specified, but paths were missing for the following manifests:
 
             #{relative_paths(difference).join("\n")}
@@ -217,6 +191,7 @@ module Packwerk
       end
     end
 
+    sig { returns(Result) }
     def check_valid_package_dependencies
       packages_dependencies = package_manifests_settings_for("dependencies")
         .delete_if { |_, deps| deps.nil? }
@@ -228,7 +203,7 @@ module Packwerk
         end
 
       if packages_with_invalid_dependencies.empty?
-        Result.new(true)
+        Result.new(ok: true)
       else
         error_locations = packages_with_invalid_dependencies.map do |package, invalid_dependencies|
           package ||= @configuration.root_path
@@ -242,8 +217,8 @@ module Packwerk
         end
 
         Result.new(
-          false,
-          <<~EOS
+          ok: false,
+          error_value: <<~EOS
             These dependencies do not point to valid packages:
 
             #{error_locations.join("\n")}
@@ -252,16 +227,17 @@ module Packwerk
       end
     end
 
+    sig { returns(Result) }
     def check_root_package_exists
       root_package_path = File.join(@configuration.root_path, "package.yml")
       all_packages_manifests = package_manifests(package_glob)
 
       if all_packages_manifests.include?(root_package_path)
-        Result.new(true)
+        Result.new(ok: true)
       else
         Result.new(
-          false,
-          <<~EOS
+          ok: false,
+          error_value: <<~EOS
             A root package does not exist. Create an empty `package.yml` at the root directory.
           EOS
         )
@@ -277,6 +253,7 @@ module Packwerk
     # to the string:
     #
     #   ["a -> b -> c -> a", "b -> c -> b"]
+    sig { params(cycles: T.untyped).returns(T::Array[String]) }
     def build_cycle_strings(cycles)
       cycles.map do |cycle|
         cycle_strings = cycle.map(&:to_s)
@@ -285,84 +262,102 @@ module Packwerk
       end
     end
 
+    sig { params(setting: T.untyped).returns(T.untyped) }
     def package_manifests_settings_for(setting)
       package_manifests.map { |f| [f, (YAML.load_file(File.join(f)) || {})[setting]] }
     end
 
+    sig { params(list: T.untyped).returns(T.untyped) }
     def format_yaml_strings(list)
       list.sort.map { |p| "- \"#{p}\"" }.join("\n")
     end
 
+    sig { returns(T.any(T::Array[String], String)) }
     def package_glob
       @configuration.package_paths || "**"
     end
 
+    sig { params(glob_pattern: T.any(T::Array[String], String)).returns(T::Array[String]) }
     def package_manifests(glob_pattern = package_glob)
       PackageSet.package_paths(@configuration.root_path, glob_pattern, @configuration.exclude)
         .map { |f| File.realpath(f) }
     end
 
+    sig { params(paths: T::Array[String]).returns(T::Array[Pathname]) }
     def relative_paths(paths)
       paths.map { |path| relative_path(path) }
     end
 
+    sig { params(path: String).returns(Pathname) }
     def relative_path(path)
       Pathname.new(path).relative_path_from(@configuration.root_path)
     end
 
+    sig { params(path: T.untyped).returns(T::Boolean) }
     def invalid_package_path?(path)
       # Packages at the root can be implicitly specified as "."
       return false if path == "."
 
-      package_path = File.join(@configuration.root_path, path, Packwerk::PackageSet::PACKAGE_CONFIG_FILENAME)
+      package_path = File.join(@configuration.root_path, path, PackageSet::PACKAGE_CONFIG_FILENAME)
       !File.file?(package_path)
     end
 
-    def assert_constants_can_be_loaded(constants)
-      constants.each(&:constantize)
-      nil
+    sig { params(constants: T.untyped, config_file_path: String).returns(T::Array[Result]) }
+    def assert_constants_can_be_loaded(constants, config_file_path)
+      constants.map do |constant|
+        if !constant.start_with?("::")
+          Result.new(
+            ok: false,
+            error_value: "'#{constant}', listed in the 'enforce_privacy' option in #{config_file_path}, is invalid.\n"\
+            "Private constants need to be prefixed with the top-level namespace operator `::`."
+          )
+        else
+          constant.try(&:constantize) && Result.new(ok: true)
+        end
+      end
     end
 
+    sig { params(name: T.untyped, config_file_path: T.untyped).returns(Result) }
     def private_constant_unresolvable(name, config_file_path)
       explicit_filepath = (name.start_with?("::") ? name[2..-1] : name).underscore + ".rb"
 
       Result.new(
-        false,
-        "'#{name}', listed in #{config_file_path}, could not be resolved.\n"\
+        ok: false,
+        error_value: "'#{name}', listed in #{config_file_path}, could not be resolved.\n"\
         "This is probably because it is an autovivified namespace - a namespace module that doesn't have a\n"\
         "file explicitly defining it. Packwerk currently doesn't support declaring autovivified namespaces as\n"\
         "private. Add a #{explicit_filepath} file to explicitly define the constant."
       )
     end
 
+    sig { params(name: T.untyped, location: T.untyped, config_file_path: T.untyped).returns(Result) }
     def check_private_constant_location(name, location, config_file_path)
-      declared_package = package_set.package_from_path(relative_path(config_file_path))
-      constant_package = package_set.package_from_path(location)
+      declared_package = @package_set.package_from_path(relative_path(config_file_path))
+      constant_package = @package_set.package_from_path(location)
 
       if constant_package == declared_package
-        Result.new(true)
+        Result.new(ok: true)
       else
         Result.new(
-          false,
-          "'#{name}' is declared as private in the '#{declared_package}' package but appears to be "\
+          ok: false,
+          error_value: "'#{name}' is declared as private in the '#{declared_package}' package but appears to be "\
           "defined\nin the '#{constant_package}' package. Packwerk resolved it to #{location}."
         )
       end
     end
 
-    def package_set
-      @package_set ||= Packwerk::PackageSet.load_all_from(@configuration.root_path, package_pathspec: package_glob)
+    sig do
+      params(results: T::Array[Result], separator: String, errors_headline: String).returns(Result)
     end
-
     def merge_results(results, separator: "\n===\n", errors_headline: "")
       results.reject!(&:ok?)
 
       if results.empty?
-        Result.new(true)
+        Result.new(ok: true)
       else
         Result.new(
-          false,
-          errors_headline + results.map(&:error_value).join(separator)
+          ok: false,
+          error_value: errors_headline + results.map(&:error_value).join(separator)
         )
       end
     end

data/lib/packwerk/association_inspector.rb

@@ -19,7 +19,7 @@ module Packwerk
       CustomAssociations
     )
 
-    sig { params(inflector: Inflector, custom_associations: CustomAssociations).void }
+    sig { params(inflector: T.class_of(ActiveSupport::Inflector), custom_associations: CustomAssociations).void }
     def initialize(inflector:, custom_associations: Set.new)
       @inflector = inflector
       @associations = T.let(RAILS_ASSOCIATIONS + custom_associations, CustomAssociations)