reactive_shipping 3.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c43d1a97e5cb9e2e72ade72b5d17e95c89668aa2
+  data.tar.gz: 87e454f7865af135094523003ef4e3b5b3f87d57
+SHA512:
+  metadata.gz: 26e31650d140395aacfa6449f0b37f740361dff22ec8624ba012ac159589794505f84fdb23a4d00bdd67df60970d2e9b74de36e453a4530f2938c21cbd5a574f
+  data.tar.gz: 2f03e4f98d09d7dc7b5d9a2bf14ccb4bcb8afb2533cffb2f437ef15c70c32048b387d8ccd113bf69cfbc05f78dc816206fc19002e5f4daf893da8a7823d8da8c

data/.gitignore

@@ -0,0 +1,15 @@
+.DS_Store
+test.xml
+sample.rb
+*.orig
+pkg
+.dotest
+Gemfile*.lock
+.rvmrc
+test/fixtures/live_credentials.yml
+.rbenv-version
+.yardoc/
+doc/
+.idea
+.bundle
+.byebug_history

data/.travis.yml

@@ -0,0 +1,33 @@
+# travis.yml
+
+language: ruby
+script: bundle exec rake test
+sudo: false
+
+rvm:
+- "2.2.2"
+- "2.3.1"
+- "2.4.1"
+
+gemfile:
+- gemfiles/activesupport42.gemfile
+- gemfiles/activesupport50.gemfile
+- gemfiles/activesupport51.gemfile
+- gemfiles/activesupport52.gemfile
+
+matrix:
+  include:
+    - rvm: "2.4.1"
+      gemfile: gemfiles/activesupport_master.gemfile
+  exclude:
+    - rvm: "2.4.1"
+      gemfile: gemfiles/activesupport42.gemfile
+
+env:
+  global:
+  - ACTIVESHIPPING_NEW_ZEALAND_POST_KEY=4d9dc0f0-dda0-012e-066f-000c29b44ac0
+  - ACTIVESHIPPING_CANADA_POST_LOGIN=CPC_DEMO_XML
+  - ACTIVESHIPPING_CANADA_POST_PWS_CUSTOMER_NUMBER=2004381
+  - ACTIVESHIPPING_CANADA_POST_PWS_API_KEY=6e93d53968881714
+  - ACTIVESHIPPING_CANADA_POST_PWS_SECRET=0bfa9fcb9853d1f51ee57a
+  - ACTIVESHIPPING_USPS_LOGIN=677JADED7283

data/.yardopts

@@ -0,0 +1,13 @@
+--readme README.md
+--title 'ActiveShipping API documentation'
+--charset utf-8
+--hide-void-return
+--protected
+--no-private
+--markup markdown
+--markup-provider redcarpet
+-
+README.md
+CHANGELOG.md
+CONTRIBUTING.md
+MIT-LICENSE

data/CHANGELOG.md

