freight_kit 0.1.19 → 0.1.21

data/lib/freight_kit/carriers.rb

@@ -1,50 +1,346 @@
-# frozen_string_literal: true
-
 module FreightKit
   module Carriers
-    extend self
-
-    attr_reader :registered
+    module_function
 
     @registered = []
 
-    def register(class_name, autoload_require)
-      FreightKit.autoload(class_name, autoload_require)
-      registered << class_name
-    end
-
-    def all
-      FreightKit::Carriers.registered.map { |name| FreightKit.const_get(name) }
-    end
+    def all = registered.map { |name| const_get(name) }
 
     def find(name)
       all.find { |c| c.name.downcase == name.to_s.downcase } or raise NameError, "unknown carrier #{name}"
     end
+
+    def find_by(**attributes)
+      all.find { |carrier| attributes.all? { |key, value| carrier.public_send(key) == value } }
+    end
+
+    def register(class_name) = registered << class_name
+    def registered = @registered
   end
 end
 
-FreightKit::Carriers.register(:ABFS, 'freight_kit/carriers/abfs')
-FreightKit::Carriers.register(:BTVP, 'freight_kit/carriers/btvp')
-FreightKit::Carriers.register(:CCYQ, 'freight_kit/carriers/ccyq')
-FreightKit::Carriers.register(:CLNI, 'freight_kit/carriers/clni')
-FreightKit::Carriers.register(:CNWY, 'freight_kit/carriers/cnwy')
-FreightKit::Carriers.register(:DLDS, 'freight_kit/carriers/dlds')
-FreightKit::Carriers.register(:DPHE, 'freight_kit/carriers/dphe')
-FreightKit::Carriers.register(:DRRQ, 'freight_kit/carriers/drrq')
-FreightKit::Carriers.register(:FWDA, 'freight_kit/carriers/fwda')
-FreightKit::Carriers.register(:MTVL, 'freight_kit/carriers/mtvl')
-FreightKit::Carriers.register(:NUMK, 'freight_kit/carriers/numk')
-FreightKit::Carriers.register(:OTCL, 'freight_kit/carriers/otcl')
-FreightKit::Carriers.register(:PENS, 'freight_kit/carriers/pens')
-FreightKit::Carriers.register(:RDFS, 'freight_kit/carriers/rdfs')
-FreightKit::Carriers.register(:SAIA, 'freight_kit/carriers/saia')
-FreightKit::Carriers.register(:SEFL, 'freight_kit/carriers/sefl')
-FreightKit::Carriers.register(:TQYL, 'freight_kit/carriers/tqyl')
-FreightKit::Carriers.register(:WRDS, 'freight_kit/carriers/wrds')
+FreightKit::Carriers.register(:ABFFreightSystem)
+FreightKit::Carriers.register(:BestOverniteExpress)
+FreightKit::Carriers.register(:CrossCountryFreightSolutions)
+FreightKit::Carriers.register(:ClearLaneFreightSystems)
+FreightKit::Carriers.register(:XPOLogistics)
+FreightKit::Carriers.register(:DiamondLineDelivery)
+FreightKit::Carriers.register(:DependableHighwayExpress)
+FreightKit::Carriers.register(:TForceWorldwide)
+FreightKit::Carriers.register(:ForwardAir)
+FreightKit::Carriers.register(:GLSFreight)
+FreightKit::Carriers.register(:NumarkTransportation)
+FreightKit::Carriers.register(:OnTrac)
+FreightKit::Carriers.register(:PeninsulaTruckLines)
+FreightKit::Carriers.register(:RoadrunnerTransportationServices)
+FreightKit::Carriers.register(:Saia)
+FreightKit::Carriers.register(:SoutheasternFreightLines)
+FreightKit::Carriers.register(:TotalQualityLogistics)
+FreightKit::Carriers.register(:WesternRegionalDeliveryService)
 
 # Based on Platform
