leftovers 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2e0c74dad85b7b571608a7207f006fe14d5748e1a155470185112b80a7b80a3
-  data.tar.gz: 68f3d83b310f640e127b961e6ac2ece795a7b9e2a6de961a1b42498916e092d7
+  metadata.gz: 36067c7870efb2d16529b0af04739161fc445c310bd5eab7b4b5ff5ccf556126
+  data.tar.gz: 5953a6893935af8ac6f1c33afad540c097515a12c4dede73261079cbbd2a561d
 SHA512:
-  metadata.gz: c57c64254cc2092e38b8decfd7bde0a021d66a7c3f563dc3e1f5a68b91c4bfc7b16a8490e5437b3da942071d41d2c35c247e1e51739064e14fdfcc6653b192b3
-  data.tar.gz: b129119436c793987c89b032d5936b10ca935c7fc5398e7a2843665bbfec28ccaacd0a0090c8cd37c5172b6892f4291455aef40df6bae67727d25ac47fd871a3
+  metadata.gz: 70b0cd0d8f3caa5f14282b36bf7f3776a1b0396485a7cfb7fb66460fc3f287edf7ed1d8f733ce303fcb67704c8839df2bb9eb105c761f492b53e1ea575b8f685
+  data.tar.gz: f43bf9b235fcc43dfdf0d322037523f659214d35387ad788dc5f2c8453a74ef74861db6cca91dc9ae159f8122edcf2fbb6adb9fa107b69e74a753b4e4d286d42

data/CHANGELOG.md

@@ -1,3 +1,20 @@
+# v0.9.0
+- Automatically test the config examples in the documentation, and fix the errors
+- simplify the `type: Proc` matcher
+- Update FastIgnore dependency, make fewer filesystem calls
+- Comprehensively describe all of ruby core and rails
+  This required/revealed a number of additions to the config
+  - Improve the performance of large config files by squash the config matching more
+  - Add `names:` and `has_arguments:` to `has_value:`.
+  - Fix error when positional `has_arguments:`/`has_value: at:` checks a node without arguments
+  - Add `eval` as a processing type, alongside `calls:` and `defines:`, this will process allow processing literal calls to instance_eval etc.
+  - Allow calling or defining based on the `receiver:`
+  - `all: []` & `any: []` arguments to dynamic/keep/test_only
+  - add `arguments: 1+` or `has_arguments: { at: 1+, has_value: true }` to match arguments from that position onward
+  - allow `has_arguments:` and `has_receiver:` (and `unless:` and `all:` and `any:` of those) to go within `calls:`,`defines:`,`set_privacy:`,`add_prefix:`,`add_suffix:` for cases like the `delegate prefix: true` vs `delegate prefix: :value` without having to redefine everything.
+  - allow `has_arguments.at` and `arguments:` to have a `type:` to distinguish between e.g. symbol keys and string keys.
+- Add a way to test custom precompilers with --view-compiled [PATH_PATTERNS...]
+
 # v0.8.0
 - Allow custom precompilers
   ```yml

data/README.md

@@ -15,7 +15,7 @@ Code that never gets executed is code that you shouldn't need to maintain
 
 Leftovers will use static analysis to find these bits of code for you.
 
-It's aware of how some gems call methods for you, including (still somewhat incomplete) support for rails.
+It's aware of how some gems call methods for you, including support for much of rails.
 
 ## Features
 
@@ -141,21 +141,21 @@ This would consider `puts` and `warn` to both have been called
 To mark a dynamic call for literal hash and array values without enumerating everything in the comment again, use `leftovers:dynamic:`  on the same line as the beginning of the array or hash
 
 ```ruby
-[ # leftovers:dynamic:call_login
+[ # leftovers:dynamic:call_attributes
   :user,
   :admin
-].each { |method| send("#{method}_login") }
+].map { |method| send("#{method}_attributes") }
 ```
 
 with the following configuration matching the `name: value` to the `leftovers:dynamic:process_name`
 
 ```yaml
 dynamic:
-  name: call_login
+  name: call_attributes
   arguments: '*'
