Swift 3 library that loads environment variables from .env
into the environment inspired by the Ruby dotenv and PHP dotenv projects.
Storing configuration in the environment is one of the tenets of a twelve-factor app. Anything that is likely to change between deployment environments–such as resource handles for databases or credentials for external services–should be extracted from the code into environment variables.
But it is not always practical to set environment variables on development machines or continuous integration servers where multiple projects are run. SwiftDotEnv loads variables from a .env
file into ENV
when the environment is bootstrapped.
Install using Swift Package Manager.
This module has been tested with Swift version 3.0
.
import DotEnv
let env = DotEnv(withFile: ".env")
let host = env.get("DB_HOST") ?? "localhost"
let port = env.getInt("DB_PORT") ?? 3306
let isEnabled = env.getBool("IS_ENABLED") ?? true
There are three getter methods:
get()
returns aString?
getInt()
returns anInt?
getBool()
returns aBool?
where case-insensitive"true"
,"yes"
and"1"
evaluate totrue
You can also use subscript access to retrieve the string version:
let host = env["DB_HOST"] ?? "localhost"
As a convenience, you can use env.all()
to retrieve all environment variables.
Currently has a very naive parser of the .env
file and so doesn't support multi-line values.
Contributions welcome! Please put your changes in a separate branch from master and raise a PR.