-FreightKit::Carriers.register(:CTBV, 'freight_kit/carriers/ctbv')
-FreightKit::Carriers.register(:DCHA, 'freight_kit/carriers/dcha')
-FreightKit::Carriers.register(:JFJTransportation, 'freight_kit/carriers/jfj_transportation')
-FreightKit::Carriers.register(:FCSY, 'freight_kit/carriers/fcsy')
-FreightKit::Carriers.register(:TOTL, 'freight_kit/carriers/totl')
+FreightKit::Carriers.register(:TheCustomCompanies)
+FreightKit::Carriers.register(:MountainValleyExpress)
+FreightKit::Carriers.register(:JFJTransportation)
+FreightKit::Carriers.register(:STG)
+FreightKit::Carriers.register(:TotalTransportation)
+
+# Without an API
+FreightKit::Carriers.register(:AAAExpeditedServices)
+FreightKit::Carriers.register(:AAACooper)
+FreightKit::Carriers.register(:ABBrothersUSAInc)
+FreightKit::Carriers.register(:AberdeenExpressInc)
+FreightKit::Carriers.register(:A1Express)
+FreightKit::Carriers.register(:ArcherCargo)
+FreightKit::Carriers.register(:AverittExpress)
+FreightKit::Carriers.register(:AccessTransport)
+FreightKit::Carriers.register(:ActionExpress)
+FreightKit::Carriers.register(:AdamsAndCompanies)
+FreightKit::Carriers.register(:AdvanceDistribution)
+FreightKit::Carriers.register(:AlconTransport)
+FreightKit::Carriers.register(:AllFreight)
+FreightKit::Carriers.register(:AllianceTransportationGroup)
+FreightKit::Carriers.register(:AllstateTransport)
+FreightKit::Carriers.register(:AmadoTrucking)
+FreightKit::Carriers.register(:AmericanFastFreight)
+FreightKit::Carriers.register(:AmigosServiceTransportation)
+FreightKit::Carriers.register(:AndersonTowingAndTransport)
+FreightKit::Carriers.register(:ApexTransporting)
+FreightKit::Carriers.register(:ArmstrongTransportGroup)
+FreightKit::Carriers.register(:AutobahnLogistics)
+FreightKit::Carriers.register(:BATransportation)
+FreightKit::Carriers.register(:BenjaminBestFreightInc)
+FreightKit::Carriers.register(:BcFreightways)
+FreightKit::Carriers.register(:BalkinExpress)
+FreightKit::Carriers.register(:BayAreaExpress)
+FreightKit::Carriers.register(:BennettTrucking)
+FreightKit::Carriers.register(:BestTrucking)
+FreightKit::Carriers.register(:BestwayTransport)
+FreightKit::Carriers.register(:BryanSystems)
+FreightKit::Carriers.register(:CAndWExpress)
+FreightKit::Carriers.register(:CDCTransport)
+FreightKit::Carriers.register(:CDOExpressDiversified)
+FreightKit::Carriers.register(:CentralFreightLines)
+FreightKit::Carriers.register(:CustomGlobalLogistics)
+FreightKit::Carriers.register(:CMSDomestic)
+FreightKit::Carriers.register(:CNDLogistics)
+FreightKit::Carriers.register(:CPLExpress)
+FreightKit::Carriers.register(:CSATransportation)
+FreightKit::Carriers.register(:ChicagoSuburbanExpress)
+FreightKit::Carriers.register(:CSXTransportation)
+FreightKit::Carriers.register(:CentralTransport)
+FreightKit::Carriers.register(:CampbellTrucking)
+FreightKit::Carriers.register(:CardeTransportation)
+FreightKit::Carriers.register(:CardinalLogistics)
+FreightKit::Carriers.register(:CedarSupplyTrucking)
+FreightKit::Carriers.register(:CityLogistics)
+FreightKit::Carriers.register(:CleopatraTrucking)
+FreightKit::Carriers.register(:CliffordTransportation)
+FreightKit::Carriers.register(:CoastToCoastTransport)
+FreightKit::Carriers.register(:CountrywideCarriers)
+FreightKit::Carriers.register(:CrosbyTruckingService)
+FreightKit::Carriers.register(:Crowley)
+FreightKit::Carriers.register(:DaytonFreightLines)
+FreightKit::Carriers.register(:DAKTransport)
+FreightKit::Carriers.register(:DAndATransport)
+FreightKit::Carriers.register(:DBRLogistics)
+FreightKit::Carriers.register(:DHL)
+FreightKit::Carriers.register(:DohrnTransferCompany)
+FreightKit::Carriers.register(:DotLineTransportation)
+FreightKit::Carriers.register(:DRTTransportation)
+FreightKit::Carriers.register(:DuganTruckLine)
+FreightKit::Carriers.register(:DaylightTransport)
+FreightKit::Carriers.register(:DashCourierAndLogisticsNorthCarolina)
+FreightKit::Carriers.register(:DeepSouthFreight)
+FreightKit::Carriers.register(:DeltaExpress)
+FreightKit::Carriers.register(:DeltaTransport)
+FreightKit::Carriers.register(:DeltaTruckingLogistics)
+FreightKit::Carriers.register(:DemcoExpress)
+FreightKit::Carriers.register(:DependableGlobalExpress)
+FreightKit::Carriers.register(:DesertCoastalTransport)
+FreightKit::Carriers.register(:DingTaiTrucking)
+FreightKit::Carriers.register(:DiversifiedTransferAndStorage)
+FreightKit::Carriers.register(:Dupont)
+FreightKit::Carriers.register(:Express2000Inc)
+FreightKit::Carriers.register(:ERATransport)
+FreightKit::Carriers.register(:ETransportCarriers)
+FreightKit::Carriers.register(:EWRiversideTrucking)
+FreightKit::Carriers.register(:EstesExpressLines)
+FreightKit::Carriers.register(:EchoGlobalLogistics)
+FreightKit::Carriers.register(:EcklundLogistics)
+FreightKit::Carriers.register(:ElEmplumadoTransport)
+FreightKit::Carriers.register(:EliteCarriers)
+FreightKit::Carriers.register(:EmeraldExpress)
+FreightKit::Carriers.register(:EuroKam)
+FreightKit::Carriers.register(:ExpressServicesInternational)
+FreightKit::Carriers.register(:FAndAExpress)
+FreightKit::Carriers.register(:FedExGround)
+FreightKit::Carriers.register(:FedExExpress)
+FreightKit::Carriers.register(:FortTransportationAndServiceCompanyInc)
+FreightKit::Carriers.register(:FedExLTLPriority)
+FreightKit::Carriers.register(:FedExLTLEconomy)
+FreightKit::Carriers.register(:FairmontLogistics)
+FreightKit::Carriers.register(:FargoCargo)
+FreightKit::Carriers.register(:FastFreightTransportation)
+FreightKit::Carriers.register(:FastLoadTransport)
+FreightKit::Carriers.register(:FirstTruckingExpress)
+FreightKit::Carriers.register(:FlashTrucking)
+FreightKit::Carriers.register(:Frahtex)
+FreightKit::Carriers.register(:FrozenFoodExpress)
+FreightKit::Carriers.register(:GPSTransport)
+FreightKit::Carriers.register(:GSAInternational)
+FreightKit::Carriers.register(:GSPExpress)
+FreightKit::Carriers.register(:GSVTransportation)
+FreightKit::Carriers.register(:GTATransportation)
+FreightKit::Carriers.register(:GholiaBrosTrucking)
+FreightKit::Carriers.register(:GlobalCargo)
+FreightKit::Carriers.register(:GlobalLogisticsAndTransportation)
+FreightKit::Carriers.register(:GoTruckingServices)
+FreightKit::Carriers.register(:GoldEagleTransportation)
+FreightKit::Carriers.register(:GoldenDropTrucking)
+FreightKit::Carriers.register(:GonzalezTransportation)
+FreightKit::Carriers.register(:GreeneEnterprise)
+FreightKit::Carriers.register(:GuamFreightServices)
+FreightKit::Carriers.register(:HERTrucking)
+FreightKit::Carriers.register(:HotLineFreightSystemInc)
+FreightKit::Carriers.register(:USFHolland)
+FreightKit::Carriers.register(:HNTransport)
+FreightKit::Carriers.register(:DependableHawaiianExpress)
+FreightKit::Carriers.register(:RISTTransport)
+FreightKit::Carriers.register(:HarrahTransportation)
+FreightKit::Carriers.register(:HerculesFreight)
+FreightKit::Carriers.register(:HighlanderXpress)
+FreightKit::Carriers.register(:HonoluluFreightService)
+FreightKit::Carriers.register(:HotshotFreightOfTexas)
+FreightKit::Carriers.register(:HouserTransport)
+FreightKit::Carriers.register(:InfinitiFreightLogistics)
+FreightKit::Carriers.register(:InfinityTrucking)
+FreightKit::Carriers.register(:InterstateTMA)
+FreightKit::Carriers.register(:IntradeIndustries)
+FreightKit::Carriers.register(:JBHunt)
+FreightKit::Carriers.register(:JKBExpress)
+FreightKit::Carriers.register(:JLMTransport)
+FreightKit::Carriers.register(:JPLogistics)
+FreightKit::Carriers.register(:JasperTrucking)
+FreightKit::Carriers.register(:JohanssonTransport)
+FreightKit::Carriers.register(:JonesExpress)
+FreightKit::Carriers.register(:JustInTimeCargo)
+FreightKit::Carriers.register(:KLCTransportation)
+FreightKit::Carriers.register(:KMALogistics)
+FreightKit::Carriers.register(:KMTrucking)
+FreightKit::Carriers.register(:KRCLogistics)
+FreightKit::Carriers.register(:KTX)
+FreightKit::Carriers.register(:KengkokTimes)
+FreightKit::Carriers.register(:KingsExpress)
+FreightKit::Carriers.register(:Landstar)
+FreightKit::Carriers.register(:LDTrucking)
+FreightKit::Carriers.register(:LJExpress)
+FreightKit::Carriers.register(:LKPEnterprises)
+FreightKit::Carriers.register(:LanterDistributingLlc)
+FreightKit::Carriers.register(:LTLPros)
+FreightKit::Carriers.register(:LegacyLogisticsSolutions)
+FreightKit::Carriers.register(:LeonardsExpress)
+FreightKit::Carriers.register(:LibertyLinehaulWest)
+FreightKit::Carriers.register(:LibertyTransport)
+FreightKit::Carriers.register(:LightningExpress)
+FreightKit::Carriers.register(:MAndMAndSons)
+FreightKit::Carriers.register(:MCSystems)
+FreightKit::Carriers.register(:MagicMessenger)
+FreightKit::Carriers.register(:MidwestMotorExpress)
+FreightKit::Carriers.register(:MSFreight)
+FreightKit::Carriers.register(:MotoTransportation)
+FreightKit::Carriers.register(:MVGTransport)
+FreightKit::Carriers.register(:MagLinesTransport)
+FreightKit::Carriers.register(:MajorsTransit)
+FreightKit::Carriers.register(:MapGlobalLogistics)
+FreightKit::Carriers.register(:MatthsTrucking)
+FreightKit::Carriers.register(:MavCanadianTransport)
+FreightKit::Carriers.register(:MegaFleet)
+FreightKit::Carriers.register(:MegaTransGroup)
+FreightKit::Carriers.register(:MetaExpress)
+FreightKit::Carriers.register(:MiaTransportation)
+FreightKit::Carriers.register(:MidwestTransportAndTrucking)
+FreightKit::Carriers.register(:MikadeDeliveryService)
+FreightKit::Carriers.register(:MohoffFreightLines)
+FreightKit::Carriers.register(:MontataTravelersExpress)
+FreightKit::Carriers.register(:MorganVanLines)
+FreightKit::Carriers.register(:NAndMTransferCoInc)
+FreightKit::Carriers.register(:NewPennMotorExpress)
+FreightKit::Carriers.register(:NTUSA)
+FreightKit::Carriers.register(:NVKTransport)
+FreightKit::Carriers.register(:NYTransport)
+FreightKit::Carriers.register(:NabotTransportSolutions)
+FreightKit::Carriers.register(:NationalFreightXpress)
+FreightKit::Carriers.register(:NavigationGroup)
+FreightKit::Carriers.register(:NelsonTrucking)
+FreightKit::Carriers.register(:Network1Transportation)
+FreightKit::Carriers.register(:NewCenturyTransport)
+FreightKit::Carriers.register(:NievesTransportation)
+FreightKit::Carriers.register(:NolanTransportationGroup)
+FreightKit::Carriers.register(:NorthlandTrucking)
+FreightKit::Carriers.register(:NorthwestCarrierLogistics)
+FreightKit::Carriers.register(:NuLineTransportation)
+FreightKit::Carriers.register(:OldDominionFreightLine)
+FreightKit::Carriers.register(:OakHarbor)
+FreightKit::Carriers.register(:OaklineTransportation)
+FreightKit::Carriers.register(:OneHundredOneTransport)
+FreightKit::Carriers.register(:OneWayDelivery)
+FreightKit::Carriers.register(:OracleTransportationSolutions)
+FreightKit::Carriers.register(:OrangeCourier)
+FreightKit::Carriers.register(:OrtasTrucking)
+FreightKit::Carriers.register(:PGS360)
+FreightKit::Carriers.register(:PGTransport)
+FreightKit::Carriers.register(:PittOhioExpress)
+FreightKit::Carriers.register(:PKILogistics)
+FreightKit::Carriers.register(:PWCInternational)
+FreightKit::Carriers.register(:ADuiePyle)
+FreightKit::Carriers.register(:PacTruxTransportation)
+FreightKit::Carriers.register(:Pacer)
+FreightKit::Carriers.register(:PacificLogistics)
+FreightKit::Carriers.register(:PacificStatesTruckLines)
+FreightKit::Carriers.register(:ParadiseDistributing)
+FreightKit::Carriers.register(:ParamountFreightSystems)
+FreightKit::Carriers.register(:PilotFreightServices)
+FreightKit::Carriers.register(:PiousTrans)
+FreightKit::Carriers.register(:PlanaTransportation)
+FreightKit::Carriers.register(:Prestige)
+FreightKit::Carriers.register(:ProTransSolutions)
+FreightKit::Carriers.register(:PumaLogistics)
+FreightKit::Carriers.register(:QualityLogistics)
+FreightKit::Carriers.register(:QueenStarTrucking)
+FreightKit::Carriers.register(:RACTransport)
+FreightKit::Carriers.register(:YRCFreight)
+FreightKit::Carriers.register(:RELogistics)
+FreightKit::Carriers.register(:Reddaway)
+FreightKit::Carriers.register(:RAndLCarriers)
+FreightKit::Carriers.register(:RoseTrucking)
+FreightKit::Carriers.register(:RPAndJTransport)
+FreightKit::Carriers.register(:RPMTransportation)
+FreightKit::Carriers.register(:RudeTransportation)
+FreightKit::Carriers.register(:ReeferVanNetwork)
+FreightKit::Carriers.register(:RefrigeratedTruckingAndLTLTransportationServices)
+FreightKit::Carriers.register(:RidgelineExpress)
+FreightKit::Carriers.register(:RiverCityTransport)
+FreightKit::Carriers.register(:Roadtex)
+FreightKit::Carriers.register(:RonaldTransportServices)
+FreightKit::Carriers.register(:SAndSLogistics)
+FreightKit::Carriers.register(:SBTransportation)
+FreightKit::Carriers.register(:SouthwesternMotorTransport)
+FreightKit::Carriers.register(:SNATransportation)
+FreightKit::Carriers.register(:SSIRefrigeratedExpress)
+FreightKit::Carriers.register(:StandardForwardingLlc)
+FreightKit::Carriers.register(:SuttonTransportInc)
+FreightKit::Carriers.register(:SchneiderNational)
+FreightKit::Carriers.register(:SchwarzTrucking)
+FreightKit::Carriers.register(:SewellMotorExpress)
+FreightKit::Carriers.register(:ShawneeTrucking)
+FreightKit::Carriers.register(:ShiLogistics)
+FreightKit::Carriers.register(:SinbadTransport)
+FreightKit::Carriers.register(:Skyway)
+FreightKit::Carriers.register(:SmithCargoTransportationServices)
+FreightKit::Carriers.register(:SolidGroup)
+FreightKit::Carriers.register(:SolutionCarrierExpress)
+FreightKit::Carriers.register(:SpanAlaska)
+FreightKit::Carriers.register(:SpecializeTransportation)
+FreightKit::Carriers.register(:StarAmericanEnterprise)
+FreightKit::Carriers.register(:SterlingTransportation)
+FreightKit::Carriers.register(:SupervanService)
+FreightKit::Carriers.register(:SwiftTransportation)
+FreightKit::Carriers.register(:TaxAirfreightInc)
+FreightKit::Carriers.register(:TforceFreightInc)
+FreightKit::Carriers.register(:THKTrucking)
+FreightKit::Carriers.register(:TILILogistics)
+FreightKit::Carriers.register(:TMTIndustries)
+FreightKit::Carriers.register(:TSIKansas)
+FreightKit::Carriers.register(:AlohaFreightForwarders)
+FreightKit::Carriers.register(:TigerCoolExpress)
+FreightKit::Carriers.register(:TopTenExpress)
+FreightKit::Carriers.register(:TransInternationalTrucking)
+FreightKit::Carriers.register(:TreasureTransportation)
+FreightKit::Carriers.register(:TriStateServices)
+FreightKit::Carriers.register(:TritexFreighters)
+FreightKit::Carriers.register(:Triways)
+FreightKit::Carriers.register(:UAndRTransportation)
+FreightKit::Carriers.register(:UPSFreight)
+FreightKit::Carriers.register(:UPStreamline)
+FreightKit::Carriers.register(:USATruck)
+FreightKit::Carriers.register(:USFreightways)
+FreightKit::Carriers.register(:UnionPacific)
+FreightKit::Carriers.register(:UnitedFreightLogistics)
+FreightKit::Carriers.register(:UnlimitedDistanceTransportation)
+FreightKit::Carriers.register(:ValleyCartage)
+FreightKit::Carriers.register(:VCTransport)
+FreightKit::Carriers.register(:VMGTransportationGroup)
+FreightKit::Carriers.register(:VisionExpress)
+FreightKit::Carriers.register(:VisionLogisticsGroup)
+FreightKit::Carriers.register(:VolpeExpress)
+FreightKit::Carriers.register(:WardTrucking)
+FreightKit::Carriers.register(:WDWB)
+FreightKit::Carriers.register(:WLBTransport)
+FreightKit::Carriers.register(:WesternFlyerExpress)
+FreightKit::Carriers.register(:WesternSpecializedTrucking)
+FreightKit::Carriers.register(:WinDistribution)
+FreightKit::Carriers.register(:XpressGlobalSystems)
+FreightKit::Carriers.register(:XTrux)
+FreightKit::Carriers.register(:XyloTrucking)
+FreightKit::Carriers.register(:ZentnerTransportation)

data/lib/freight_kit/countries.rb

@@ -0,0 +1,22 @@
+module FreightKit
+  module Countries
+    module_function
+
+    def all
+      @all ||= ISO3166::Country
+               .all
+               .map do |iso_country|
+                 Country.new(
+                   iso31661_alpha2: iso_country.alpha2,
+                   iso31661_alpha3: iso_country.alpha3,
+                   name: iso_country.iso_short_name,
+                   un_code: iso_country.number&.to_i
+                 )
+               end
+    end
+
+    def find_by(**attributes)
+      all.find { |country| attributes.all? { |key, value| country.public_send(key) == value } }
+    end
+  end
+end

data/lib/freight_kit/error.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   class Error < StandardError; end
 end

data/lib/freight_kit/errors/document_not_found_error.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   class DocumentNotFoundError < Error; end
 end

data/lib/freight_kit/errors/expired_credentials_error.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   class ExpiredCredentialsError < InvalidCredentialsError; end
 end

data/lib/freight_kit/errors/http_error.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   class HTTPError < Error
     attr_reader :body, :code

data/lib/freight_kit/errors/invalid_credentials_error.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   class InvalidCredentialsError < Error; end
 end

data/lib/freight_kit/errors/response_error.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   class ResponseError < Error
     attr_reader :response
@@ -9,7 +7,7 @@ module FreightKit
         super(response.message)
         @response = response
       else
-        super(response)
+        super
       end
     end
   end

data/lib/freight_kit/errors/shipment_not_found_error.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   class ShipmentNotFoundError < Error; end
 end

data/lib/freight_kit/errors/unserviceable_accessorials_error.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   class UnserviceableAccessorialsError < UnserviceableError
     attr_reader :accessorials
@@ -12,8 +10,8 @@ module FreightKit
 
     def message
       @message ||= "Unable to service #{@accessorials.map do |accessorial|
-                                          accessorial.to_s.gsub("_", " ")
-                                        end.join(", ")}"
+                                          accessorial.to_s.gsub('_', ' ')
+                                        end.join(', ')}"
     end
   end
 end

data/lib/freight_kit/errors/unserviceable_error.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   class UnserviceableError < Error; end
 end

data/lib/freight_kit/helpers/documentable.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   module Documentable
     def pod(tracking_number)

data/lib/freight_kit/helpers/pickupable.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   module Pickupable
     def create_pickup(
@@ -20,15 +18,15 @@ module FreightKit
         pickup_to:,
         scac:,
         service:,
-        shipment:,
+        shipment:
       )
 
       begin
         # For SOAP APIs, the :action parameter is required
         response = commit(:pickup, request) if method(:commit).parameters.count == 2
         response ||= commit(request)
-      rescue FreightKit::Error => error
-        response = PickupResponse.new(request:, response: nil, error:)
+      rescue FreightKit::Error => e
+        response = PickupResponse.new(request:, response: nil, error: e)
       end
 
       return response if response.is_a?(PickupResponse)

data/lib/freight_kit/helpers/rateable.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   module Rateable
     def find_rates(shipment:)

data/lib/freight_kit/helpers/trackable.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FreightKit
   module Trackable
     def find_tracking_info(tracking_number, *)

data/lib/freight_kit/http_client/cache_store.rb

@@ -0,0 +1,59 @@
+module FreightKit
+  class HTTPClient
+    # Adapts an ActiveSupport::Cache::Store-like backend (#read, #write, #delete_matched)
+    # to the HTTPX cache store interface (#get, #set, #clear).
+    #
+    # HTTPX responses hold sockets and options, so only status, headers and body are stored.
+    class CacheStore
+      NAMESPACE = 'freight_kit/http_client'.freeze
+      VALIDATOR_HEADERS = ['if-modified-since', 'if-none-match'].freeze
+
+      def initialize(backend) = @backend = backend
+
+      # RedisCacheStore only supports glob strings, the other ActiveSupport stores only regular expressions
+      def clear
+        @backend.delete_matched(%r{\A#{Regexp.escape(NAMESPACE)}/})
+      rescue ArgumentError
+        @backend.delete_matched("#{NAMESPACE}/*")
+      end
+
+      def get(request)
+        entry = @backend.read(key(request))
+        return if entry.blank?
+
+        response = request.options.response_class.new(request, entry[:status], entry[:version], entry[:headers])
+        response.finish!
+        response.mark_as_cached!
+        response.body.write(entry[:body])
+        response.body.rewind
+        response
+      end
+
+      def set(request, response)
+        response.body.rewind
+
+        @backend.write(
+          key(request),
+          {
+            body: response.body.to_s,
+            headers: response.headers.to_h,
+            status: response.status,
+            version: response.version
+          }
+        )
+      end
+
+      private
+
+      # Unlike HTTPX's default key, every request header (e.g. Authorization, API keys) is
+      # part of the key so that responses are never shared across credentials.
+      # Query parameters given as `params:` are only part of the request path, not its URI.
+      def key(request)
+        headers = request.headers.to_a.reject { |field, _| VALIDATOR_HEADERS.include?(field) }.sort
+        digest = Digest::SHA256.hexdigest([request.verb, request.uri.merge(request.path).to_s, headers].to_json)
+
+        "#{NAMESPACE}/#{digest}"
+      end
+    end
+  end
+end

data/lib/freight_kit/http_client/log_device.rb

@@ -0,0 +1,13 @@
+module FreightKit
+  class HTTPClient
+    # HTTPX writes debug output to an IO-like object (#<<); this forwards it to a logger at debug level.
+    class LogDevice
+      def initialize(logger) = @logger = logger
+
+      def <<(message)
+        @logger.debug(message.chomp)
+        self
+      end
+    end
+  end
+end

data/lib/freight_kit/http_client/response.rb

@@ -0,0 +1,38 @@
+module FreightKit
+  class HTTPClient
+    # Like HTTParty::Response, unknown methods (e.g. #dig, #[]) are delegated to the parsed body.
+    class Response
+      JSON_CONTENT_TYPES = ['application/hal+json', 'application/json', 'application/vnd.api+json', 'text/json'].freeze
+      XML_CONTENT_TYPES = ['application/xml', 'text/xml'].freeze
+
+      attr_reader :body, :code, :content_type, :headers
+
+      # Delegation alone would make empty bodies (parsed as nil) look present
+      delegate :blank?, to: :parsed_response
+      delegate_missing_to :parsed_response
+
+      def initialize(response)
+        @body = response.body.to_s
+        @code = response.status
+        @content_type = response.content_type.mime_type
+        @headers = response.headers
+      end
+
+      def parsed_response
+        return @parsed_response if defined?(@parsed_response)
+
+        @parsed_response = if body.strip.empty? || body == 'null'
+                             nil
+                           elsif JSON_CONTENT_TYPES.include?(content_type)
+                             JSON.parse(body, allow_nan: true)
+                           elsif XML_CONTENT_TYPES.include?(content_type)
+                             MultiXML.parse(body)
+                           else
+                             body
+                           end
+      end
+
+      def to_s = body
+    end
+  end
+end

data/lib/freight_kit/http_client/revalidation.rb

@@ -0,0 +1,25 @@
+module FreightKit
+  class HTTPClient
+    # HTTPX plugin making revalidated (304 Not Modified) responses look like the cached
+    # response they were revalidated against, so callers checking for 200 keep working.
+    #
+    # HTTPX renews freshness by mutating the cached response in memory, which serializing
+    # cache stores never see, so the refreshed response is stored again.
+    module Revalidation
+      module ResponseMethods
+        def copy_from_cached!
+          super
+          return unless (cached_response = @request.cached_response)
+
+          @status = cached_response.status
+          store = @request.options.response_cache_store
+          store.set(@request, self) if HTTPX::Plugins::ResponseCache.cacheable_response?(self)
+        end
+      end
+
+      class << self
+        def load_dependencies(klass) = klass.plugin(:response_cache)
+      end
+    end
+  end
+end