defra_ruby_mocks 5.3.0 → 5.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5df956ffaf0644fb9dae96ae157ec7f45b8121d6bc42e5cd96164de8470342a
-  data.tar.gz: 6da12c96f050164e579932bf9ad188866198db203893ab436fc84c0a1e4ceeb8
+  metadata.gz: efb2290f30c28bbc86c9b910aac27b675c2fc2e571d648d7b1464d6f60844396
+  data.tar.gz: c3205f6fcf14ba5efecbbfde5ff1afc46b66fefa3aa65a78b23487396dbe70d5
 SHA512:
-  metadata.gz: df8d21f730573cdf3d97f10a6e41a4c2d7464e62ac3c5d032190fb6b5b9a21c9bc7a76cce56fadcfb757affd1cb21b1c2b5a6bc8a24c33c1a8db882543ffab14
-  data.tar.gz: bed07b31c14573ba390b13294a69f3209538616bd360379d0efb7b6dcc7b57c42406b6b4cc6e1cdc307933851e07c4537f876c0f9f8e80afdc953bdeec10a47d
+  metadata.gz: 3ff3b5611d9409b0efb13621ef5afa071b52bf625c6d4b4534b2190c61d01a1752446ee426910134e01cf3a981515dbc4e3ad898c93077f0243803ebb67b4a31
+  data.tar.gz: 4b06c4bc2fa793e68a01b2cfc4746e2a09e4576a4a0d8e7aabc57f6fa44f2d917c69f60eaf91f3bbb54d803b8bae171223c7a6e3abc76fdadbc264635f6112de

data/README.md

