magentwo 0.1.86 → 0.1.90

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e51e4d4b67554b49a976fee18670db67323bdcf507a8558ea2cd95d1bc4cc49
-  data.tar.gz: bba71d4d4bba4e985c266b1271ccc56514abc5001a8a5fbca99d1b9be76410bf
+  metadata.gz: 44f33adbf5ffc5496b64a1f441adc196278dbbad3a8aadc318ca19b676aa6858
+  data.tar.gz: 20b45d22c24da87f886cb8b09033b6148adc8fe3ea6004ce48423480cf64c965
 SHA512:
-  metadata.gz: 69c50939de4b66c4fa9795fda777e22a5952388d89187e8009e6dedda81346a07f81084d751c9cfd9f0185ef30800a107bd29e90596f24c79dc174afcf25b676
-  data.tar.gz: beed6c14fb9b09a9ca8e68dff160bbec457a6c18c85dd0021c236930b456b8e809ac40738f9f06bfe01400fc4c34d926d87e253e36ae3341c7bb7707544b1aff
+  metadata.gz: 2fcce9091f7e9ef49383278c230d8c61b7eb0248ba97c4fc002c8385494fe5fc803bcda137e8b1bc6732f320299a6309d8d9c1789ffa01b29d6944b451791411
+  data.tar.gz: 32f13b1fdcf0c182bd6151566bba566a0d6ebfec22220805e03deb6205b0cd7815dc7d274606c7213fa37e41b75573a2d0881f17605ab789aab0e41241518297

data/README.md

@@ -1,37 +1,50 @@
-
 This gem is under developement and nowhere near finished but feel free to play around with it.
 I am grateful for any ideas and suggestions
 
 # Magentwo
-Ruby-Wrapper for the Magento 2 REST API
 
+Ruby-Wrapper for the Magento 2 REST API
 
 # How to install
+
 To install the Gem directly use
+
 ```
 gem install magentwo
 ```
 
 or add the following line to your Gemfile
+
 ```
 gem 'magentwo'
 ```
+
 and call bundler
+
 ```
 bundle
 ```
 
-
 # How to connect to your magento 2 shop
+
 When only using one connection simply type
+
 ```
-  Magentwo.connect "http://example.com", "user_name", "password"  
+  Magentwo.connect "http://example.com", "user_name", "password"
 ```
+
+or
+
+```
+  Magentwo.connect_with_token "http://example.com", "my_secret_token"
+```
+
 When using multiple connections at once you can save the result of `Magentwo.connect` and use the `Magentwo.with` method
+
 ```
   connection1 = Magentwo.connect "http://example1.com", "user_name", "password"
-  connection2 = Magentwo.connect "http://example2.com", "user_name", "password"
-  
+  connection2 = Magentwo.connect_with_token "http://example2.com", "my_secret_token"
+
   Magentwo.with (connection1) do
     #do things in the context of connection1
   end
@@ -41,6 +54,7 @@ When using multiple connections at once you can save the result of `Magentwo.con
 ```
 
 # How to use
+
 In Magentwo you interact with the API using Models. These are named according the the REST-API specifications of Magento 2
 The basic functionality is the same for all Models. For products some simple requests would look like this
 
@@ -52,40 +66,49 @@ Magentwo::Product.fields #returns an array of productfields
 ```
 
 # Filtering
+
 You can filter requests to search for specific elements
 Here are some examples
 
 Look for all customers whose firstname is Foobar
+
 ```
 Magentwo::Customer.filter(:firstname => "Foobar").all
 ```
 
 Look for all customers whose id is not 42
+
 ```
 Magentwo::Customer.exclude(:id => 42).all
 ```
 
 You can also combine these
+
 ```
 Magentwo::Customer.filter(:firstname => "Foobar").exclude(:id => 42).all
 ```
+
 The `filter` and `exclude` methods can also be used to filter for a set. To Request all Customers whose firstname is either Foo or Bar you could write
+
 ```
 Magentwo::Customer.filter(:firstname => ["Foo", "bar"]).all
 ```
 
 Look for all Products whose name includes the word "Computer"
+
 ```
 Magentwo::Product.like(:name => "%Computer%").all
 ```
 
 Compare using `gt`, `gteq`, `lt` or `lteq`. These methods do not seem to work with dates, please use `from` and `to` when e.g. trying to fetch all Products that changed within a certain period.
+
 ```
 Magentwo::Product.lt(:price => 42).all
 Magentwo::Product.gt(:id => 1337).first
 ```
 
 Compare using `from` and `to`, you may also use both to specify a range.
