nz_post_api 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd7725f76d54c6a212beecd45f4ffc568ae7b0ab010d69ecf0f92d3dcbe57149
-  data.tar.gz: 7298abe8f2dae29e17f9525839b405e5c88a6be22f9072021002cdc1e3a8c957
+  metadata.gz: db4c2d341925855b00d54c677d88820dfcb183e16bf3a92e12c284bbdc665f80
+  data.tar.gz: 6ffccabb911d0b5683984b45c75b5aea2392771452794c0572a65bae0fea8350
 SHA512:
-  metadata.gz: 233660b133767bfc37a494719f344be5882d5d1093cbd92fc51b835e25481e0ba2d31ac4f5f4991622a9d3f3cae389350580e635bb99e35f55fdd4bce2efad9e
-  data.tar.gz: '08319bcd20474c2bccbc4f69b14bb57ccbe648e9ef95c186b3bc719067259baa4e8e7bd8840acfdd62d79d7564d0283e986be1cafe1cb87eb3f3775892a85070'
+  metadata.gz: 4d66466023a5ae7a3d341218fe006cf25d022747bfc7dbf08be4a2026629982507cba8837b884609c68f1b11a3ca270484c13b50f4e43fb02e72683420ada83b
+  data.tar.gz: 2dac646484e52891d15da15f731625fb28a8fc1a389f54b2f3b66302f5f9b4f111fc8a5727a6ae516c90d51dba0c659944d67c3804a79290c4a4cec4e884a5b2

data/AGENTS.md

@@ -15,6 +15,7 @@ This project is a Ruby gem wrapper for the NZ Post API.
 2.  Implement the test case.
 3.  Implement the code to pass the test.
 4.  Refactor.
+5.  **Documentation**: Update README.md if there are any changes to the public API or configuration.
 
 ## API Documentation
 

data/README.md

@@ -37,6 +37,16 @@ Then, initialize the client with the access token.
 client = NzPostApi::Client.new(client_id: "YOUR_CLIENT_ID", access_token: access_token)
 ```
 
+### Configuration
+
+By default, the gem uses the UAT environment. To use the production environment, configure the gem as follows:
+
+```ruby
+NzPostApi.configure do |config|
+  config.prod = true # set to true for production, defaults to false (UAT)
+end
+```
+
 ### Parcel Address
 
 #### Search

data/lib/nz_post_api/configuration.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module NzPostApi
+  class Configuration
+    attr_accessor :prod
+
+    def initialize
+      @prod = false
+    end
+
+    def base_url
+      if @prod
+        "https://api.nzpost.co.nz"
+      else
+        "https://api.uat.nzpost.co.nz"
+      end
+    end
+  end
+end

data/lib/nz_post_api/resources/parcel_address.rb

@@ -3,14 +3,16 @@
 module NzPostApi
   module Resources
     class ParcelAddress
-      BASE_URL = "https://api.uat.nzpost.co.nz/parceladdress/2.0/domestic/addresses"
+      def base_url
+        "#{NzPostApi.configuration.base_url}/parceladdress/2.0/domestic/addresses"
+      end
 
       def initialize(client)
         @client = client
       end
 
       def search(q:, count: 10)
-        response = @client.connection.get(BASE_URL, { q: q, count: count })
+        response = @client.connection.get(base_url, { q: q, count: count })
 
         if response.success?
           response.body["addresses"].map { |addr| Objects::Address.new(addr) }

data/lib/nz_post_api/resources/parcel_label.rb

@@ -3,24 +3,26 @@
 module NzPostApi
   module Resources
     class ParcelLabel
-      BASE_URL = "https://api.uat.nzpost.co.nz/parcellabel/v3/labels"
+      def base_url
+        "#{NzPostApi.configuration.base_url}/parcellabel/v3/labels"
+      end
 
       def initialize(client)
         @client = client
       end
 
       def create(payload)
-        response = @client.connection.post(BASE_URL, payload)
+        response = @client.connection.post(base_url, payload)
         handle_response(response)
       end
 
       def status(consignment_id)
-        response = @client.connection.get("#{BASE_URL}/#{consignment_id}/status")
+        response = @client.connection.get("#{base_url}/#{consignment_id}/status")
         handle_response(response)
       end
 
       def download(consignment_id, format: "PDF")
-        response = @client.connection.get("#{BASE_URL}/#{consignment_id}", { format: format })
+        response = @client.connection.get("#{base_url}/#{consignment_id}", { format: format })
         if response.success?
           response.body
         else

data/lib/nz_post_api/resources/parcel_track.rb

@@ -3,14 +3,16 @@
 module NzPostApi
   module Resources
     class ParcelTrack
-      BASE_URL = "https://api.uat.nzpost.co.nz/parceltrack/3.0/parcels"
+      def base_url
+        "#{NzPostApi.configuration.base_url}/parceltrack/3.0/parcels"
+      end
 
       def initialize(client)
         @client = client
       end
 
       def track(tracking_reference)
-        response = @client.connection.get("#{BASE_URL}/#{tracking_reference}")
+        response = @client.connection.get("#{base_url}/#{tracking_reference}")
 
         if response.success?
           Objects::ParcelTrack.new(response.body["results"])
@@ -24,7 +26,7 @@ module NzPostApi
           tracking_reference: tracking_reference,
           notification_endpoint: notification_endpoint
         }
-        response = @client.connection.post("#{BASE_URL.sub('parcels', 'subscription/webhook/')}", payload)
+        response = @client.connection.post("#{base_url.sub('parcels', 'subscription/webhook/')}", payload)
 
         if response.success?
           Objects::ParcelTrackSubscription.new(response.body)
@@ -34,7 +36,7 @@ module NzPostApi
       end
 
       def unsubscribe(subscription_guid:)
-        response = @client.connection.delete("#{BASE_URL.sub('parcels', 'subscription/webhook')}/#{subscription_guid}")
+        response = @client.connection.delete("#{base_url.sub('parcels', 'subscription/webhook')}/#{subscription_guid}")
 
         if response.success?
           true

data/lib/nz_post_api/resources/shipping_option.rb

@@ -3,14 +3,16 @@
 module NzPostApi
   module Resources
     class ShippingOption
-      BASE_URL = "https://api.uat.nzpost.co.nz/shippingoptions/2.0/domestic"
+      def base_url
+        "#{NzPostApi.configuration.base_url}/shippingoptions/2.0/domestic"
+      end
 
       def initialize(client)
         @client = client
       end
 
       def list(params = {})
-        response = @client.connection.get(BASE_URL, params)
+        response = @client.connection.get(base_url, params)
 
         if response.success?
           Objects::ShippingOption.new(response.body)

data/lib/nz_post_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module NzPostApi
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/nz_post_api.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "nz_post_api/version"
+require_relative "nz_post_api/configuration"
 require_relative "nz_post_api/objects/base"
 require_relative "nz_post_api/objects/address"
 require_relative "nz_post_api/objects/label"
@@ -16,5 +17,14 @@ require_relative "nz_post_api/resources/parcel_track"
 
 module NzPostApi
   class Error < StandardError; end
-  # Your code goes here...
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nz_post_api
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Andy Chong
@@ -70,6 +70,7 @@ files:
 - lib/nz_post_api.rb
 - lib/nz_post_api/auth.rb
 - lib/nz_post_api/client.rb
+- lib/nz_post_api/configuration.rb
 - lib/nz_post_api/objects/address.rb
 - lib/nz_post_api/objects/base.rb
 - lib/nz_post_api/objects/label.rb