Re-generate methods in the existing format.

Author: dblock

.rubocop_todo.yml

@@ -1,28 +1,55 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-09-06 22:02:31 UTC using RuboCop version 1.80.2.
+# on 2025-09-06 22:39:09 UTC using RuboCop version 1.80.2.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 1
+# Offense count: 3
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 24
+  Max: 49
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 27
 
 # Offense count: 1
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 108
+
+# Offense count: 2
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/CyclomaticComplexity:
+  Max: 20
+
+# Offense count: 5
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 16
+  Max: 32
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/PerceivedComplexity:
+  Max: 19
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Rake/Desc:
+  Exclude:
+    - 'tasks/update.rake'
 
 # Offense count: 3
 Security/Open:
   Exclude:
     - 'tasks/lib/docs/events_downloader.rb'
     - 'tasks/lib/docs/methods_downloader.rb'
 
-# Offense count: 3
+# Offense count: 4
 # Configuration parameters: AllowedConstants.
 Style/Documentation:
   Exclude:
@@ -31,8 +58,9 @@ Style/Documentation:
     - 'tasks/lib/docs/downloader.rb'
     - 'tasks/lib/docs/events_downloader.rb'
     - 'tasks/lib/docs/methods_downloader.rb'
+    - 'tasks/lib/slack_api/methods_generator.rb'
 
-# Offense count: 5
+# Offense count: 6
 # This cop supports unsafe autocorrection (--autocorrect-all).
 # Configuration parameters: EnforcedStyle.
 # SupportedStyles: always, always_true, never
@@ -41,6 +69,7 @@ Style/FrozenStringLiteralComment:
     - '**/*.arb'
     - 'tasks/events.rake'
     - 'tasks/lib/docs/downloader.rb'
+    - 'tasks/lib/slack_api/methods_generator.rb'
     - 'tasks/methods.rake'
     - 'tasks/update.rake'
     - 'tasks/validate.rake'

tasks/lib/docs/downloader.rb

@@ -13,8 +13,6 @@ def download!
         events_downloader.download!
       end
 
-      private
-
       def methods_downloader
         @methods_downloader ||= MethodsDownloader.new(target_path)
       end

tasks/lib/slack_api/methods_generator.rb

@@ -0,0 +1,132 @@
+module SlackApi
+  class MethodsGenerator
+    def downloader
+      @downloader ||= SlackApi::Docs::Downloader.new
+    end
+
+    def generate!
+      methods = JSON.load_file(downloader.methods_downloader.methods_path)
+      groups = Set.new
+
+      methods.each do |method_data|
+        groups += method_data['family']
+
+        method_filename = downloader.methods_downloader.method_target_path(method_data['name'])
+        data = JSON.load_file(method_filename)
+
+        process_method(
+          data.merge(
+            'name' => method_data['name'],
+            'group' => method_data['family'].first.split('.').first
+          )
+        )
+      end
+    end
+
+    private
+
+    def process_method(data)
+      args, fields = parse_args(data)
+
+      errors = parse_errors(data)
+      response = parse_response(data)
+
+      result = {
+        group: data['group'],
+        name: data['name'],
+        deprecated: false,
+        desc: data['desc'],
+        args: args,
+        response: response,
+        errors: errors
+      }.merge(fields)
+
+      filename = "methods/#{data['group']}/#{data['name']}.json"
+      FileUtils.mkdir_p("methods/#{data['group']}")
+      File.write(filename, JSON.pretty_generate(result))
+    end
+
+    def parse_args(data)
+      args = {}
+      fields = {}
+
+      data['args']['properties'].each_pair do |name, arg|
+        all = []
+        arg['anyOf']&.each do |coll|
+          all << coll['type'] unless coll['type'] == 'null'
+        end
+        arg['type'] = Array(all).length == 1 ? all.first : all if all.any?
+        arg.delete('anyOf')
+
+        type = massage_type(name, arg, data)
+        required = data['args']['required']&.include?(name)
+
+        desc = arg['desc']
+          &.tap { |t| t.slice!("\n") }
+          &.tap { |t| t << '.' unless t.end_with?('.') }
+          &.gsub('’', "'")
+        example = arg['example'] || arg['default']
+
+        case name
+        when 'token'
+          # ignore token, always required
+        when 'count', 'page'
+          fields['has_paging'] = true
+          fields['default_count'] = 100
+        else
+          h = {}
+          h['required'] = required
+          h['example'] = example if example
+          h['desc'] = desc if desc
+          h['type'] = type if type
+          h['format'] = 'json' if desc&.include?('JSON')
+          args[name] = h
+        end
+      end
+
+      [args.sort.to_h, fields]
+    end
+
+    def massage_type(name, arg, data = {})
+      return 'enum' if arg.key?('enum')
+
+      case name
+      when 'date' then 'date'
+      when 'latest', 'oldest', 'ts' then 'timestamp'
+      when 'file' then 'file'
+      when 'bot', 'user' then 'user'
+      when 'channel'
+        case data[:method_group]
+        when 'im' then 'im'
+        when 'mpim' then 'mpim'
+        when 'groups' then 'group'
+        else 'channel'
+        end
+      else
+        case detected = arg['type']
+        when '', 'null' then nil
+        else detected
+        end
+      end
+    end
+
+    def parse_response(data)
+      examples = []
+      data['examples']&.each_pair do |_example_type, response|
+        example = JSON.pretty_generate(response['example'], indent: '    ')
+        example.gsub!(/\{\n\s*\}/, '{}')
+        example.gsub!(/\[\n\s*\]/, '[]')
+        examples.push example
+      end
+      { 'examples' => examples }
+    end
+
+    def parse_errors(data)
+      errors = {}
+      data['errors']&.each_pair do |name, desc|
+        errors[name] = desc['desc']
+      end
+      errors
+    end
+  end
+end

tasks/update.rake

@@ -1,8 +1,14 @@
-require_relative 'lib/slack_api/spec_validator'
+require_relative 'lib/slack_api/methods_generator'
 
 namespace :api do
-  desc 'Validate scraped methods and events are valid.'
+  namespace :methods do
+    desc 'Update methods.'
+    task :update do
+      SlackApi::MethodsGenerator.new.generate!
+    end
+  end
+
   task :update do
-    puts 'TODO'
+    Rake::Task['api:methods:update'].invoke
   end
 end