w3c_api 0.1.4 → 0.1.5

data/examples/rate_limiting_stress_test.rb

@@ -0,0 +1,239 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/w3c_api"
+
+# Advanced example: Rate limiting stress test and performance analysis
+puts "W3C API Rate Limiting - Advanced Stress Test Example"
+puts "=" * 55
+
+puts "\nThis example demonstrates advanced rate limiting scenarios:"
+puts "• Rapid sequential requests"
+puts "• Performance analysis across different endpoints"
+puts "• Dynamic configuration changes"
+puts "• Load testing patterns"
+
+# Create a client instance
+client = W3cApi::Client.new
+
+# Configure aggressive rate limiting for testing
+W3cApi::Hal.instance.configure_rate_limiting(
+  max_retries: 3,
+  base_delay: 0.1,      # Very short delay for testing
+  max_delay: 5.0,       # Lower max delay
+  backoff_factor: 2.0,
+)
+
+puts "\n🔧 Rate limiting configuration for stress testing:"
+puts "   - Max retries: 3"
+puts "   - Base delay: 0.1s (very aggressive)"
+puts "   - Max delay: 5.0s"
+puts "   - Backoff factor: 2.0"
+
+# Test 1: Rapid sequential requests
+puts "\n1. 🚀 Rapid Sequential Requests Test:"
+puts "   Making 10 rapid requests to analyze rate limiting behavior..."
+
+start_time = Time.now
+successful_requests = 0
+failed_requests = 0
+request_times = []
+
+10.times do |i|
+  print "   Request #{i + 1}: "
+  request_start = Time.now
+
+  begin
+    specs = client.specifications(items: 1)
+    request_time = (Time.now - request_start).round(3)
+    request_times << request_time
+    puts "✓ Success (#{specs.links.specifications.length} items, #{request_time}s)"
+    successful_requests += 1
+  rescue StandardError => e
+    request_time = (Time.now - request_start).round(3)
+    request_times << request_time
+    puts "✗ Failed: #{e.message} (#{request_time}s)"
+    failed_requests += 1
+  end
+end
+
+end_time = Time.now
+total_time = (end_time - start_time).round(2)
+
+puts "\n   📊 Performance Analysis:"
+puts "   - Successful requests: #{successful_requests}"
+puts "   - Failed requests: #{failed_requests}"
+puts "   - Total time: #{total_time}s"
+puts "   - Average time per request: #{(total_time / 10).round(3)}s"
+puts "   - Fastest request: #{request_times.min}s"
+puts "   - Slowest request: #{request_times.max}s"
+
+# Test 2: Cross-endpoint performance analysis
+puts "\n2. 🎯 Cross-Endpoint Performance Analysis:"
+endpoints = [
+  { name: "specifications", method: :specifications,
+    link_key: :specifications },
+  { name: "groups", method: :groups, link_key: :groups },
+  { name: "series", method: :series, link_key: :series },
+  { name: "ecosystems", method: :ecosystems, link_key: :ecosystems },
+]
+
+endpoint_results = {}
+
+endpoints.each do |endpoint|
+  print "   Testing #{endpoint[:name].ljust(15)}: "
+  start = Time.now
+
+  begin
+    result = client.send(endpoint[:method], items: 2)
+    duration = (Time.now - start).round(3)
+    count = result.links.send(endpoint[:link_key]).length
+
+    endpoint_results[endpoint[:name]] = {
+      success: true,
+      duration: duration,
+      count: count,
+    }
+
+    puts "✓ Success (#{count} items, #{duration}s)"
+  rescue StandardError => e
+    duration = (Time.now - start).round(3)
+    endpoint_results[endpoint[:name]] = {
+      success: false,
+      duration: duration,
+      error: e.message,
+    }
+    puts "✗ Failed: #{e.message} (#{duration}s)"
+  end
+end
+
+puts "\n   📈 Endpoint Performance Summary:"
+endpoint_results.each do |name, result|
+  if result[:success]
+    puts "   - #{name.ljust(15)}: #{result[:duration]}s (#{result[:count]} items)"
+  else
+    puts "   - #{name.ljust(15)}: #{result[:duration]}s (FAILED)"
+  end
+end
+
+# Test 3: Dynamic configuration testing
+puts "\n3. ⚙️  Dynamic Configuration Testing:"
+
+begin
+  puts "   Testing with rate limiting enabled..."
+  start = Time.now
+  client.specifications(items: 1)
+  time1 = (Time.now - start).round(3)
+  puts "   ✓ Request 1 (enabled): #{time1}s"
+
+  puts "   🔄 Disabling rate limiting..."
+  W3cApi::Hal.instance.disable_rate_limiting
+
+  start = Time.now
+  client.specifications(items: 1)
+  time2 = (Time.now - start).round(3)
+  puts "   ✓ Request 2 (disabled): #{time2}s"
+
+  puts "   🔄 Re-enabling with different configuration..."
+  W3cApi::Hal.instance.enable_rate_limiting
+  W3cApi::Hal.instance.configure_rate_limiting(
+    max_retries: 5,
+    base_delay: 0.2,
+    max_delay: 10.0,
+    backoff_factor: 1.5,
+  )
+
+  start = Time.now
+  client.specifications(items: 1)
+  time3 = (Time.now - start).round(3)
+  puts "   ✓ Request 3 (reconfigured): #{time3}s"
+
+  puts "\n   ⏱️  Timing Comparison:"
+  puts "   - Enabled (default):  #{time1}s"
+  puts "   - Disabled:           #{time2}s"
+  puts "   - Reconfigured:       #{time3}s"
+rescue StandardError => e
+  puts "   ✗ Error: #{e.message}"
+end
+
+# Test 4: Bulk operation simulation
+puts "\n4. 📦 Bulk Operation Simulation:"
+puts "   Simulating a bulk data collection scenario..."
+
+bulk_start = Time.now
+bulk_results = []
+
+# Simulate collecting data from multiple endpoints
+bulk_operations = [
+  { name: "Collect specifications", method: :specifications, items: 3 },
+  { name: "Collect groups", method: :groups, items: 2 },
+  { name: "Collect series", method: :series, items: 2 },
+]
+
+bulk_operations.each_with_index do |operation, _index|
+  print "   #{operation[:name]}: "
+  op_start = Time.now
+
+  begin
+    result = client.send(operation[:method], items: operation[:items])
+    duration = (Time.now - op_start).round(3)
+
+    case operation[:method]
+    when :specifications
+      count = result.links.specifications.length
+    when :groups
+      count = result.links.groups.length
+    when :series
+      count = result.links.series.length
+    end
+
+    bulk_results << { success: true, duration: duration, count: count }
+    puts "✓ #{count} items (#{duration}s)"
+
+    # Add a small delay between bulk operations
+    sleep(0.1)
+  rescue StandardError => e
+    duration = (Time.now - op_start).round(3)
+    bulk_results << { success: false, duration: duration }
+    puts "✗ Failed: #{e.message} (#{duration}s)"
+  end
+end
+
+bulk_total_time = (Time.now - bulk_start).round(2)
+successful_ops = bulk_results.count { |r| r[:success] }
+total_items = bulk_results.select { |r| r[:success] }.sum { |r| r[:count] || 0 }
+
+puts "\n   📊 Bulk Operation Results:"
+puts "   - Total time: #{bulk_total_time}s"
+puts "   - Successful operations: #{successful_ops}/#{bulk_operations.length}"
+puts "   - Total items collected: #{total_items}"
+puts "   - Average time per operation: #{(bulk_total_time / bulk_operations.length).round(3)}s"
+
+puts "\n#{'=' * 55}"
+puts "🎉 Advanced Stress Test Completed!"
+
+puts "\n📋 Test Summary:"
+puts "• Sequential requests: #{successful_requests}/10 successful"
+puts "• Endpoint tests: #{endpoint_results.count do |_, r|
+  r[:success]
+end}/#{endpoints.length} successful"
+puts "• Configuration changes: Applied successfully"
+puts "• Bulk operations: #{successful_ops}/#{bulk_operations.length} successful"
+
+puts "\n💡 Key Insights:"
+puts "• Rate limiting maintains API stability under load"
+puts "• Configuration changes take effect immediately"
+puts "• Different endpoints may have varying response times"
+puts "• Bulk operations benefit from rate limiting protection"
+
+puts "\n🔍 In Production Scenarios:"
+puts "• Rate limiting prevents API abuse and ensures fair usage"
+puts "• Exponential backoff reduces server load during high traffic"
+puts "• Retry-After headers are automatically respected"
+puts "• 429 and 5xx errors are handled gracefully with retries"
+
+puts "\n📚 Advanced Usage Tips:"
+puts "• Monitor request patterns to optimize rate limiting settings"
+puts "• Use bulk operations with manual delays for large datasets"
+puts "• Adjust configuration based on API documentation"
+puts "• Consider disabling rate limiting for controlled bulk operations"

