blomming_api 0.5.1 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9ffd881cfdd0c8498bd0392a6b5c0e8922219f9c
-  data.tar.gz: 0036add36a945f228b8b0bc67eb6aab79af3ac44
+  metadata.gz: 6876fd023df19ccb0a6d8dde18e50b1dbe36bd30
+  data.tar.gz: 457d04eb4e71e806a98d2ea3e3cf39503c5c54ea
 SHA512:
-  metadata.gz: c206d43a3fb1dbdf5d47aa426e80c2b74179675cab503668fa02bfe48e40c169ee9fc7f7161136e125552bb02f0bdd819fa0a2681dc7549d1524d1a7085bcf79
-  data.tar.gz: f004dc99860ce60a36b2be52406ba8172e38695188a3d0727a61ed13257a034712c466c3d4967e725d939479a2b0004423d33908806704c80e2eb65d95bb5131
+  metadata.gz: 55b70b6d3118e54f1f615289ef0b268ee8d2312a232394e0ef03abf7e2d61bc7a58b8a5ea6718025aff0ffba007828bc1cc57a7d300769385c458ebfecb3bbbe
+  data.tar.gz: 0abc6e593f89c2752b0991fa0548e4cc1fa55f12c0550e60f918911d329133149786ed13d14bce63f26e3e76caff21e159b7304dd8637e04041fb3439b28cd26

data/lib/blomming_api/help.rb

