fulfil_api 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10fcad8a31843f9c7c15e2c0d7e9ed00331fbc665091f088f6fd7794fae7159a
-  data.tar.gz: 367ed1508c804dc8fffc4da5089683702ca18d35433c5d6ae8744a06fae7bde7
+  metadata.gz: 0a281b6b98a2a9e17e00dfcfc9a69c25d981742fc6be3ed3107843381ed0ee72
+  data.tar.gz: 709b239f59384ab61adf1f258aea4f6f429846a7d1bebce1373694c6a3b8bd1d
 SHA512:
-  metadata.gz: 84f5db4b17bb3c6e0011f30dd5b9a8d9472199a49f2562ad1e2646540e0d08f1d89372e42fc3f4492731c6df52e4343cda4547b20dbdcafc48c388aa176780f1
-  data.tar.gz: fa251dcc692380fa34543b6ae0d82338cc09b9cadd5d2d8875d02a02ee6c49168017808607a7508996f61ab10dc1d389b5915c7269b24792997ba65113071c44
+  metadata.gz: 0e992ff3b009ae88f5bf03fd50694b241eb8dfdb316c8c71d036d8e55d582018a32d9c7c306d1c2dc85cf9d12413785b44dc796a11ea9f0bec8b879416014375
+  data.tar.gz: b3ba21ef6d73d9d077f172535451b6ba62a7410f610271601c485e356e4df22ef5fb5c741d113b7ed43773a798a036cacc29564fcfd231807f02a9520bcf5cc2

data/lib/fulfil_api/resource/persistable.rb

@@ -12,18 +12,49 @@ module FulfilApi
       extend ActiveSupport::Concern
 
       class_methods do
+        # Creates a new resource on the model name.
+        #
+        # @param model_name [String] The name of the model to which the resource belongs.
+        # @params attributes [Hash] The attributes to create the resource with.
+        # @return [FulfilApi::Resource, false] The created resource.
+        #
+        # @example Creating a resource
+        #   FulfilApi::Resource.create(model_name: "sale.sale", reference: "MK123")
+        def create(model_name:, **attributes)
+          resource = new(model_name: model_name)
+          resource.create(attributes)
+        rescue FulfilApi::Error
+          false
+        end
+
+        # Creates a new resource on the model name, raising an error if the create fails.
+        #
+        # @param model_name [String] The name of the model to which the resource belongs.
+        # @params attributes [Hash] The attributes to create the resource with.
+        # @return [FulfilApi::Resource] The created resource.
+        # @raise [FulfilApi::Error] If the create fails.
+        #
+        # @example Creating a resource
+        #   FulfilApi::Resource.create!(model_name: "sale.sale", reference: "MK123")
+        def create!(model_name:, **attributes)
+          resource = new(model_name: model_name)
+          resource.create!(attributes)
+        end
+
         # Updates a resource by its ID and model name.
         #
         # @param id [String, Integer] The ID of the resource to update.
         # @param model_name [String] The name of the model to which the resource belongs.
         # @param attributes [Hash] The attributes to update on the resource.
-        # @return [FulfilApi::Resource] The updated resource.
+        # @return [FulfilApi::Resource, false] The updated resource.
         #
         # @example Updating a resource
         #   FulfilApi::Resource.update(id: 123, model_name: "sale.sale", reference: "MK123")
         def update(id:, model_name:, **attributes)
           resource = new(id: id, model_name: model_name)
           resource.update(attributes)
+        rescue FulfilApi::Error
+          false
         end
 
         # Updates a resource by its ID and model name, raising an error if the update fails.
@@ -42,6 +73,31 @@ module FulfilApi
         end
       end
 
+      # Creates a resource with the given attributes and saves it.
+      #
+      # @param attributes [Hash] The attributes to assign to the resource.
+      # @return [FulfilApi::Resource] The created resource.
+      #
+      # @example Creating a resource
+      #   resource.create(reference: "MK123")
+      def create(attributes)
+        assign_attributes(attributes)
+        save
+      end
+
+      # Creates a resource with the given attributes and saves it, raising an error if saving fails.
+      #
+      # @param attributes [Hash] The attributes to assign to the resource.
+      # @return [FulfilApi::Resource] The created resource.
+      # @raise [FulfilApi::Error] If an error occurs during the create.
+      #
+      # @example Creating a resource with error raising
+      #   resource.create(reference: "MK123")
+      def create!(attributes)
+        assign_attributes(attributes)
+        save!
+      end
+
       # Saves the current resource, rescuing any errors that occur and handling them based on error type.
       #
       # @return [FulfilApi::Resource, nil] Returns the resource if saved successfully, otherwise nil.
@@ -67,8 +123,8 @@ module FulfilApi
 
         if id.present?
           FulfilApi.client.put("/model/#{model_name}/#{id}", body: to_h)
-        else # rubocop:disable Style/EmptyElse
-          # TODO: Implement the {#create} and {#create!} methods to save a new resource
+        else
+          FulfilApi.client.post("/model/#{model_name}", body: to_h)
         end
 
         self

data/lib/fulfil_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FulfilApi
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fulfil_api
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Stefan Vermaas
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-10-09 00:00:00.000000000 Z
+date: 2024-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -121,7 +121,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.18
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: A HTTP client to interact the Fulfil.io API