Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Plek

"Plek" is Afrikaans. It means "Location". Plek is used to generate the correct base URLs for internal GOV.UK services, eg:

# on a dev machine
> Plek.find('frontend')
=> "http://frontend.dev.gov.uk"
# on a production machine
> Plek.find('frontend')
=> "https://frontend.publishing.service.gov.uk"

This means we can use this in our code and let our environment configuration figure out the correct hosts for us at runtime.

In an environment where we have internal hostnames and external ones an option of external can be provided to determine whether an internal or external host is returned.

> Plek.find('frontend')
=> "https://frontend.integration.govuk-internal.digital"
> Plek.find('frontend', external: true)
=> "https://frontend.integration.publishing.service.gov.uk"

Technical documentation

See the API docs for full details of the API.

Running the test suite

bundle exec rake

Environment variables

For base URLs

The base URL Plek uses for each service can be set using environment variables.

Plek will use any variables set matching this pattern:

PLEK_SERVICE_ + the service name, uppercased with any hyphens converted to underscores + _URI.

For example, the variable for static would be PLEK_SERVICE_STATIC_URI.

Others

To domain is based on the environment, and defaults to 'dev.gov.uk'. The environment can be set using either RAILS_ENV or RACK_ENV.

You can prepend strings to the hostnames generated using: PLEK_HOSTNAME_PREFIX.

Override the asset URL with: GOVUK_ASSET_ROOT. The default is to generate a URL for the static service.

Override the website root with GOVUK_WEBSITE_ROOT. The default is to generate a URL for the www service.

Licence

MIT License

Versioning policy

This is versioned according to Semantic Versioning 2.0

About

Generates URLs for GOV.UK services based on environment

Topics

Resources

License

Packages

No packages published

Languages

You can’t perform that action at this time.