data/exe/w3c_api

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require 'w3c_api'
+require "w3c_api"
 
 W3cApi::Cli.start(ARGV)

data/lib/w3c_api/cli.rb

@@ -1,45 +1,46 @@
 # frozen_string_literal: true
 
-require 'thor'
-require_relative 'commands/specification'
-require_relative 'commands/specification_version'
-require_relative 'commands/group'
-require_relative 'commands/user'
-require_relative 'commands/translation'
-require_relative 'commands/ecosystem'
-require_relative 'commands/series'
-require_relative 'commands/affiliation'
-require_relative 'commands/participation'
+require "thor"
+require_relative "commands/specification"
+require_relative "commands/specification_version"
+require_relative "commands/group"
+require_relative "commands/user"
+require_relative "commands/translation"
+require_relative "commands/ecosystem"
+require_relative "commands/series"
+require_relative "commands/affiliation"
+require_relative "commands/participation"
 
 module W3cApi
   # Main CLI class that registers all subcommands
   class Cli < Thor
     # Register subcommands
-    desc 'specification SUBCOMMAND ...ARGS', 'Work with W3C specifications'
-    subcommand 'specification', Commands::Specification
+    desc "specification SUBCOMMAND ...ARGS", "Work with W3C specifications"
+    subcommand "specification", Commands::Specification
 