@@ -5,9 +5,7 @@ module BlommingApi
   AUTHORS = ["Giorgio Robino"]
   EMAILS = ["giorgio.robino@gmail.com"]
   SUMMARY = %q{www.blomming.com social commerce API's wrapper}
-  DESCRIPTION = %q{www.blomming.com social commerce API's wrapper. \
- Supply a client access layer embedding authentication and communication details, \ 
- simple API endpoints.}
+  DESCRIPTION = SUMMARY
   HOMEPAGE = "https://github.com/solyaris/blomming_api"
 
   def BlommingApi::about

data/lib/blomming_api/private_helpers.rb

@@ -60,7 +60,7 @@ module BlommingApi
       rescue RestClient::Exception => e
 
         if http_status_code_401? e
-          authenticate_refresh e
+          re_authenticate e
           retry
 
         elsif http_status_code_4xx? e
@@ -79,8 +79,12 @@ module BlommingApi
         return unknown_error! e
 
       else
-        # HTTP status 200: return data (hash from JSON)!
-        MultiJson.load json_data
+        #
+        # HTTP status 200: 
+        # return 
+        #  nil if there are no data!
+        #  data as a Ruby hash (loaded from JSON)        
+        (json_data.empty? || json_data.nil?) ? nil : (MultiJson.load json_data)
       end
     end
 
@@ -108,14 +112,25 @@ module BlommingApi
     #
     # Errors managers
     #
-    def authenticate_refresh(e)
+    def re_authenticate(e)
       STDERR.puts "#{Time.now}: HTTP status code: #{e.response.code}: #{e.response.body}. Invalid or expired token. Retry in #@retry_seconds seconds."
 
       # sleep maybe useless here
       sleep @retry_seconds
 
-      # authenticate with refresh token
-      authenticate :refresh
+      #
+      # Normal/expected behaviour with http status code == 401 
+      # would be to authenticate with refresh token after the 401, so: 
+      #
+      # authenticate :refresh
+      #
+      # but in production sometime authentication with refresh token  
+      # after an initial 401 bring to dead-end (getting 401 permanently), 
+      #
+      # so the agreed solution with Blomming tech team
+      # have been to authenticate again from from scratch:
+      # 
+      authenticate :initialize
     end
 
     def server_error!(e)

data/lib/blomming_api/public_helpers.rb

@@ -1,4 +1,5 @@
 # encoding: utf-8
+require 'time'
 require 'multi_json'
 require 'rest_client'
 
@@ -101,6 +102,49 @@ module BlommingApi
       return nil if array.nil?
       return array.collect { |item| item[key_name] }
     end
+
+    #
+    # TIME CONVERSIONS
+    #
+
+    #
+    # Convert a timestamp in ISO 8601 format to Time
+    #
+    # example:
+    #
+    #   timestamp = '2014-01-14T15:17:42Z'
+    #   to_time timestamp => 2014-01-14 15:17:42 UTC
+    #
+    def self.to_time (iso8601_timestamp)
+      Time.iso8601(iso8601_timestamp)
+    end 
+
+    #
+    # Print timestamp from Time in UTC
+    # to local time in "European" timestamp format
+    #
+    # example:
+    #
+    #   time = 2014-01-14 15:17:42 UTC
+    #   to_eurolocal_timestamp time => => '14-01-2014 16:17:42'
+    #
+    def self.to_eurolocal_timestamp (time)
+      time.localtime if time.utc?   
+      time.strftime "%d-%m-%Y %H:%M:%S"
+    end 
+
+
+    #
+    # Convert a timestamp in ISO 8601 format to Time
+    #
+    # example:
+    #
+    #   timestamp = '2014-01-14T15:17:42Z'
+    #   to_eurolocal timestamp => '14-01-2014 16:17:42'
+    #
+    def self.to_eurolocal (iso8601_timestamp)
+      to_eurolocal_timestamp to_time iso8601_timestamp 
+    end 
     
   end
 end  	

data/lib/blomming_api/sell_endpoints.rb

@@ -244,9 +244,23 @@ module BlommingApi
     #
     # Create a new shop item
     #
-    def sell_shop_item_create (payload, params={})
+    # example:
+    #
+    # item = { "category_ids": [101], 
+    #          "source_shipping_profile_id": "", 
+    #          "price": 8.50, 
+    #          "title": "An Item", 
+    #          "quantity": 1, 
+    #          "description": "New description", 
+    #          "published": true, 
+    #          "original_price": 10.00 
+    #        }
+    #
+    # blomming.sell_shop_item_create item 
+    #
+    def sell_shop_item_create (item, params={})
       url = api_url "/sell/shop/items/new"
-      load = MultiJson.dump payload
+      load = MultiJson.dump item
       req = request_params(params)
 
       feed_or_retry do
@@ -269,9 +283,24 @@ module BlommingApi
     #
     # Update some of the properties of the Item
     #
-    def sell_shop_item_update (item_id, payload, params={})
+    # example:
+    #
+    # item = { "category_ids": [101], 
+    #          "source_shipping_profile_id": "", 
+    #          "price": 8.50, 
+    #          "title": "An Item", 
+    #          "quantity": 1, 
+    #          "description": "New description", 
+    #          "published": true, 
+    #          "original_price": 10.00 
+    #        }
+    #
+    # blomming.sell_shop_item_update 60034, item 
+    #    
+    #
+    def sell_shop_item_update (item_id, item, params={})
       url = api_url "/sell/shop/items/#{item_id}"
-      load = MultiJson.dump payload
+      load = MultiJson.dump item
       req = request_params(params)
 
       feed_or_retry do
@@ -319,6 +348,33 @@ module BlommingApi
       end  
     end    
 
+
+    #
+    # Add an Item (:item_id) to a section (:section_name)
+    #
+    def sell_shop_item_section_add(item_id, section_name, params={})
+      url = api_url "/sell/shop/items/#{item_id}/add_section"
+      req = request_params({currency: @currency, locale: @locale}.merge(params))
+      load = MultiJson.dump section: section_name
+
+      feed_or_retry do
+        RestClient.post url, load, req
+      end  
+    end 
+
+
+    #
+    # Remove an Item (:item_id) from a section (:section_id)
+    #
+    def sell_shop_item_section_remove(item_id, section_id, params={})
+      url = api_url "/sell/shop/items/#{item_id}/remove_section/#{section_id}"
+      req = request_params({currency: @currency, locale: @locale}.merge(params))
+      
+      feed_or_retry do
+        RestClient.delete url, req
+      end  
+    end 
+
     #
     # SELL
     # SHOP_SECTIONS

data/lib/blomming_api/version.rb

@@ -1,3 +1,3 @@
 module BlommingApi
-  VERSION = "0.5.1"
+  VERSION = "0.6.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: blomming_api
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.1
 platform: ruby
 authors:
 - Giorgio Robino
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-19 00:00:00.000000000 Z
+date: 2014-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: method_source
@@ -94,9 +94,7 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: "www.blomming.com social commerce API's wrapper. \\\n Supply a client
-  access layer embedding authentication and communication details, \\ \n simple API
-  endpoints."
+description: www.blomming.com social commerce API's wrapper
 email:
 - giorgio.robino@gmail.com
 executables: