w3c_api 0.1.4 → 0.1.5

data/lib/w3c_api/commands/series.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 Series < Thor
       include OutputFormatter
 
-      desc 'fetch [OPTIONS]', 'Fetch specification series'
-      option :shortname, type: :string, desc: 'Series shortname'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "fetch [OPTIONS]", "Fetch specification series"
+      option :shortname, type: :string, desc: "Series shortname"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def fetch
         client = W3cApi::Client.new
 
@@ -27,9 +28,10 @@ module W3cApi
         output_results(series, options[:format])
       end
 
-      desc 'specifications', 'Fetch specifications in a series'
-      option :shortname, type: :string, required: true, desc: 'Series shortname'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "specifications", "Fetch specifications in a series"
+      option :shortname, type: :string, required: true, desc: "Series shortname"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def specifications
         client = W3cApi::Client.new
         specifications = client.series_specifications(options[:shortname])

data/lib/w3c_api/commands/specification.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,50 +10,39 @@ module W3cApi
     class Specification < Thor
       include OutputFormatter
 
-      desc 'fetch [OPTIONS]', 'Fetch specifications'
-      option :shortname, type: :string, desc: 'Filter by shortname'
-      option :version, type: :string, desc: 'Specific version of the specification'
-      option :status, type: :string, desc: 'Filter by status'
-      option :resolve, type: :array, desc: 'Links to resolve (e.g. version-history, latest-version, series)'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "fetch [OPTIONS]", "Fetch specifications"
+      option :shortname, type: :string, desc: "Filter by shortname"
+      option :version, type: :string,
+                       desc: "Specific version of the specification"
+      option :status, type: :string, desc: "Filter by status"
+      option :resolve, type: :array,
+                       desc: "Links to resolve (e.g. version-history, latest-version, series)"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def fetch
         client = W3cApi::Client.new
-
-        specifications = if options[:shortname] && options[:version]
-                           # Single specification version
-                           client.specification_version(options[:shortname], options[:version])
-                         elsif options[:shortname]
-                           # Single specification
-                           client.specification(options[:shortname])
-                         elsif options[:status]
-                           # Specifications by status
-                           client.specifications_by_status(options[:status])
-                         else
-                           # All specifications
-                           client.specifications
-                         end
-
-        # # Resolve links if specified
-        # if options[:resolve] && specifications.respond_to?(:realize_links)
-        #   specifications.realize_links(options[:resolve], client)
-        # end
-
+        specifications = fetch_specifications(client)
         output_results(specifications, options[:format])
       end
 
-      desc 'versions', 'Fetch versions of a specification'
-      option :shortname, type: :string, required: true, desc: 'Specification shortname'
-      option :resolve, type: :array, desc: 'Links to resolve on each version'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "versions", "Fetch versions of a specification"
+      option :shortname, type: :string, required: true,
+                         desc: "Specification shortname"
+      option :resolve, type: :array, desc: "Links to resolve on each version"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def versions
         client = W3cApi::Client.new
         versions = client.specification_versions(options[:shortname])
         output_results(versions, options[:format])
       end
 
-      desc 'supersedes', 'Fetch specifications that this specification supersedes'
-      option :shortname, type: :string, required: true, desc: 'Specification shortname'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "supersedes",
+           "Fetch specifications that this specification supersedes"
+      option :shortname, type: :string, required: true,
+                         desc: "Specification shortname"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def supersedes
         # We need to add client.specification_supersedes method in the client
         client = W3cApi::Client.new
@@ -61,9 +50,12 @@ module W3cApi
         output_results(specifications, options[:format])
       end
 
-      desc 'superseded-by', 'Fetch specifications that supersede this specification'
-      option :shortname, type: :string, required: true, desc: 'Specification shortname'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "superseded-by",
+           "Fetch specifications that supersede this specification"
+      option :shortname, type: :string, required: true,
+                         desc: "Specification shortname"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def superseded_by
         # We need to add client.specification_superseded_by method in the client
         client = W3cApi::Client.new
@@ -71,23 +63,45 @@ module W3cApi
         output_results(specifications, options[:format])
       end
 
-      desc 'editors', 'Fetch editors of a specification'
-      option :shortname, type: :string, required: true, desc: 'Specification shortname'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "editors", "Fetch editors of a specification"
+      option :shortname, type: :string, required: true,
+                         desc: "Specification shortname"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def editors
         client = W3cApi::Client.new
         editors = client.specification_editors(options[:shortname])
         output_results(editors, options[:format])
       end
 
-      desc 'deliverers', 'Fetch deliverers (working groups) of a specification'
-      option :shortname, type: :string, required: true, desc: 'Specification shortname'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "deliverers", "Fetch deliverers (working groups) of a specification"
+      option :shortname, type: :string, required: true,
+                         desc: "Specification shortname"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def deliverers
         client = W3cApi::Client.new
         deliverers = client.specification_deliverers(options[:shortname])
         output_results(deliverers, options[:format])
       end
+
+      private
+
+      def fetch_specifications(client)
+        if options[:shortname] && options[:version]
+          # Single specification version
+          client.specification_version(options[:shortname], options[:version])
+        elsif options[:shortname]
+          # Single specification
+          client.specification(options[:shortname])
+        elsif options[:status]
+          # Specifications by status
+          client.specifications_by_status(options[:status])
+        else
+          # All specifications
+          client.specifications
+        end
+      end
     end
   end
 end

data/lib/w3c_api/commands/specification_version.rb

@@ -1,33 +1,42 @@
 # frozen_string_literal: true
 
-require 'thor'
-require_relative 'output_formatter'
+require "thor"
+require_relative "output_formatter"
 
 module W3cApi
   module Commands
     class SpecificationVersion < Thor
       include OutputFormatter
 
-      desc 'editors', 'Fetch editors of a specification version'
-      option :shortname, type: :string, required: true, desc: 'Specification shortname'
-      option :version, type: :string, required: true, desc: 'Specification version'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "editors", "Fetch editors of a specification version"
+      option :shortname, type: :string, required: true,
+                         desc: "Specification shortname"
+      option :version, type: :string, required: true,
+                       desc: "Specification version"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def editors
         client = W3cApi::Client.new
-        result = client.specification_version_editors(options[:shortname], options[:version])
+        result = client.specification_version_editors(options[:shortname],
+                                                      options[:version])
         output_results(result, options[:format])
       rescue StandardError => e
         puts "Error: #{e.message}"
         exit 1
       end
 
-      desc 'deliverers', 'Fetch deliverers (working groups) of a specification version'
-      option :shortname, type: :string, required: true, desc: 'Specification shortname'
-      option :version, type: :string, required: true, desc: 'Specification version'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "deliverers",
+           "Fetch deliverers (working groups) of a specification version"
+      option :shortname, type: :string, required: true,
+                         desc: "Specification shortname"
+      option :version, type: :string, required: true,
+                       desc: "Specification version"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def deliverers
         client = W3cApi::Client.new
-        result = client.specification_version_deliverers(options[:shortname], options[:version])
+        result = client.specification_version_deliverers(options[:shortname],
+                                                         options[:version])
         output_results(result, options[:format])
       rescue StandardError => e
         puts "Error: #{e.message}"

data/lib/w3c_api/commands/translation.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 Translation < Thor
       include OutputFormatter
 
-      desc 'fetch [OPTIONS]', 'Fetch a translation by ID'
-      option :id, type: :string, desc: 'Translation ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "fetch [OPTIONS]", "Fetch a translation by ID"
+      option :id, type: :string, desc: "Translation ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def fetch
         client = W3cApi::Client.new
 

data/lib/w3c_api/commands/user.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,63 +10,75 @@ module W3cApi
     class User < Thor
       include OutputFormatter
 
-      desc 'fetch [OPTIONS]', 'Fetch a user by ID'
-      option :id, type: :string, required: true, desc: 'User ID (required)'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "fetch [OPTIONS]", "Fetch a user by ID"
+      option :id, type: :string, required: true, desc: "User ID (required)"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def fetch
         client = W3cApi::Client.new
         user = client.user(options[:id])
         output_results(user, options[:format])
       end
 
-      desc 'groups', 'Fetch groups a user is a member of'
-      option :id, type: :string, required: true, desc: 'User ID'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "groups", "Fetch groups a user is a member of"
+      option :id, type: :string, required: true, desc: "User ID"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def groups
         client = W3cApi::Client.new
         groups = client.user_groups(options[:id])
         output_results(groups, options[:format])
       end
 
-      desc 'specifications', 'Fetch specifications a user has contributed to'
-      option :id, type: :string, required: true, desc: 'User ID (string or numeric)'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "specifications", "Fetch specifications a user has contributed to"
+      option :id, type: :string, required: true,
+                  desc: "User ID (string or numeric)"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def specifications
         client = W3cApi::Client.new
         specifications = client.user_specifications(options[:id])
         output_results(specifications, options[:format])
       end
 
-      desc 'affiliations', 'Fetch affiliations of a user'
-      option :id, type: :string, required: true, desc: 'User ID (string or numeric)'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "affiliations", "Fetch affiliations of a user"
+      option :id, type: :string, required: true,
+                  desc: "User ID (string or numeric)"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def affiliations
         client = W3cApi::Client.new
         affiliations = client.user_affiliations(options[:id])
         output_results(affiliations, options[:format])
       end
 
-      desc 'participations', 'Fetch participations of a user'
-      option :id, type: :string, required: true, desc: 'User ID (string or numeric)'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "participations", "Fetch participations of a user"
+      option :id, type: :string, required: true,
+                  desc: "User ID (string or numeric)"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def participations
         client = W3cApi::Client.new
         participations = client.user_participations(options[:id])
         output_results(participations, options[:format])
       end
 
-      desc 'chair-of-groups', 'Fetch groups a user chairs'
-      option :id, type: :string, required: true, desc: 'User ID (string or numeric)'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "chair-of-groups", "Fetch groups a user chairs"
+      option :id, type: :string, required: true,
+                  desc: "User ID (string or numeric)"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def chair_of_groups
         client = W3cApi::Client.new
         groups = client.user_chair_of_groups(options[:id])
         output_results(groups, options[:format])
       end
 
-      desc 'team-contact-of-groups', 'Fetch groups a user is a team contact of'
-      option :id, type: :string, required: true, desc: 'User ID (string or numeric)'
-      option :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
+      desc "team-contact-of-groups", "Fetch groups a user is a team contact of"
+      option :id, type: :string, required: true,
+                  desc: "User ID (string or numeric)"
+      option :format, type: :string, default: "yaml", enum: %w[json yaml],
+                      desc: "Output format"
       def team_contact_of_groups
         client = W3cApi::Client.new
         groups = client.user_team_contact_of_groups(options[:id])

data/lib/w3c_api/embed.rb

@@ -17,9 +17,9 @@ module W3cApi
       # Get human-readable descriptions of embed-supported endpoints
       def endpoint_descriptions
         {
-          specification_index: 'Specifications index with embedded specification details',
-          group_index: 'Groups index with embedded group details',
-          serie_index: 'Series index with embedded series details'
+          specification_index: "Specifications index with embedded specification details",
+          group_index: "Groups index with embedded group details",
+          serie_index: "Series index with embedded series details",
         }
       end
 
@@ -29,10 +29,10 @@ module W3cApi
           supported_endpoints: supported_endpoints,
           descriptions: endpoint_descriptions,
           usage_example: {
-            discovery: 'W3cApi::Client.embed_supported_endpoints',
-            usage: 'W3cApi::Client.new.specifications(embed: true, items: 2)',
-            automatic_realization: 'spec_link.realize  # Uses embedded content automatically'
-          }
+            discovery: "W3cApi::Client.embed_supported_endpoints",
+            usage: "W3cApi::Client.new.specifications(embed: true, items: 2)",
+            automatic_realization: "spec_link.realize  # Uses embedded content automatically",
+          },
         }
       end
     end