BarcodeLookup 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8481d377973a102be2e771e6425d2975450dac116469b3a6621241dc4c4d40c
-  data.tar.gz: 6da728f522cb335aefa0ea78ed8c0bf79d031851ed5691e3fb968f518c17b4f8
+  metadata.gz: c2f38b0530ec5be37c36dfa7be524a647bbf9d9be259e4ce279fef52b902063d
+  data.tar.gz: 7dc47a5eff0f8c23a07fa16f50768009d84b7136369d3a904c5488be2dbc672a
 SHA512:
-  metadata.gz: ad5bec06eb812a3136d7b0137e008432cec94042db65e14265cdc120f599d2da95518469ad3ce24238f19c5eb0e7dccae91b84912f4d99af2ed305524a1b814b
-  data.tar.gz: ee06f478118660bece9f98eef1dee439e0a075af7725b9cffd8fbe3b06135c5d978233262ab8eb1d882978996deaf089e32f4bb65326bb684faadc77cca522c3
+  metadata.gz: 6a35999870ff5c6a51db3a3b6060d5c5c2c05b0840a7abd04f8c6882f78bf49b8e73c7f66b984e536f8e24abeac5d7c515b55eac93162b13ef2d34d5c1013ce4
+  data.tar.gz: 5e137be0519a9ceb2b29c8cc8f5030168678a0aa9e2d3201fb043246d6afb4fa4cee044798708c7ced44a09347645e7b618de1da7fc08023c1114bc19b0612aa

data/lib/barcode_lookup.rb

@@ -35,7 +35,7 @@ class BarcodeLookup
   def barcode_lookup(ean, preferred_lang = 1)
     json = api_call("op=barcode-lookup&ean=#{ean}&language=#{preferred_lang}")
     result = JSON.parse(json)
-    return nil if result.is_a?(Array) && result[0].key?('error')
+    return nil if no_result?(result)
 
     result[0]
   end
@@ -47,7 +47,7 @@ class BarcodeLookup
   def isbn_lookup(isbn)
     json = api_call("op=barcode-lookup&isbn=#{isbn}")
     result = JSON.parse(json)
-    return nil if result.is_a?(Array) && result[0].key?('error')
+    return nil if no_result?(result)
 
     result[0]
   end
@@ -61,10 +61,7 @@ class BarcodeLookup
   def product_search(name, preferred_lang = 1, page = 0)
     name = CGI.escape(name)
     json = api_call("op=product-search&name=#{name}&language=#{preferred_lang}&page=#{page}")
-    result = JSON.parse(json)
-    raise result[0]['error'] if result.is_a?(Array) && result[0].key?('error')
-
-    result['productlist']
+    product_list(JSON.parse(json))
   end
 
   # Search for a similar product by name
@@ -76,10 +73,7 @@ class BarcodeLookup
   def similar_product_search(name, preferred_lang = 1, page = 0)
     name = CGI.escape(name)
     json = api_call("op=similar-product-search&name=#{name}&language=#{preferred_lang}&page=#{page}")
-    result = JSON.parse(json)
-    raise result[0]['error'] if result.is_a?(Array) && result[0].key?('error')
-
-    result['productlist']
+    product_list(JSON.parse(json))
   end
 
   # Search for a product by category and name (exact match)
@@ -92,10 +86,7 @@ class BarcodeLookup
   def category_search(category, name, preferred_lang = 1, page = 0)
     name = CGI.escape(name)
     json = api_call("op=category-search&category=#{category}&name=#{name}&language=#{preferred_lang}&page=#{page}")
-    result = JSON.parse(json)
-    raise result[0]['error'] if result.is_a?(Array) && result[0].key?('error')
-
-    result['productlist']
+    product_list(JSON.parse(json))
   end
 
   # Search for all products that start with this barcode prefix
@@ -108,10 +99,7 @@ class BarcodeLookup
   def barcode_prefix_search(prefix, preferred_lang = 1, page = 0, only_preferred_language = true)
     only_preferred_language = (only_preferred_language ? 1 : 0)
     json = api_call("op=barcode-prefix-search&prefix=#{prefix}&language=#{preferred_lang}&only-preferred-language=#{only_preferred_language}&page=#{page}")
-    result = JSON.parse(json)
-    raise result[0]['error'] if result.is_a?(Array) && result[0].key?('error')
-
-    result['productlist']
+    product_list(JSON.parse(json))
   end
 
   # Lookup the issuing country for a single barcode (GTIN, EAN, UPC or ISBN-13)
