magento 0.8.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ad71d2a627ff149bce29e8ad50d8f71926a19079c2af86000db29109d305c65
-  data.tar.gz: bc2f85e76ff1da204aa8d613a770401763bee486e6dd045af6b4e97df8758f62
+  metadata.gz: f2d89a076f05f6e5a3f3a828d7658582a76556e57f6f0ff07a2422044ce82ab4
+  data.tar.gz: fbf4ab1013bf639d81781cc40042aedc5ed62062207f597e127a2ba0bc5b21b3
 SHA512:
-  metadata.gz: 2166a5412b4f41a7298efe838d5ad927d60905206af025a745420109ff87700c56d0adaaea49da0d2a4519fb34b2abafcedbabb810bfc6972fe28c92bd29c61a
-  data.tar.gz: 400d5d6ef1669fb147a0281312a9504ee252d7d1a46debab0bb61cdc51286d6c0c4956dfeb355a691d49bd4d0f06e044f9fe0f9968a0d3529dcdde8b36ebd732
+  metadata.gz: b31854a2ad2fb3ed3ea8711c45e56a426abae13c17b392c69e0186f2594d5bb7654baf8e0dc55cf72265340153bdba56edfdff0a28836d1516d55a7c7537c4ab
+  data.tar.gz: 364a54b27877e55198d1cbb6f2f749aaa399301ba377ade578e2f9e092bd280002aa7cc1932c367adc8825c6790ab4aae2d39e20c30202f3a53d3cf2ecb9ce24

data/README.md

@@ -5,7 +5,7 @@
 Add in your Gemfile
 
 ```rb
-gem 'magento', '~> 0.8.1'
+gem 'magento', '~> 0.10.0'
 ```
 
 or run
@@ -68,6 +68,7 @@ Magento::Product.select(:id, :sku, :name, extension_attributes: [:website_ids, {
 #### Filters:
 
 ```rb
+Magento::Product.where(visibility: 4).all
 Magento::Product.where(name_like: 'IPhone%').all
 Magento::Product.where(price_gt: 100).all
 
@@ -130,6 +131,20 @@ products = Magento::Product.select(:sku, :name)
                            .all
 ```
 
+## Get one
+
+```rb
+Magento::Order.where(increment_id: '000013457').first
+# or
+Magento::Order.find_by(increment_id: '000013457')
+```
+
+## Count
+```rb
+Magento::Order.count
+Magento::Order.where(status: :pending).count
+```
+
 \* _same pattern to all models_
 
 ### Response
@@ -255,6 +270,10 @@ product.save
 # or
 
 product.update(name: 'Updated name')
+
+# or
+
+Magento::Product.update('sku-teste', name: 'Updated name')
 ```
 
 ### Delete
@@ -320,7 +339,7 @@ invoice_id = order.invoice(
 ## Create refund for invoice
 
 ```rb
-Magento::Invoice.invoice(refund_id)
+Magento::Invoice.invoice(invoice_id)
 >> 12 # return refund id
 
 # or from instance
@@ -361,6 +380,48 @@ invoice.refund(
 [Complete Refund Documentation](https://magento.redoc.ly/2.4-admin/tag/invoicescomments#operation/salesRefundInvoiceV1ExecutePost)
 
 
+## Create offline refund for order
+
+```rb
+Magento::Order.refund(order_id)
+>> 12 # return refund id
+
+# or from instance
+
+order = Magento::Order.find(order_id)
+
+order.refund
+
+# you can pass parameters too
+
+order.refund(
+  items: [
+    {
+      extension_attributes: {},
+      order_item_id: 0,
+      qty: 0
+    }
+  ],
+  notify: true,
+  appendComment: true,
+  comment: {
+    extension_attributes: {},
+    comment: string,
+    is_visible_on_front: 0
+  },
+  arguments: {
+    shipping_amount: 0,
+    adjustment_positive: 0,
+    adjustment_negative: 0,
+    extension_attributes: {
+      return_to_stock_items: [0]
+    }
+  }
+)
+```
+
+[Complete Refund Documentation](https://magento.redoc.ly/2.4-admin/tag/invoicescomments#operation/salesRefundOrderV1ExecutePost)
+
 ## Other Invoice methods
 
 ```rb

data/lib/magento/customer.rb

@@ -1,5 +1,7 @@
 module Magento
   class Customer < Model
+    self.endpoint = 'customers/search'
+
     def fullname
       "#{@firstname} #{@lastname}"
     end
@@ -7,11 +9,24 @@ module Magento
     class << self
       alias_method :find_by_id, :find
 
+      def update(*_attributes)
+        raise NotImplementedError
+      end
+
+      def create(*_attributes)
+        raise NotImplementedError
+      end
+
       def find_by_token(token)
         user_request = Request.new(token: token)
         customer_hash = user_request.get('customers/me').parse
         build(customer_hash)
       end
+
+      def find(id)
+        hash = request.get("customers/#{id}").parse
+        build(hash)
+      end
     end
   end
 end

data/lib/magento/invoice.rb

@@ -33,7 +33,7 @@ module Magento
     # invoice = Magento::Invoice.find(invoice_id)
     #
     # invoice.refund # or you can pass parameters
-    # invoice.invoice(notify: false) # See the refund class method for more information
+    # invoice.refund(isOnline: true) # See the refund class method for more information
     #
     # @return {Integer} return the refund id
     def refund(refund_params = nil)
@@ -125,7 +125,7 @@ module Magento
       #
       # @return {Integer} return the refund id
       def refund(invoice_id, refund_params=nil)
-        request.post("invoice/#{invoice_id}/refund", invoice_params).parse
+        request.post("invoice/#{invoice_id}/refund", refund_params).parse
       end
     end
   end

data/lib/magento/model.rb

@@ -9,12 +9,11 @@ module Magento
     def save
       self.class.update(send(self.class.primary_key), to_h)
     end
-
+    
     def update(attrs)
       raise "#{self.class.name} not saved" if send(self.class.primary_key).nil?
 
-      attrs.each { |key, value| send("#{key}=", value) }
-      save
+      self.class.update(send(self.class.primary_key), attrs)
     end
 
     def delete
@@ -28,7 +27,8 @@ module Magento
     class << self
       extend Forwardable
 
-      def_delegators :query, :all, :page, :per, :page_size, :order, :select, :where
+      def_delegators :query, :all, :page, :per, :page_size, :order, :select, 
+                     :where, :first, :find_by, :count
 
       def find(id)
         hash = request.get("#{api_resource}/#{id}").parse

data/lib/magento/order.rb

@@ -12,8 +12,7 @@ module Magento
     def update(attrs)
       raise "'entity_id' not found" if @entity_id.nil?
 
-      attrs[:entity_id] = @entity_id
-      self.class.update(attrs)
+      self.class.update(@entity_id, attrs)
     end
 
     def cancel
@@ -33,6 +32,20 @@ module Magento
       self.class.invoice(id, params)
     end
 
+    
+    #
+    # Create offline refund for order
+    #
+    # order = Magento::Order.find(order_id)
+    #
+    # order.refund # or you can pass parameters
+    # order.invoice(notify: false) # See the refund class method for more information
+    #
+    # @return {Integer} return the refund id
+    def refund(refund_params = nil)
+      self.class.refund(id, refund_params)
+    end
+
     #
     # Creates new Shipment for given Order.
     #
@@ -47,7 +60,8 @@ module Magento
     end
 
     class << self
-      def update(attributes)
+      def update(entity_id, attributes)
+        attributes[:entity_id] = entity_id
         hash = request.put('orders/create', { entity_key => attributes }).parse
         build(hash)
       end
@@ -84,6 +98,49 @@ module Magento
         request.post("order/#{order_id}/invoice", invoice_params).parse
       end
 
+      
+      #
+      # Create offline refund for order
+      #
+      # Magento::Order.refund(order_id)
+      #
+      # or
+      #
+      # Magento::Order.refund(
+      #   order_id,
+      #   items: [
+      #     {
+      #       extension_attributes: {},
+      #       order_item_id: 0,
+      #       qty: 0
+      #     }
+      #   ],
+      #   notify: true,
+      #   appendComment: true,
+      #   comment: {
+      #     extension_attributes: {},
+      #     comment: string,
+      #     is_visible_on_front: 0
+      #   },
+      #   arguments: {
+      #     shipping_amount: 0,
+      #     adjustment_positive: 0,
+      #     adjustment_negative: 0,
+      #     extension_attributes: {
+      #       return_to_stock_items: [
+      #         0
+      #       ]
+      #     }
+      #   }
+      # )
+      #
+      # to complete [documentation](https://magento.redoc.ly/2.4-admin/tag/invoicescomments#operation/salesRefundOrderV1ExecutePost)
+      #
+      # @return {Integer} return the refund id
+      def refund(order_id, refund_params = nil)
+        request.post("order/#{order_id}/refund", refund_params).parse
+      end
+
       #
       # Creates new Shipment for given Order.
       #

data/lib/magento/query.rb

@@ -89,6 +89,18 @@ module Magento
       RecordCollection.from_magento_response(result, model: model, iterable_field: field)
     end
 
+    def first
+      page_size(1).page(1).all.first
+    end
+
+    def find_by(attributes)
+      where(attributes).first
+    end
+
+    def count
+      select(:id).page_size(1).page(1).all.total_count
+    end
+
     private
 
     attr_accessor :current_page, :filter_groups, :request, :sort_orders, :model, :fields
@@ -119,10 +131,11 @@ module Magento
 
     def parse_filter(key)
       patter = /(.*)_([a-z]+)$/
-      raise 'Invalid format' unless key.match(patter)
-      raise 'Condition not accepted' unless ACCEPTED_CONDITIONS.include?(key.match(patter)[2])
+      match = key.match(patter)
+
+      return match.to_a[1..2] if match && ACCEPTED_CONDITIONS.include?(match[2])
 
-      key.match(patter).to_a[1..2]
+      [key, 'eq']
     end
 
     def parse_value_filter(condition, value)

data/lib/magento/version.rb

@@ -1,3 +1,3 @@
 module Magento
-  VERSION = '0.8.1'
+  VERSION = '0.10.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: magento
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.10.0
 platform: ruby
 authors:
 - Wallas Faria