Envy loads and sets environment variables from YAML. It supports all YAML data types, including arrays and hashes.
Envy uses the YAML key mapping of a value as the environment variable name.
For example, the following YAML configuration...
--- app: database: host: localhost port: 4321 server: hosts: - localhost - grottopress.localhost port: 8080
...sets environment variables as follows:
ENV["APP_DATABASE_HOST"] = "localhost" ENV["APP_DATABASE_PORT"] = "4321" ENV["APP_SERVER_HOSTS_0"] = "localhost" ENV["APP_SERVER_HOSTS_1"] = "grottopress.localhost" ENV["APP_SERVER_PORT"] = "8080"
Envy loads environment variables only once per application life-cycle. This avoids the overhead of reading and parsing YAML files on every single request.
Envy sets file permission (
0600 by default) for all config files.
Envy supports loading a file from a supplied list of files in decreasing order of priority; the first readable file is loaded.
Add the dependency to your
dependencies: envy: github: grottopress/envy
Load the first readable file from a supplied list of files. Optionally set files permissions. This does not overwrite existing environment variables:
require "envy" Envy.from_file ".env.yml", ".env.dev.yml", perm: 0o400
Load the first readable file from a supplied list of files. Optionally set files permissions. This overwrites existing environment variables:
require "envy" Envy.from_file! ".env.yml", ".env.dev.yml", perm: 0o400
Kindly report suspected security vulnerabilities in private, via contact details outlined in this repository's
- Fork it
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Add some feature')
- Push to the branch (
git push origin my-new-feature)
- Create a new Pull Request