eazypi 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bfe47c3c3c7c8c3ac25c0d67311957fb2672599ea81f48e6247f82b9fae6710b
-  data.tar.gz: 436ec6c096a12482add4ac1a0245b4c555e254fd3be329ba9549e6b1422a1154
+  metadata.gz: 3039b06d210f7a865957a6eb86b1946e0a7ae2ea63091ada95eed28ad47e8a7b
+  data.tar.gz: c5b7ad7943c65cb84eb94b27c6c0b63978bc03f42b14b140df9b52f0caebe24d
 SHA512:
-  metadata.gz: f849fdc4f64b2471955dcf1b8517e6bd445d2285b646384c6081b6aa9ffb87d78e9be72a093c4731436ea6fd4340561a2b1aa89886cdb3e53f0c8007bfd704d6
-  data.tar.gz: 62e8ba592f52624d36bedba28e96f463956c6ae3cb16e1aa2d89acfc060459bc897d2034bdfa8e7423b7222104f0f4bca0acdbe4729358d821abc9d3cf5a91ce
+  metadata.gz: 184707f28d37b10fea94dd4c245dc5143e484b22b089061b3d9efe8cea7b2e48edf38f238dc07dd9fdda728520e482689d505571998c3e52b20913fa828254f6
+  data.tar.gz: 00011c9d53005e80ada9eabf45fc4ce98fde60160fb418048a5dd46852ed8db8ee0d4d2c97455605229651d98ed1ce680a70f8a1979382733e66c1853337ad15

data/README.md

@@ -46,17 +46,95 @@ class Api::V1::Example
 end
 ~~~
 
+## Define API Objects
+
+Define API objects, they can be used with parameter objects and/or content objects in a controller
+
+~~~
+class Api::V1::Example
+  include Eazypi::Serializer
+
+  attribute :id, type: String, required: true
+  attribute :name, type: String, required: true
+end
+~~~
+
+More advanced attribute types are also possible
+
+~~~
+class Api::V1::Child
+  include Eazypi::Serializer
+
+  attribute :id, type: String, required: true
+  attribute :name, type: String, required: true
+
+  attribute :alternative_names, type: [String], required: false
+end
+
+class Api::V1::ExampleWithChildren
+  include Eazypi::Serializer
+
+  attribute :id, type: String, required: true
+  attribute :name, type: String, required: true
+
+  attribute :children, type: [Child], required: false
+end
+~~~
+
 ### Create a controller Class
 
 Create a normal rails controller and use the DSL to define operations.
 
 ~~~
 class Api::V1::ExampleController
+  include include Eazypi::ApiController
+
   operation :get, '/examples' do
-    response 200, [String]
+    parameter :filter do # By default a query parameter if it doesn't match a path parameter
+      description "Filter examples
+
+      schema FilterExample
+    end
+
+    response 200 do
+      description "Example"
+
+      content [API::V1::Example] # Example is defined as API Object (see above for example)
+    end
 
     render do
-      render json: { examples: ['A', 'B'] }
+      examples = ... # Examples is array of class Example NOT API::V1::Example
+      respond_with examples
+    end
+  end
+
+  operation :get, '/example/:id' do
+    parameter :id do # Example of path parameter
+      description "Id of the pet you want to find"
+
+      schema String # Only primitive types (String, Integer, Float) are allowed in path parameters
+    end
+
+    response 200 do
+      description "Example"
+
+      content API::V1::Example # Example is defined as API Object (see above for example)
+    end
+
+    response 404 do
+      description "Not found"
+
+      content API::V1::Error
+    end
+
+    render do
+      example = Example.find_by(params[:id]) # Note Example here is ActiveRecord Object, not the API view of it
+
+      if example
+        respond_with example # Will serialize example object
+      else
+        respond_with Error.new(message: "Not found"), status: :not_found # Will automatically serialize Error object
+      end
     end
   end
 end

data/lib/eazypi/api_controller.rb

@@ -62,11 +62,7 @@ module Eazypi
 
         response_object_type = response_type.object_type_for_content_type
 
-        if response_object_type.nil?
-          render json: nil, status: status
-        else
-          render json: response_type.object_type_for_content_type.new(object).to_json, status: status
-        end
+        render json: Serializer.serialize_object(response_object_type, object), status: status
       end
     end
   end

data/lib/eazypi/serializer.rb

@@ -18,6 +18,22 @@ module Eazypi
       end
 
       def serialize(object)
+        the_value = value(object)
+
+        Serializer.serialize_object(type, the_value)
+      end
+
+      private
+
+      def serialize_array(the_value)
+        return the_value if self.class.primitive_type?(type[0])
+
+        the_value.map do |element_value|
+          type[0].new(element_value).to_json
+        end
+      end
+
+      def value(object)
         if @method
           @method.call(object)
         elsif @method_name
@@ -33,6 +49,8 @@ module Eazypi
     end
 
     def to_json(*_args)
+      return nil if @object.nil?
+
       self.class.attributes.to_h do |attribute|
         [attribute.name, attribute.serialize(@object)]
       end
@@ -65,5 +83,19 @@ module Eazypi
         schema
       end
     end
+
+    def self.serialize_object(type_object, object) # rubocop:disable Metrics/MethodLength
+      if type_object.nil?
+        nil
+      elsif type_object.is_a?(Array)
+        object&.map do |value|
+          serialize_object(type_object[0], value)
+        end
+      elsif [String, Integer, Float].include?(type_object)
+        object
+      else
+        type_object.new(object).to_json
+      end
+    end
   end
 end

data/lib/eazypi/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Eazypi
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eazypi
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors:
 - Nathan Samson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-06-06 00:00:00.000000000 Z
+date: 2024-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack