solidus_easypost 1.0.3 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: a26dc932c698059bd4388ff49714aa3c73237428
-  data.tar.gz: d04a475b17469a183cd4bea7cff09d24f63b3d65
+SHA256:
+  metadata.gz: 0d54d7ac2a6876f5b69df700919019c7ef094bb58e146139ff8ec93a9da754a0
+  data.tar.gz: 4e75d5636a2fb85d1277dd4fe6ffc2e2a61c616ed0688ba247dc72c218dabf8a
 SHA512:
-  metadata.gz: 68b7eb575bdffce10647d57a95af4eda916598e02c60cd5d60fd741dcb3d85e3e7d88aa10d3cd75eba8405753a194ff2a051fdcd8455ae4c171e42abf91592d8
-  data.tar.gz: 62238a7110f277acd9df7672f7f208360e3d1ed9e53d2c572e9471f34c5734f58d9fb81e669610f2c58b7255834c34e3ea16f07bcfc65a7cc5e80d06e9b9c493
+  metadata.gz: 62e2e3f86ccbab5feab3550b7e32c3e168169b11790663a629dc56a34ede6b2bd6cbe63c4e5459b3af62c084f9686f58c02e05faac10c418836bfe2e00433dc8
+  data.tar.gz: adf8d14742ea4da96c3b4950b9db43b46b61fd279528a8f5610a2061ff7a03aa6a8ca610775862004784cef06af1e0a49c2e667d0c47b188a487ed76c5b3f912

data/.circleci/config.yml

@@ -0,0 +1,41 @@
+version: 2.1
+
+orbs:
+  # Always take the latest version of the orb, this allows us to
+  # run specs against Solidus supported versions only without the need
+  # to change this configuration every time a Solidus version is released
+  # or goes EOL.
+  solidusio_extensions: solidusio/extensions@volatile
+
+jobs:
+  run-specs-with-postgres:
+    executor: solidusio_extensions/postgres
+    steps:
+      - solidusio_extensions/run-tests
+  run-specs-with-mysql:
+    executor: solidusio_extensions/mysql
+    steps:
+      - solidusio_extensions/run-tests
+  lint-code:
+    executor: solidusio_extensions/sqlite-memory
+    steps:
+      - solidusio_extensions/lint-code
+
+workflows:
+  "Run specs on supported Solidus versions":
+    jobs:
+      - run-specs-with-postgres
+      - run-specs-with-mysql
+      - lint-code
+
+  "Weekly run specs against master":
+    triggers:
+      - schedule:
+          cron: "0 0 * * 4" # every Thursday
+          filters:
+            branches:
+              only:
+                - master
+    jobs:
+      - run-specs-with-postgres
+      - run-specs-with-mysql

data/.gem_release.yml

@@ -0,0 +1,5 @@
+bump:
+  recurse: false
+  file: 'lib/solidus_easypost/version.rb'
+  message: Bump SolidusEasypost to %{version}
+  tag: true

data/.github/stale.yml

@@ -0,0 +1,17 @@
+# Number of days of inactivity before an issue becomes stale
+daysUntilStale: 60
+# Number of days of inactivity before a stale issue is closed
+daysUntilClose: false
+# Issues with these labels will never be considered stale
+exemptLabels:
+  - pinned
+  - security
+# Label to use when marking an issue as stale
+staleLabel: stale
+# Comment to post when marking an issue as stale. Set to `false` to disable
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. It might be closed if no further activity occurs. Thank you
+  for your contributions.
+# Comment to post when closing a stale issue. Set to `false` to disable
+closeComment: false

data/.github_changelog_generator

@@ -0,0 +1,2 @@
+issues=false
+exclude-labels=infrastructure

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+\#*
+*~
+.#*
+.DS_Store
+.idea
+.project
+.sass-cache
+coverage
+Gemfile.lock
+tmp
+nbproject
+pkg
+*.swp
+spec/dummy
+spec/examples.txt
+/sandbox
+.rvmrc
+.ruby-version
+.ruby-gemset
+.bundle

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,7 @@
+inherit_from: .rubocop_todo.yml
+
+require:
+  - solidus_dev_support/rubocop
+
+AllCops:
+  NewCops: enable

data/.rubocop_todo.yml

@@ -0,0 +1,36 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2020-09-23 14:11:08 UTC using RuboCop version 0.91.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+RSpec/DescribeClass:
+  Exclude:
+    - 'spec/features/**/*'
+    - 'spec/integration/order_shipping_spec.rb'
+
+# Offense count: 3
+RSpec/MultipleExpectations:
+  Max: 3
+
+# Offense count: 4
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: scientific, engineering, integral
+Style/ExponentialNotation:
+  Exclude:
+    - 'spec/integration/checkout_spec.rb'
+
+# Offense count: 1
+Style/OptionalBooleanParameter:
+  Exclude:
+    - 'lib/solidus_easypost/estimator.rb'
+
+# Offense count: 3
+# Cop supports --auto-correct.
+# Configuration parameters: AutoCorrect, AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 137

data/CHANGELOG.md

@@ -0,0 +1,113 @@
+# Changelog
+
+## [v3.0.0](https://github.com/solidusio-contrib/solidus_easypost/tree/v3.0.0) (2022-01-05)
+
+[Full Changelog](https://github.com/solidusio-contrib/solidus_easypost/compare/v2.0.0...v3.0.0)
+
+**Closed issues:**
+
+- Dependabot can't resolve your Ruby dependency files [\#92](https://github.com/solidusio-contrib/solidus_easypost/issues/92)
+- Prepare Solidus Easypost for Solidus 3.0 [\#88](https://github.com/solidusio-contrib/solidus_easypost/issues/88)
+- Dependabot can't resolve your Ruby dependency files [\#77](https://github.com/solidusio-contrib/solidus_easypost/issues/77)
+- Dependabot can't resolve your Ruby dependency files [\#76](https://github.com/solidusio-contrib/solidus_easypost/issues/76)
+- README is incompatible with latest rubygems release [\#73](https://github.com/solidusio-contrib/solidus_easypost/issues/73)
+- Unable to Handle Refunds Out of the Box [\#58](https://github.com/solidusio-contrib/solidus_easypost/issues/58)
+
+**Merged pull requests:**
+
+- fix new cops [\#102](https://github.com/solidusio-contrib/solidus_easypost/pull/102) ([ccarruitero](https://github.com/ccarruitero))
+- fix webhooks handler setup and allow customize [\#100](https://github.com/solidusio-contrib/solidus_easypost/pull/100) ([ccarruitero](https://github.com/ccarruitero))
+- relax ruby version to support ruby 3.0 [\#99](https://github.com/solidusio-contrib/solidus_easypost/pull/99) ([ccarruitero](https://github.com/ccarruitero))
+- Add custom parcel dimension calculator class [\#98](https://github.com/solidusio-contrib/solidus_easypost/pull/98) ([vassalloandrea](https://github.com/vassalloandrea))
+- Update gemspec to allow Solidus 3 [\#94](https://github.com/solidusio-contrib/solidus_easypost/pull/94) ([vassalloandrea](https://github.com/vassalloandrea))
+- Prepare extension for solidus 3.0 [\#89](https://github.com/solidusio-contrib/solidus_easypost/pull/89) ([ccarruitero](https://github.com/ccarruitero))
+- Allow tracking packages via EasyPost [\#87](https://github.com/solidusio-contrib/solidus_easypost/pull/87) ([aldesantis](https://github.com/aldesantis))
+- Upgrade extension to latest defaults [\#86](https://github.com/solidusio-contrib/solidus_easypost/pull/86) ([aldesantis](https://github.com/aldesantis))
+- Allow admins to download postage labels [\#84](https://github.com/solidusio-contrib/solidus_easypost/pull/84) ([aldesantis](https://github.com/aldesantis))
+- Update extension with latest solidus\_dev\_support defaults [\#82](https://github.com/solidusio-contrib/solidus_easypost/pull/82) ([aldesantis](https://github.com/aldesantis))
+- Streamline and reorganize tests for better reliability [\#81](https://github.com/solidusio-contrib/solidus_easypost/pull/81) ([aldesantis](https://github.com/aldesantis))
+- Extract EasyPost object builders into separate classes [\#80](https://github.com/solidusio-contrib/solidus_easypost/pull/80) ([aldesantis](https://github.com/aldesantis))
+- Improve extension extendability [\#79](https://github.com/solidusio-contrib/solidus_easypost/pull/79) ([aldesantis](https://github.com/aldesantis))
+- Update extension to latest defaults from solidus\_dev\_support [\#78](https://github.com/solidusio-contrib/solidus_easypost/pull/78) ([aldesantis](https://github.com/aldesantis))
+
+## [v2.0.0](https://github.com/solidusio-contrib/solidus_easypost/tree/v2.0.0) (2020-07-24)
+
+[Full Changelog](https://github.com/solidusio-contrib/solidus_easypost/compare/v1.0.4...v2.0.0)
+
+**Breaking changes:**
+
+- keep same namespace in all files [\#68](https://github.com/solidusio-contrib/solidus_easypost/pull/68) ([ccarruitero](https://github.com/ccarruitero))
+
+**Closed issues:**
+
+- Dependabot can't resolve your Ruby dependency files [\#59](https://github.com/solidusio-contrib/solidus_easypost/issues/59)
+- Dependabot can't resolve your Ruby dependency files [\#57](https://github.com/solidusio-contrib/solidus_easypost/issues/57)
+- Dependabot can't resolve your Ruby dependency files [\#56](https://github.com/solidusio-contrib/solidus_easypost/issues/56)
+- Dependabot can't resolve your Ruby dependency files [\#54](https://github.com/solidusio-contrib/solidus_easypost/issues/54)
+- Dependabot can't resolve your Ruby dependency files [\#53](https://github.com/solidusio-contrib/solidus_easypost/issues/53)
+- Dependabot can't resolve your Ruby dependency files [\#52](https://github.com/solidusio-contrib/solidus_easypost/issues/52)
+- Config is now frozen. [\#49](https://github.com/solidusio-contrib/solidus_easypost/issues/49)
+- Easypost rate is bought twice [\#42](https://github.com/solidusio-contrib/solidus_easypost/issues/42)
+- UPS carrier doesn't allow empty company name in `from_address` [\#41](https://github.com/solidusio-contrib/solidus_easypost/issues/41)
+- Exception thrown by Estimator [\#35](https://github.com/solidusio-contrib/solidus_easypost/issues/35)
+- rake railties:install:migrations [\#30](https://github.com/solidusio-contrib/solidus_easypost/issues/30)
+- Easypost Migrations aren't working [\#22](https://github.com/solidusio-contrib/solidus_easypost/issues/22)
+- Missing for 2.1 solidus? [\#18](https://github.com/solidusio-contrib/solidus_easypost/issues/18)
+- Charge customer different amount? [\#17](https://github.com/solidusio-contrib/solidus_easypost/issues/17)
+- 1.3.0 seems to be empty [\#15](https://github.com/solidusio-contrib/solidus_easypost/issues/15)
+- Uninitialized constant EasyPost Error [\#14](https://github.com/solidusio-contrib/solidus_easypost/issues/14)
+
+**Merged pull requests:**
+
+- Extension cleanup [\#74](https://github.com/solidusio-contrib/solidus_easypost/pull/74) ([aldesantis](https://github.com/aldesantis))
+- Standardize whitespace in README [\#72](https://github.com/solidusio-contrib/solidus_easypost/pull/72) ([brchristian](https://github.com/brchristian))
+- Fix deprecation warning in engine.rb [\#71](https://github.com/solidusio-contrib/solidus_easypost/pull/71) ([brchristian](https://github.com/brchristian))
+- Update README.md [\#70](https://github.com/solidusio-contrib/solidus_easypost/pull/70) ([brchristian](https://github.com/brchristian))
+- Relax solidus\_support dependency [\#65](https://github.com/solidusio-contrib/solidus_easypost/pull/65) ([kennyadsl](https://github.com/kennyadsl))
+- Upgrade to the latest solidus\_dev\_support [\#60](https://github.com/solidusio-contrib/solidus_easypost/pull/60) ([vassalloandrea](https://github.com/vassalloandrea))
+- Fix CONFIGS constant not being modifiable [\#51](https://github.com/solidusio-contrib/solidus_easypost/pull/51) ([aldesantis](https://github.com/aldesantis))
+- Reorganize and improve tests [\#50](https://github.com/solidusio-contrib/solidus_easypost/pull/50) ([aldesantis](https://github.com/aldesantis))
+- Adopt solidus\_extension\_dev\_tools [\#48](https://github.com/solidusio-contrib/solidus_easypost/pull/48) ([aldesantis](https://github.com/aldesantis))
+- Use different easypost\_address for the stock locations [\#43](https://github.com/solidusio-contrib/solidus_easypost/pull/43) ([vassalloandrea](https://github.com/vassalloandrea))
+- Fix broken Rails 6 build [\#40](https://github.com/solidusio-contrib/solidus_easypost/pull/40) ([aldesantis](https://github.com/aldesantis))
+- Adopt CircleCI instead of Travis [\#39](https://github.com/solidusio-contrib/solidus_easypost/pull/39) ([aldesantis](https://github.com/aldesantis))
+- Fixing Travis [\#38](https://github.com/solidusio-contrib/solidus_easypost/pull/38) ([spaghetticode](https://github.com/spaghetticode))
+- Add Rubocop for linting [\#37](https://github.com/solidusio-contrib/solidus_easypost/pull/37) ([aitbw](https://github.com/aitbw))
+- Lock SQLite3 to version 1.3 [\#34](https://github.com/solidusio-contrib/solidus_easypost/pull/34) ([aitbw](https://github.com/aitbw))
+-  Use dynamic attributes on factories [\#33](https://github.com/solidusio-contrib/solidus_easypost/pull/33) ([aitbw](https://github.com/aitbw))
+- add solidus\_easypost file [\#32](https://github.com/solidusio-contrib/solidus_easypost/pull/32) ([peterberkenbosch](https://github.com/peterberkenbosch))
+- Add Solidus v2.8 to Travis config [\#31](https://github.com/solidusio-contrib/solidus_easypost/pull/31) ([aitbw](https://github.com/aitbw))
+- Spec suite maintenance [\#29](https://github.com/solidusio-contrib/solidus_easypost/pull/29) ([aitbw](https://github.com/aitbw))
+- Remove 2.2 from CI \(EOL\) [\#28](https://github.com/solidusio-contrib/solidus_easypost/pull/28) ([jacobherrington](https://github.com/jacobherrington))
+- Remove versions past EOL from .travis.yml [\#26](https://github.com/solidusio-contrib/solidus_easypost/pull/26) ([jacobherrington](https://github.com/jacobherrington))
+- Add Solidus 2.3-2.7 to .travis.yml [\#25](https://github.com/solidusio-contrib/solidus_easypost/pull/25) ([jacobherrington](https://github.com/jacobherrington))
+- Support Solidus 1.3 and beyond [\#19](https://github.com/solidusio-contrib/solidus_easypost/pull/19) ([jhawthorn](https://github.com/jhawthorn))
+- Add the require pry to spec helper [\#7](https://github.com/solidusio-contrib/solidus_easypost/pull/7) ([qr8r](https://github.com/qr8r))
+- Fix multiple version testing [\#5](https://github.com/solidusio-contrib/solidus_easypost/pull/5) ([jhawthorn](https://github.com/jhawthorn))
+
+## [v1.0.4](https://github.com/solidusio-contrib/solidus_easypost/tree/v1.0.4) (2016-10-03)
+
+[Full Changelog](https://github.com/solidusio-contrib/solidus_easypost/compare/v1.0.3...v1.0.4)
+
+## [v1.0.3](https://github.com/solidusio-contrib/solidus_easypost/tree/v1.0.3) (2016-07-20)
+
+[Full Changelog](https://github.com/solidusio-contrib/solidus_easypost/compare/v1.0.2...v1.0.3)
+
+## [v1.0.2](https://github.com/solidusio-contrib/solidus_easypost/tree/v1.0.2) (2016-03-14)
+
+[Full Changelog](https://github.com/solidusio-contrib/solidus_easypost/compare/solidus-1.0.2...v1.0.2)
+
+**Merged pull requests:**
+
+- Update Gemspec [\#4](https://github.com/solidusio-contrib/solidus_easypost/pull/4) ([qr8r](https://github.com/qr8r))
+- Version 1.0.0  [\#3](https://github.com/solidusio-contrib/solidus_easypost/pull/3) ([qr8r](https://github.com/qr8r))
+- Add a travis config file [\#2](https://github.com/solidusio-contrib/solidus_easypost/pull/2) ([qr8r](https://github.com/qr8r))
+- Fix address decorator spec [\#1](https://github.com/solidusio-contrib/solidus_easypost/pull/1) ([travisp](https://github.com/travisp))
+
+## [solidus-1.0.2](https://github.com/solidusio-contrib/solidus_easypost/tree/solidus-1.0.2) (2015-12-08)
+
+[Full Changelog](https://github.com/solidusio-contrib/solidus_easypost/compare/d963686e8d728ec5beec6c04fd4ae99e3cf7450e...solidus-1.0.2)
+
+
+
+\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*

data/Gemfile

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+git_source(:github) { |repo| "https://github.com/#{repo}.git" }
+
+branch = ENV.fetch('SOLIDUS_BRANCH', 'master')
+gem 'solidus', github: 'solidusio/solidus', branch: branch
+
+# Needed to help Bundler figure out how to resolve dependencies,
+# otherwise it takes forever to resolve them.
+# See https://github.com/bundler/bundler/issues/6677
+gem 'rails', '>0.a'
+
+# Provides basic authentication functionality for testing parts of your engine
+gem 'solidus_auth_devise'
+
+case ENV['DB']
+when 'mysql'
+  gem 'mysql2'
+when 'postgresql'
+  gem 'pg'
+else
+  gem 'sqlite3'
+end
+
+gemspec
+
+# Use a local Gemfile to include development dependencies that might not be
+# relevant for the project or for other contributors, e.g. pry-byebug.
+#
+# We use `send` instead of calling `eval_gemfile` to work around an issue with
+# how Dependabot parses projects: https://github.com/dependabot/dependabot-core/issues/1658.
+send(:eval_gemfile, 'Gemfile-local') if File.exist? 'Gemfile-local'

data/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2015 Brendan Deere
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+    * Neither the name Solidus nor the names of its contributors may be used to
+      endorse or promote products derived from this software without specific
+      prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,194 @@
+# solidus_easypost
+
+
+
+This is an extension to integrate EasyPost with Solidus.
+
+Due to how it works, you will not be able to use any other extension for shipping methods. Your own
+shipping methods will not work, either. But the good thing is that you won't have to worry about
+that, because EasyPost handles it all for you.
+
+You will need to [sign up for an account](https://www.easypost.com/) to use this extension.
+
+## Installation
+
+Add solidus_easypost to your Gemfile:
+
+```ruby
+gem 'solidus_easypost'
+```
+
+Bundle your dependencies and run the installation generator:
+
+```shell
+bin/rails generate solidus_easypost:install
+```
+
+This will create an initializer at `config/initializers/solidus_easypost.rb`. Read through the
+available configuration options and make sure to adjust the extension for your requirements.
+
+Finally, you will need to configure Solidus to use the EasyPost stock estimator:
+
+```ruby
+# config/initializers/spree.rb
+Spree.config do |config|
+  config.stock.estimator_class = 'SolidusEasypost::Estimator'
+end
+```
+
+## Usage
+
+Once you switch to the EasyPost rate calculator, the extension will start calculating shipping rates
+for all shipments. The cheapest rate will be selected by default, but your users will be able to
+change the selected rate in the `delivery` step of the checkout process, if they wish.
+
+Admins will also be able to download the postage label associated to each EasyPost shipment after
+a shipment has been bought.
+
+### Buying labels upon shipping
+
+By default, the extension also adds a callback to the `ship` event on the `Spree::Shipment` model,
+automatically buying the selected rate from EasyPost.
+
+If you want to disable this logic, you can set `purchase_labels` to `false`.
+
+### Customizing shipping rate calculation
+
+By default, the extension will pass the entire cost of shipping to the user (i.e., the shipping cost
+presented to the user will be equal to the rate received from the EasyPost API).
+
+If you want to override this logic (e.g., you want to offer your users free shipping, but still buy
+the rates from EasyPost), you can provide your own `shipping_rate_calculator_class`.
+
+### Customizing shipping method selection
+
+By default, the extension will create shipping methods for each type of carrier/service for which it
+receives a rate from the EasyPost API. These are not available to users by default, and must be
+enabled before they are visible and selectable in the storefront during the checkout process.
+
+If you want to override this logic, you can provide your own `shipping_method_selector_class`.
+
+### Customizing parcel dimension calculator
+
+By default, the extension will use the default weight dimension calculator to calculate the parcel dimension that is passed to EasyPost. The default calculator uses the variants weight to calculate the parcel weight without taking into consideration the other package properties like `width`, `height`, and `lenght`.
+
+If you want to override this logic, you can provide your own `parcel_dimension_calculator_class`.
+
+### Tracking cartons via EasyPost
+
+You can optionally track packages via EasyPost's [Trackers API](https://www.easypost.com/docs/api#trackers).
+In order to do this, you can call the `#easypost_tracker` method on any carton:
+
+```ruby
+carton = Spree::Carton.find(2)
+carton.easypost_tracker # => #<Easypost::Tracker>
+```
+
+This will also save the ID of the tracker on the `easy_post_tracker_id` column, to more easily
+retrieve the tracker in the future.
+
+> NOTE: In orders for carton tracking to work, you need to make sure that the `tracking` column
+> in `spree_cartons` contains a valid tracking number, and that the `carrier` column in
+> `spree_shipping_methods` contains a carrier name [that EasyPost will recognize](https://www.easypost.com/docs/api#carrier-tracking-strings).
+> The extension already generates compliant shipping methods by default, but you may need to change
+> the data on your custom shipping methods if you want to track them.
+
+You can also enable automatic tracking for all created cartons:
+
+```ruby
+SolidusEasypost.configure do |config|
+  config.track_all_cartons = true
+end
+```
+
+### Getting tracking updates via webhooks
+
+Once a tracker has been created for a given carton, you can either use it manually or you can use
+EasyPost's [webhooks](https://www.easypost.com/docs/api#webhooks) to have any shipping updates
+forwarded to your application.
+
+In order for webhooks to work, you need to install the [solidus_webhooks](https://github.com/solidusio-contrib/solidus_webhooks)
+extension. When the extension is available, a webhook will be automatically configured at
+`/webhooks/easypost_trackers`. Simply add it to your EasyPost dashboard with the following
+configuration:
+
+- *Environment:* `Production` or `Test`
+- *Webhook URL:* `https://your-store.com/webhooks/easypost_trackers?token=[YOUR_TOKEN]` (replace`[YOUR_TOKEN]` with the API key of an admin user or, better yet, a[webhook user](https://github.com/solidusio-contrib/solidus_webhooks#restricting-permissions)
+
+Now, when Solidus gets a tracking update from EasyPost, a `solidus_easypost.tracker.updated` event
+will be fired. The event's payload will contain the `:carton` and `:payload` keys, with the
+`Spree::Carton` object associated to the tracker and the EasyPost payload respectively.
+
+### Customizing the tracking webhook handler
+
+If you want to override default webhook handler, you can provide your own `webhook_handler_class` in your configuration.
+
+Note that, if you override the webhook handler, no events will be fired out of the box.
+
+## Development
+
+### Testing the extension
+
+First bundle your dependencies, then run `bin/rake`. `bin/rake` will default to building the dummy
+app if it does not exist, then it will run specs. The dummy app can be regenerated by using
+`bin/rake extension:test_app`.
+
+```shell
+bin/rake
+```
+
+To run [Rubocop](https://github.com/bbatsov/rubocop) static code analysis run
+
+```shell
+bundle exec rubocop
+```
+
+When testing your application's integration with this extension you may use its factories.
+Simply add this require statement to your spec_helper:
+
+```ruby
+require 'solidus_easypost/factories'
+```
+
+### Running the sandbox
+
+To run this extension in a sandboxed Solidus application, you can run `bin/sandbox`. The path for
+the sandbox app is `./sandbox` and `bin/rails` will forward any Rails commands to
+`sandbox/bin/rails`.
+
+Here's an example:
+
+```
+$ bin/rails server
+=> Booting Puma
+=> Rails 6.0.2.1 application starting in development
+* Listening on tcp://127.0.0.1:3000
+Use Ctrl-C to stop
+```
+
+### Updating the changelog
+
+Before and after releases the changelog should be updated to reflect the up-to-date status of
+the project:
+
+```shell
+bin/rake changelog
+git add CHANGELOG.md
+git commit -m "Update the changelog"
+```
+
+### Releasing new versions
+
+Your new extension version can be released using `gem-release` like this:
+
+```shell
+bundle exec gem bump -v 1.6.0
+bin/rake changelog
+git commit -a --amend
+git push
+bundle exec gem release
+```
+
+## License
+
+Copyright (c) 2015 Brendan Deere, released under the New BSD License.

data/Rakefile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require 'solidus_dev_support/rake_tasks'
+SolidusDevSupport::RakeTasks.install
+
+task default: 'extension:specs'

data/app/controllers/spree/admin/postage_labels_controller.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Spree
+  module Admin
+    class PostageLabelsController < Spree::Admin::BaseController
+      def show
+        @shipment = Spree::Shipment.find_by(number: params[:shipment_id])
+        authorize! @shipment, :show
+
+        unless @shipment.easypost_postage_label_url
+          flash[:error] = t('.no_postage_label', shipment_number: @shipment.number)
+          redirect_back(fallback_location: edit_admin_order_path(@shipment.order))
+          return
+        end
+
+        redirect_to @shipment.easypost_postage_label_url
+      end
+    end
+  end
+end

data/app/decorators/models/solidus_easypost/spree/carton_decorator.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module SolidusEasypost
+  module Spree
+    module CartonDecorator
+      def self.prepended(base)
+        base.after_create :track_via_easypost
+      end
+
+      def easypost_tracker
+        return @easypost_tracker if @easypost_tracker
+
+        if easy_post_tracker_id.present?
+          @easypost_tracker = EasyPost::Tracker.retrieve(easy_post_tracker_id)
+        else
+          @easypost_tracker = EasyPost::Tracker.create(
+            tracking_code: tracking,
+            carrier: shipping_method.carrier,
+          )
+
+          update!(easy_post_tracker_id: @easypost_tracker.id)
+        end
+
+        @easypost_tracker
+      end
+
+      private
+
+      def track_via_easypost
+        return unless SolidusEasypost.configuration.track_all_cartons
+
+        easypost_tracker
+      end
+
+      ::Spree::Carton.prepend self
+    end
+  end
+end

data/app/decorators/models/solidus_easypost/spree/shipment_decorator.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module SolidusEasypost
+  module Spree
+    module ShipmentDecorator
+      def self.prepended(base)
+        base.state_machine.before_transition(
+          to: :shipped,
+          do: :buy_easypost_rate,
+          if: -> { SolidusEasypost.configuration.purchase_labels }
+        )
+
+        base.delegate(
+          :easy_post_rate_id,
+          :easy_post_shipment_id,
+          to: :selected_shipping_rate,
+          prefix: :selected,
+          allow_nil: true,
+        )
+      end
+
+      def easypost_shipment
+        return unless selected_easy_post_shipment_id
+
+        @easypost_shipment ||= ::EasyPost::Shipment.retrieve(selected_easy_post_shipment_id)
+      end
+
+      def easypost_postage_label_url
+        easypost_shipment&.postage_label&.label_url
+      end
+
+      private
+
+      def buy_easypost_rate
+        rate = easypost_shipment.rates.find do |easypost_rate|
+          easypost_rate.id == selected_easy_post_rate_id
+        end
+
+        easypost_shipment.buy(rate)
+
+        self.tracking = easypost_shipment.tracking_code
+      end
+
+      ::Spree::Shipment.prepend self
+    end
+  end
+end

data/app/decorators/models/solidus_easypost/spree/shipping_rate_decorator.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module SolidusEasypost
+  module Spree
+    module ShippingRateDecorator
+      def name
+        read_attribute(:name) || super
+      end
+
+      ::Spree::ShippingRate.prepend self
+    end
+  end
+end