-  add_suffix: '_login'
+  add_suffix: '_attributes'
 ```
-This would consider `user_login` and `admin_login` to both have been called.
+This would consider `user_attributes` and `admin_attributes` to both have been called.
 
 ## Configuration file
 
@@ -201,7 +201,7 @@ To install this gem onto your local machine, run `bundle exec rake install`.
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/robotdana/leftovers.
 
-I especially encourage issues and improvements to the default config, whether expanding the existing config/*.yml (rails.yml is particularly incomplete) or adding new gems.
+I especially encourage issues and improvements to the default config, whether expanding the existing config/*.yml or adding new gems.
 The file should be named `[rubygems name].yml` and its structure is identical to the [project config](#configuration)
 
 ## License

data/docs/Configuration.md

@@ -99,10 +99,10 @@ Define any precompilers and the paths they affect.
 
 `paths:` are defined using the [.gitignore pattern format](https://git-scm.com/docs/gitignore#_pattern_format)
 
-`format:` must be one of the predefined precompilers (erb, haml, [json](#format-json), slim, [yaml](#format-yaml)), or `custom:` with the name of a [custom precompiler]('../Custom-Precompilers.md) module.
+`format:` must be one of the predefined precompilers (erb, haml, [json](#format-json), slim, [yaml](#format-yaml)), or `custom:` with the name of a [custom precompiler](https://github.com/robotdana/leftovers/blob/main/docs/Custom-Precompilers.md) module.
 (use [`require:`](#requires) to have leftovers load its file)
 
-See [Custom precompilers]('../Custom-Precompilers.md) for more details on the custom precompiler class
+See [Custom precompilers](https://github.com/robotdana/leftovers/blob/main/docs/Custom-Precompilers.md) for more details on the custom precompiler class
 
 Arrays are not necessary for single values.
 
@@ -113,7 +113,7 @@ and renders the structure of the yaml document as arguments for the [`document:t
 
 so you could, e.g. read the class name out of a yaml document like:
 
