halva 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80195ba0344ba27a745702df037112a4a99dd5dcf8b5a6efead8239695e45d65
-  data.tar.gz: a9ecef55da2bc12c3c3c87f81e866b598bfcc3c721c39951f44a9a13e753245b
+  metadata.gz: 3b7e22a105b03d70350b3e43d8c449edebf1eafc5dc348ebdc9d5247f9d9bf01
+  data.tar.gz: 96f911bb17f7fa41ff6ac293adb363eac38f5902f48cd08b9145a551ee554646
 SHA512:
-  metadata.gz: 6a23c6fb22884252b2184fd5b2caef1e9f59fbdbae3066230586b72782b018868a5d19c8de049b4a1751fed301f6350871f0765b6cbbae9b3e236b087a452daa
-  data.tar.gz: 8662e1c3887fe0c23061fb33a21a8e059e7e39764be9282ec219bc53064db34a565394cdd04d461a11fe3e4eba8f0442924989a788ced5ebdca07278884459a6
+  metadata.gz: cf8aedb6cbddcbe4ff987ea66e0cca8840228aa5349fa6887643af6e7b248a8b64d440dde92de30ade4b7c22ef6ef4c9babeb7c781ff351d3aa0f8b56a8ee997
+  data.tar.gz: 7a2ff75eb11509ed050e36368b19ad4d55d8274fcd5db5588a3595bb193339f6a39c58f2d77d4909377050d410eaa9f608ef68b4d7f2772265685048e3ec7438

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    halva (0.3.0)
+    halva (0.4.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,13 +1,20 @@
 # Halva
 
-HAL-compliant serializer
+HAL-compliant decorator
 
 [![Ruby](https://github.com/denblackstache/halva/actions/workflows/main.yml/badge.svg)](https://github.com/denblackstache/halva/actions/workflows/main.yml) [![Gem Version](https://badge.fury.io/rb/halva.svg)](https://badge.fury.io/rb/halva)
 
-Links
+**Links**
 * [HAL - Hypertext Application Language](https://stateless.co/hal_specification.html)
 * [Specification Draft](https://datatracker.ietf.org/doc/html/draft-kelly-json-hal-08)
 
+**Goals**
+
+* No DSL
+* HAL-compliant
+* Not responsible for the whole presentation layer
+* Simple, extensible, self-discoverable
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -38,6 +45,20 @@ Halva::Resource.from_model(order)
                .link(Halva::Link.new('/orders/1/customer', :customer))
                .to_h
 
+# {
+#   :id => 1, 
+#   :name => "Order Example"
+#   :_embedded => {
+#     :customer => [{
+#       :id => 1, 
+#       :name => "Customer Example"
+#     }]
+#   }, 
+#   :_links => { 
+#     :self => {:href => "/orders/1"}, 
+#     :customer => {:href => "/orders/1/customer"} 
+#   }
+# }
 ```
 
 ### Representing a collection
@@ -50,12 +71,33 @@ Halva::Resource.from_empty_model
                .embed(orders.map do |order|
                  Halva::Resource.from_model(order)
                                 .link(Halva::Link.new("/orders/#{order.id}", :self))
-               end)
-               .link(Halva::Link.new('/orders?page=3', :next))
+               end, :'acme:order')
                .link(Halva::Link.new('/orders?page=2', :self))
+               .link(Halva::Link.new('/orders?page=3', :next))
                .link(Halva::Link.new('/orders?page=1', :prev))
+               .link(Halva::Curie.new('https://docs.acme.com/relations/{rel}', 'acme'))
                .to_h
 
+# {
+#   :_embedded => {
+#     :"acme:order" => [{
+#       :id => 1, 
+#       :name => "Example"
+#       :_links => {:self => {:href => "/orders/1"} }
+#     }]
+#   }, 
+#   :_links => { 
+#     :self => {:href => "/orders/1?page=2"}, 
+#     :next => {:href => "/orders/1?page=3"}, 
+#     :prev => {:href => "/orders/1?page=1"},
+#     :curies => [{
+#       name: 'acme',
+#       href: 'https://docs.acme.com/relations/{rel}',
+#       templated: true
+#     }]
+#   }
+# }
+
 ```
 
 ## Development

data/halva.gemspec

@@ -8,7 +8,7 @@ Gem::Specification.new do |spec|
   spec.authors       = ['Denis Semenenko']
   spec.email         = ['hypercoderx@gmail.com']
 
-  spec.summary       = 'HAL-compliant serializer'
+  spec.summary       = 'HAL-compliant decorator'
   spec.homepage      = 'https://github.com/denblackstache/halva'
   spec.license       = 'MIT'
   spec.required_ruby_version = Gem::Requirement.new('>= 2.7.0')

data/lib/halva/curie.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Halva
+  # Compact URI Link Object
+  # See [HAL Draft](https://datatracker.ietf.org/doc/html/draft-kelly-json-hal#section-8.2)
+  class Curie
+    attr_reader :relation, :href
+
+    # @param [String] href
+    # @param [String] name
+    def initialize(href, name)
+      @href = href
+      @relation = :curies
+      @link = Halva::Link.new(@href, @relation, { templated: true, name: name })
+    end
+
+    def to_h
+      @link.to_h
+    end
+  end
+end

data/lib/halva/link.rb

@@ -2,10 +2,20 @@
 
 module Halva
   # HAL Link Object
-  # https://datatracker.ietf.org/doc/html/draft-kelly-json-hal#section-5}
+  # See [HAL Draft](https://datatracker.ietf.org/doc/html/draft-kelly-json-hal#section-5)
   class Link
-    attr_reader :relation, :href
+    attr_reader :relation
 
+    # @param [String] href
+    # @param [Symbol] relation
+    # @param [Hash] options (templated, type, deprecation, name, profile, title, hreflang)
+    # @option options [Boolean] :templated true when the Link Object's "href" property is a URI Template
+    # @option options [String] :type a hint to indicate the media type expected when dereferencing the target resource
+    # @option options [String] :deprecation indicate that the link is to be deprecated (i.e. removed) at a future date
+    # @option options [String] :name a secondary key for selecting Link Objects which share the same relation type
+    # @option options [String] :profile a URI that hints about the profile of the target resource
+    # @option options [String] :title label for the link with a human-readable identifier
+    # @option options [String] :hreflang indicate the language of the target resource
     def initialize(href, relation, options = {})
       @href = href
       @relation = relation.to_sym

data/lib/halva/resource.rb

@@ -2,10 +2,11 @@
 
 module Halva
   # HAL Resource object
-  # https://datatracker.ietf.org/doc/html/draft-kelly-json-hal#section-4
+  # See [HAL Draft](https://datatracker.ietf.org/doc/html/draft-kelly-json-hal#section-4)
   class Resource
     EMBEDDED_KEY = :_embedded
     LINKS_KEY = :_links
+    CURIES_KEY = :curies
 
     def self.from_model(model)
       new(model.to_h)
@@ -48,7 +49,12 @@ module Halva
       unless @links.empty?
         document[LINKS_KEY] = {} unless document.key?(LINKS_KEY)
         @links.each do |link|
-          document[LINKS_KEY][link.relation] = link.to_h
+          if link.relation == CURIES_KEY
+            document[LINKS_KEY][CURIES_KEY] = [] unless document[LINKS_KEY].key?(CURIES_KEY)
+            document[LINKS_KEY][CURIES_KEY] << link.to_h
+          else
+            document[LINKS_KEY][link.relation] = link.to_h
+          end
         end
       end
 

data/lib/halva/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Halva
-  VERSION = '0.3.0'
+  VERSION = '0.4.0'
 end

data/lib/halva.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'halva/curie'
 require 'halva/link'
 require 'halva/resource'
 require 'halva/version'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: halva
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Denis Semenenko
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-02-21 00:00:00.000000000 Z
+date: 2023-02-25 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -30,6 +30,7 @@ files:
 - bin/setup
 - halva.gemspec
 - lib/halva.rb
+- lib/halva/curie.rb
 - lib/halva/link.rb
 - lib/halva/resource.rb
 - lib/halva/version.rb
@@ -58,5 +59,5 @@ requirements: []
 rubygems_version: 3.1.6
 signing_key:
 specification_version: 4
-summary: HAL-compliant serializer
+summary: HAL-compliant decorator
 test_files: []