carriage 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f5731948e95e6eabc30c63bdc9d9ab781b9f2a259ed1f31c7b24fd9182ea144
-  data.tar.gz: 4bc1df903a37ed1a5cb6e1302677cf5c1a2cfbe6054e9cbb255ca514c806070c
+  metadata.gz: 6e81427fae2e36e6ee765fc14b94efb8a78efee6feacbe24e47b35e25f54a6ad
+  data.tar.gz: 0ae15d63cff13b5d0c8a44a64f7262ccbb0ef98fd5f702e5845c79c81570ca1a
 SHA512:
-  metadata.gz: c1a761f0808373a2756dc6907e58b7f81a5044a6f1d126a9d0e7433d7767de2879bbde27140f7b46f81e6a8b871cc8f029c31c07f35141593de9aabc70cde35b
-  data.tar.gz: c9f22786974d6eddbd5dc12c03be524b68ddaa20f7c635c0b71718c929e583487bf016da17cb3835d7f537f0f726be2cde889c64799da0e4083608e4407cdf18
+  metadata.gz: dc0891d5d827726e047b89f1689530e8908517d1403b50422f0f1e3bef987b8031fe0bb1d0de4c30f1b14ec0c6cdc68df13eea719eaf99bc9c38000590f517ca
+  data.tar.gz: 3d16f7d941e8c7d16d6f5216f7a7eb26fec47708dfa2b2885f991997c1c3e5d673a2f7df06c1ab9247c9d37fb4320935a6e184c497102b031595df787d10fafb

data/.gitignore

@@ -9,3 +9,4 @@
 
 .idea/
 .rakeTasks
+Gemfile.lock

data/.travis.yml

@@ -4,3 +4,6 @@ cache: bundler
 rvm:
   - 2.7.0
 before_install: gem install bundler -v 2.1.2
+script:
+  - "bundle install"
+  - "bundle exec rake test"

data/CHANGELOG.md

@@ -2,5 +2,16 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [Unreleased]
+
+## [0.2.0]
+### Added
+- Set default quantity for a product
+- Write down regions and respective hosts associated with them
+
+### Changed
+- Using `URI.encode_www_form` to build URL parameters
+- `AWSAccessKeyId` is not a required argument
+
 ## [0.1.0]
 First public version, only focused on supporting one region - US.

data/README.md

@@ -1,9 +1,13 @@
-# Carriage
+[![Gem Version](https://badge.fury.io/rb/carriage.svg)](https://badge.fury.io/rb/carriage)
+[![Maintainability](https://api.codeclimate.com/v1/badges/79ddcbeb02fe9447cd0d/maintainability)](https://codeclimate.com/github/skatkov/carriage/maintainability)
+[![Build Status](https://travis-ci.org/skatkov/carriage.svg?branch=master)](https://travis-ci.org/skatkov/carriage)
 
+# Carriage
 Carriage is a Ruby wrapper to [Amazon Product Advertising API 5.0 - Cart Form](https://webservices.amazon.com/paapi5/documentation/add-to-cart-form.html). This gem helps add any number of items to a customer's shopping cart and sending him to Amazon website to complete his order. 
 
 To use this gem, you need to have Amazon **AssociateTag**, so don't forget to [register first](https://webservices.amazon.com/paapi5/documentation/register-for-pa-api.html) with Amazon Associate program.
 
+Programmatic access to product data is out of scope for this gem, but I recommend to use [vacuum gem](https://github.com/hakanensari/vacuum) if there is such a need.
 
 ## Installation
 
@@ -25,15 +29,10 @@ Or install it yourself as:
 
 TODO: Write usage instructions here
 
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-## Contributing
+## Getting help
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/carriage. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/carriage/blob/master/CODE_OF_CONDUCT.md).
+* Ask specific questions about the API on the [Amazon forum](https://forums.aws.amazon.com/forum.jspa?forumID=9).
+* Report bugs and discuss potential features in [GitHub issues](https://github.com/skatkov/carriage/issues).
 
 
 ## License
@@ -42,4 +41,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Carriage project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/carriage/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Carriage project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/skatkov/carriage/blob/master/CODE_OF_CONDUCT.md).

data/carriage.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
   spec.homepage      = "https://www.github.com/skatkov/carriage"
   spec.license       = "MIT"
   spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
-  
+
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://www.github.com/skatkov/carriage"
   spec.metadata["changelog_uri"] = "https://github.com/skatkov/carriage/blob/master/CHANGELOG.md"

data/lib/carriage.rb

@@ -1,26 +1,44 @@
-require "carriage/version"
+require 'carriage/version'
+require 'uri'
 
 module Carriage
-  class Error < StandardError; end
+  HOSTS_AND_REGIONS = {
+      au: 'https://www.amazon.com.au/gp/aws/cart/add.html',
+      br: 'https://www.amazon.com.br/gp/aws/cart/add.html',
+      ca: 'https://www.amazon.ca/gp/aws/cart/add.html',
+      fr: 'https://www.amazon.fr/gp/aws/cart/add.html',
+      de: 'https://www.amazon.de/gp/aws/cart/add.html',
+      in: 'https://www.amazon.in/gp/aws/cart/add.html',
+      it: 'https://www.amazon.it/gp/aws/cart/add.html',
+      jp: 'https://www.amazon.co.jp/gp/aws/cart/add.html',
+      mx: 'https://www.amazon.com.mx/gp/aws/cart/add.html',
+      sg: 'https://www.amazon.sg/gp/aws/cart/add.html',
+      es: 'https://www.amazon.es/gp/aws/cart/add.html',
+      tr: 'https://www.amazon.com.tr/gp/aws/cart/add.html',
+      ae: 'https://www.amazon.ae/gp/aws/cart/add.html',
+      uk: 'https://www.amazon.co.uk/gp/aws/cart/add.html',
+      us: 'https://www.amazon.com/gp/aws/cart/add.html'
+  }.freeze
 
-  BASE_URL = "https://www.amazon.com/gp/aws/cart/add.html?".freeze
+  def self.call(region, params)
+    "#{HOSTS_AND_REGIONS[:us]}?#{URI.encode_www_form params}"
+  end
 
-  def self.build(items, tag, key_id)
+  def self.build(items, tag, key_id=nil)
     return nil if items.nil? || items.empty?
 
-    params = ""
+    params = {}
     index = 0
 
     while index < items.size
-      params << '&' if index > 0
-      params << "ASIN.#{index+1}=#{items[index][:asin]}&Quantity.#{index+1}=#{items[index][:quantity]}"
+      params[:"ASIN.#{index + 1}"] = items[index][:asin]
+      params[:"Quantity.#{index + 1}"] = items[index].fetch(:quantity, 1)
       index += 1
     end
 
-    if key_id.nil? || key_id.empty?
-      "#{BASE_URL}#{params}&AssociateTag=#{tag}"
-    else
-      "#{BASE_URL}#{params}&AssociateTag=#{tag}&AWSAccessKeyId=#{key_id}"
-    end
+    params[:AssociateTag] = tag
+    params[:AWSAccessKeyId] = key_id unless (key_id.nil? || key_id.empty?)
+
+    call(:us, params)
   end
 end

data/lib/carriage/version.rb

@@ -1,3 +1,3 @@
 module Carriage
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: carriage
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Stanislav (Stas) Katkov
@@ -23,7 +23,6 @@ files:
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile

data/Gemfile.lock

@@ -1,21 +0,0 @@
-PATH
-  remote: .
-  specs:
-    carriage (0.1.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    minitest (5.13.0)
-    rake (12.3.2)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  carriage!
-  minitest (~> 5.0)
-  rake (~> 12.0)
-
-BUNDLED WITH
-   1.17.3