-    desc 'specification_version SUBCOMMAND ...ARGS', 'Work with W3C specification versions'
-    subcommand 'specification_version', Commands::SpecificationVersion
+    desc "specification_version SUBCOMMAND ...ARGS",
+         "Work with W3C specification versions"
+    subcommand "specification_version", Commands::SpecificationVersion
 
-    desc 'group SUBCOMMAND ...ARGS', 'Work with W3C groups'
-    subcommand 'group', Commands::Group
+    desc "group SUBCOMMAND ...ARGS", "Work with W3C groups"
+    subcommand "group", Commands::Group
 
-    desc 'user SUBCOMMAND ...ARGS', 'Work with W3C users'
-    subcommand 'user', Commands::User
+    desc "user SUBCOMMAND ...ARGS", "Work with W3C users"
+    subcommand "user", Commands::User
 
-    desc 'translation SUBCOMMAND ...ARGS', 'Work with W3C translations'
-    subcommand 'translation', Commands::Translation
+    desc "translation SUBCOMMAND ...ARGS", "Work with W3C translations"
+    subcommand "translation", Commands::Translation
 
-    desc 'ecosystem SUBCOMMAND ...ARGS', 'Work with W3C ecosystems'
-    subcommand 'ecosystem', Commands::Ecosystem
+    desc "ecosystem SUBCOMMAND ...ARGS", "Work with W3C ecosystems"
+    subcommand "ecosystem", Commands::Ecosystem
 
-    desc 'series SUBCOMMAND ...ARGS', 'Work with W3C specification series'
-    subcommand 'series', Commands::Series
+    desc "series SUBCOMMAND ...ARGS", "Work with W3C specification series"
+    subcommand "series", Commands::Series
 
-    desc 'affiliation SUBCOMMAND ...ARGS', 'Work with W3C affiliations'
-    subcommand 'affiliation', Commands::Affiliation
+    desc "affiliation SUBCOMMAND ...ARGS", "Work with W3C affiliations"
+    subcommand "affiliation", Commands::Affiliation
 
-    desc 'participation SUBCOMMAND ...ARGS', 'Work with W3C participations'
-    subcommand 'participation', Commands::Participation
+    desc "participation SUBCOMMAND ...ARGS", "Work with W3C participations"
+    subcommand "participation", Commands::Participation
   end
 end

data/lib/w3c_api/client.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-require 'json'
-require 'rainbow'
-require 'pp'
-require_relative 'hal'
+require "json"
+require "rainbow"
+require "pp"
+require_relative "hal"
 
 module W3cApi
   class Client
@@ -15,7 +15,7 @@ module W3cApi
       hal_instance.register.models.each do |endpoint_id, endpoint_config|
         # Check if this endpoint has embed parameter support
         has_embed = endpoint_config[:parameters].any? do |param|
-          param.name == 'embed' && param.location == :query
+          param.name == "embed" && param.location == :query
         end
 
         endpoints_with_embed << endpoint_id if has_embed
@@ -48,7 +48,7 @@ module W3cApi
         :specification_resource_version_resource,
         shortname: shortname,
         version: version,
-        **options
+        **options,
       )
     end
 
@@ -101,7 +101,8 @@ module W3cApi
       fetch_resource(:group_resource, id: id, **options)
     end
 
-    %w[specifications users charters chairs team_contacts participations].each do |resource|
+    %w[specifications users charters chairs team_contacts
+       participations].each do |resource|
       define_method("group_#{resource}") do |id, options = {}|
         fetch_resource(:"group_#{resource}_index", id: id, **options)
       end

data/lib/w3c_api/commands/affiliation.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require 'thor'
-require_relative 'output_formatter'
-require_relative '../client'
+require "thor"
+require_relative "output_formatter"
+require_relative "../client"
 
 module W3cApi
   module Commands
@@ -10,9 +10,10 @@ module W3cApi
     class Affiliation < Thor
       include OutputFormatter
 
-      desc 'fetch [OPTIONS]', 'Fetch affiliations'
-      option :id, type: :numeric, desc: 'Affiliation ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "fetch [OPTIONS]", "Fetch affiliations"
+      option :id, type: :numeric, desc: "Affiliation ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def fetch
         client = W3cApi::Client.new
 
@@ -26,18 +27,20 @@ module W3cApi
         output_results(affiliations, options[:format])
       end
 
-      desc 'participants', 'Fetch participants of an affiliation'
-      option :id, type: :numeric, required: true, desc: 'Affiliation ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "participants", "Fetch participants of an affiliation"
+      option :id, type: :numeric, required: true, desc: "Affiliation ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def participants
         client = W3cApi::Client.new
         participants = client.affiliation_participants(options[:id])
         output_results(participants, options[:format])
       end
 
-      desc 'participations', 'Fetch participations of an affiliation'
-      option :id, type: :numeric, required: true, desc: 'Affiliation ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "participations", "Fetch participations of an affiliation"
+      option :id, type: :numeric, required: true, desc: "Affiliation ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def participations
         client = W3cApi::Client.new
         participations = client.affiliation_participations(options[:id])

data/lib/w3c_api/commands/ecosystem.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require 'thor'
-require_relative 'output_formatter'
-require_relative '../client'
+require "thor"
+require_relative "output_formatter"
+require_relative "../client"
 
 module W3cApi
   module Commands
@@ -10,9 +10,10 @@ module W3cApi
     class Ecosystem < Thor
       include OutputFormatter
 
-      desc 'fetch [OPTIONS]', 'Fetch ecosystems'
-      option :shortname, type: :string, desc: 'Ecosystem shortname'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "fetch [OPTIONS]", "Fetch ecosystems"
+      option :shortname, type: :string, desc: "Ecosystem shortname"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def fetch
         client = W3cApi::Client.new
 
@@ -26,27 +27,33 @@ module W3cApi
         output_results(ecosystems, options[:format])
       end
 
-      desc 'groups', 'Fetch groups in an ecosystem'
-      option :shortname, type: :string, required: true, desc: 'Ecosystem shortname'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "groups", "Fetch groups in an ecosystem"
+      option :shortname, type: :string, required: true,
+                         desc: "Ecosystem shortname"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def groups
         client = W3cApi::Client.new
         groups = client.ecosystem_groups(options[:shortname])
         output_results(groups, options[:format])
       end
 
-      desc 'evangelists', 'Fetch evangelists of an ecosystem'
-      option :shortname, type: :string, required: true, desc: 'Ecosystem shortname'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "evangelists", "Fetch evangelists of an ecosystem"
+      option :shortname, type: :string, required: true,
+                         desc: "Ecosystem shortname"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def evangelists
         client = W3cApi::Client.new
         evangelists = client.ecosystem_evangelists(options[:shortname])
         output_results(evangelists, options[:format])
       end
 
-      desc 'member-organizations', 'Fetch member organizations of an ecosystem'
-      option :shortname, type: :string, required: true, desc: 'Ecosystem shortname'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "member-organizations", "Fetch member organizations of an ecosystem"
+      option :shortname, type: :string, required: true,
+                         desc: "Ecosystem shortname"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def member_organizations
         client = W3cApi::Client.new
         organizations = client.ecosystem_member_organizations(options[:shortname])

data/lib/w3c_api/commands/group.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require 'thor'
-require_relative 'output_formatter'
-require_relative '../client'
+require "thor"
+require_relative "output_formatter"
+require_relative "../client"
 
 module W3cApi
   module Commands
@@ -10,10 +10,11 @@ module W3cApi
     class Group < Thor
       include OutputFormatter
 
-      desc 'fetch [OPTIONS]', 'Fetch groups'
-      option :id, type: :string, desc: 'Group ID'
-      option :type, type: :string, desc: 'Group type'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "fetch [OPTIONS]", "Fetch groups"
+      option :id, type: :string, desc: "Group ID"
+      option :type, type: :string, desc: "Group type"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def fetch
         client = W3cApi::Client.new
 
@@ -29,54 +30,60 @@ module W3cApi
         output_results(groups, options[:format])
       end
 
-      desc 'users', 'Fetch users in a group'
-      option :id, type: :numeric, required: true, desc: 'Group ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "users", "Fetch users in a group"
+      option :id, type: :numeric, required: true, desc: "Group ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def users
         client = W3cApi::Client.new
         users = client.group_users(options[:id])
         output_results(users, options[:format])
       end
 
-      desc 'specifications', 'Fetch specifications produced by a group'
-      option :id, type: :numeric, required: true, desc: 'Group ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "specifications", "Fetch specifications produced by a group"
+      option :id, type: :numeric, required: true, desc: "Group ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def specifications
         client = W3cApi::Client.new
         specifications = client.group_specifications(options[:id])
         output_results(specifications, options[:format])
       end
 
-      desc 'charters', 'Fetch charters of a group'
-      option :id, type: :numeric, required: true, desc: 'Group ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "charters", "Fetch charters of a group"
+      option :id, type: :numeric, required: true, desc: "Group ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def charters
         client = W3cApi::Client.new
         charters = client.group_charters(options[:id])
         output_results(charters, options[:format])
       end
 
-      desc 'chairs', 'Fetch chairs of a group'
-      option :id, type: :numeric, required: true, desc: 'Group ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "chairs", "Fetch chairs of a group"
+      option :id, type: :numeric, required: true, desc: "Group ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def chairs
         client = W3cApi::Client.new
         chairs = client.group_chairs(options[:id])
         output_results(chairs, options[:format])
       end
 
-      desc 'team-contacts', 'Fetch team contacts of a group'
-      option :id, type: :numeric, required: true, desc: 'Group ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "team-contacts", "Fetch team contacts of a group"
+      option :id, type: :numeric, required: true, desc: "Group ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def team_contacts
         client = W3cApi::Client.new
         team_contacts = client.group_team_contacts(options[:id])
         output_results(team_contacts, options[:format])
       end
 
-      desc 'participations', 'Fetch participations in a group'
-      option :id, type: :numeric, required: true, desc: 'Group ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "participations", "Fetch participations in a group"
+      option :id, type: :numeric, required: true, desc: "Group ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def participations
         client = W3cApi::Client.new
         participations = client.group_participations(options[:id])

data/lib/w3c_api/commands/output_formatter.rb

@@ -6,7 +6,7 @@ module W3cApi
       # Format and output results based on the specified format
       def output_results(results, format)
         case format
-        when 'yaml'
+        when "yaml"
           puts results.to_yaml
         else
           # Default to JSON if format is not recognized

data/lib/w3c_api/commands/participation.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require 'thor'
-require_relative 'output_formatter'
-require_relative '../client'
+require "thor"
+require_relative "output_formatter"
+require_relative "../client"
 
 module W3cApi
   module Commands
@@ -10,18 +10,20 @@ module W3cApi
     class Participation < Thor
       include OutputFormatter
 
-      desc 'fetch', 'Fetch a participation by ID'
-      option :id, type: :numeric, required: true, desc: 'Participation ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "fetch", "Fetch a participation by ID"
+      option :id, type: :numeric, required: true, desc: "Participation ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def fetch
         client = W3cApi::Client.new
         participation = client.participation(options[:id])
         output_results(participation, options[:format])
       end
 
-      desc 'participants', 'Fetch participants in a participation'
-      option :id, type: :numeric, required: true, desc: 'Participation ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "participants", "Fetch participants in a participation"
+      option :id, type: :numeric, required: true, desc: "Participation ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def participants
         client = W3cApi::Client.new
         participants = client.participation_participants(options[:id])