@@ -122,7 +110,7 @@ class BarcodeLookup
   def issuing_country(ean)
     json = api_call("op=issuing-country&ean=#{ean}")
     result = JSON.parse(json)
-    return nil if result.is_a?(Array) && result[0].key?('error')
+    return nil if no_result?(result)
 
     result[0]['issuingCountry']
   end
@@ -136,11 +124,66 @@ class BarcodeLookup
   def barcode_image(ean, width = 102, height = 50)
     json = api_call("op=barcode-image&ean=#{ean}&width=#{width}&height=#{height}")
     result = JSON.parse(json)
-    return nil if result.is_a?(Array) && result[0].key?('error')
+    return nil if no_result?(result)
 
     result[0]['barcode']
   end
 
+  # Find the Amazon ASIN for a barcode (GTIN, EAN, UPC or ISBN-13)
+  # returns nil if no ASIN was found
+  #
+  # Arguments:
+  # barcode: (String)
+  def find_asin_for_ean(ean)
+    json = api_call("op=asin-for-ean-lookup&ean=#{ean}")
+    result = JSON.parse(json)
+    return nil if !result.is_a?(Array) || no_result?(result)
+
+    result[0]['asin']
+  end
+
+  # Find the barcode (EAN) for an Amazon ASIN
+  # returns nil if no barcode was found
+  #
+  # Arguments:
+  # asin: (String)
+  def find_ean_for_asin(asin)
+    asin = CGI.escape(asin)
+    json = api_call("op=ean-for-asin-lookup&asin=#{asin}")
+    result = JSON.parse(json)
+    return nil if !result.is_a?(Array) || no_result?(result)
+
+    result[0]['ean']
+  end
+
+  # Find the Library of Congress Control Number (LCCN) for a barcode (GTIN, EAN, UPC or ISBN-13)
+  # returns nil if no LCCN was found
+  #
+  # Arguments:
+  # barcode: (String)
+  def find_lccn_for_ean(ean)
+    json = api_call("op=lccn-for-ean-lookup&ean=#{ean}")
+    result = JSON.parse(json)
+    return nil if !result.is_a?(Array) || no_result?(result)
+
+    result[0]['lccn']
+  end
+
+  # Find the barcode (EAN) for a Library of Congress Control Number (LCCN)
+  # there can be multiple barcodes for one LCCN, this returns the first one found
+  # returns nil if no barcode was found
+  #
+  # Arguments:
+  # lccn: (String)
+  def find_ean_for_lccn(lccn)
+    lccn = CGI.escape(lccn)
+    json = api_call("op=ean-for-lccn-lookup&lccn=#{lccn}")
+    result = JSON.parse(json)
+    return nil if !result.is_a?(Array) || no_result?(result)
+
+    result[0]['ean']
+  end
+
   # Set the HTTP timeout for API calls in seconds
   #
   # Arguments:
@@ -157,6 +200,19 @@ class BarcodeLookup
 
   protected
 
+  # true if the API returned an empty list or an error message instead of a result
+  def no_result?(result)
+    result.is_a?(Array) && (result.empty? || result[0].key?('error'))
+  end
+
+  # the product list of a search result, raises the error message if the API returned one
+  def product_list(result)
+    return [] if result.is_a?(Array) && result.empty?
+    raise result[0]['error'] if result.is_a?(Array) && result[0].key?('error')
+
+    result['productlist']
+  end
+
   def api_call(params, tries = 1)
     @uri = URI("#{@base_url}#{@token}&#{params}")
     response = Net::HTTP.start(@uri.host, @uri.port, use_ssl: true, read_timeout: @timeout) do |http|
@@ -167,7 +223,8 @@ class BarcodeLookup
       sleep 1
       return api_call(params, tries + 1)
     end
-    @remain = response['X-Credits-Remaining'] if response.key?('X-Credits-Remaining')
+    credits = response['X-Credits-Remaining'].to_s.strip
+    @remain = credits.to_i if credits.match?(/\A\d+\z/)
     response.body
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: BarcodeLookup
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - Relaxed Communications GmbH
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-08 00:00:00.000000000 Z
+date: 2026-09-20 00:00:00.000000000 Z
 dependencies: []
 description: A Ruby Gem for GTIN, UPC, EAN and ISBN barcode lookup and validation
   using the API on ean-search.org