postcodes_io 0.1.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ad9cc32017365faafe6c67cf7d18da5aa5010e1b
-  data.tar.gz: b04650165b7ec3830d90f1fc5eec3ce617273868
+SHA256:
+  metadata.gz: 2c6a93dd223ae7a6cc8c04b1f7079f955eb4d93d0ebab8bd14f6cffa87f57b82
+  data.tar.gz: 28052e4ba75fa32901fc03b8997cbc67575df1e97c7902fbead915086b88f758
 SHA512:
-  metadata.gz: ec45114d531178260c93decbc083b0b4b7d6a02ae45aee0730c6658d18b3b79d0a1b776387099dd6685e6826e9573d51d019f3d1eedc56aaad4277e424408485
-  data.tar.gz: 890e6ca0d609aaf1204a6269c6b3426b71e8c2a67d3c06651b40b663cb186238ecacf48f1a1180786f08a1a1cddf168e229b4e076a5dc29fcb947bad7d7c5c8c
+  metadata.gz: 3cb7ab91ceba1f04d2aed32d96a5c4b1c9754c06fef797246311ed340aeaa78cd69157f05f59a9a47d04f6ba3c8d66a537108cd361f00940d30a3189e88b1342
+  data.tar.gz: e91286586e6dd99db43ae487df61d621df6e623877facc54117a132eab964a2f8d506c3c27fb8655d956a771bce39ec0859f3398b3375253b54b2766b678fe2f

data/.github/workflows/gem-push.yml

@@ -0,0 +1,43 @@
+name: Ruby Gem
+
+on:
+  push:
+    branches: [ master ]
+
+jobs:
+  build:
+    name: Build + Publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby 2.6
+      uses: actions/setup-ruby@v1
+      with:
+        ruby-version: 2.6.x
+
+    - name: Publish to GPR
+      run: |
+        mkdir -p $HOME/.gem
+        touch $HOME/.gem/credentials
+        chmod 0600 $HOME/.gem/credentials
+        printf -- "---\n:github: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+        gem build *.gemspec
+        gem push --KEY github --host https://rubygems.pkg.github.com/${OWNER} *.gem
+      env:
+        GEM_HOST_API_KEY: "Bearer ${{secrets.GITHUB_TOKEN}}"
+        OWNER: ${{ github.repository_owner }}
+
+    - name: Publish to RubyGems
+      run: |
+        mkdir -p $HOME/.gem
+        touch $HOME/.gem/credentials
+        chmod 0600 $HOME/.gem/credentials
+        printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+        gem build *.gemspec
+        gem push *.gem
+      env:
+        GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_AUTH_TOKEN}}"

data/.github/workflows/ruby.yml

@@ -0,0 +1,35 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
+# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
+
+name: Ruby
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: ['2.6', '2.7', '3.0']
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+    # To automatically get bug fixes and new Ruby versions for ruby/setup-ruby,
+    # change this to (see https://github.com/ruby/setup-ruby#versioning):
+    # uses: ruby/setup-ruby@v1
+      uses: ruby/setup-ruby@473e4d8fe5dd94ee328fdfca9f8c9c7afc9dae5e
+      with:
+        ruby-version: ${{ matrix.ruby-version }}
+        bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+    - name: Run tests
+      run: bundle exec rake

data/.gitignore

@@ -12,3 +12,4 @@
 *.o
 *.a
 mkmf.log
+.idea/

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+ - 2.3

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2014 TODO: Write your name
+Copyright (c) 2015 James Ruston
 
 MIT License
 

data/README.md

@@ -1,3 +1,4 @@
+[![Build Status](https://travis-ci.org/jamesruston/postcodes_io.svg?branch=master)](https://travis-ci.org/jamesruston/postcodes_io) [![Gem Version](https://badge.fury.io/rb/postcodes_io.svg)](https://badge.fury.io/rb/postcodes_io)
 # PostcodesIo
 
 A simple wrapper around [postcodes.io](http://postcodes.io/)
@@ -23,16 +24,16 @@ Or install it yourself as:
 Require the gem
 
 ```ruby
-require 'PostcodesIO'
+require 'postcodes_io'
 ```
 
-Create new instance of the Postcode::IO
+Create new instance of the Postcodes::IO
 
 ```ruby
 pio = Postcodes::IO.new
 ```
 
-Lookup a postcode
+### Lookup a postcode
 ```ruby
 postcode = pio.lookup('NN12 8TN')
 ```
@@ -43,7 +44,44 @@ postcode.longitude # -1.02144562675883
 postcode.latitude # 52.0776806788868
 ```
 
-##All available fields
+### Make a batch postcode lookup request
+
+> max 100 postcodes per request
+
+```ruby
+postcodes = pio.lookup('NN12 8TN', 'DA3 8NG') # or pio.lookup(['NN12 8TN', 'DA3 8NG'])
+postcodes.each do |p|
+  puts p.nuts
+end
+```
+
+### Autocomplete a postcode
+
+```ruby
+postcodes = pio.autocomplete('NN12')
+puts postcodes.list # ["NN12 6AA", "NN12 6AB", "NN12 6AD", "NN12 6AE", "NN12 6AF", "NN12 6AG", "NN12 6AH", "NN12 6AJ", "NN12 6AL", "NN12 6AN"]
+```
+
+
+### Perform a reverse geocode lookup
+
+```ruby
+postcodes = pio.reverse_geocode(longitude: 0.629834, latitude: 51.79232)
+puts postcodes.first.postcode # CM8 1EF
+```
+
+### Lookup a terminated postcode
+```ruby
+postcode = pio.lookup_terminated('SO23 7SP')
+```
+
+Inspect the results!
+```ruby
+postcode.longitude # -1.02144562675883
+postcode.latitude # 52.0776806788868
+```
+
+### All available fields
 
 |name|description|
 |----|-----------|
@@ -64,14 +102,14 @@ postcode.latitude # 52.0776806788868
 |region| [former GORs](http://www.ons.gov.uk/ons/guide-method/geography/beginner-s-guide/administrative/england/government-office-regions/index.html)|
 |parish| The smallest type of administrative area|
 |lsoa| [The 2011 Census lower layer SOA code](http://www.ons.gov.uk/ons/guide-method/geography/beginner-s-guide/census/super-output-areas--soas-/index.html)|
-|msoa| [The 2011 Census middle layer SOA (MSOA) code](The 2011 Census lower layer SOA code for England and Wales](http://www.ons.gov.uk/ons/guide-method/geography/beginner-s-guide/census/super-output-areas--soas-/index.html)|
+|msoa| [The 2011 Census middle layer SOA (MSOA) code](http://www.ons.gov.uk/ons/guide-method/geography/beginner-s-guide/census/super-output-areas--soas-/index.html)|
 |ccg| Clinical Commissioning Group |
 |nuts| [see here](http://en.wikipedia.org/wiki/Nomenclature_of_Territorial_Units_for_Statistics)|
 
 For more details see [the documentation on postcodes.io](http://postcodes.io/docs)
 ## Contributing
 
-1. Fork it ( https://github.com/[my-github-username]/postcodes_io/fork )
+1. Fork it ( https://github.com/jamesruston/postcodes_io/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`)

data/Rakefile

@@ -1,5 +1,10 @@
-require "bundler/gem_tasks"
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) 
+
+task default: :spec
 
 task :console do
   exec "irb -r postcodes_io -I ./lib"
-end
+end

data/lib/postcodes_io/autocomplete.rb

@@ -0,0 +1,37 @@
+require 'excon'
+require 'json'
+require 'postcodes_io/autocomplete_list'
+
+module Postcodes
+  module Autocomplete
+
+    def autocomplete(postcode)
+      autocomplete_postcode postcode
+    end
+
+    private
+
+    def autocomplete_postcode(postcode)
+      postcode = remove_whitespace postcode
+      response = Excon.get("https://api.postcodes.io/postcodes/#{postcode}/autocomplete")
+
+      unless response.status == 404
+        parsed_response = JSON.parse(response.body)
+        return Postcodes::AutocompleteList.new(parsed_response['result'])
+      end
+      return nil
+    end
+
+    def remove_whitespace(string)
+      string.gsub(/\s+/, '')
+    end
+
+    def process_response(response, &block)
+      unless response.status == 404
+        yield JSON.parse(response.body)
+      end
+      nil
+    end
+
+  end
+end

data/lib/postcodes_io/autocomplete_list.rb

@@ -0,0 +1,12 @@
+require "postcodes_io/base"
+
+module Postcodes
+  class AutocompleteList < Base
+
+    attr_reader :list
+
+    def initialize(list)
+      @list = list
+    end
+  end
+end

data/lib/postcodes_io/base.rb

@@ -0,0 +1,10 @@
+module Postcodes
+  class Base
+    # allow accessing info values with dot notation
+    def method_missing(name, *args, &block)
+      return @info[name.to_s] if @info.key? name.to_s
+      return @info[name] if @info.key? name
+      super.method_missing name
+    end
+  end
+end

data/lib/postcodes_io/lookup.rb

@@ -4,14 +4,56 @@ require 'postcodes_io/postcode'
 
 module Postcodes
   module Lookup
-    def lookup(postcode)
-      postcode.gsub!(/\s+/, '') # remove any whitespace. m1 1ab => m11ab
+
+
+    def lookup(*postcodes)
+      postcodes.flatten!
+      if postcodes.count > 1
+        lookup_multiple postcodes
+      else
+        lookup_postcode postcodes.first
+      end
+    end
+          
+
+    private
+
+    def lookup_postcode(postcode)
+      postcode = remove_whitespace postcode
       response = Excon.get("https://api.postcodes.io/postcodes/#{postcode}")
+
       unless response.status == 404
         parsed_response = JSON.parse(response.body)
         return Postcodes::Postcode.new(parsed_response['result'])
       end
       return nil
     end
+
+    def lookup_multiple(postcodes)
+      payload = {postcodes: postcodes.map {|p| remove_whitespace p}}
+      response = Excon.post(
+        "https://api.postcodes.io/postcodes",
+         body: payload.to_json,
+         headers: {'Content-Type' => 'application/json'}
+         )
+
+      process_response(response) do |r|
+        return r['result'].map do |result|
+          Postcodes::Postcode.new(result['result'])
+        end
+      end
+    end
+
+    def remove_whitespace(string)
+      string.gsub(/\s+/, '') # remove any whitespace. m1 1ab => m11ab
+    end
+
+    def process_response(response, &block)
+      unless response.status == 404
+        yield JSON.parse(response.body)
+      end
+      nil
+    end
+
   end
 end

data/lib/postcodes_io/lookup_terminated.rb

@@ -0,0 +1,33 @@
+require 'excon'
+require 'json'
+require 'postcodes_io/postcode'
+
+module Postcodes
+  module LookupTerminated
+    def lookup_terminated(postcode)
+      lookup_terminated_postcode postcode
+    end
+
+    private
+
+    def lookup_terminated_postcode(postcode)
+      postcode = remove_whitespace postcode
+      response = Excon.get("https://api.postcodes.io/terminated_postcodes/#{postcode}")
+
+      unless response.status == 404
+        parsed_response = JSON.parse(response.body)
+        return Postcodes::Postcode.new(parsed_response['result'])
+      end
+      nil
+    end
+
+    def remove_whitespace(string)
+      string.gsub(/\s+/, '') # remove any whitespace. m1 1ab => m11ab
+    end
+
+    def process_response(response)
+      yield JSON.parse(response.body) unless response.status == 404
+      nil
+    end
+  end
+end

data/lib/postcodes_io/postcode.rb

@@ -1,17 +1,12 @@
+require "postcodes_io/base"
+
 module Postcodes
-  class Postcode
+  class Postcode < Base
 
     attr_reader :info
 
     def initialize(info)
       @info = info
     end
-
-    # allow accessing info values with dot notation
-    def method_missing(name, *args, &block)
-      return @info[name] if @info.key? name
-      @info.each { |k,v| return v if k.to_s.to_sym == name }
-      super.method_missing name
-    end
   end
 end

data/lib/postcodes_io/reverse_geocode.rb

@@ -0,0 +1,20 @@
+require 'excon'
+require 'json'
+require 'postcodes_io/postcode'
+
+module Postcodes
+  module ReverseGeocode
+    def reverse_geocode(longitude:, latitude:, limit: 10, radius: 100, wide_search: false)
+      response = Excon.get(
+        "https://api.postcodes.io/postcodes?lon=#{longitude}&lat=#{latitude}&limit=#{limit}&radius=#{radius}&wideSearch=#{wide_search}")
+      return unless response.status == 200
+
+      json = JSON.parse(response.body)
+      return unless json['result']
+
+      json['result'].map do |result|
+        Postcode.new(result)
+      end
+    end
+  end
+end

data/lib/postcodes_io/version.rb

@@ -1,3 +1,3 @@
 module Postcodes
-  VERSION = "0.1.0"
+  VERSION = "0.4.0"
 end

data/lib/postcodes_io.rb

@@ -1,9 +1,15 @@
-require "postcodes_io/version"
-require "postcodes_io/lookup"
-require "postcodes_io/postcode"
+require 'postcodes_io/version'
+require 'postcodes_io/lookup'
+require 'postcodes_io/autocomplete'
+require 'postcodes_io/postcode'
+require 'postcodes_io/reverse_geocode'
+require 'postcodes_io/lookup_terminated'
 
 module Postcodes
   class IO
     include Lookup
+    include Autocomplete
+    include ReverseGeocode
+    include LookupTerminated
   end
 end

data/postcodes_io.gemspec

@@ -18,8 +18,8 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.7"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"
   spec.add_development_dependency "webmock"
 

data/spec/autocomplete_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe Postcodes::IO do
+
+  let(:base_url) {'https://api.postcodes.io'}
+  let(:stub_autocomplete) { File.read('spec/fixtures/autocomplete_response.json') }
+
+  describe '#autocomplete' do
+
+    before :each do
+      stub_request(:get, "#{base_url}/postcodes/NN10/autocomplete")
+          .to_return(status: 200, body: stub_autocomplete)
+    end
+
+    let(:input) { 'NN10' }
+    let(:output) { subject.autocomplete(input) }
+
+    it 'requests a postcode' do
+      output
+      WebMock.should have_requested(:get, "#{base_url}/postcodes/NN10/autocomplete")
+    end
+
+    it 'returns autocompleted array' do
+      expect(output.list).to eq(["NN10 0AA",
+                                 "NN10 0AD",
+                                 "NN10 0AE",
+                                 "NN10 0AF",
+                                 "NN10 0AG",
+                                 "NN10 0AH",
+                                 "NN10 0AJ",
+                                 "NN10 0AL",
+                                 "NN10 0AN",
+                                 "NN10 0AP"])
+    end
+  end
+end

data/spec/fixtures/autocomplete_response.json

@@ -0,0 +1,14 @@
+{
+  "result": [
+    "NN10 0AA",
+    "NN10 0AD",
+    "NN10 0AE",
+    "NN10 0AF",
+    "NN10 0AG",
+    "NN10 0AH",
+    "NN10 0AJ",
+    "NN10 0AL",
+    "NN10 0AN",
+    "NN10 0AP"
+  ]
+}

data/spec/fixtures/lookup_multi_response.json

@@ -0,0 +1,86 @@
+{
+    "status": 200,
+    "result": [
+        {
+            "query": "OX49 5NU",
+            "result": {
+                "postcode": "OX49 5NU",
+                "quality": 1,
+                "eastings": 464435,
+                "northings": 195686,
+                "country": "England",
+                "nhs_ha": "South Central",
+                "admin_county": "Oxfordshire",
+                "admin_district": "South Oxfordshire",
+                "admin_ward": "Benson",
+                "longitude": -1.06993881320412,
+                "latitude": 51.6562791294687,
+                "parliamentary_constituency": "Henley",
+                "european_electoral_region": "South East",
+                "primary_care_trust": "Oxfordshire",
+                "region": "South East",
+                "parish": "Brightwell Baldwin",
+                "lsoa": "South Oxfordshire 011B",
+                "msoa": "South Oxfordshire 011",
+                "nuts": "Benson",
+                "incode": "5NU",
+                "outcode": "OX49",
+                "ccg": "NHS Oxfordshire CCG"
+            }
+        },
+        {
+            "query": "M32 0JG",
+            "result": {
+                "postcode": "M32 0JG",
+                "quality": 1,
+                "eastings": 379988,
+                "northings": 395476,
+                "country": "England",
+                "nhs_ha": "North West",
+                "admin_county": null,
+                "admin_district": "Trafford",
+                "admin_ward": "Gorse Hill",
+                "longitude": -2.30283674284007,
+                "latitude": 53.4556572899372,
+                "parliamentary_constituency": "Stretford and Urmston",
+                "european_electoral_region": "North West",
+                "primary_care_trust": "Trafford",
+                "region": "North West",
+                "parish": null,
+                "lsoa": "Trafford 003C",
+                "msoa": "Trafford 003",
+                "nuts": "Gorse Hill",
+                "incode": "0JG",
+                "outcode": "M32",
+                "ccg": "NHS Trafford CCG"
+            }
+        },
+        {
+            "query": "NE30 1DP",
+            "result": {
+                "postcode": "NE30 1DP",
+                "quality": 1,
+                "eastings": 435982,
+                "northings": 568683,
+                "country": "England",
+                "nhs_ha": "North East",
+                "admin_county": null,
+                "admin_district": "North Tyneside",
+                "admin_ward": "Tynemouth",
+                "longitude": -1.43889223951028,
+                "latitude": 55.0114112900573,
+                "parliamentary_constituency": "Tynemouth",
+                "european_electoral_region": "North East",
+                "primary_care_trust": "North Tyneside",
+                "region": "North East",
+                "parish": null,
+                "lsoa": "North Tyneside 016C",
+                "msoa": "North Tyneside 016",
+                "nuts": "Tynemouth",
+                "incode": "1DP",
+                "outcode": "NE30",
+                "ccg": "NHS North Tyneside CCG"
+            }
+        }
+    ]
+}

data/spec/fixtures/lookup_terminated_response.json

@@ -0,0 +1,10 @@
+{
+    "status": 200,
+    "result": {
+      "postcode": "SO23 9DD",
+      "year_terminated": 2001,
+      "month_terminated": 8,
+      "longitude": -1.316261,
+      "latitude": 51.062297
+    }
+}

data/spec/fixtures/no_results_response.json

@@ -0,0 +1 @@
+{"status":200,"result":null}

data/spec/fixtures/reverse_geocode_response.json

@@ -0,0 +1 @@
+{"status":200,"result":[{"postcode":"PR7 4HF","quality":1,"eastings":360059,"northings":412765,"country":"England","nhs_ha":"North West","longitude":-2.60515477763266,"latitude":53.6099106263766,"european_electoral_region":"North West","primary_care_trust":"Central Lancashire","region":"North West","lsoa":"Chorley 014C","msoa":"Chorley 014","incode":"4HF","outcode":"PR7","distance":0,"parliamentary_constituency":"Chorley","admin_district":"Chorley","parish":"Adlington","admin_county":"Lancashire","admin_ward":"Adlington and Anderton","ccg":"NHS Chorley and South Ribble","nuts":"Chorley and West Lancashire","codes":{"admin_district":"E07000118","admin_county":"E10000017","admin_ward":"E05005165","parish":"E04005139","parliamentary_constituency":"E14000637","ccg":"E38000034","nuts":"UKD47"}},{"postcode":"PR7 4HR","quality":1,"eastings":360038,"northings":412741,"country":"England","nhs_ha":"North West","longitude":-2.60546907187036,"latitude":53.6096933152903,"european_electoral_region":"North West","primary_care_trust":"Central Lancashire","region":"North West","lsoa":"Chorley 014C","msoa":"Chorley 014","incode":"4HR","outcode":"PR7","distance":31.90158431,"parliamentary_constituency":"Chorley","admin_district":"Chorley","parish":"Adlington","admin_county":"Lancashire","admin_ward":"Adlington and Anderton","ccg":"NHS Chorley and South Ribble","nuts":"Chorley and West Lancashire","codes":{"admin_district":"E07000118","admin_county":"E10000017","admin_ward":"E05005165","parish":"E04005139","parliamentary_constituency":"E14000637","ccg":"E38000034","nuts":"UKD47"}},{"postcode":"PR7 4HJ","quality":1,"eastings":360076,"northings":412843,"country":"England","nhs_ha":"North West","longitude":-2.60490787349104,"latitude":53.6106129688375,"european_electoral_region":"North West","primary_care_trust":"Central Lancashire","region":"North West","lsoa":"Chorley 014C","msoa":"Chorley 014","incode":"4HJ","outcode":"PR7","distance":79.85903188,"parliamentary_constituency":"Chorley","admin_district":"Chorley","parish":"Adlington","admin_county":"Lancashire","admin_ward":"Adlington and Anderton","ccg":"NHS Chorley and South Ribble","nuts":"Chorley and West Lancashire","codes":{"admin_district":"E07000118","admin_county":"E10000017","admin_ward":"E05005165","parish":"E04005139","parliamentary_constituency":"E14000637","ccg":"E38000034","nuts":"UKD47"}}]}

data/spec/lookup_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+
+describe Postcodes::IO do
+
+  let(:base_url) {'https://api.postcodes.io'}
+  let(:stub_single_response) { File.read('spec/fixtures/lookup_response.json') }
+  let(:stub_multi_response) { File.read('spec/fixtures/lookup_multi_response.json') }
+
+  describe '#lookup' do
+
+    before :each do
+      stub_request(:get, "#{base_url}/postcodes/CM129TR")
+          .to_return(status: 200, body: stub_single_response)
+    end
+
+    let(:input) { 'CM12 9TR' }
+    let(:output) { subject.lookup(input) }
+
+    it 'requests a postcode' do
+      output
+      WebMock.should have_requested(:get, "#{base_url}/postcodes/CM129TR")
+    end
+
+    it 'returns the long and lat' do
+      output.longitude.should == 0.411227930206834
+    end
+  end
+
+  describe '#lookup with multiple postcodes' do
+    before :each do
+      stub_request(:post, "#{base_url}/postcodes")
+          .with(body: postcode_payload, headers: {'Content-Type' => 'application/json'})
+          .to_return(status: 200, body: stub_multi_response)
+    end
+
+    let(:input) { ['OX495NU', 'M320JG', 'NE301DP'] }
+    let(:output) { subject.lookup(input) }
+    let(:postcode_payload) { {postcodes: input}.to_json }
+
+    it 'makes a request with mutliple postcodes' do
+      output
+      WebMock.should have_requested(:post, "#{base_url}/postcodes")
+    end
+
+    it 'returns a postcode object for each result' do
+      output.count.should == 3
+      output.each do |o|
+        o.class.should == Postcodes::Postcode
+      end
+    end
+
+    describe 'as splat' do
+      let(:output) { subject.lookup('OX495NU', 'M320JG', 'NE301DP') }
+
+      it 'allows passing postcodes as multiple arguments' do
+        output
+        WebMock.should have_requested(:post, "#{base_url}/postcodes")
+      end
+
+    end
+  end
+end

data/spec/lookup_terminated_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Postcodes::IO do
+  let(:base_url) { 'https://api.postcodes.io' }
+  let(:stub_response) { File.read('spec/fixtures/lookup_terminated_response.json') }
+
+  describe '#lookup_terminated' do
+    before :each do
+      stub_request(:get, "#{base_url}/terminated_postcodes/CM129TR")
+        .to_return(status: 200, body: stub_response)
+    end
+
+    let(:input) { 'CM12 9TR' }
+    let(:output) { subject.lookup_terminated(input) }
+
+    it 'requests a terminated postcode' do
+      output
+      WebMock.should have_requested(:get, "#{base_url}/terminated_postcodes/CM129TR")
+    end
+
+    it 'returns the long and lat' do
+      output.longitude.should == -1.316261
+      output.latitude.should == 51.062297
+    end
+  end
+end

data/spec/postcode_io_spec.rb

@@ -2,26 +2,4 @@ require 'spec_helper'
 
 describe Postcodes::IO do
 
-  let(:base_url) {'https://api.postcodes.io'}
-  let(:stub_response) { File.read('spec/fixtures/lookup_response.json') }
-
-  before :each do
-    stub_request(:get, "#{base_url}/postcodes/CM129TR")
-    .to_return(status: 200, body: stub_response)
-  end
-
-  describe '#lookup' do
-    let(:input) { 'CM12 9TR' }
-    let(:output) { subject.lookup(input) }
-
-    it 'requests a postcode' do
-      output
-      WebMock.should have_requested(:get, "#{base_url}/postcodes/CM129TR")
-    end
-
-    it 'returns the long and lat' do
-      output.longitude.should == 0.411227930206834
-    end
-
-  end
 end

data/spec/reverse_geocode_spec.rb

@@ -0,0 +1,52 @@
+require 'spec_helper'
+
+RSpec.describe Postcodes::IO, '#reverse_geocode' do
+  let(:latitiude) { '53.6099106263766' }
+  let(:longitude) { '2.60515477763266' }
+  let(:base_url) { 'https://api.postcodes.io' }
+  let(:url) { "#{base_url}/postcodes?lon=#{longitude}&lat=#{latitiude}&limit=10&radius=100&wideSearch=false" }
+  let(:no_results_response) do
+    File.read('spec/fixtures/no_results_response.json')
+  end
+  let(:reverse_geocode_response) do
+    File.read('spec/fixtures/reverse_geocode_response.json')
+  end
+
+  subject(:reverse_geocode) do
+    described_class.new.reverse_geocode(
+      longitude: longitude, latitude: latitiude)
+  end
+
+  context 'when a 400 is returned' do
+    before do
+      stub_request(:get, url).to_return(status: 400)
+    end
+
+    it { is_expected.to be_nil }
+  end
+
+  context 'when there are no results returned' do
+    before do
+      stub_request(:get, url).to_return(status: 200, body: no_results_response)
+    end
+
+    it { is_expected.to be_nil }
+  end
+
+  context 'when results are returned' do
+    before do
+      stub_request(:get, url)
+        .to_return(status: 200, body: reverse_geocode_response)
+    end
+
+    it 'returns the correct number of postcodes' do
+      expect(reverse_geocode.count).to eq(3)
+    end
+
+    it 'instantiates an object for each returned postcode' do
+      reverse_geocode.each do |result|
+        expect(result).to be_a(Postcodes::Postcode)
+      end
+    end
+  end
+end

metadata

@@ -1,83 +1,83 @@
 --- !ruby/object:Gem::Specification
 name: postcodes_io
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.4.0
 platform: ruby
 authors:
 - James Ruston
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-20 00:00:00.000000000 Z
+date: 2021-10-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: excon
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.39'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.39'
 description: Get rich data from postcode lookups. Wraps postcodes.io
@@ -87,19 +87,36 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .rspec
+- ".github/workflows/gem-push.yml"
+- ".github/workflows/ruby.yml"
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - lib/postcodes_io.rb
+- lib/postcodes_io/autocomplete.rb
+- lib/postcodes_io/autocomplete_list.rb
+- lib/postcodes_io/base.rb
 - lib/postcodes_io/lookup.rb
+- lib/postcodes_io/lookup_terminated.rb
 - lib/postcodes_io/postcode.rb
+- lib/postcodes_io/reverse_geocode.rb
 - lib/postcodes_io/version.rb
 - postcodes_io.gemspec
+- spec/autocomplete_spec.rb
+- spec/fixtures/autocomplete_response.json
+- spec/fixtures/lookup_multi_response.json
 - spec/fixtures/lookup_response.json
+- spec/fixtures/lookup_terminated_response.json
+- spec/fixtures/no_results_response.json
+- spec/fixtures/reverse_geocode_response.json
+- spec/lookup_spec.rb
+- spec/lookup_terminated_spec.rb
 - spec/postcode_io_spec.rb
+- spec/reverse_geocode_spec.rb
 - spec/spec_helper.rb
 homepage: ''
 licenses:
@@ -111,21 +128,29 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 3.0.3.1
 signing_key: 
 specification_version: 4
 summary: Lookup postcodes
 test_files:
+- spec/autocomplete_spec.rb
+- spec/fixtures/autocomplete_response.json
+- spec/fixtures/lookup_multi_response.json
 - spec/fixtures/lookup_response.json
+- spec/fixtures/lookup_terminated_response.json
+- spec/fixtures/no_results_response.json
+- spec/fixtures/reverse_geocode_response.json
+- spec/lookup_spec.rb
+- spec/lookup_terminated_spec.rb
 - spec/postcode_io_spec.rb
+- spec/reverse_geocode_spec.rb
 - spec/spec_helper.rb