w3c_api 0.1.0 → 0.1.1

data/lib/w3c_api/models/serie.rb

@@ -1,11 +1,9 @@
 # frozen_string_literal: true
 
-require_relative 'base'
-require_relative 'link'
-
+# https://api.w3.org/specification-series/css-backgrounds
 # {
 #     "shortname": "css-backgrounds",
-#     "name": "CSS Backgrounds and Borders Module",
+#     "name": "CSS Backgrounds and Borders",
 #     "_links": {
 #         "self": {
 #             "href": "https://api.w3.org/specification-series/css-backgrounds"
@@ -18,7 +16,7 @@ require_relative 'link'
 #         }
 #     }
 # }
-#
+
 # {
 #   "shortname": "2dcontext",
 #   "name": "HTML Canvas 2D Context",
@@ -36,53 +34,25 @@ require_relative 'link'
 # }
 
 module W3cApi
-    module Models
-      class SerieLinks < Lutaml::Model::Serializable
-        attribute :self, Link
-        attribute :specifications, Link
-        attribute :current_specification, Link
-      end
-
-      class Serie < Base
-        attribute :shortname, :string
-        attribute :name, :string
-        attribute :href, :string
-        attribute :title, :string
-        attribute :_links, SerieLinks
-
-        # Get specifications in this series
-        def specifications(client = nil)
-          return nil unless client && _links&.specifications
-
-          client.series_specifications(shortname)
-        end
-
-        # Get current specification in this series
-        def current_specification(client = nil)
-          return nil unless client && _links&.current_specification
-
-          href = _links.current_specification.href
-          shortname = href.split('/').last
-          client.specification(shortname)
-        end
-
-        def self.from_response(response)
-          transformed_response = transform_keys(response)
-
-          series = new
-          transformed_response.each do |key, value|
-            case key
-            when :_links
-              links = value.each_with_object({}) do |(link_name, link_data), acc|
-                acc[link_name] = Link.new(href: link_data[:href], title: link_data[:title])
-              end
-              series._links = SerieLinks.new(links)
-            else
-              series.send("#{key}=", value) if series.respond_to?("#{key}=")
-            end
-          end
-          series
+  module Models
+    class Serie < Lutaml::Hal::Resource
+      attribute :shortname, :string
+      attribute :name, :string
+      attribute :href, :string
+      attribute :title, :string
+
+      hal_link :self, key: 'self', realize_class: 'Serie'
+      hal_link :specifications, key: 'specifications', realize_class: 'SpecificationIndex'
+      hal_link :current_specification, key: 'current-specification', realize_class: 'SpecVersion'
+
+      key_value do
+        %i[
+          shortname
+          name
+        ].each do |key|
+          map key.to_s.tr('_', '-'), to: key
         end
       end
     end
+  end
 end

data/lib/w3c_api/models/{series.rb → serie_index.rb}

@@ -1,14 +1,12 @@
 # frozen_string_literal: true
 
-require 'lutaml/model'
 require_relative 'serie'
-require_relative 'delegate_enumerable'
-require_relative 'collection_base'
 
+# https://api.w3.org/specification-series
 # {
 #   "page": 1,
-#   "limit": 1000,
-#   "pages": 2,
+#   "limit": 100,
+#   "pages": 15,
 #   "total": 1426,
 #   "_links": {
 #     "specification-series": [
@@ -28,14 +26,25 @@ require_relative 'collection_base'
 #         "href": "https://api.w3.org/specification-series/accessibility-metrics-report",
 #         "title": "accessibility-metrics-report"
 #       },
-
+#     ],
+#     "self": {
+#         "href": "https://api.w3.org/specification-series?page=1&items=100"
+#     },
+#     "first": {
+#         "href": "https://api.w3.org/specification-series?page=1&items=100"
+#     },
+#     "last": {
+#         "href": "https://api.w3.org/specification-series?page=15&items=100"
+#     },
+#     "next": {
+#         "href": "https://api.w3.org/specification-series?page=2&items=100"
+#     }
+#   }
+# }
 module W3cApi
-    module Models
-      class Series < CollectionBase
-        attribute :series, Serie, collection: true
-
-        delegate_enumerable :series
-        collection_instance_class Serie, :series
-      end
+  module Models
+    class SerieIndex < Lutaml::Hal::Page
+      hal_link :series, key: 'specification-series', realize_class: 'Serie', collection: true
     end
