abn_lookup 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 276141b6aaae5383c076b6b2ab7a17536a56e38c296fab584e6ed27873c94ef7
-  data.tar.gz: ab311bca6af0587a06811776a387898d4d40d082d5c89891784b071fe343f79c
+  metadata.gz: 16decb392208f999b3723e09636178b22b321a748c898ff99a527c92acdffcf4
+  data.tar.gz: 4b1026420192d43e40322deb6b6d6364885cc37600b684036966b229fec5383d
 SHA512:
-  metadata.gz: 696b8cf8190be707c30acd77ddf990d1ca17197f32514304488b457ef7511651b6487f265ccf30af2d2f04858309f774c720776f381d4680b330b57a90ef2e3d
-  data.tar.gz: 74f09efa50d894a986dd906dd601151f0f51d73103e4824f08a245a679b820c92de84cdefbcf3916a262c6a1e5d54c2c122198356dd4818cf61d12d0d5406304
+  metadata.gz: a76b10768152aab4128cec7ebbbd660bda45ba8943cad6d7f64f60e5a7258e8edf27352b805a964098b2cf9a577444ff9e3d1e47a5728beeaf4c748eb21c2c0f
+  data.tar.gz: 1731b48946798a19b11b9ecd77d5784df31e0bfbd9d663dd6f8b2f2cadc555505731696093f5be2d1e368edfe318cd250be7fcae6288cfb62ca3048123781ec8

data/README.md

@@ -16,7 +16,7 @@ If bundler is not being used to manage dependencies, install the gem by executin
 
 ## Usage
 
-First step is configure you GUID key. You can request a GUID key [here](https://abr.business.gov.au/Tools/WebServices) in contact us session
+First step is configure your GUID key. You can request a GUID key [here](https://abr.business.gov.au/Tools/WebServices) in contact us session
 
 ```ruby
 AbnLookup.guid = "your_GUID_key"
@@ -30,13 +30,13 @@ If you are using Ruby On Rails you can put this in initializer folder.
 ```ruby
 AbnLookup.search_by_abn("26008672179")
 
-=> {"Abn"=>"26008672179",
- "AbnStatus"=>"Active",
- "AbnStatusEffectiveFrom"=>"1999-11-01",
- "Acn"=>"008672179",
- "AddressDate"=>"2022-01-13",
- "AddressPostcode"=>"3121",
- "AddressState"=>"VIC",
+=> {"Abn" => "26008672179",
+ "AbnStatus" => "Active",
+ "AbnStatusEffectiveFrom" => "1999-11-01",
+ "Acn" => "008672179",
+ "AddressDate" => "2022-01-13",
+ "AddressPostcode" => "3121",
+ "AddressState" => "VIC",
  "BusinessName"=>
   ["Dynamic Pods",
    "Dynamic Steel Frame",
@@ -67,24 +67,24 @@ AbnLookup.search_by_abn("26008672179")
    "NARELLAN HOMEMAKER CENTRE",
    "BUNNINGS WAREHOUSE",
    "HARDWARE CAFE"],
- "EntityName"=>"BUNNINGS GROUP LIMITED",
- "EntityTypeCode"=>"PUB",
- "EntityTypeName"=>"Australian Public Company",
- "Gst"=>"2000-07-01",
- "Message"=>""}
+ "EntityName" => "BUNNINGS GROUP LIMITED",
+ "EntityTypeCode" => "PUB",
+ "EntityTypeName" => "Australian Public Company",
+ "Gst" => "2000-07-01",
+ "Message" => ""}
 ```
 ### Search by ACN
 
 ```ruby
 AbnLookup.search_by_acn("008672179")
 
-=> {"Abn"=>"26008672179",
- "AbnStatus"=>"Active",
- "AbnStatusEffectiveFrom"=>"1999-11-01",
- "Acn"=>"008672179",
- "AddressDate"=>"2022-01-13",
- "AddressPostcode"=>"3121",
- "AddressState"=>"VIC",
+=> {"Abn" => "26008672179",
+ "AbnStatus" => "Active",
+ "AbnStatusEffectiveFrom" => "1999-11-01",
+ "Acn" => "008672179",
+ "AddressDate" => "2022-01-13",
+ "AddressPostcode" => "3121",
+ "AddressState" => "VIC",
  "BusinessName"=>
   ["Dynamic Pods",
    "Dynamic Steel Frame",
@@ -115,30 +115,108 @@ AbnLookup.search_by_acn("008672179")
    "NARELLAN HOMEMAKER CENTRE",
    "BUNNINGS WAREHOUSE",
    "HARDWARE CAFE"],
- "EntityName"=>"BUNNINGS GROUP LIMITED",
- "EntityTypeCode"=>"PUB",
- "EntityTypeName"=>"Australian Public Company",
- "Gst"=>"2000-07-01",
- "Message"=>""}
+ "EntityName" => "BUNNINGS GROUP LIMITED",
+ "EntityTypeCode" => "PUB",
+ "EntityTypeName" => "Australian Public Company",
+ "Gst" => "2000-07-01",
+ "Message" => ""}
 ```
 ### Search by Name
 
 ```ruby
 AbnLookup.search_by_name("Dynamic Pods", max_result = 10)
 
-=> {"Message"=>"",
+=> {"Message" => "",
  "Names"=>
-  [{"Abn"=>"89619123287", "AbnStatus"=>"0000000001", "IsCurrent"=>true, "Name"=>"Dynamic Pods", "NameType"=>"Business Name", "Postcode"=>"3111", "Score"=>100, "State"=>"VIC"},
-   {"Abn"=>"26008672179", "AbnStatus"=>"0000000001", "IsCurrent"=>true, "Name"=>"Dynamic Pods", "NameType"=>"Business Name", "Postcode"=>"3121", "Score"=>100, "State"=>"VIC"},
-   {"Abn"=>"89619123287", "AbnStatus"=>"0000000001", "IsCurrent"=>true, "Name"=>"DYNAMIC PODS PTY LTD", "NameType"=>"Entity Name", "Postcode"=>"3111", "Score"=>99, "State"=>"VIC"},
-   {"Abn"=>"47051861468", "AbnStatus"=>"0000000002", "IsCurrent"=>true, "Name"=>"@ DYNAMIC PTY LTD", "NameType"=>"Entity Name", "Postcode"=>"2000", "Score"=>94, "State"=>"NSW"},
-   {"Abn"=>"91451385418", "AbnStatus"=>"0000000002", "IsCurrent"=>true, "Name"=>"DYNAMIC", "NameType"=>"Trading Name", "Postcode"=>"4105", "Score"=>94, "State"=>"QLD"},
-   {"Abn"=>"55666163917", "AbnStatus"=>"0000000001", "IsCurrent"=>true, "Name"=>"DYNAMIC CO PTY LTD", "NameType"=>"Entity Name", "Postcode"=>"4035", "Score"=>94, "State"=>"QLD"},
-   {"Abn"=>"47294848908", "AbnStatus"=>"0000000002", "IsCurrent"=>true, "Name"=>"DYNAMIC PTY LTD", "NameType"=>"Trading Name", "Postcode"=>"3204", "Score"=>94, "State"=>"VIC"},
-   {"Abn"=>"63006924349", "AbnStatus"=>"0000000002", "IsCurrent"=>true, "Name"=>"DYNAMIC PTY. LTD.", "NameType"=>"Entity Name", "Postcode"=>"3059", "Score"=>94, "State"=>"VIC"},
-   {"Abn"=>"84622042537", "AbnStatus"=>"0000000002", "IsCurrent"=>true, "Name"=>"DYnamic", "NameType"=>"Trading Name", "Postcode"=>"2000", "Score"=>94, "State"=>"NSW"},
-   {"Abn"=>"55274753082", "AbnStatus"=>"0000000001", "IsCurrent"=>true, "Name"=>"Dynamic", "NameType"=>"Other Name", "Postcode"=>"5085", "Score"=>94, "State"=>"SA"}]}
+  [{"Abn" => "89619123287", "AbnStatus" => "0000000001", "IsCurrent"=>true, "Name" => "Dynamic Pods", "NameType" => "Business Name", "Postcode" => "3111", "Score"=>100, "State" => "VIC"},
+   {"Abn" => "26008672179", "AbnStatus" => "0000000001", "IsCurrent"=>true, "Name" => "Dynamic Pods", "NameType" => "Business Name", "Postcode" => "3121", "Score"=>100, "State" => "VIC"},
+   {"Abn" => "89619123287", "AbnStatus" => "0000000001", "IsCurrent"=>true, "Name" => "DYNAMIC PODS PTY LTD", "NameType" => "Entity Name", "Postcode" => "3111", "Score"=>99, "State" => "VIC"},
+   {"Abn" => "47051861468", "AbnStatus" => "0000000002", "IsCurrent"=>true, "Name" => "@ DYNAMIC PTY LTD", "NameType" => "Entity Name", "Postcode" => "2000", "Score"=>94, "State" => "NSW"},
+   {"Abn" => "91451385418", "AbnStatus" => "0000000002", "IsCurrent"=>true, "Name" => "DYNAMIC", "NameType" => "Trading Name", "Postcode" => "4105", "Score"=>94, "State" => "QLD"},
+   {"Abn" => "55666163917", "AbnStatus" => "0000000001", "IsCurrent"=>true, "Name" => "DYNAMIC CO PTY LTD", "NameType" => "Entity Name", "Postcode" => "4035", "Score"=>94, "State" => "QLD"},
+   {"Abn" => "47294848908", "AbnStatus" => "0000000002", "IsCurrent"=>true, "Name" => "DYNAMIC PTY LTD", "NameType" => "Trading Name", "Postcode" => "3204", "Score"=>94, "State" => "VIC"},
+   {"Abn" => "63006924349", "AbnStatus" => "0000000002", "IsCurrent"=>true, "Name" => "DYNAMIC PTY. LTD.", "NameType" => "Entity Name", "Postcode" => "3059", "Score"=>94, "State" => "VIC"},
+   {"Abn" => "84622042537", "AbnStatus" => "0000000002", "IsCurrent"=>true, "Name" => "DYnamic", "NameType" => "Trading Name", "Postcode" => "2000", "Score"=>94, "State" => "NSW"},
+   {"Abn" => "55274753082", "AbnStatus" => "0000000001", "IsCurrent"=>true, "Name" => "Dynamic", "NameType" => "Other Name", "Postcode" => "5085", "Score"=>94, "State" => "SA"}]}
 ```
+
+## Testing
+When writing tests for an app using AbnLookup  may be is a good ideia to avoid network calls and have return consistent, configurable results. To do this:
+
+
+**Adding a stub to search_by_abn:**
+
+```ruby
+
+AbnLookup::Test.stub_search_by_abn("26008672179",
+  AbnLookup::Abn.parse(
+    {
+      "Abn" => "26008672179",
+      "AbnStatus" => "Active",
+      "AbnStatusEffectiveFrom" => "1999-11-01",
+      "Acn" => "008672179",
+      "AddressDate" => "2022-01-13",
+      "AddressPostcode" => "3121",
+      "AddressState" => "VIC",
+      "BusinessName"=> [
+        "Dynamic Pods",
+        "Dynamic Steel Frame",
+        "TOOL KIT DEPOT",
+      ],
+      "EntityName" => "BUNNINGS GROUP LIMITED",
+      "EntityTypeCode" => "PUB",
+      "EntityTypeName" => "Australian Public Company",
+      "Gst" => "2000-07-01",
+      "Message" => ""
+    }
+  )
+)
+
+AbnLookup.search_by_abn("26008672179")
+
+=> #<AbnLookup::Abn:0x3570940 @abn="26008672179" @acn="008672179" @active="true" @gst="2000-07-01" @entity_name="BUNNINGS GROUP LIMITED">
+
+
+```
+
+
+**Adding a stub to search_by_acn:**
+
+
+
+```ruby
+
+AbnLookup::Test.stub_search_by_acn("008672179",
+  AbnLookup::Abn.parse(
+    {
+      "Abn" => "26008672179",
+      "AbnStatus" => "Active",
+      "AbnStatusEffectiveFrom" => "1999-11-01",
+      "Acn" => "008672179",
+      "AddressDate" => "2022-01-13",
+      "AddressPostcode" => "3121",
+      "AddressState" => "VIC",
+      "BusinessName"=>[
+        "Dynamic Pods",
+        "Dynamic Steel Frame",
+        "TOOL KIT DEPOT"
+      ],
+      "EntityName" => "BUNNINGS GROUP LIMITED",
+      "EntityTypeCode" => "PUB",
+      "EntityTypeName" => "Australian Public Company",
+      "Gst" => "2000-07-01",
+      "Message" => ""
+    }
+  )
+)
+
+AbnLookup.search_by_acn("008672179")
+
+=> #<AbnLookup::Abn:0x3570940 @abn="26008672179" @acn="008672179" @active="true" @gst="2000-07-01" @entity_name="BUNNINGS GROUP LIMITED">
+
+
+```
+
 ## 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.

data/lib/abn_lookup/abn.rb

@@ -9,7 +9,7 @@ module AbnLookup
     end
 
     def inspect
-      "#<#{self.class.name}:0x#{object_id} @abn=\"#{abn}\" @acn=\"#{acn}\" @active=\"#{active?}\" @gst=\"#{gst}\" @entity_name=\"#{entity_name}}\""
+      "#<#{self.class.name}:0x#{object_id} @abn=\"#{abn}\" @acn=\"#{acn}\" @active=#{active?} @gst=\"#{gst}\" @entity_name=\"#{entity_name}\">"
     end
 
     def self.parse(data)

data/lib/abn_lookup/search_by_abn.rb

@@ -2,14 +2,25 @@
 
 module AbnLookup
   class SearchByAbn
-    def self.fetch(abn)
-      response = AbnLookup.connection.get("AbnDetails.aspx?abn=#{abn.gsub(/\s/, '')}")
-      body  = response.body
+    class << self
+      attr_accessor :stubs, :default_stub
 
-      raise InvalidGuidError if body["Message"] == "The GUID entered is not recognised as a Registered Party"
-      raise AbnNotFoundError if body["Abn"].empty?
+      def fetch(abn, options = {})
+        stub = stubs[abn] || default_stub
+        return stub if stub
 
-      Abn.parse(body)
+        parse = options.fetch(:parse, true)
+        response = AbnLookup.connection.get("AbnDetails.aspx?abn=#{abn.gsub(/\s/, '')}")
+        body  = response.body
+
+        raise InvalidGuidError if body["Message"] == "The GUID entered is not recognised as a Registered Party"
+        raise AbnNotFoundError if body["Abn"].empty? || body["Message"] == "No record found"
+
+        parse ? Abn.parse(body) : body
+      end
     end
+
+    @stubs = {}
+    @default_stub = nil
   end
 end

data/lib/abn_lookup/search_by_acn.rb

@@ -2,14 +2,25 @@
 
 module AbnLookup
   class SearchByAcn
-    def self.fetch(acn)
-      response = AbnLookup.connection.get("AcnDetails.aspx?acn=#{acn.gsub(/\s/, '')}")
-      response.body
+    class << self
+      attr_accessor :stubs, :default_stub
 
-      raise InvalidGuidError if body["Message"] == "The GUID entered is not recognised as a Registered Party"
-      raise AbnNotFoundError if body["Abn"].empty?
+      def fetch(acn, options = {})
+        stub = stubs[acn] || default_stub
+        return stub if stub
 
-      Abn.parse(body)
+        parse = options.fetch(:parse, true)
+        response = AbnLookup.connection.get("AcnDetails.aspx?acn=#{acn.gsub(/\s/, '')}")
+        body  = response.body
+
+        raise InvalidGuidError if body["Message"] == "The GUID entered is not recognised as a Registered Party"
+        raise AbnNotFoundError if body["Abn"].empty? || body["Message"] == "No record found"
+
+        parse ? Abn.parse(body) : body
+      end
     end
+
+    @stubs = {}
+    @default_stub = nil
   end
 end

data/lib/abn_lookup/test.rb

@@ -0,0 +1,27 @@
+module AbnLookup
+  module Test
+    def self.stub_search_by_abn(abn, result)
+      SearchByAbn.stubs[abn] = result
+    end
+
+    def self.stub_search_by_acn(acn, result)
+      SearchByAcn.stubs[acn] = result
+    end
+
+    def self.stub_search_by_name(name, result)
+      SearchByName.stubs[name] = result
+    end
+
+    def self.clear_stubs
+      SearchByAbn.stubs.clear
+      SearchByAcn.stubs.clear
+      SearchByName.stubs.clear
+    end
+
+    def self.set_default_stub(result)
+      SearchByAbn.default_stub = result
+      SearchByAcn.default_stub = result
+      SearchByName.default_stub = result
+    end
+  end
+end

data/lib/abn_lookup/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AbnLookup
-  VERSION = "0.2.1"
+  VERSION = "0.2.3"
 end

data/lib/abn_lookup.rb

@@ -9,6 +9,7 @@ require "abn_lookup/search_by_name"
 require "abn_lookup/abn"
 require "abn_lookup/abn_not_found_error"
 require "abn_lookup/invalid_guid_error"
+require "abn_lookup/test"
 
 require "faraday"
 require "faraday_middleware"
@@ -25,11 +26,11 @@ module AbnLookup
 
     def_delegators :@config, :guid, :guid=
 
-    def search_by_abn(abn)
-      SearchByAbn.fetch(abn)
+    def search_by_abn(abn, options = {})
+      SearchByAbn.fetch(abn, options)
     end
 
-    def search_by_acn(acn)
+    def search_by_acn(acn, options = {})
       SearchByAcn.fetch(acn)
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: abn_lookup
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.3
 platform: ruby
 authors:
 - Lairton Mendes
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-06-03 00:00:00.000000000 Z
+date: 2024-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -62,6 +62,7 @@ files:
 - lib/abn_lookup/search_by_abn.rb
 - lib/abn_lookup/search_by_acn.rb
 - lib/abn_lookup/search_by_name.rb
+- lib/abn_lookup/test.rb
 - lib/abn_lookup/version.rb
 - sig/abn_lookup.rbs
 homepage: