w3c_api 0.1.0 → 0.1.2

data/lib/w3c_api/commands/group.rb

@@ -5,83 +5,83 @@ require_relative 'output_formatter'
 require_relative '../client'
 
 module W3cApi
-    module Commands
-      # Thor CLI command for group operations
-      class Group < Thor
-        include OutputFormatter
+  module Commands
+    # Thor CLI command for group operations
+    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'
-        def fetch
-          client = W3cApi::Client.new
+      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
 
-          groups = if options[:id]
-                     # Single group
-                     client.group(options[:id])
-                   elsif options[:type]
-                     client.groups(type: options[:type])
-                   else
-                     client.groups
-                   end
+        groups = if options[:id]
+                   # Single group
+                   client.group(options[:id])
+                 elsif options[:type]
+                   client.groups(type: options[:type])
+                 else
+                   client.groups
+                 end
 
-          output_results(groups, options[:format])
-        end
+        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'
-        def users
-          client = W3cApi::Client.new
-          users = client.group_users(options[:id])
-          output_results(users, 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'
+      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'
-        def specifications
-          client = W3cApi::Client.new
-          specifications = client.group_specifications(options[:id])
-          output_results(specifications, 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'
+      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'
-        def charters
-          client = W3cApi::Client.new
-          charters = client.group_charters(options[:id])
-          output_results(charters, 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'
+      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'
-        def chairs
-          client = W3cApi::Client.new
-          chairs = client.group_chairs(options[:id])
-          output_results(chairs, 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'
+      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'
-        def team_contacts
-          client = W3cApi::Client.new
-          team_contacts = client.group_team_contacts(options[:id])
-          output_results(team_contacts, 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'
+      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'
-        def participations
-          client = W3cApi::Client.new
-          participations = client.group_participations(options[:id])
-          output_results(participations, 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'
+      def participations
+        client = W3cApi::Client.new
+        participations = client.group_participations(options[:id])
+        output_results(participations, options[:format])
       end
     end
+  end
 end

data/lib/w3c_api/commands/output_formatter.rb

@@ -1,18 +1,18 @@
 # frozen_string_literal: true
 
 module W3cApi
-    module Commands
-      module OutputFormatter
-        # Format and output results based on the specified format
-        def output_results(results, format)
-          case format
-          when 'yaml'
-            puts results.to_yaml
-          else
-            # Default to JSON if format is not recognized
-            puts results.to_json
-          end
+  module Commands
+    module OutputFormatter
+      # Format and output results based on the specified format
+      def output_results(results, format)
+        case format
+        when 'yaml'
+          puts results.to_yaml
+        else
+          # Default to JSON if format is not recognized
+          puts results.to_json
         end
       end
     end
+  end
 end

data/lib/w3c_api/commands/participation.rb

@@ -5,30 +5,28 @@ require_relative 'output_formatter'
 require_relative '../client'
 
 module W3cApi
-    module Commands
-      # Thor CLI command for participation operations
-      class Participation < Thor
-        include OutputFormatter
+  module Commands
+    # Thor CLI command for participation operations
+    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'
-        def fetch
-          client = W3cApi::Client.new
-          participation = client.participation(options[:id])
-          # Wrap in a collection for consistent output
-          participations = Models::Participations.new(participations: [participation])
-          output_results(participations, options[:format])
-        end
+      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'
-        def participants
-          client = W3cApi::Client.new
-          participants = client.participation_participants(options[:id])
-          output_results(participants, 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'
+      def participants
+        client = W3cApi::Client.new
+        participants = client.participation_participants(options[:id])
+        output_results(participants, options[:format])
       end
     end
+  end
 end

data/lib/w3c_api/commands/series.rb

@@ -5,36 +5,36 @@ require_relative 'output_formatter'
 require_relative '../client'
 
 module W3cApi
-    module Commands
-      # Thor CLI command for series operations
-      class Series < Thor
-        include OutputFormatter
+  module Commands
+    # Thor CLI command for series operations
+    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'
-        def fetch
-          client = W3cApi::Client.new
+      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
 
-          series = if options[:shortname]
-                     # Single series
-                     client.series_by_shortname(options[:shortname])
-                   else
-                     # All series
-                     client.series
-                   end
+        series = if options[:shortname]
+                   # Single series
+                   client.series_by_shortname(options[:shortname])
+                 else
+                   # All series
+                   client.series
+                 end
 
-          output_results(series, options[:format])
-        end
+        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'
-        def specifications
-          client = W3cApi::Client.new
-          specifications = client.series_specifications(options[:shortname])
-          output_results(specifications, 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'
+      def specifications
+        client = W3cApi::Client.new
+        specifications = client.series_specifications(options[:shortname])
+        output_results(specifications, options[:format])
       end
     end
+  end
 end

data/lib/w3c_api/commands/specification.rb

@@ -5,64 +5,89 @@ require_relative 'output_formatter'
 require_relative '../client'
 
 module W3cApi
-    module Commands
-      # Thor CLI command for specification operations
-      class Specification < Thor
-        include OutputFormatter
+  module Commands
+    # Thor CLI command for specification operations
+    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 :format, type: :string, default: 'yaml', enum: %w[json yaml], desc: 'Output format'
-        def fetch
-          client = W3cApi::Client.new
+      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
+        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
 
-          output_results(specifications, options[:format])
-        end
+        # # Resolve links if specified
+        # if options[:resolve] && specifications.respond_to?(:realize_links)
+        #   specifications.realize_links(options[:resolve], client)
+        # end
 
-        desc 'versions', 'Fetch versions 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 versions
-          client = W3cApi::Client.new
-          versions = client.specification_versions(options[:shortname])
-          output_results(versions, options[:format])
-        end
+        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'
+      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'
+      def supersedes
+        # We need to add client.specification_supersedes method in the client
+        client = W3cApi::Client.new
+        specifications = client.specification_supersedes(options[:shortname])
+        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'
+      def superseded_by
+        # We need to add client.specification_superseded_by method in the client
+        client = W3cApi::Client.new
+        specifications = client.specification_superseded_by(options[:shortname])
+        output_results(specifications, 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'
-        def supersedes
-          # We need to add client.specification_supersedes method in the client
-          client = W3cApi::Client.new
-          specifications = client.specification_supersedes(options[:shortname])
-          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'
+      def editors
+        client = W3cApi::Client.new
+        editors = client.specification_editors(options[:shortname])
+        output_results(editors, 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'
-        def superseded_by
-          # We need to add client.specification_superseded_by method in the client
-          client = W3cApi::Client.new
-          specifications = client.specification_superseded_by(options[:shortname])
-          output_results(specifications, 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'
+      def deliverers
+        client = W3cApi::Client.new
+        deliverers = client.specification_deliverers(options[:shortname])
+        output_results(deliverers, options[:format])
       end
     end
+  end
 end

data/lib/w3c_api/commands/translation.rb

@@ -5,27 +5,27 @@ require_relative 'output_formatter'
 require_relative '../client'
 
 module W3cApi
-    module Commands
-      # Thor CLI command for translation operations
-      class Translation < Thor
-        include OutputFormatter
+  module Commands
+    # Thor CLI command for translation operations
+    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'
-        def fetch
-          client = W3cApi::Client.new
+      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
 
-          translations = if options[:id]
-                           # Single specification version
-                           client.translation(options[:id])
-                         else
-                           # All translations
-                           client.translations
-                         end
+        translations = if options[:id]
+                         # Single specification version
+                         client.translation(options[:id])
+                       else
+                         # All translations
+                         client.translations
+                       end
 
-          output_results(translations, options[:format])
-        end
+        output_results(translations, options[:format])
       end
     end
+  end
 end

data/lib/w3c_api/commands/user.rb

@@ -5,73 +5,73 @@ require_relative 'output_formatter'
 require_relative '../client'
 
 module W3cApi
-    module Commands
-      # Thor CLI command for user operations
-      class User < Thor
-        include OutputFormatter
+  module Commands
+    # Thor CLI command for user operations
+    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'
-        def fetch
-          client = W3cApi::Client.new
-          user = client.user(options[:id])
-          output_results(user, options[:format])
-        end
+      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'
-        def groups
-          client = W3cApi::Client.new
-          groups = client.user_groups(options[:id])
-          output_results(groups, 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'
+      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'
-        def specifications
-          client = W3cApi::Client.new
-          specifications = client.user_specifications(options[:id])
-          output_results(specifications, 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'
+      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'
-        def affiliations
-          client = W3cApi::Client.new
-          affiliations = client.user_affiliations(options[:id])
-          output_results(affiliations, 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'
+      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'
-        def participations
-          client = W3cApi::Client.new
-          participations = client.user_participations(options[:id])
-          output_results(participations, 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'
+      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'
-        def chair_of_groups
-          client = W3cApi::Client.new
-          groups = client.user_chair_of_groups(options[:id])
-          output_results(groups, 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'
+      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'
-        def team_contact_of_groups
-          client = W3cApi::Client.new
-          groups = client.user_team_contact_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'
+      def team_contact_of_groups
+        client = W3cApi::Client.new
+        groups = client.user_team_contact_of_groups(options[:id])
+        output_results(groups, options[:format])
       end
     end
+  end
 end