@@ -132,6 +132,41 @@ The list of possible statuses was taken from
 - [Companies House API](https://developer.companieshouse.gov.uk/api/docs/company/company_number/companyProfile-resource.html)
 - [Companies House API enumerations](https://github.com/companieshouse/api-enumerations/blob/master/constants.yml)
 
+### OS Places
+
+When mounted into an app you can make requests to `/mocks/places/v1/postcode?postcode=[postcode]` to get a mock address lookup response in the OS Places API DPA format.
+
+```bash
+curl "http://localhost:3000/mocks/places/v1/postcode?postcode=BS1%205AH"
+{
+    "results": [
+        {
+            "DPA": {
+                "UPRN": "340116",
+                "ADDRESS": "ENVIRONMENT AGENCY, HORIZON HOUSE, DEANERY ROAD, BRISTOL, BS1 5AH",
+                "ORGANISATION_NAME": "ENVIRONMENT AGENCY",
+                "BUILDING_NAME": "HORIZON HOUSE",
+                "THOROUGHFARE_NAME": "DEANERY ROAD",
+                "POST_TOWN": "BRISTOL",
+                "POSTCODE": "BS1 5AH",
+                "X_COORDINATE": 358205.0,
+                "Y_COORDINATE": 172708.0,
+                ...
+            }
+        },
+        ...
+    ]
+}
+```
+
+#### Postcodes
+
+The mock normalizes postcodes by converting to uppercase and removing spaces. Currently the following postcodes return mock data:
+
+- `BS1 5AH` - Returns two addresses (Environment Agency Horizon House, Bristol)
+
+Any other postcode will return `{"results": []}`.
+
 ### Govpay
 
 When mounted into an app you can simulate interacting with the Govpay hosted pages service. The following endpoints are supported:

data/Rakefile

@@ -16,8 +16,6 @@ RDoc::Task.new(:rdoc) do |rdoc|
   rdoc.rdoc_files.include("lib/**/*.rb")
 end
 
-load "rails/tasks/statistics.rake"
-
 Dir[File.join(File.dirname(__FILE__), "lib/tasks/**/*.rake")].each { |f| load f }
 
 Bundler::GemHelper.install_tasks

data/app/controllers/defra_ruby_mocks/os_places_controller.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module DefraRubyMocks
+  class OsPlacesController < ::DefraRubyMocks::ApplicationController
+    def postcode
+      results = OsPlacesService.run(params[:postcode]).results
+      render json: { "results" => results }
+    end
+  end
+end

data/app/services/defra_ruby_mocks/aws_bucket_service.rb

@@ -21,6 +21,7 @@ module DefraRubyMocks
       new.remove(bucket_name, file_name)
     end
 
+    # rubocop:disable-next Naming/PredicateMethod
     def write(bucket_name, file_name, content)
       @bucket_name = bucket_name
       @file_name = file_name

data/app/services/defra_ruby_mocks/govpay_create_payment_service.rb

@@ -41,7 +41,7 @@ module DefraRubyMocks
       url_root
     end
 
-    # rubocop:disable Metrics/MethodLength
+    # rubocop:disable-next Metrics/MethodLength
     def success_response(amount, description)
       {
         created_date: "2020-03-03T16:17:19.554Z",
@@ -68,7 +68,6 @@ module DefraRubyMocks
         provider_id: "10987654321"
       }
     end
-    # rubocop:enable Metrics/MethodLength
 
   end
 end

data/app/services/defra_ruby_mocks/govpay_get_payment_service.rb

@@ -25,7 +25,7 @@ module DefraRubyMocks
       response_status(response_status_filename: "test_payment_response_status", default_status: "success")
     end
 
-    # rubocop:disable Metrics/MethodLength
+    # rubocop:disable-next Metrics/MethodLength
     def response_success
       {
         amount: 10_501,
@@ -90,7 +90,6 @@ module DefraRubyMocks
         }
       }
     end
-    # rubocop:enable Metrics/MethodLength
 
   end
 end

data/app/services/defra_ruby_mocks/os_places_service.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module DefraRubyMocks
+  class OsPlacesService < BaseService
+    # Mock addresses in OS Places API DPA format, keyed by normalized postcode
+    MOCK_ADDRESSES = {
+      "BS15AH" => [
+        {
+          "DPA" => {
+            "UPRN" => "340116",
+            "ADDRESS" => "ENVIRONMENT AGENCY, HORIZON HOUSE, DEANERY ROAD, BRISTOL, BS1 5AH",
+            "ORGANISATION_NAME" => "ENVIRONMENT AGENCY",
+            "BUILDING_NAME" => "HORIZON HOUSE",
+            "THOROUGHFARE_NAME" => "DEANERY ROAD",
+            "POST_TOWN" => "BRISTOL",
+            "POSTCODE" => "BS1 5AH",
+            "X_COORDINATE" => 358_205.0,
+            "Y_COORDINATE" => 172_708.0,
+            "DEPENDENT_LOCALITY" => "",
+            "MATCH" => 1.0,
+            "MATCH_DESCRIPTION" => "EXACT",
+            "LANGUAGE" => "EN",
+            "LAST_UPDATE_DATE" => "2024-01-01",
+            "ENTRY_DATE" => "2020-01-01",
+            "BLPU_STATE_CODE" => "2",
+            "BLPU_STATE_CODE_DESCRIPTION" => "In use",
+            "CLASSIFICATION_CODE" => "CO01",
+            "CLASSIFICATION_CODE_DESCRIPTION" => "Office / Work Studio",
+            "POSTAL_ADDRESS_CODE" => "D",
+            "POSTAL_ADDRESS_CODE_DESCRIPTION" => "A record which is linked to PAF",
+            "LOGICAL_STATUS_CODE" => "1",
+            "STATUS" => "APPROVED",
+            "TOPOGRAPHY_LAYER_TOID" => "",
+            "PARENT_UPRN" => "",
+            "USRN" => ""
+          }
+        },
+        {
+          "DPA" => {
+            "UPRN" => "340117",
+            "ADDRESS" => "THRIVE RENEWABLES PLC, DEANERY ROAD, BRISTOL, BS1 5AH",
+            "ORGANISATION_NAME" => "THRIVE RENEWABLES PLC",
+            "BUILDING_NAME" => "",
+            "THOROUGHFARE_NAME" => "DEANERY ROAD",
+            "POST_TOWN" => "BRISTOL",
+            "POSTCODE" => "BS1 5AH",
+            "X_COORDINATE" => 358_130.0,
+            "Y_COORDINATE" => 172_687.0,
+            "DEPENDENT_LOCALITY" => "",
+            "MATCH" => 1.0,
+            "MATCH_DESCRIPTION" => "EXACT",
+            "LANGUAGE" => "EN",
+            "LAST_UPDATE_DATE" => "2024-01-01",
+            "ENTRY_DATE" => "2020-01-01",
+            "BLPU_STATE_CODE" => "2",
+            "BLPU_STATE_CODE_DESCRIPTION" => "In use",
+            "CLASSIFICATION_CODE" => "CO01",
+            "CLASSIFICATION_CODE_DESCRIPTION" => "Office / Work Studio",
+            "POSTAL_ADDRESS_CODE" => "D",
+            "POSTAL_ADDRESS_CODE_DESCRIPTION" => "A record which is linked to PAF",
+            "LOGICAL_STATUS_CODE" => "1",
+            "STATUS" => "APPROVED",
+            "TOPOGRAPHY_LAYER_TOID" => "",
+            "PARENT_UPRN" => "",
+            "USRN" => ""
+          }
+        }
+      ]
+    }.freeze
+
+    def run(postcode)
+      @postcode = normalize_postcode(postcode)
+      self
+    end
+
+    def results
+      MOCK_ADDRESSES.fetch(@postcode, [])
+    end
+
+    private
+
+    def normalize_postcode(postcode)
+      postcode.to_s.upcase.gsub(/\s+/, "")
+    end
+  end
+end

data/config/routes.rb

@@ -11,6 +11,11 @@ DefraRubyMocks::Engine.routes.draw do # rubocop:disable Metrics/BlockLength
       as: "company_officers",
       constraints: ->(_request) { DefraRubyMocks.configuration.enabled? }
 
+  get "/places/v1/postcode",
+      to: "os_places#postcode",
+      as: "os_places_addresses",
+      constraints: ->(_request) { DefraRubyMocks.configuration.enabled? }
+
   post "/govpay/v1/payments",
        to: "govpay#create_payment",
        as: "govpay_create_payment",

data/lib/defra_ruby_mocks/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DefraRubyMocks
-  VERSION = "5.3.0"
+  VERSION = "5.4.1"
 end

metadata

@@ -1,27 +1,27 @@
 --- !ruby/object:Gem::Specification
 name: defra_ruby_mocks
 version: !ruby/object:Gem::Version
-  version: 5.3.0
+  version: 5.4.1
 platform: ruby
 authors:
 - Defra
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-09 00:00:00.000000000 Z
+date: 2026-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
 - !ruby/object:Gem::Dependency
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.6'
 - !ruby/object:Gem::Dependency
   name: rest-client
   requirement: !ruby/object:Gem::Requirement
@@ -96,6 +96,7 @@ files:
 - app/controllers/defra_ruby_mocks/company_controller.rb
 - app/controllers/defra_ruby_mocks/govpay_controller.rb
 - app/controllers/defra_ruby_mocks/govpay_test_helpers_controller.rb
+- app/controllers/defra_ruby_mocks/os_places_controller.rb
 - app/jobs/application_job.rb
 - app/jobs/base_send_webhook_job.rb
 - app/jobs/send_payment_webhook_job.rb
@@ -107,6 +108,7 @@ files:
 - app/services/defra_ruby_mocks/govpay_get_payment_service.rb
 - app/services/defra_ruby_mocks/govpay_refund_details_service.rb
 - app/services/defra_ruby_mocks/govpay_request_refund_service.rb
+- app/services/defra_ruby_mocks/os_places_service.rb
 - app/views/defra_ruby_mocks/company/not_found.json.erb
 - app/views/defra_ruby_mocks/company/officers.json.erb
 - app/views/defra_ruby_mocks/company/show.json.erb