-```yml
+```
 class_name: MyClass
 ```
 
@@ -187,7 +187,9 @@ Each entry can be a string (an exact match for a method, constant, or variable n
 - [`has_receiver:`](#has_receiver)
 - [`type:`](#type)
 - [`privacy:`](#privacy)
-- [`unless`](#unless)
+- [`unless:`](#unless)
+- [`all:`](#any-all)
+- [`any:`](#any-all)
 
 Arrays are not necessary for single values
 
@@ -198,7 +200,6 @@ keep:
   - ssl_configured?
   - has_suffix: Helper
     path: /app/helpers
-  ...
 ```
 
 Alternatively, you can mark method/constants/variables in-place using [magic comments](https://github.com/robotdana/leftovers/tree/main/README.md#magic-comments).
@@ -215,7 +216,12 @@ Each entry can be a string (an exact match for a method, constant, or variable n
   - [`matches:`](#matches)
 - [`paths:`](#paths)
 - [`has_arguments:`](#has_arguments)
+- [`has_receiver:`](#has_receiver)
+- [`type:`](#type)
+- [`privacy:`](#privacy)
 - [`unless`](#unless)
+- [`all:`](#any-all)
+- [`any:`](#any-all)
 
 Arrays are not necessary for single values
 
@@ -226,7 +232,6 @@ test_only:
   - ssl_configured?
   - has_suffix: Helper
     path: /app/helpers
-  ...
 ```
 
 Alternatively, you can mark method/constants/variables in-place using [magic comments](https://github.com/robotdana/leftovers/tree/main/README.md#magic-comments).
@@ -241,17 +246,22 @@ Each entry must have at least one of the following properties to restrict which
   - [`has_prefix:`](#has_prefix)
   - [`has_suffix:`](#has_suffix)
   - [`matches:`](#matches)
+- [`document: true`](#document-true)
 - [`paths:`](#paths)
 - [`has_arguments:`](#has_arguments)
 - [`has_receiver:`](#has_receiver)
+- [`type:`](#type)
+- [`privacy:`](#privacy)
 - [`unless:`](#unless)
-- [`document: true`](#document-true)
+- [`all:`](#any-all)
+- [`any:`](#any-all)
 
 And must have at least one of
 - ['calls:`](#calls-defines)
 - [`defines:`](#calls-defines)
 - [`set_privacy:](#set-privacy)
 - [`set_default_privacy:`](#set-default-privacy)
+- [`eval:`](#eval)
 
 Arrays are not necessary for single values.
 
@@ -266,7 +276,6 @@ dynamic:
     calls:
       arguments: '*'
       add_prefix: '@'
-    ...
 ```
 
 ## `names:`
@@ -289,7 +298,6 @@ keep:
   - names:
       has_suffix: Helper
     path: /app/helpers
-  ...
 ```
 
 ## `has_prefix:`, `has_suffix:`
@@ -351,7 +359,7 @@ Instructs to consider the whole document. this is useful when parsing [YAML](#ya
 e.g.
 
 ```yml
-includes: /config/roles.yml
+include_paths: /config/roles.yml
 dynamic:
   - document: true
     path: /config/roles.yml
@@ -362,7 +370,7 @@ dynamic:
 ```
 
 will parse "config/roles.yml"
-```yml
+```
 - build_house
 - drive_car
 ```
@@ -393,8 +401,10 @@ also there may be any or all of these properties:
   - [`add_suffix:`](#add_prefix-add_suffix)
   - [`delete_prefix:`](#delete_prefix-delete_suffix)
   - [`delete_suffix:`](#delete_prefix-delete_suffix)
-  - [`delete_before:`](#delete_before-delete_after)
-  - [`delete_after:`](#delete_before-delete_after)
+  - [`delete_before:`](#delete_before-delete_after--delete_before_last-delete_after_last)
+  - [`delete_after:`](#delete_before-delete_after--delete_before_last-delete_after_last)
+  - [`delete_before_last:`](#delete_before-delete_after-delete_before_last-delete_after_last)
+  - [`delete_after_last:`](#delete_before-delete_after-delete_before_last-delete_after_last)
   - [`split:`](#split)
   - [`downcase:`](#downcase-upcase-capitalize-swapcase)
   - [`upcase:`](#downcase-upcase-capitalize-swapcase)
@@ -417,13 +427,13 @@ dynamic:
       - send
     calls:
       arguments:
-        - 1
+        - 0
 ```
 is equivalent to:
 ```yml
 dynamic:
   name: send
-  calls: 1
+  calls: 0
 ```
 
 ## `set_privacy:`
@@ -463,6 +473,27 @@ dynamic:
 
 these methods could then be filtered using the [`privacy:`](#privacy) method in another [`dynamic:`](#dynamic) or [`keep:`](#keep) rule.
 
+## `eval:`
+
+Eval has the same requirements as [`calls:` & `defines:`](#calls-defines).
+
+it parses a string or transformed string as ruby, using the same rules as the containing file
+For example:
+
+```yml
+dynamic:
+  name: eval_later
+  eval:
+    argument: my_ruby_string
+```
+
+with the ruby:
+```ruby
+eval_later(delay: 1000, my_ruby_string: "MyClass.puts 'shenanigans'")
+```
+
+would consider `MyClass`, and `puts` to have been called.
+
 ## `arguments:`
 _alias `argument:`_
 
@@ -503,11 +534,11 @@ When the keyword argument **keywords** are the thing being called.
 ```yml
 dynamic:
   - name: validates
-      calls:
-        - arguments: '*'
-        - keywords: '**'
-          camelize: true
-          add_suffix: Validator
+    calls:
+      - arguments: '*'
+      - keywords: '**'
+        camelize: true
+        add_suffix: Validator
 ```
 ```ruby
 validates :first_name, :surname, presence: true
@@ -526,7 +557,9 @@ This can be used in:
 Each entry can be any of:
 - `'*'`: matches all positional arguments/array positions
 - `'**'`: matches all keyword arguments/hash positions
-- any positive Integer: matches the 1-indexed argument position/array position
+- `1+`, `2+`, etc: matches all positional arguments/array elements at or greater than the 0-indexed position
+- any Integer: matches the 0-indexed argument position/array position
+- negative values match positions counting from the end, e.g. `-1` is the last item
 - any other String: matches the keyword argument or hash value, where the keyword/hash key string or symbol
 - or have at least one of the following properties to match the keyword/hash key string or symbol:
   - [`has_prefix:`](#has_prefix)
@@ -535,6 +568,41 @@ Each entry can be any of:
 
 Arrays are not necessary for single values
 
+## `any:`, `all:`
+
+filter by `any:` or `all:` of the argument filters
+
+by default array values match any of the values,
+and hash values are match all of the values
+
+```yml
+dynamic:
+  name: my_method
+  has_receiver: MyReceiver
+  has_arguments:
+    - part_a
+    - part_b
+  calls: 0
+```
+
+will match the first argument of anything named my_method, with the receiver MyReceiver that has the keyword argument part_a and/or part_b.
+
+to avoid this default use `all:` and/or `any:`
+
+```yml
+dynamic:
+  any:
+    - name: my_method
+    - has_receiver: MyReceiver
+  all:
+    - has_argument: part_a
+    - has_argument: part_b
+  calls: 0
+```
+
+will match the first argument of anything named my_method or with the receiver MyReceiver, that have both the keyword arguments part_a and part_b
+
+
 ## `has_value:`, `has_receiver:`
 
 filter [`arguments:`](#arguments), [`has_arguments:`](#has_arguments), and [`keywords:`](#keywords), by the argument/assigned/receiver value
@@ -606,7 +674,7 @@ e.g.
 dynamic:
   - names: my_method
     calls:
-      argument: 2
+      argument: 1
       nested:
         argument: '*'
         nested:
@@ -643,6 +711,7 @@ The original method/constant/variable name will continue to be called/defined as
 This can be used in [`calls:`](#calls-defines) and [`defines:`](#calls-defines)
 
 ```yml
+dynamic:
 - name:
     has_prefix: be_
   calls:
@@ -661,6 +730,7 @@ Will supply a literal string value method/constant/variable name itself as the t
 This can be used in [`calls:`](#calls-defines) and [`defines:`](#calls-defines).
 
 ```yml
+dynamic:
 - name: perform_async
   calls:
     value: perform
@@ -683,8 +753,10 @@ Each entry can have a string that is an argumentless transform (e.g. capitalize)
 - [`add_suffix:`](#add_prefix-add_suffix)
 - [`delete_prefix:`](#delete_prefix-delete_suffix)
 - [`delete_suffix:`](#delete_prefix-delete_suffix)
-- [`delete_before:`](#delete_before-delete_after)
-- [`delete_after:`](#delete_before-delete_after)
+- [`delete_before:`](#delete_before-delete_after-delete_before_last-delete_after_last)
+- [`delete_after:`](#delete_before-delete_after-delete_before_last-delete_after_last)
+- [`delete_before_last:`](#delete_before-delete_after-delete_before_last-delete_after_last)
+- [`delete_after_last:`](#delete_before-delete_after-delete_before_last-delete_after_last)
 - [`split:`](#split)
 - [`downcase`](#downcase-upcase-capitalize-swapcase) or `downcase: true`
 - [`upcase`](#downcase-upcase-capitalize-swapcase) or `upcase: true`
@@ -699,26 +771,43 @@ Each entry can have a string that is an argumentless transform (e.g. capitalize)
   - [`deconstantize`](#pluralize-singularize-camelize-demodulize-deconstantize-parameterize-titleize-underscore) or `deconstantize: true`
   - [`titleize`](#pluralize-singularize-camelize-demodulize-deconstantize-parameterize-titleize-underscore) or `titleize: true`
   - [`parameterize`](#pluralize-singularize-camelize-demodulize-deconstantize-parameterize-titleize-underscore) or `parameterize: true`
+  - `transforms:`
 
 If any one of these `transforms:` entries are used, all count as being used. To have these be counted independently instead, create multiple entries in the `defines:` list.
 
 ```yml
+dynamic:
 - name: attribute
-    defines:
-      - argument: 1
-        transforms:
-          - original # no transformation
-          - add_suffix: '?'
-          - add_suffix: '='
+  defines:
+    - argument: 0
+      transforms:
+        - original # no transformation
+        - add_suffix: '?'
+        - add_suffix: '='
 ```
 ```ruby
 attribute :first_name
 ```
 will count as a definition of `first_name`, `first_name=` and `first_name?`. `firstname=` wouldn't be reported on, even if only `first_name` and `first_name?` were used.
 
+```yml
+dynamic:
+- name: attr_accessor
+  defines:
+    - argument: '*'
+    - argument: '*'
+      transforms:
+        add_suffix: '='
+```
+```ruby
+attr_accessor :first_name
+```
+will count the calls to `first_name` and `first_name=` separately, with the understand it can be swapped to attr_reader or attr_writer if one or other isn't used.
+
 Arrays are not necessary for single values, and if there is just one set of transforms, the `transforms:` keyword can be omitted and everything moved up a level.
 
 ```yml
+dynamic:
 - name: attr_writer
   defines:
     - argument: '*'
@@ -729,6 +818,21 @@ attr_writer :first_name, :surname
 ```
 will count as the definition of `first_name=`, and `surname=`
 
+Multiple transform arguments will be applied sequentially
+```yml
+dynamic:
+- name: has_many
+  calls:
+    - argument: 0
+      singularize: true
+      camelize: true
+      split: '::'
+```
+```ruby
+has_many :users
+```
+counts as a call to `User`
+
 ## `original`
 
 Can be used in the [`transforms:`](#transforms) list, if used in a hash `true` can be used as a placeholder value
@@ -758,11 +862,16 @@ if multiple transform results are possible (from multiple entries), then all res
 
 Arrays are not necessary for single values
 
-## `delete_before:`, `delete_after:`
+## `delete_before:`, `delete_after:`, `delete_before_last:`, `delete_after_last:`
 
 Can be used in the [`transforms:`](#transforms) list (or anywhere `transforms:` is able to be omitted).
 
-Each entry is a literal string, and _if present_ the string and everything before/after will be removed from the incoming value (if it's not present, this transform will continue to the next transform/result unmodified). if it's present multiple times then it will always be everything before/after the first substring match
+Each entry is a literal string, and _if present_ the string and everything before/after will be removed from the incoming value (if it's not present, this transform will continue to the next transform/result unmodified).
+
+- `delete_before:` will delete everything before and including the _first_ occurrence
+- `delete_after:` will delete everything after and including the _first_ occurrence
+- `delete_before_last:` will delete everything before and including the _last_ occurrence
+- `delete_after_last:` will delete everything after and including the _last_ occurrence
 
 if multiple transform results are possible (from multiple entries), then all results will be used.
 

data/docs/Custom-Precompilers.md

@@ -36,3 +36,9 @@ Define which paths use the custom precompiler using [`precompile:`](https://gith
 reference the name of the precompiler with `format: { custom: MyNotRubyPrecompiler }`
 
 If the `precompile` method raises any errors while precompiling, a warning will be printed to stderr and the file will be skipped
+
+To test the output of the precompiler you can use the `--view-compiled` flag with a list of paths or path patterns, like so:
+
+`bundle exec leftovers --view-compiled '*.not_rb'`
+
+

data/leftovers.gemspec

@@ -44,6 +44,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rubocop-performance'
   spec.add_development_dependency 'rubocop-rake'
   spec.add_development_dependency 'rubocop-rspec'
+  spec.add_development_dependency 'ruby-prof'
   spec.add_development_dependency 'simplecov', '>= 0.18.5'
   spec.add_development_dependency 'simplecov-console'
   spec.add_development_dependency 'slim'
@@ -51,7 +52,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'tty_string', '>= 0.2.1'
 
   spec.add_development_dependency 'spellr', '>= 0.8.1'
-  spec.add_dependency 'fast_ignore', '>= 0.15.1'
+  spec.add_dependency 'fast_ignore', '>= 0.17.0'
   spec.add_dependency 'parallel'
   spec.add_dependency 'parser'
 end

data/lib/config/actioncable.yml

@@ -0,0 +1,36 @@
+# https://guides.rubyonrails.org/action_cable_overview.html
+gems:
+  - activesupport
+  - actionpack
+
+keep:
+  # https://guides.rubyonrails.org/action_cable_overview.html#server-side-components-channels-subscriptions
+  # https://api.rubyonrails.org/v7.0.2.2/classes/ActionCable/Channel/Base.html#method-i-subscribed
+  # it's for overriding
+  - subscribed
+  # https://api.rubyonrails.org/v7.0.2.2/classes/ActionCable/Channel/Base.html#method-i-unsubscribed
+  # it's for overriding
+  - unsubscribed
+
+  # https://api.rubyonrails.org/v7.0.2.2/classes/ActionCable/Channel/Base.html
+  - type: Method
+    privacy: public
+    path: /app/channels/**/*_channel.rb
+
+  - path: /app/channels/**/*_channel.rb
+    has_suffix: Channel
+
+
+dynamic:
+  # https://guides.rubyonrails.org/action_cable_overview.html#connection-setup
+  # it's just attr_accessor
+  - names: identified_by
+    define:
+      - argument: '*'
+        transforms:
+          - original
+          - add_suffix: '='
+    call:
+      - argument: '*'
+        add_prefix: '@'
+

data/lib/config/actionmailbox.yml

@@ -0,0 +1,28 @@
+# https://guides.rubyonrails.org/action_mailbox_basics.html
+
+gems:
+  - activesupport
+  - activerecord
+  - activestorage
+  - activejob
+  - actionpack
+
+keep:
+  # https://api.rubyonrails.org/v7.0.2.2/classes/ActionMailbox/Base.html
+  # Overwrite in subclasses
+  - process
+
+dynamic:
+  # https://api.rubyonrails.org/v7.0.2.2/classes/ActionMailbox/Base.html
+  - names: [before_processing, after_processing, around_processing]
+    calls: ['*', if, unless]
+
+  # https://guides.rubyonrails.org/action_mailbox_basics.html#examples
+  # i'm guessing a lot about how this is supposed to work
+  - names: routing
+    calls:
+      arguments: '**'
+      camelize: true
+      add_suffix: Mailbox
+
+

data/lib/config/actionmailer.yml

@@ -1,22 +1,98 @@
-# THIS IS INCOMPLETE (you can help by expanding it)
-# rails is _really complicated_ and has a lot of magic which calls methods for you.
-# some is currently impossible to handle (with_options).
-# Some is just corners of rails I haven't hit yet.
+# https://edgeapi.rubyonrails.org/classes/ActionMailer/Base.html
+# https://guides.rubyonrails.org/action_mailer_basics.html
+gems:
+  - activesupport
+  - actionpack
+  - actionview
+  - activejob
+
 keep:
+  # https://guides.rubyonrails.org/action_mailer_basics.html
   - has_suffix: Preview
-    path: '**/mailers/previews/**/*_preview.rb'
+    path: '/test/mailers/previews/**/*_preview.rb'
+    # this path is the default
+    # if it's overridden copy this into .leftovers.yml with
+    # whatever it was overridden as
+
+  # https://guides.rubyonrails.org/action_mailer_basics.html#intercepting-emails
   - delivering_email
+
+  # https://guides.rubyonrails.org/action_mailer_basics.html#observing-emails
   - delivered_email
 
 dynamic:
-  - names:
-      - deliver_now
-      - deliver_later
-    calls:
-      value:
-        deliver
+  # https://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-callbacks
   - names:
       - before_action
       - after_action
       - around_action
     calls: ['*', if, unless]
+
+  # https://guides.rubyonrails.org/action_mailer_basics.html#intercepting-emails
+  - names: interceptors=
+    has_receiver: action_mailer
+    calls:
+      argument: 0
+      nested: '*'
+      split: '::'
+
+  # https://edgeapi.rubyonrails.org/classes/ActionMailer/Base.html#method-c-register_interceptor
+  - names: register_interceptor
+    calls:
+      argument: 0
+      camelize: true
+      split: '::'
+
+  # https://edgeapi.rubyonrails.org/classes/ActionMailer/Base.html#method-c-register_interceptors
+  - names: register_interceptors
+    calls:
+      argument: '*'
+      camelize: true
+      split: '::'
+
+
+  # https://guides.rubyonrails.org/action_mailer_basics.html#observing-emails
+  - names: observers=
+    has_receiver: action_mailer
+    calls:
+      argument: 0
+      nested: '*'
+      split: '::'
+
+  # https://edgeapi.rubyonrails.org/classes/ActionMailer/Base.html#method-c-register_observer
+  - names: register_observer
+    calls:
+      argument: 0
+      camelize: true
+      split: '::'
+
+  # https://edgeapi.rubyonrails.org/classes/ActionMailer/Base.html#method-c-register_observers
+  - names: register_observers
+    calls:
+      argument: '*'
+      camelize: true
+      split: '::'
+
+  # https://edgeapi.rubyonrails.org/classes/ActionMailer/DeliveryMethods/ClassMethods.html#method-i-add_delivery_method
+  # i'm going to skip this because it immediately calls the method it creates
+  # - names: add_delivery_method
+  #   defines:
+  #     argument: 0
+  #     transforms:
+  #       - add_suffix: _settings=
+  #       - add_suffix: _settings
+  #   calls:
+  #     argument: 0
+  #     add_suffix: _settings=
+
+  # https://edgeapi.rubyonrails.org/classes/ActionMailer/Previews/ClassMethods.html#method-i-register_preview_interceptor
+  - names: register_preview_interceptor
+    calls:
+      argument: 0
+      split: '::'
+
+  # https://edgeapi.rubyonrails.org/classes/ActionMailer/Previews/ClassMethods.html#method-i-register_preview_interceptors
+  - names: register_preview_interceptors
+    calls:
+      argument: '*'
+      split: '::'