trailer_vote-api 0.8.4 → 0.9.0

data/lib/trailer_vote/api/place/children.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'trailer_vote/api/place'
+require 'trailer_vote/api/place/find'
+
+module TrailerVote
+  module Api
+    class Product
+      class Find
+        # @return [TrailerVote::Api::Product::Children] api to deal with a place's children
+        def children
+          Children.new(configuration: configuration, place: self)
+        end
+      end
+
+      class Children
+        def initialize(configuration:, place: nil)
+          self.configuration = configuration
+          self.place = place
+        end
+
+        # @return [TrailerVote::Api::Product::Find] api to deal with a found place
+        def back
+          place
+        end
+
+        private
+
+        attr_accessor :configuration, :place
+      end
+    end
+  end
+end

data/lib/trailer_vote/api/place/children/urls.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'trailer_vote/api/composable/get'
+require 'trailer_vote/api/place'
+
+module TrailerVote
+  module Api
+    class Place
+      class Children
+
+        # @return [TrailerVote::Api::Place::Children::Urls] the api to get the children urls for the current place
+        def urls
+          Urls.new(configuration: configuration, place: place)
+        end
+
+        class Urls
+          include Composable::Get
+
+          SUCCESS = MediaTypes::Place.to_constructable.version(3).view('index')
+          FAILURE = MediaTypes::Errors.to_constructable.version(1)
+
+          ACCEPT = [SUCCESS.to_s, FAILURE.to_s(0.1)].join(', ').freeze
+
+          def initialize(configuration:, place:, result: nil)
+            self.configuration = configuration
+            self.place = place
+            self.result = result
+          end
+
+          # @return [TrailerVote::Api::Place::Children] the api to deal with a place's children
+          def back
+            place.children
+          end
+
+          def call(url: resolve_url)
+            return self if ok? || !url
+
+            guard_network_errors do
+              branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
+            end
+          end
+
+          def data
+            to_h[:places]
+          end
+
+          private
+
+          attr_accessor :place
+
+          def ok?
+            result&.status&.ok?
+          end
+
+          def resolve_url
+            place.links.children
+          end
+
+          def redirect(result)
+            redirect_klazz.new(configuration: configuration, place: place, result: result)
+                          .call(url: redirected_url(result))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/trailer_vote/api/place/create.rb

@@ -1,83 +1,83 @@
-# frozen_string_literal: true
-
-require 'trailer_vote/api/composable/common'
-require 'trailer_vote/api/place'
-require 'trailer_vote/api/place/find'
-
-module TrailerVote
-  module Api
-    class Place
-      class Find
-
-        # @return [TrailerVote::Api::Place::Create] the api to create a child place
-        def create
-          Create.new(configuration: configuration, place: self)
-        end
-      end
-
-      class Create
-        include Composable::Common
-
-        CONTENT = MediaTypes::Place.to_constructable.version(2).view('create')
-        SUCCESS = MediaTypes::Place.to_constructable.version(2)
-        FAILURE = MediaTypes::Errors.to_constructable.version(1)
-
-        ACCEPT = [SUCCESS.to_s, FAILURE.to_s(0.1)].join(', ').freeze
-
-        # @private
-        def initialize(configuration:, place:)
-          self.configuration = configuration
-          self.place = place
-        end
-
-        # @return [TrailerVote::Api::Place::Find] the found place
-        def back
-          place
-        end
-
-        # Create a place
-        #
-        # @see https://www.rubydoc.info/gems/trailer_vote-media_types/TrailerVote/MediaTypes/Place TrailerVote::MediaTypes::Place
-        #
-        # @param [String, Hash] data the data conform to the Place media type
-        # @param [String] url (#resolve_url result) the url to post to
-        #
-        # @return [TrailerVote::Api::Place::Find]
-        def call(data:, url: resolve_url)
-          guard_network_errors do
-            body = encode(data)
-            branch(
-              resolve_client.headers(
-                Headers::ACCEPT => ACCEPT,
-                Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
-              ).post(url, body: body),
-              data: data
-            )
-          end
-        end
-
-        private
-
-        attr_accessor :place
-
-        def resolve_url
-          place.links.self
-        end
-
-        def encode(data)
-          TrailerVote::Api.encode(CONTENT, place: data)
-        end
-
-        def forward(result, data:)
-          return unless [307, 308].include?(result.status)
-          forward_klazz.new(configuration: configuration, place: place)
-                       .call(data: data, url: redirected_url(result))
-        end
-
-        def redirect_klazz
-          Find
-        end
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+require 'trailer_vote/api/composable/common'
+require 'trailer_vote/api/place'
+require 'trailer_vote/api/place/find'
+
+module TrailerVote
+  module Api
+    class Place
+      class Find
+
+        # @return [TrailerVote::Api::Place::Create] the api to create a child place
+        def create
+          Create.new(configuration: configuration, place: self)
+        end
+      end
+
+      class Create
+        include Composable::Common
+
+        CONTENT = MediaTypes::Place.to_constructable.version(2).view('create')
+        SUCCESS = MediaTypes::Place.to_constructable.version(2)
+        FAILURE = MediaTypes::Errors.to_constructable.version(1)
+
+        ACCEPT = [SUCCESS.to_s, FAILURE.to_s(0.1)].join(', ').freeze
+
+        # @private
+        def initialize(configuration:, place:)
+          self.configuration = configuration
+          self.place = place
+        end
+
+        # @return [TrailerVote::Api::Place::Find] the found place
+        def back
+          place
+        end
+
+        # Create a place
+        #
+        # @see https://www.rubydoc.info/gems/trailer_vote-media_types/TrailerVote/MediaTypes/Place TrailerVote::MediaTypes::Place
+        #
+        # @param [String, Hash] data the data conform to the Place media type
+        # @param [String] url (#resolve_url result) the url to post to
+        #
+        # @return [TrailerVote::Api::Place::Find]
+        def call(data:, url: resolve_url)
+          guard_network_errors do
+            body = encode(data)
+            branch(
+              resolve_client.headers(
+                Headers::ACCEPT => ACCEPT,
+                Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
+              ).post(url, body: body),
+              data: data
+            )
+          end
+        end
+
+        private
+
+        attr_accessor :place
+
+        def resolve_url
+          place.links.self
+        end
+
+        def encode(data)
+          TrailerVote::Api.encode(CONTENT, place: data)
+        end
+
+        def forward(result, data:)
+          return unless [307, 308].include?(result.status)
+          forward_klazz.new(configuration: configuration, place: place)
+                       .call(data: data, url: redirected_url(result))
+        end
+
+        def redirect_klazz
+          Find
+        end
+      end
+    end
+  end
+end

data/lib/trailer_vote/api/place/find.rb

@@ -1,59 +1,60 @@
-# frozen_string_literal: true
-
-require 'trailer_vote/api/composable/get'
-require 'trailer_vote/api/place'
-
-module TrailerVote
-  module Api
-    class Configuration
-
-      # @return [TrailerVote::Api::Place::Find] the root place attached to the credentials
-      def place
-        Place::Find.new(configuration: self)
-      end
-    end
-
-    class Place
-      class Find
-        include Composable::Get
-
-        SUCCESS = MediaTypes::Place.to_constructable.version(2)
-        FAILURE = MediaTypes::Errors.to_constructable.version(1)
-
-        ACCEPT = [SUCCESS.to_s, FAILURE.to_s(0.1)].join(', ').freeze
-
-        def initialize(configuration:, result: nil)
-          self.configuration = configuration
-          self.result = result
-        end
-
-        # @return [TrailerVote::Api::Configuration, TrailerVote::Api::Place::Create]
-        def back
-          backtrack = result
-          backtrack = result.back while backtrack&.is_a?(self.class)
-          backtrack || configuration
-        end
-
-        def call(url: resolve_url)
-          return self if ok? || !url
-          guard_network_errors do
-            branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
-          end
-        end
-
-        def resolve_url
-          configuration.links.place
-        end
-
-        def data
-          to_h[:place]
-        end
-
-        def parent
-          Find.new(configuration: configuration)
-              .call(url: links.parent)
-        end
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+require 'trailer_vote/api/composable/get'
+require 'trailer_vote/api/place'
+
+module TrailerVote
+  module Api
+    class Configuration
+
+      # @return [TrailerVote::Api::Place::Find] the root place attached to the credentials
+      def place
+        Place::Find.new(configuration: self)
+      end
+    end
+
+    class Place
+      class Find
+        include Composable::Get
+
+        SUCCESS = MediaTypes::Place.to_constructable.version(3)
+        FAILURE = MediaTypes::Errors.to_constructable.version(1)
+
+        ACCEPT = [SUCCESS.to_s, FAILURE.to_s(0.1)].join(', ').freeze
+
+        def initialize(configuration:, result: nil)
+          self.configuration = configuration
+          self.result = result
+        end
+
+        # @return [TrailerVote::Api::Configuration, TrailerVote::Api::Place::Create]
+        def back
+          backtrack = result
+          backtrack = result.back while backtrack&.is_a?(self.class)
+          backtrack || configuration
+        end
+
+        def call(url: resolve_url)
+          return self if ok? || !url
+
+          guard_network_errors do
+            branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
+          end
+        end
+
+        def resolve_url
+          configuration.links.place
+        end
+
+        def data
+          to_h[:place]
+        end
+
+        def parent
+          Find.new(configuration: configuration)
+              .call(url: links.parent)
+        end
+      end
+    end
+  end
+end

data/lib/trailer_vote/api/product.rb

@@ -1,33 +1,33 @@
-# frozen_string_literal: true
-
-require 'trailer_vote/media_types'
-require 'trailer_vote/api/configuration'
-
-module TrailerVote
-  module Api
-    class Configuration
-      # @return [TrailerVote::Api::Product] api to deal with products
-      def product
-        Product.new(configuration: self)
-      end
-
-      alias products product
-    end
-
-    class Product
-      def initialize(configuration:)
-        self.configuration = configuration
-      end
-
-      def back
-        configuration
-      end
-
-      private
-
-      attr_accessor :configuration
-    end
-  end
-end
-
-TrailerVote::MediaTypes::Product.register
+# frozen_string_literal: true
+
+require 'trailer_vote/media_types'
+require 'trailer_vote/api/configuration'
+
+module TrailerVote
+  module Api
+    class Configuration
+      # @return [TrailerVote::Api::Product] api to deal with products
+      def product
+        Product.new(configuration: self)
+      end
+
+      alias products product
+    end
+
+    class Product
+      def initialize(configuration:)
+        self.configuration = configuration
+      end
+
+      def back
+        configuration
+      end
+
+      private
+
+      attr_accessor :configuration
+    end
+  end
+end
+
+TrailerVote::MediaTypes::Product.register