+
 ```
 Magentwo::Product.from(:updated_at => Time.new(2019, 1, 1).all
 Magentwo::Product.to(:created_at => Time.new(2019, 2, 1).all
@@ -94,30 +117,38 @@ Magentwo::Product.to(:created_at => Time.new(2019, 2, 1).all
 All of these filter-functions can be chained as needed
 
 # Select
+
 If you know which fields you are interested in you can speed up the fetching process by only requesting these fields
+
 ```
 Magentwo::Product.filter(...).select(:id, :sku).all
 ```
 
 # Pagination
+
 On default the pagesize is set to 20, you can change this with
+
 ```
 Magentwo.default_page_size=42
 ```
 
 The pagesize can also be set on the fly
 To request page 2 with a pagesize of 100 simply write the following. The second paramter is optional
+
 ```
 Magentwo::Product.exclude(:name => "foobar").page(2, 100).all
 ```
 
 To iterate threw all the pages use `each_page`. Again the pagesize parameter is optional
+
 ```
 Magentwo::Product.each_page(512) do |page|
   p page
 end
 ```
+
 You may also want to fetch all pages of products that match a certain criteria
+
 ```
 Magentwo::Product.from(:updated_at => my_last_sync_value).each_page(512) do |page|
   p page
@@ -125,15 +156,19 @@ end
 ```
 
 # Order
+
 By default the results are ordered as Magento2 "thinks" its best. At any place you may add the `order_by` to sepcify this to your liking. If you skip the `ASC/DESC` argument, `ASC` will be set.
+
 ```
 Magentwo::Product.order_by(:id, "ASC").all
 Magentwo::Product.order_by(:id, "DESC").all
 ```
 
 # Updates
+
 To update Models back to Magento 2 use the `save` method
 This switches the first and last name of the Customer Foo Bar
+
 ```
 customer = Magentwo::Customer.filter(:first_name => "Foo", :last_name => "Bar").first
 customer.firstname = "Bar"
@@ -142,7 +177,9 @@ customer.save
 ```
 
 # Delete
+
 To delete a Model use the `delete` method
+
 ```
 product = Magentwo::Product.first
 product.delete

data/lib/connection.rb

@@ -2,15 +2,23 @@ module Magentwo
   class Connection
     attr_accessor :host, :port, :user, :password, :token, :base_path, :scheme
 
-    def initialize uri, user, password, base_path:nil
+    def initialize uri:, user:nil, password:nil, base_path:nil, token:nil
       uri = URI(uri)
       @host = uri.host
       @port = uri.port
-      @user = user
       @scheme = uri.scheme
-      @password = password
       @base_path = base_path || "/rest/V1"
-      request_token
+
+      if (user && password)
+        @user = user
+        @password = password
+        request_token
+      elsif (token)
+       @token = token
+      else
+        raise ArgumentError, "expected user/password or token"
+      end
+
     end
 
     def request_token

data/lib/magentwo.rb

@@ -11,7 +11,13 @@ module Magentwo
     raise ArgumentError, "no host specified" unless host
     raise ArgumentError, "no user_name specified" unless user_name
     raise ArgumentError, "no password specified" unless password
-    Base.adapter = Adapter.new host, user_name, password
+    Base.adapter = Adapter.new ({uri: host, user: user_name, password: password})
+  end
+
+  def self.connect_with_token host=nil, token=nil
+    raise ArgumentError, "no host specified" unless host
+    raise ArgumentError, "no token specified" unless token
+    Base.adapter = Adapter.new ({token: token, uri: host})
   end
 
   def self.with connection

data/magentwo.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name        = 'magentwo'
-  s.version     = '0.1.86'
+  s.version     = '0.1.90'
   s.date        = '2019-01-17'
   s.summary     = "Magento 2 API Wrapper"
   s.description = "Provides a simple Ruby Interface to interact with the Magento 2 API"

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: magentwo
 version: !ruby/object:Gem::Version
-  version: 0.1.86
+  version: 0.1.90
 platform: ruby
 authors:
 - André Mueß
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
 date: 2019-01-17 00:00:00.000000000 Z
@@ -46,7 +46,7 @@ licenses:
 - MIT
 metadata:
   source_code_uri: https://github.com/Arkad82x/magentwo
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -61,8 +61,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.2.15
+signing_key:
 specification_version: 4
 summary: Magento 2 API Wrapper
 test_files: []