+  end
 end

data/lib/w3c_api/models/spec_version.rb

@@ -1,96 +1,82 @@
 # frozen_string_literal: true
 
-require_relative 'base'
-require_relative 'link'
-
-# Example spec version response format:
+# https://api.w3.org/specifications/html5/versions/20180327
 # {
-#   "date": "2023-09-21"
-#   "status": "REC"
-#   "rec_track": true
-#   "editor-draft": "https://w3c.github.io/example-draft/"
-#   "uri": "https://www.w3.org/TR/2023/REC-example-20230921/"
-#   "title": "Example Specification"
-#   "shortlink": "https://www.w3.org/TR/example/"
-#   "process-rules": "2021"
-#   "_links": {
-#     "self": {
-#       "href": "https://api.w3.org/specifications/example/versions/20230921"
-#     },
-#     "specification": {
-#       "href": "https://api.w3.org/specifications/example"
+#     "status": "Retired",
+#     "rec-track": true,
+#     "uri": "https://www.w3.org/TR/2018/SPSD-html5-20180327/",
+#     "date": "2018-03-27",
+#     "informative": false,
+#     "title": "HTML5",
+#     "shortlink": "https://www.w3.org/TR/html5/",
+#     "_links": {
+#         "self": {
+#             "href": "https://api.w3.org/specifications/html5/versions/20180327"
+#         },
+#         "editors": {
+#             "href": "https://api.w3.org/specifications/html5/versions/20180327/editors"
+#         },
+#         "deliverers": {
+#             "href": "https://api.w3.org/specifications/html5/versions/20180327/deliverers"
+#         },
+#         "specification": {
+#             "href": "https://api.w3.org/specifications/html5"
+#         },
+#         "predecessor-version": {
+#             "href": "https://api.w3.org/specifications/html5/versions/20180327/predecessors"
+#         }
 #     }
-#   }
 # }
 
 module W3cApi
-    module Models
-      class SpecVersionLinks < Lutaml::Model::Serializable
-        attribute :self, Link
-        attribute :specification, Link
-      end
-
-      class SpecVersion < Base
-        attribute :status, :string
-        attribute :rec_track, :boolean
-        attribute :editor_draft, :string
-        attribute :uri, :string, pattern: %r{https://www\.w3\.org/.*}
-        attribute :date, :date_time # Date-time format
-        attribute :last_call_feedback_due, :date_time # Date-time format
-        attribute :pr_reviews_date, :date_time # Date-time format
-        attribute :implementation_feedback_due, :date_time # Date-time format
-        attribute :per_reviews_due, :date_time # Date-time format
-        attribute :informative, :boolean
-        attribute :title, :string
-        attribute :href, :string
-        attribute :shortlink, :string, pattern: %r{https://www\.w3\.org/.*}
-        attribute :translation, :string
-        attribute :errata, :string
-        attribute :process_rules, :string
-        attribute :_links, SpecVersionLinks
-
-        # Return the specification this version belongs to
-        def specification(client = nil)
-          return nil unless client && _links&.specification
-
-          spec_href = _links.specification.href
-          spec_shortname = spec_href.split('/').last
-
-          client.specification(spec_shortname)
-        end
-
-        # Check if this spec version is a Recommendation
-        def recommendation?
-          status == 'REC'
-        end
-
-        # Check if this spec version is a Working Draft
-        def working_draft?
-          status == 'WD'
-        end
-
-        # Check if this spec version is a Candidate Recommendation
-        def candidate_recommendation?
-          status == 'CR'
-        end
+  module Models
+    class SpecVersion < Lutaml::Hal::Resource
+      attribute :status, :string
+      attribute :rec_track, :boolean
+      attribute :editor_draft, :string
+      attribute :uri, :string
+      attribute :date, :date_time
+      attribute :last_call_feedback_due, :date_time
+      attribute :pr_reviews_date, :date_time
+      attribute :implementation_feedback_due, :date_time
+      attribute :per_reviews_due, :date_time
+      attribute :informative, :boolean
+      attribute :title, :string
+      attribute :href, :string
+      attribute :shortlink, :string
+      attribute :translation, :string
+      attribute :errata, :string
+      attribute :process_rules, :string
 
-        def self.from_response(response)
-          transformed_response = transform_keys(response)
+      hal_link :self, key: 'self', realize_class: 'SpecVersion'
+      hal_link :editors, key: 'editors', realize_class: 'UserIndex'
+      hal_link :deliverers, key: 'deliverers', realize_class: 'UserIndex'
+      hal_link :specification, key: 'specification', realize_class: 'Specification'
+      hal_link :predecessor_version, key: 'predecessor-version', realize_class: 'SpecVersionIndex'
+      hal_link :successor_version, key: 'successor-version', realize_class: 'SpecVersionIndex'
 
-          spec_version = new
-          transformed_response.each do |key, value|
-            case key
-            when :_links
-              links = value.each_with_object({}) do |(link_name, link_data), acc|
-                acc[link_name] = Link.new(href: link_data[:href], title: link_data[:title])
-              end
-              spec_version._links = SpecVersionLinks.new(links)
-            else
-              spec_version.send("#{key}=", value) if spec_version.respond_to?("#{key}=")
-            end
-          end
-          spec_version
+      key_value do
+        %i[
+          status
+          rec_track
+          editor_draft
+          uri
+          date
+          last_call_feedback_due
+          pr_reviews_date
+          implementation_feedback_due
+          per_reviews_due
+          informative
+          title
+          href
+          shortlink
+          translation
+          errata
+          process_rules
+        ].each do |key|
+          map key.to_s.tr('_', '-'), to: key
         end
       end
     end
+  end
 end

data/lib/w3c_api/models/spec_version_index.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative 'spec_version'
+
+module W3cApi
+  module Models
+    class SpecVersionIndex < Lutaml::Hal::Page
+      hal_link :spec_versions, key: 'version-history', realize_class: 'SpecVersion', collection: true
+      hal_link :predecessor_version, key: 'predecessor-version', realize_class: 'SpecVersionIndex', collection: true
+      hal_link :successor_version, key: 'successor-version', realize_class: 'SpecVersionIndex', collection: true
+    end
+  end
+end

data/lib/w3c_api/models/spec_version_ref.rb

@@ -1,18 +1,16 @@
 # frozen_string_literal: true
 
-require 'lutaml/model'
-
 module W3cApi
-    module Models
-      class SpecVersionRef < Lutaml::Model::Serializable
-        attribute :status, :string
-        attribute :rec_track, :boolean
-        attribute :editor_draft, :string
-        attribute :uri, :string
-        attribute :date, :string
-        attribute :title, :string
-        attribute :shortlink, :string
-        attribute :process_rules, :string
-      end
+  module Models
+    class SpecVersionRef < Lutaml::Model::Serializable
+      attribute :status, :string
+      attribute :rec_track, :boolean
+      attribute :editor_draft, :string
+      attribute :uri, :string
+      attribute :date, :string
+      attribute :title, :string
+      attribute :shortlink, :string
+      attribute :process_rules, :string
     end
+  end
 end

data/lib/w3c_api/models/specification.rb

@@ -1,79 +1,67 @@
 # frozen_string_literal: true
 
-require_relative 'base'
-require_relative 'link'
-
+# https://api.w3.org/specifications/html5
 # {
-#   "shortlink"=>"https://www.w3.org/TR/PNG/",
-#   "description"=>"<p>This document describes PNG (Portable Network Graphics), an extensible file format for the lossless, portable, well-compressed storage of raster images. PNG provides a patent-free replacement for GIF and can also replace many common uses of TIFF. Indexed-color, grayscale, and truecolor images are supported, plus an optional alpha channel. Sample depths range from 1 to 16 bits.</p>\r\n<p>PNG is designed to work well in online viewing applications, such as the World Wide Web, so it is fully streamable with a progressive display option. PNG is robust, providing both full file integrity checking and simple detection of common transmission errors. Also, PNG can store gamma and chromaticity data for improved color matching on heterogeneous platforms.</p>\r\n<p>This specification defines an Internet Media Type image/png.</p>",
-#   "title"=>"Portable Network Graphics (PNG) Specification (Second Edition)",
-#   "shortname"=>"png-2",
-#   "editor-draft"=>"https://w3c.github.io/png/",
-#   "_links"=>{
-#     "self"=>{
-#       "href"=>"https://api.w3.org/specifications/png-2"
-#     },
-#     "version-history"=>{
-#       "href"=>"https://api.w3.org/specifications/png-2/versions"
-#     },
-#     "first-version"=>{
-#       "href"=>"https://api.w3.org/specifications/png-2/versions/20030520",
-#       "title"=>"Proposed Recommendation"
-#     },
-#     "latest-version"=>{
-#       "href"=>"https://api.w3.org/specifications/png-2/versions/20031110",
-#       "title"=>"Recommendation"
-#     },
-#     "series"=>{
-#       "href"=>"https://api.w3.org/specification-series/png"
+#     "shortlink": "https://www.w3.org/TR/html5/",
+#     "description": "<p>This specification defines the 5th major revision of the core language of the World Wide Web: the Hypertext Markup Language (HTML). In this version, new features are introduced to help Web application authors, new elements are introduced based on research into prevailing authoring practices, and special attention has been given to defining clear conformance criteria for user agents in an effort to improve interoperability.</p>",
+#     "title": "HTML5",
+#     "shortname": "html5",
+#     "series-version": "5",
+#     "_links": {
+#         "self": {
+#             "href": "https://api.w3.org/specifications/html5"
+#         },
+#         "version-history": {
+#             "href": "https://api.w3.org/specifications/html5/versions"
+#         },
+#         "first-version": {
+#             "href": "https://api.w3.org/specifications/html5/versions/20080122",
+#             "title": "Working Draft"
+#         },
+#         "latest-version": {
+#             "href": "https://api.w3.org/specifications/html5/versions/20180327",
+#             "title": "Retired"
+#         },
+#         "supersedes": {
+#             "href": "https://api.w3.org/specifications/html5/supersedes"
+#         },
+#         "series": {
+#             "href": "https://api.w3.org/specification-series/html"
+#         }
 #     }
-#   }
 # }
 
 module W3cApi
-    module Models
-      class SpecificationLinks < Lutaml::Model::Serializable
-        attribute :self, Link
-        attribute :version_history, Link
-        attribute :first_version, Link
-        attribute :latest_version, Link
-        attribute :series, Link
-      end
-
-      class Specification < Base
-        attribute :shortlink, :string
-        attribute :description, :string
-        attribute :title, :string
-        attribute :href, :string
-        attribute :shortname, :string
-        attribute :editor_draft, :string
-        attribute :series_version, :string
-        attribute :_links, SpecificationLinks
-
-        # Return versions of this specification
-        def versions(client = nil)
-          return nil unless client && shortname
-
-          client.specification_versions(shortname)
-        end
+  module Models
+    class Specification < Lutaml::Hal::Resource
+      attribute :shortlink, :string
+      attribute :description, :string
+      attribute :title, :string
+      attribute :href, :string
+      attribute :shortname, :string
+      attribute :editor_draft, :string
+      attribute :series_version, :string
 
-        def self.from_response(response)
-          transformed_response = transform_keys(response)
+      hal_link :self, key: 'self', realize_class: 'Specification'
+      hal_link :version_history, key: 'version-history', realize_class: 'SpecVersionIndex'
+      hal_link :first_version, key: 'first-version', realize_class: 'SpecVersion'
+      hal_link :latest_version, key: 'latest-version', realize_class: 'SpecVersion'
+      hal_link :supersedes, key: 'supersedes', realize_class: 'SpecificationIndex', collection: true
+      hal_link :series, key: 'series', realize_class: 'Serie'
 
-          spec = new
-          transformed_response.each do |key, value|
-            case key
-            when :_links
-              links = value.each_with_object({}) do |(link_name, link_data), acc|
-                acc[link_name] = Link.new(href: link_data[:href], title: link_data[:title])
-              end
-              spec._links = SpecificationLinks.new(links)
-            else
-              spec.send("#{key}=", value) if spec.respond_to?("#{key}=")
-            end
-          end
-          spec
+      key_value do
+        %i[
+          shortlink
+          description
+          title
+          href
+          shortname
+          editor_draft
+          series_version
+        ].each do |key|
+          map key.to_s.tr('_', '-'), to: key
         end
       end
     end
+  end
 end

data/lib/w3c_api/models/specification_index.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module W3cApi
+  module Models
+    # SpecificationIndex class that models `/specifications`
+    class SpecificationIndex < Lutaml::Hal::Page
+      hal_link :specifications, key: 'specifications', realize_class: 'Specification', collection: true
+    end
+  end
+end

data/lib/w3c_api/models/team_contact_index.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative 'user'
+
+module W3cApi
+  module Models
+    class TeamContactIndex < Lutaml::Hal::Page
+      hal_link :team_contacts, key: 'team-contacts', realize_class: 'User', collection: true
+    end
+  end
+end

data/lib/w3c_api/models/testimonial.rb

@@ -0,0 +1,17 @@
+require 'lutaml/hal'
+
+#     "testimonials": {
+#         "en": "Google's mission is to organize the world’s information and make it universally accessible and useful."
+#     },
+
+module W3cApi
+  module Models
+    class Testimonial < Lutaml::Hal::Resource
+      attribute :en, :string
+
+      key_value do
+        map 'en', to: :en
+      end
+    end
+  end
+end

data/lib/w3c_api/models/translation.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
-require_relative 'base'
-require_relative 'call_for_translation_ref'
-require_relative 'link'
+require_relative 'call_for_translation'
 require_relative 'user'
 
 # {
@@ -85,78 +83,41 @@ require_relative 'user'
 # }
 
 module W3cApi
-    module Models
-      class TranslationLinks < Lutaml::Model::Serializable
-        attribute :self, Link
-      end
-
-      class Translation < Base
-        attribute :uri, :string
-        attribute :title, :string
-        attribute :href, :string
-        attribute :language, :string
-        attribute :published, :string # Date-time format
-        attribute :updated, :string # Date-time format
-        attribute :authorized, :boolean
-        attribute :lto_name, :string
-        attribute :call_for_translation, CallForTranslationRef
-        attribute :comments, :string
-        attribute :states, :string, collection: true
-        attribute :translators, User, collection: true
-        attribute :_links, TranslationLinks
-
-        # Parse date strings to Date objects
-        def published_date
-          Date.parse(published) if published
-        rescue Date::Error
-          nil
-        end
-
-        def updated_date
-          Date.parse(updated) if updated
-        rescue Date::Error
-          nil
-        end
-
-        # Get the call for translation as a CallForTranslation object
-        def call_for_translation_object
-          return nil unless call_for_translation
-
-          Models::CallForTranslation.new(call_for_translation)
-        end
-
-        # Get the specification version associated with this translation
-        def specification_version(client = nil)
-          return nil unless call_for_translation&.spec_version
-
-          call_for_translation.spec_version
-        end
+  module Models
+    class Translation < Lutaml::Hal::Resource
+      attribute :uri, :string
+      attribute :title, :string
+      attribute :href, :string
+      attribute :language, :string
+      attribute :published, :date_time
+      attribute :updated, :date_time
+      attribute :authorized, :boolean
+      attribute :lto_name, :string
+      attribute :call_for_translation, CallForTranslation
+      attribute :comments, :string
+      attribute :states, :string, collection: true
+      attribute :translators, User, collection: true
 
-        def self.from_response(response)
-          transformed_response = transform_keys(response)
+      hal_link :self, key: 'self', realize_class: 'Translation'
 
-          translation = new
-          transformed_response.each do |key, value|
-            case key
-            when :_links
-              links = value.each_with_object({}) do |(link_name, link_data), acc|
-                acc[link_name] = Link.new(href: link_data[:href], title: link_data[:title])
-              end
-              translation._links = TranslationLinks.new(links)
-            when :call_for_translation
-              translation.call_for_translation = CallForTranslationRef.new(value)
-            when :translators
-              # Handle translators as User objects if present
-              if value.is_a?(Array)
-                users = value.map { |user_data| User.from_response(user_data) }
-                translation.translators = users
-              end
-            else
-              translation.send("#{key}=", value) if translation.respond_to?("#{key}=")
-            end
-          end
-          translation
+      key_value do
+        %i[
+          uri
+          title
+          href
+          language
+          published
+          updated
+          authorized
+          lto_name
+          call_for_translation
+          comments
+          states
+          translators
+        ].each do |key|
+          map key.to_s.tr('_', '-'), to: key
         end
       end
     end
+  end
 end