magento 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10797b41b2292eb765414cf4757cca8e92d6eeaa604ae3c59da76763e11dce9e
-  data.tar.gz: 683f76e2c1b7215e279459bd5eca921caba0e58fe18d299a29c256a0a5e11b94
+  metadata.gz: 5a31c9d80a9b75142710a4eaca0c87e47ac32c9fc0589ce967cebd450350a4e2
+  data.tar.gz: 16e930d0a17ccab6e520e75e4a87da495caee97977c6ed61b59b5ed046c82485
 SHA512:
-  metadata.gz: c8c44416f426c6c57bd402cd2d794027ce811bdd1d2e001502d19ffc785e3cb16b26d01fa983c1a3e1582a2d2a6b18f33a3a6f472230069abb33d75263676060
-  data.tar.gz: 5175d8d609601f3b207e29f92cfa38fff076c7ec51a225c274cbdfbd5d6a81edc99e3f8069ebeed100b838899add3c875c70054afa2de70601d69148270ad521
+  metadata.gz: ed64d3a633a8d5e4cfd6eac464ff4d3bfc85c5105c5a2f83a4dc8d739710d584fa9ca35a17f49ea49eeadd01e3aadc6d1c6c48e3f46fbe085544b3ada8e518b4
+  data.tar.gz: 9ad6ce4e8e29c15eea332371f3c73b9d0c342d97b540a764ae7e8f6f03244e087e44fd72e8f1bd5e50cb5fc5b22327f9b2ee55369261ea9efa1208fc13527209

data/.github/workflows/gem-push.yml

@@ -2,9 +2,9 @@ name: Ruby Gem
 
 on:
   push:
-    branches: [ master ]
+    branches: [ release ]
   pull_request:
-    branches: [ master ]
+    branches: [ release ]
 
 jobs:
   build:

data/README.md

@@ -1,221 +1,286 @@
-# Magento Ruby library
-
-## Install
-
-Add in your Gemfile
-
-```rb
-gem 'magento', '~> 0.4.0'
-```
-
-or run
-
-```sh
-gem install magento
-```
-
-### Setup
-
-```rb
-Magento.url   = 'https://yourstore.com'
-Magento.token = 'MAGENTO_API_KEY'
-Magento.store = :default # optional, Default is :all
-```
-
-## Models
-```rb
-Magento::Product
-Magento::Order
-Magento::Country
-Magento::Category
-```
-
-## Get details
-
-```rb
-Magento::Product.find('sku-test')
-Magento::Order.find(25)
-Magento::Country.find('BR')
-```
-\* _same pattern to all models_
-
-**Outside pattern**
-
-Get customer by token
-
-```rb
-Magento::Customer.find_by_token('user_token')
-```
-
-## Get List
-
-```rb
-Magento::Product.all
-```
-
-#### Select fields:
-```rb
-Magento::Product.select(:id, :sku, :name).all
-Magento::Product.select(:id, :sku, :name, extension_attributes: :category_links).all
-Magento::Product.select(:id, :sku, :name, extension_attributes: [:category_links, :website_ids]).all
-Magento::Product.select(:id, :sku, :name, extension_attributes: [:website_ids, { category_links: :category_id }]).all
-```
-
-#### Filters:
-
-```rb
-Magento::Product.where(name_like: 'IPhone%').all
-Magento::Product.where(price_gt: 100).all
-
-# price > 10 AND price < 20
-Magento::Product.where(price_gt: 10)
-                .where(price_lt: 20).all
-
-# price < 1 OR price > 100
-Magento::Product.where(price_lt: 1, price_gt: 100).all
-
-Magento::Order.where(status_in: [:canceled, :complete]).all
-```
-
-| Condition | Notes |
-| --------- | ----- |
-|eq         | Equals. |
-|finset     | A value within a set of values |
-|from       | The beginning of a range. Must be used with to |
-|gt         | Greater than |
-|gteq       | Greater than or equal |
-|in         | In. The value is an array |
-|like       | Like. The value can contain the SQL wildcard characters when like is specified. |
-|lt         | Less than |
-|lteq       | Less than or equal |
-|moreq      | More or equal |
-|neq        | Not equal |
-|nfinset    | A value that is not within a set of values |
-|nin        | Not in. The value is an array |
-|notnull    | Not null |
-|null       | Null |
-|to         | The end of a range. Must be used with from |
-
-
-#### SortOrder:
-
-```rb
-Magento::Product.order(:sku).all
-Magento::Product.order(sku: :desc).all
-Magento::Product.order(status: :desc, name: :asc).all
-```
-
-#### Pagination:
-
-```rb
-# Set page and quantity per page
-Magento::Product.page(1)       # Current page, Default is 1
-                .page_size(25) # Default is 50
-                .all
-
-# per is an alias to page_size
-Magento::Product.per(25).all
-```
-
-#### Example of several options together:
-```rb
-products = Magento::Product.select(:sku, :name)
-                           .where(name_like: 'biscoito%')
-                           .page(1)
-                           .page_size(5)
-                           .all
-```
-
-\* _same pattern to all models_
-
-### Response
-
-The `all` method retorns a `Magento::RecordCollection` instance
-
-```rb
-products.first
-# #<Magento::Product @sku="2100", @name="Biscoito Piraque Salgadinho 100G">
-
-products[0]
-# #<Magento::Product @sku="2100", @name="Biscoito Piraque Salgadinho 100G">
-
-products.last
-# #<Magento::Product @sku="964", @name="Biscoito Negresco 140 G Original">
-
-products.map(&:sku)
-# ["2100", "792", "836", "913", "964"]
-
-products.size
-# 5
-
-products.current_page 
-# 1
-
-products.page_size    
-# 5
-
-products.total_count  
-# 307
-```
-
-## Create
-
-```rb
-Magento::Order.create(
-  customer_firstname: '',
-  customer_lastname: '',
-  customer_email: '',
-  # others attrbutes ...,
-  items: [
-    {
-      sku: '',
-      price: '',
-      qty_ordered: 1,
-      # others attrbutes ...,
-    }
-  ],
-  billing_address: {
-    # attrbutes...
-  },
-  payment: {
-    # attrbutes...
-  },
-  extension_attributes: {
-    # attrbutes...
-  }
-)
-```
-
-### Update
-
-```rb
-product = Magento::Product.find('sku-teste')
-
-product.name = 'Updated name'
-product.save
-
-# or
-
-product.update(name: 'Updated name')
-```
-
-### Delete
-
-```rb
-product = Magento::Product.find('sku-teste')
-
-product.delete
-
-# or
-
-Magento::Product.delete('sku-teste')
-```
-
-___
-
-##TODO:
-
-### Search products
-```rb
-Magento::Product.search('tshort')
-```
+# Magento Ruby library
+
+## Install
+
+Add in your Gemfile
+
+```rb
+gem 'magento', '~> 0.5.0'
+```
+
+or run
+
+```sh
+gem install magento
+```
+
+### Setup
+
+```rb
+Magento.url   = 'https://yourstore.com'
+Magento.token = 'MAGENTO_API_KEY'
+Magento.store = :default # optional, Default is :all
+```
+
+## Models
+```rb
+Magento::Product
+Magento::Order
+Magento::Country
+Magento::Category
+```
+
+## Get details
+
+```rb
+Magento::Product.find('sku-test')
+Magento::Order.find(25)
+Magento::Country.find('BR')
+```
+\* _same pattern to all models_
+
+**Outside pattern**
+
+Get customer by token
+
+```rb
+Magento::Customer.find_by_token('user_token')
+```
+
+## Get List
+
+```rb
+Magento::Product.all
+```
+
+#### Select fields:
+```rb
+Magento::Product.select(:id, :sku, :name).all
+Magento::Product.select(:id, :sku, :name, extension_attributes: :category_links).all
+Magento::Product.select(:id, :sku, :name, extension_attributes: [:category_links, :website_ids]).all
+Magento::Product.select(:id, :sku, :name, extension_attributes: [:website_ids, { category_links: :category_id }]).all
+```
+
+#### Filters:
+
+```rb
+Magento::Product.where(name_like: 'IPhone%').all
+Magento::Product.where(price_gt: 100).all
+
+# price > 10 AND price < 20
+Magento::Product.where(price_gt: 10)
+                .where(price_lt: 20).all
+
+# price < 1 OR price > 100
+Magento::Product.where(price_lt: 1, price_gt: 100).all
+
+Magento::Order.where(status_in: [:canceled, :complete]).all
+```
+
+| Condition | Notes |
+| --------- | ----- |
+|eq         | Equals. |
+|finset     | A value within a set of values |
+|from       | The beginning of a range. Must be used with to |
+|gt         | Greater than |
+|gteq       | Greater than or equal |
+|in         | In. The value is an array |
+|like       | Like. The value can contain the SQL wildcard characters when like is specified. |
+|lt         | Less than |
+|lteq       | Less than or equal |
+|moreq      | More or equal |
+|neq        | Not equal |
+|nfinset    | A value that is not within a set of values |
+|nin        | Not in. The value is an array |
+|notnull    | Not null |
+|null       | Null |
+|to         | The end of a range. Must be used with from |
+
+
+#### SortOrder:
+
+```rb
+Magento::Product.order(:sku).all
+Magento::Product.order(sku: :desc).all
+Magento::Product.order(status: :desc, name: :asc).all
+```
+
+#### Pagination:
+
+```rb
+# Set page and quantity per page
+Magento::Product.page(1)       # Current page, Default is 1
+                .page_size(25) # Default is 50
+                .all
+
+# per is an alias to page_size
+Magento::Product.per(25).all
+```
+
+#### Example of several options together:
+```rb
+products = Magento::Product.select(:sku, :name)
+                           .where(name_like: 'biscoito%')
+                           .page(1)
+                           .page_size(5)
+                           .all
+```
+
+\* _same pattern to all models_
+
+### Response
+
+The `all` method retorns a `Magento::RecordCollection` instance
+
+```rb
+products.first
+>> <Magento::Product @sku="2100", @name="Biscoito Piraque Salgadinho 100G">
+
+products[0]
+>> <Magento::Product @sku="2100", @name="Biscoito Piraque Salgadinho 100G">
+
+products.last
+>> <Magento::Product @sku="964", @name="Biscoito Negresco 140 G Original">
+
+products.map(&:sku)
+>> ["2100", "792", "836", "913", "964"]
+
+products.size
+>> 5
+
+products.current_page
+>> 1
+
+products.page_size
+>> 5
+
+products.total_count
+>> 307
+
+products.filter_groups
+>> [<Magento::FilterGroup @filters=[<Magento::Filter @field="name", @value="biscoito%", @condition_type="like">]>]
+```
+
+All Methods:
+
+```rb
+# Information about search criteria
+:current_page
+:page_size
+:total_count
+:filter_groups
+
+# Iterating with the list of items
+:count
+:length
+:size
+
+:first
+:last
+:[]
+:find
+
+:each
+:each_with_index
+:sample
+
+:map
+:select
+:filter
+:reject
+:collect
+:take
+:take_while
+
+:sort
+:sort_by
+:reverse_each
+:reverse
+
+:all?
+:any?
+:none?
+:one?
+:empty?
+```
+
+## Create
+
+```rb
+Magento::Order.create(
+  customer_firstname: '',
+  customer_lastname: '',
+  customer_email: '',
+  # others attrbutes ...,
+  items: [
+    {
+      sku: '',
+      price: '',
+      qty_ordered: 1,
+      # others attrbutes ...,
+    }
+  ],
+  billing_address: {
+    # attrbutes...
+  },
+  payment: {
+    # attrbutes...
+  },
+  extension_attributes: {
+    # attrbutes...
+  }
+)
+```
+
+### Update
+
+```rb
+product = Magento::Product.find('sku-teste')
+
+product.name = 'Updated name'
+product.save
+
+# or
+
+product.update(name: 'Updated name')
+```
+
+### Delete
+
+```rb
+product = Magento::Product.find('sku-teste')
+
+product.delete
+
+# or
+
+Magento::Product.delete('sku-teste')
+```
+
+## GuestCart
+
+Set payment information to finish the order
+```rb
+cart = Magento::GuestCart.find('gXsepZcgJbY8RCJXgGioKOO9iBCR20r7')
+
+# or use "build" to not request information from the magento API
+cart = Magento::GuestCart.build(
+  cart_id: 'aj8oUtY1Qi44Fror6UWVN7ftX1idbBKN'
+)
+
+cart.payment_information(
+  email: 'customer@gmail.com',
+  payment: { method: 'cashondelivery' }
+)
+
+>> "234575" # return the order id
+```
+
+___
+
+##TODO:
+
+### Search products
+```rb
+Magento::Product.search('tshort')
+```