govuk_personalisation 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08b691342c4c22592162f9eb11e8c8f74b8fea75af5669568c71d15337166626'
-  data.tar.gz: 0e266ec1d1f91a7537ccef2c1a4398e90b4c0435546772d41877cfd34e9df092
+  metadata.gz: 5ba6e9b0f0533ecc545582e031f6faf0f734d727e42478ffea40ddac7635986e
+  data.tar.gz: '0974635ac43c8dfacb6894787db3d36b2608438117b41640364bfd40dcecb125'
 SHA512:
-  metadata.gz: 5f265633173eee3b60e436c781ddb4047d849471cc1760d88e8c3e497a79d8a0fd188a4c3908feb33fecf3b8c2b171dbbc1ea7f08ed837fae2d58cfc5658ae35
-  data.tar.gz: d90dc8a74720981e16d7d379939c08072806ead930d012bb40c1a57ac2e90ae3879a10d7fb0bfbe3d874d39c70312952d72c0c9eca452fd757906c253ecb402e
+  metadata.gz: 0fdb4622d551eae409978cac47ea4dfc78205a33d6e6b324b0a4eae4ab97eb5730571cd038a49ae9d74167a50093771aa96e60062a8fadfe33dc9b57206da2a1
+  data.tar.gz: f11fc215ac0ab1bb8147c973398b1bba72a1f58a7ea838473ea05f305a2ac169bd527fb61e8eb7e5676be14fb02fde5ef821800868488b6250b0591e64e6aab0

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+# 0.7.0
+
+- Add `GovukPersonalisation::Urls` module ([#14](https://github.com/alphagov/govuk_personalisation/pull/14) [#16](https://github.com/alphagov/govuk_personalisation/pull/16))
+
 # 0.6.0
 
 - Add `GovukPersonalisation::Flash` and helper methods to the concern ([#9](https://github.com/alphagov/govuk_personalisation/pull/9))

data/govuk_personalisation.gemspec

@@ -25,9 +25,11 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = %w[lib]
 
+  spec.add_dependency "plek", ">= 1.9.0"
   spec.add_dependency "rails", "~> 6"
 
   spec.add_development_dependency "bundler"
+  spec.add_development_dependency "climate_control"
   spec.add_development_dependency "pry-byebug"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec-rails"

data/lib/govuk_personalisation/urls.rb

@@ -0,0 +1,87 @@
+require "plek"
+
+module GovukPersonalisation::Urls
+  # Find the GOV.UK URL for the "sign in" page
+  #
+  # @return [String] the URL
+  def self.sign_in
+    find_govuk_url(var: "SIGN_IN", application: "frontend", path: "/sign-in")
+  end
+
+  # Find the GOV.UK URL for the "sign out" page
+  #
+  # @return [String] the URL
+  def self.sign_out
+    find_govuk_url(var: "SIGN_OUT", application: "frontend", path: "/sign-out")
+  end
+
+  # Find the GOV.UK URL for the "your account" page
+  #
+  # @return [String] the URL
+  def self.your_account
+    find_govuk_url(var: "YOUR_ACCOUNT", application: "frontend", path: "/account/home")
+  end
+
+  # Find the external URL for the "manage" page
+  #
+  # @return [String] the URL
+  def self.manage
+    find_external_url(var: "MANAGE", application: "account-manager", path: "/account/manage")
+  end
+
+  # Find the external URL for the "security" page
+  #
+  # @return [String] the URL
+  def self.security
+    find_external_url(var: "SECURITY", application: "account-manager", path: "/account/security")
+  end
+
+  # Find the external URL for the "feedback" page
+  #
+  # @return [String] the URL
+  def self.feedback
+    find_external_url(var: "FEEDBACK", application: "account-manager", path: "/feedback")
+  end
+
+  # Finds a URL on www.gov.uk.  This method is used so we can have
+  # links which work both in production (where the website root is
+  # returned) and in local development (where an application URL is
+  # returned).
+  #
+  # If `GOVUK_PERSONALISATION_#{var}_URI` is in the environment, that
+  # will be returned.
+  #
+  # Otherwise, a `www.gov.uk` URL will be returned (a `dev.gov.uk`
+  # domain in development mode)
+  #
+  # @param var         [String] the name of the variable to look up
+  # @param application [String] the name of the frontend application, passed to Plek, to use in development mode (if the env var is set, this is ignored)
+  # @param path        [String] the path to use (if the env var is set this is ignored)
+  #
+  # @return [String] the URL
+  def self.find_govuk_url(var:, application:, path:)
+    value_from_env_var = ENV["GOVUK_PERSONALISATION_#{var}_URI"]
+    if value_from_env_var
+      value_from_env_var
+    else
+      plek_application_uri = Rails.env.development? ? Plek.find(application) : Plek.new.website_root
+      "#{plek_application_uri}#{path}"
+    end
+  end
+
+  # Finds a URL outside www.gov.uk
+  #
+  # If `GOVUK_PERSONALISATION_#{var}_URI` is in the environment, that
+  # will be returned.
+  #
+  # Otherwise, an application URL generated by Plek will be returned.
+  #
+  # @param var         [String] the name of the variable to look up
+  # @param application [String] the name of the frontend application, passed to Plek (if the env var is set, this is ignored)
+  # @param path        [String] the path to use (if the env var is set this is ignored)
+  #
+  # @return [String] the URL
+  def self.find_external_url(var:, application:, path:)
+    ENV.fetch("GOVUK_PERSONALISATION_#{var}_URI", "#{Plek.find(application)}#{path}")
+  end
+end

data/lib/govuk_personalisation/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GovukPersonalisation
-  VERSION = "0.6.0"
+  VERSION = "0.7.0"
 end

data/lib/govuk_personalisation.rb

@@ -5,5 +5,6 @@ require "govuk_personalisation/controller_concern"
 require "govuk_personalisation/flash"
 require "govuk_personalisation/test_helpers/features"
 require "govuk_personalisation/test_helpers/requests"
+require "govuk_personalisation/urls"
 
 module GovukPersonalisation; end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: govuk_personalisation
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - GOV.UK Dev
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-08-06 00:00:00.000000000 Z
+date: 2021-08-31 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: plek
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.9.0
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -38,6 +52,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: climate_control
+  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: pry-byebug
   requirement: !ruby/object:Gem::Requirement
@@ -120,6 +148,7 @@ files:
 - lib/govuk_personalisation/flash.rb
 - lib/govuk_personalisation/test_helpers/features.rb
 - lib/govuk_personalisation/test_helpers/requests.rb
+- lib/govuk_personalisation/urls.rb
 - lib/govuk_personalisation/version.rb
 homepage: https://github.com/alphagov/govuk_personalisation
 licenses: