leftovers 0.6.0 → 0.9.0

data/lib/config/actioncable.yml

@@ -1,4 +1,36 @@
-# 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://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
-  names:
-    - before_action
-    - after_action
-    - around_action
-  calls: ['*', if, unless]
+  # 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: '::'

data/lib/config/actionpack.yml

@@ -1,24 +1,31 @@
-# 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.
+include_paths: '*.rjs'
+precompile:
+  - paths: '*.rjs'
+    format: erb
 
-include_paths:
-  - '*.rjs'
-  - '*.rhtml'
+gems:
+  - activesupport
+  - actionview
 
-erb_paths:
-  - '*.rjs'
-  - '*.rhtml'
 
 keep:
-  - ssl_configured? # ApplicationController
-  - default_url_options # called by url_for
-  - matches? # called by route constraints
+  # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Scoping.html#method-i-constraints
+  - matches?
+
+  # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Concerns.html#method-i-concern
+  - call
+
+  # https://edgeapi.rubyonrails.org/classes/AbstractController/Rendering.html#method-i-view_assigns
+  - view_assigns
+
+  # https://edgeapi.rubyonrails.org/classes/ActionController/RequestForgeryProtection/ClassMethods.html#method-i-protect_from_forgery
+  - handle_unverified_request
+
   - has_suffix: Helper
     path: /app/helpers
 
 dynamic:
+  # https://edgeapi.rubyonrails.org/classes/AbstractController/Callbacks.html
   - names:
       - after_action
       - append_after_action
@@ -29,11 +36,41 @@ dynamic:
       - prepend_after_action
       - prepend_around_action
       - prepend_before_action
-      - skip_before_action
-      - skip_after_action
-      - skip_around_action
     calls:
       - arguments: ['*', if, unless]
+
+  - names:
+    - skip_after_action
+    - skip_around_action
+    - skip_before_action
+    calls: [if, unless]
+
+  - names: protect_from_forgery
+    calls: [if, unless]
+
+
+  # https://edgeapi.rubyonrails.org/classes/ActionController/Logging/ClassMethods.html#method-i-log_at
+  - names: log_at
+    calls: [if, unless]
+
+
+  - name: helper
+    calls:
+      - arguments: '*'
+        camelize: true
+
+  # https://edgeapi.rubyonrails.org/classes/ActionController/TestCase/Behavior.html
+  - names: [delete, get, head, patch, put, post]
+    unless:
+      has_argument: 1
+    calls: 0
+
+  - names: process
+    calls: 0
+    unless:
+      has_argument: 1
+
+  # https://edgeapi.rubyonrails.org/classes/AbstractController/Helpers/ClassMethods.html
   - name: scope
     unless:
       has_argument:
@@ -44,32 +81,77 @@ dynamic:
       argument: module # routes
       camelize: true
       split: '::'
-  - name: namespace
-    calls:
-      - argument: 0
-        camelize: true
-        split: '::'
-  - name:
-      - rescue_from
-    calls:
-      - argument: [1, with]
+
   - name:
+      # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Base.html#method-i-match
       - match
+      # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/HttpHelpers.html
       - delete
       - get
+      - options
       - patch
       - post
       - put
+      # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Resources.html#method-i-namespace
       - root
     calls:
-      - arguments: [0, action]
-      - argument: '**'
+      - argument: action
+      - argument: controller
+        camelize: true
+        add_suffix: Controller
+        split: '::'
+      - argument: 'to'
         delete_before: '#'
-      - argument: '**'
+      - argument: 'to'
         delete_after: '#'
         camelize: true
         add_suffix: Controller
         split: '::'
+      - argument: module
+        camelize: true
+        split: '::'
+      # these might not make sense for root
+      - argument: { type: String }
+        delete_before: '#'
+      - argument: { type: String }
+        delete_after: '#'
+        camelize: true
+        add_suffix: Controller
+        split: '::'
+
+    # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Base.html#method-i-match
+    # defines:
+      # my logic is, `as:` generates a method you chose, everything else you might just be setting up the routes to be whatever.
+      # argument: as
+      # add_suffix: [_path, _url]
+
+    # unfortunately we can't do this as the method generated by as: depends on scope/namespace and we can't look up yet
+
+  # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Resources.html#method-i-root
+  # in addition to the above nonsense, root can also have the to: as the first positional argument
+  - name: root
+    calls:
+    - argument: 0
+      delete_before: '#'
+    - argument: 0
+      delete_after: '#'
+      camelize: true
+      add_suffix: Controller
+      split: '::'
+  # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/CustomUrls.html#method-i-direct
+  - name: direct
+    defines:
+      argument: 0
+      add_suffix: [_path, _url]
+
+  # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/CustomUrls.html#method-i-resolve
+  - name: resolve
+    calls:
+      argument: 0
+      split: '::'
+
+  # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Resources.html#method-i-resources
+  # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Resources.html#method-i-resource
   - name:
       - resource
       - resources
@@ -176,8 +258,8 @@ dynamic:
   - name:
       - resources
       - resource
+      # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Scoping.html#method-i-controller
       - controller
-      - namespace
     calls:
       - argument: 0
         camelize: true
@@ -190,12 +272,28 @@ dynamic:
         pluralize: true
         add_suffix: Controller
         split: '::'
+
+  # https://api.rubyonrails.org/classes/ActionDispatch/Routing/Mapper/Scoping.html#method-i-namespace
+  - name: namespace
+    has_argument: module
+    calls:
+      argument: module
+      camelize: true
+      split: '::'
+  - name: namespace
+    unless:
+      has_argument: module
+    calls:
+      argument: 0
+      camelize: true
+      split: '::'
+
+  # this is not technically calling these,
+  # but it feels useful nonetheless as permit will (generally) be used to process
+  # before calling AR or AM #create or #update
   - name: permit
     calls:
       arguments: ['*', '**']
       keywords: '**'
       add_suffix: "="
       recursive: true
-  - name: layout
-    calls:
-      argument: 0

data/lib/config/actiontext.yml

@@ -0,0 +1,56 @@
+# https://edgeguides.rubyonrails.org/action_text_overview.html
+
+gems:
+  - activesupport
+  - activerecord
+  - activestorage
+  - actionpack
+
+keep:
+  # https://edgeguides.rubyonrails.org/action_text_overview.html#rendering-attachments
+  - to_attachable_partial_path
+
+dynamic:
+  # https://edgeapi.rubyonrails.org/classes/ActionView/Helpers/FormHelper.html#method-i-rich_text_area
+  - name: rich_text_area
+    has_receiver: true
+    calls:
+      argument: 0
+      transforms:
+        - original
+        - add_suffix: '='
+
+  - name: rich_text_area
+    unless:
+      has_receiver: true
+    calls:
+      - argument: 1
+        transforms:
+         - original
+         - add_suffix: '='
+      - argument: 0
+        add_prefix: '@'
+
+  # https://edgeapi.rubyonrails.org/classes/ActionText/Attribute.html#method-i-has_rich_text
+  - name: has_rich_text
+    defines:
+      argument: 0
+      transforms:
+        # defines its own methods
+        - original
+        - add_suffix: '?'
+        - add_suffix: '='
+        # some scopes
+        - add_prefix: with_rich_text_
+        - { add_prefix: with_rich_text_, add_suffix: _and_embeds }
+        # and has_one with this prefix
+        - add_prefix: rich_text_
+          transforms:
+            # these are copied from has_one
+            - original
+            - add_suffix: '='
+            - add_prefix: build_
+            - add_prefix: create_
+            - { add_prefix: create_, add_suffix: '!' }
+            - add_prefix: reload_
+