@@ -0,0 +1,225 @@
+# ReactiveShipping CHANGELOG
+
+### v3.0.0
+
+- Change ActiveShipping name to ReactiveShipping
+- Return UPS support
+
+## (Previous) ActiveShipping
+
+### v2.2.0
+- Remove UPS integration from ActiveShipping repository as requested by UPS. For information about the UPS APIs see https://www.ups.com/upsdeveloperkit
+
+### v2.1.1
+- Update README to clarify Shopify's involvement moving forward with v2.x
+
+### v2.1.0
+- Add email field to Location
+
+### v2.0.0
+- Drop support for < ruby 2.2, support ruby 2.4
+- Drop support for < Rails 4.2.
+- BREAKING CHANGE: Use shopify/measured instead of shopify/quantified for dimensions and units.
+
+### v1.14.2
+- Make saturday delivery an option for fedex
+
+### v1.14.1
+- Fix parsing of CanadaPostPWS service options response.
+
+### v1.14.0
+- Update Correios default services list.
+- Fix CanadaPostPWS from generating an empty options tag.
+- Allow contract-number on CanadaPost merchant detail's response to be nil.
+- Fix a flakey UPS remote test that would fail only on Fridays.
+
+### v1.13.4
+- Upcase postal code for CanadaPostPWS
+- Fix failing USPS test
+- add .byebug_history to .gitignore
+
+### v1.13.3
+- CanadaPostPWS no longer modifies locations passed to it
+
+### v1.13.2
+- Bump active_utils to 3.3.1
+- Allow activesupport <5.2.0
+
+### v1.13.1
+- Fix up UPS tracker parsing for Kosovo (KV)
+
+### v1.13.0
+- Add default location for CanadaPost PWS
+- Patch UPS to use old Kosovo country code
+- Add option to not include tax in rates for CP PWS
+
+### v1.12.1
+- Explicitly set ssl_version for USPS
+- Strip 9 digit origin zip code for USPS world rate requests
+
+### v1.12.0
+- Update active_utils dependency to v3.3.0
+
+### v1.8.6
+- Fix UPS TrackResponse with no status code
+- Stop FedEx from raising for successful responses with no statuses
+- Raise appropriate exception response for FedEx errors
+
+### v1.8.5
+- Fix UPS TrackResponse parsing for missing elements
+
+### v1.8.4
+- Add price details to rate estimates
+- Fix encoding for UPS responses
+
+### v1.8.3
+- Add description field to rate estimates
+
+### v1.8.2
+- Add option for FedEx label format
+- Fix kunaki remote tests broken due to more shipping options
+
+### v1.6.1
+- Fix FedEx ShipmentEvents to include event type
+- Skip broken Canada Post remote tests
+
+### v1.6.0
+- Update active_utils dependency to v3.2.0
+
+### v1.5.0
+- Fix Kunaki remote test
+- Fix credentials for Canada Post PWS remote tests
+- Add compare price to rate estimate options
+- Add phone required to rate estimate options
+- Update active_utils dependency to v3.1.0
+
+### v1.4.3
+
+- Fix UPS SurePost for < 1 pound packages
+- Use status type code in UPS tracking
+- Fix USPS and Fedex remote tests
+
+### v1.4.2
+
+- Fix USPS rates for commercial shipments
+
+### v1.4.1
+
+- Raise error on invalid status code with FedEx
+- Fix USPS tracking to certain countries
+- Fix USPS tracking of events with no time
+- Fix USPS batch tracking error messages.
+- Fix FedEx logging exception
+
+### v1.4.0
+
+- Added support for USPS merchant returns service
+- Added support for UPS SurePost
+- Added support for UPS third party billing
+- Fix FedEx tracking response errors
+- Add rake console command for development
+
+### v1.3.0
+
+- Support voiding labels on UPS
+- Parse FedEx ground delivery dates
+- Add maximum address length field
+- Fix UPS unknown country code when using SUREPOST
+
+### v1.2.2
+
+- Fix "RECTANGULAR" errors with small USPS US->US package rate requests
+- Fix error tracking USPS packages to other countries
+- Fix USPS rate requests to destinations with only a country.
+
+### v1.2.1
+
+- Fix compatibility with latest USPS WEBTOOLS international rate schema changes.
+
+### v1.2.0
+
+- Added support for buying labels with FedEx
+- Added support for batched tracking requests with USPS
+
+### v1.1.3
+
+- Handle ZIP+4 numbers in USPS tracking
+- Add a field for rate estimate references
+- Add support for UPS mail innovations tracking option
+
+### v1.1.2
+
+- Fix finding of error descriptions for USPS tracking
+
+### v1.1.1
+
+- Fix bug with USPS tracking not handling optional fields being absent.
+
+### v1.1.0
+
+- USPS: Allows package tracking disambiguation and exposes predicted arrival date and event codes.
+
+### v1.0.0
+
+- **BREAKING CHANGE:** Change namespace from `ActiveMerchant::Shipping` to `ActiveShipping`
+- Drop support for Ruby 1.8 and Ruby 1.9.
+- Drop support for ActiveSupport < 3.2, support up to ActiveSupport 4.2.
+- Updated Fedex to use latest API version for tracking
+- Various improvements to UPS carrier implementation.
+- Small bugfixes in USPS carrier implementation.
+- Various small bugfixes in XML handling for several carriers.
+- Rewite all carriers to use nokogiri for XML parsing and generating.
+- Bump `active_utils` dependency to require 3.x to avoid conflicts with `ActiveMerchant`.
+- Extracted `quantified` into separate gem.
+- Removed vendored `XmlNode` library.
+- Removed `builder` dependency.
+- Improved test setup that allows running functional tests on CI.
+- Improved documentation of the abstraction API.
+
+### v0.10.1
+
+ - Canada Post PWS: Makes wrapper act more consistently with the rest of the API [jnormore]
+ - UPS: Adds insurance charge to package object declarations [pbonnell]
+ - USPS: Improves how unavailable delivery information is handled [cyu]
+ - Shipment Packer: Prevents packing errors and consistently return an array when packing [christianblais]
+ - General: Improves tests such that they work with ruby 2.0 [Sirupsen]
+
+### 2011/04/21
+
+* USPS updated to use new APIs [james]
+* new :gift boolean option for Package [james]
+* Location's :address_type can be "po_box" [james]
+
+### Earlier
+
+* New Zealand Post [AbleTech]
+* Include address name for rate requests to Shipwire if provided [dennis]
+* Add support for address name to Location [dennis]
+* Add fix for updated USPS API to strip any encoded html and trailing asterisks from rate names [dennis]
+* Add carrier CanadaPost [william]
+* Update FedEx rates and added ability to auto-generate rate name from code that gets returned by FedEx [dennis]
+* Assume test_helper is in load path when running tests [cody]
+* Add support Kunaki rating service [cody]
+* Require active_support instead of activesupport to avoid deprecation warning in Rails 2.3.5 [cody]
+* Remove ftools for Rails 1.9 compatibility and remove xml logging, as logging is now included in the connection [cody]
+* Update connection code from ActiveMerchant [cody]
+* Fix space-ridden USPS usernames when validating credentials [james]
+* Remove extra slash from USPS URLs [james]
+* Update Shipwire endpoint hostname [cody]
+* Add missing ISO countries [Edward Ocampo-Gooding]
+* Add support for Guernsey to country.rb [cody]
+* Use :words_connector instead of connector in RequiresParameters [cody]
+* Add name to Shipwire class [cody]
+* Improve FedEx handling of some error conditions [cody]
+* Add support for validating credentials to Shipwire [cody]
+* Add support for ssl_get to PostsData. Update Carriers to use PostsData module. Turn on retry safety for carriers [cody]
+* Add support for Shipwire Shipping Rate API [cody]
+* Cleanup package tests [cody]
+* Remove unused Carrier#setup method [cody]
+* Don't use Array splat in Regex comparisons in Package [cody]
+* Default the Location to use the :alpha2 country code format [cody]
+* Add configurable timeouts from Active Merchant [cody]
+* Update xml_node.rb from XML Node [cody]
+* Update requires_parameters from ActiveMerchant [cody]
+* Sync posts_data.rb with ActiveMerchant [cody]
+* Don't use credentials fixtures in local tests [cody]

data/CONTRIBUTING.md

@@ -0,0 +1,23 @@
+# Contributing to ReactiveShipping
+
+We love receiving pull requests! Anything from new carriers to documentation fixes.
+
+Also, we are looking for maintainers for the current version of ReactiveShipping 2.0.
+
+## Standards
+
+* PR should explain what the feature does, and why the change exists.
+* PR should include any carrier specific documentation explaining how it works.
+* Code _must_ be tested, including both unit and remote tests where applicable.
+* Be consistent. Write clean code that follows [Ruby community standards](https://github.com/bbatsov/ruby-style-guide).
+* Code should be generic and reusable.
+
+If you're stuck, ask questions!
+
+## How to contribute
+
+1. Fork it ( https://github.com/realsubpop/reactive_shipping/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright for portions of project ReactiveShipping are held by Shopify 2016 as part of project ActiveShipping.
+All other copyright for project ReactiveShipping are held by Sub Pop Records, 2018.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,158 @@
+# ReactiveShipping [![Build status](https://travis-ci.org/realsubpop/reactive_shipping.svg?branch=master)](https://travis-ci.org/realsubpop/reactive_shipping)
+
+This library interfaces with the web services of various shipping carriers. The goal is to abstract the features that are most frequently used into a pleasant and consistent Ruby API:
+
+- Finding shipping rates
+- Registering shipments
+- Tracking shipments
+- Purchasing shipping labels
+
+## Supported Shipping Carriers
+
+
+* [UPS](http://www.ups.com)
+* [USPS](http://www.usps.com)
+* [USPS Returns](http://returns.usps.com)
+* [FedEx](http://www.fedex.com)
+* [Canada Post](http://www.canadapost.ca)
+* [New Zealand Post](http://www.nzpost.co.nz)
+* [Shipwire](http://www.shipwire.com)
+* [Stamps](http://www.stamps.com)
+* [Kunaki](http://www.kunaki.com)
+* [Australia Post](http://auspost.com.au/)
+
+## Installation
+
+Using bundler, add to the `Gemfile`:
+
+```ruby
+gem 'reactive_shipping'
+```
+
+Or stand alone:
+
+```
+$ gem install reactive_shipping
+```
+
+
+## Sample Usage
+
+### Compare rates from different carriers
+
+```ruby
+require 'reactive_shipping'
+
+# Package up a poster and a Wii for your nephew.
+packages = [
+  ReactiveShipping::Package.new(100,               # 100 grams
+                              [93,10],           # 93 cm long, 10 cm diameter
+                              cylinder: true),   # cylinders have different volume calculations
+
+  ReactiveShipping::Package.new(7.5 * 16,          # 7.5 lbs, times 16 oz/lb.
+                              [15, 10, 4.5],     # 15x10x4.5 inches
+                              units: :imperial)  # not grams, not centimetres
+ ]
+
+ # You live in Beverly Hills, he lives in Ottawa
+ origin = ReactiveShipping::Location.new(country: 'US',
+                                       state: 'CA',
+                                       city: 'Beverly Hills',
+                                       zip: '90210')
+
+ destination = ReactiveShipping::Location.new(country: 'CA',
+                                            province: 'ON',
+                                            city: 'Ottawa',
+                                            postal_code: 'K1P 1J1')
+
+ # Find out how much it'll be.
+ usps = ReactiveShipping::USPS.new(login: 'developer-key')
+ response = usps.find_rates(origin, destination, packages)
+
+ usps_rates = response.rates.sort_by(&:price).collect {|rate| [rate.service_name, rate.price]}
+ # => [["USPS Priority Mail International", 4110],
+ #     ["USPS Express Mail International (EMS)", 5750],
+ #     ["USPS Global Express Guaranteed Non-Document Non-Rectangular", 9400],
+ #     ["USPS GXG Envelopes", 9400],
+ #     ["USPS Global Express Guaranteed Non-Document Rectangular", 9400],
+ #     ["USPS Global Express Guaranteed", 9400]]
+```
+
+Dimensions for packages are in `Height x Width x Length` order.
+
+### Track a FedEx package
+
+```ruby
+fedex = ReactiveShipping::FedEx.new(login: '999999999', password: '7777777', key: '1BXXXXXXXXXxrcB', account: '51XXXXX20')
+tracking_info = fedex.find_tracking_info('tracking-number', carrier_code: 'fedex_ground') # Ground package
+
+tracking_info.shipment_events.each do |event|
+  puts "#{event.name} at #{event.location.city}, #{event.location.state} on #{event.time}. #{event.message}"
+end
+# => Package information transmitted to FedEx at NASHVILLE LOCAL, TN on Thu Oct 23 00:00:00 UTC 2008.
+# Picked up by FedEx at NASHVILLE LOCAL, TN on Thu Oct 23 17:30:00 UTC 2008.
+# Scanned at FedEx sort facility at NASHVILLE, TN on Thu Oct 23 18:50:00 UTC 2008.
+# Departed FedEx sort facility at NASHVILLE, TN on Thu Oct 23 22:33:00 UTC 2008.
+# Arrived at FedEx sort facility at KNOXVILLE, TN on Fri Oct 24 02:45:00 UTC 2008.
+# Scanned at FedEx sort facility at KNOXVILLE, TN on Fri Oct 24 05:56:00 UTC 2008.
+# Delivered at Knoxville, TN on Fri Oct 24 16:45:00 UTC 2008. Signed for by: T.BAKER
+```
+
+## Carrier specific notes
+
+### FedEx connection
+
+The `:login` key passed to `ReactiveShipping::FedEx.new()` is really the FedEx meter number, not the FedEx login.
+
+When developing with test credentials, be sure to pass `test: true` to `ReactiveShipping::FedEx.new()`.
+
+
+## Tests
+
+You can run the unit tests with:
+
+```
+bundle exec rake test:unit
+```
+
+and the remote tests with:
+
+```
+bundle exec rake test:remote
+```
+
+The unit tests mock out requests and responses so that everything runs locally, while the remote tests actually hit the carrier servers. For the remote tests, you'll need valid test credentials for any carriers' tests you want to run. The credentials should go in [`~/.reactive_shipping/credentials.yml`](https://github.com/realsubpop/reactive_shipping/blob/master/test/credentials.yml). For some carriers, we have public credentials you can use for testing in `.travis.yml`. Remote tests missing credentials will be skipped.
+
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/realsubpop/reactive_shipping/blob/master/CONTRIBUTING.md).
+
+We love getting pull requests! Anything from new features to documentation clean up.
+
+If you're building a new carrier, a good place to start is in the [`Carrier` base class](https://github.com/realsubpop/reactive_shipping/blob/master/lib/reactive_shipping/carrier.rb).
+
+It would also be good to familiarize yourself with [`Location`](https://github.com/realsubpop/reactive_shipping/blob/master/lib/reactive_shipping/location.rb), [`Package`](https://github.com/realsubpop/reactive_shipping/blob/master/lib/reactive_shipping/package.rb), and [`Response`](https://github.com/realsubpop/reactive_shipping/blob/master/lib/reactive_shipping/response.rb).
+
+You can use the [`test/console.rb`](https://github.com/realsubpop/reactive_shipping/blob/master/test/console.rb) to do some local testing against real endpoints.
+
+To log requests and responses, just set the `logger` on your Carrier class to some kind of `Logger` object:
+
+```ruby
+ReactiveShipping::USPS.logger = Logger.new(STDOUT)
+```
+
+### Anatomy of a pull request
+
+Any new features or carriers should have passing unit _and_ remote tests. Look at some existing carriers as examples.
+
+When opening a pull request, include description of the feature, why it exists, and any supporting documentation to explain interaction with carriers.
+
+
+### How to contribute
+
+1. Fork it ( https://github.com/realsubpop/reactive_shipping/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request