- 2.0.1 and master22.214.171.124.04.2
- 2.0.1 and masteriOSmacOS(Intel)macOS(ARM)LinuxtvOSwatchOS
Swift library that loads environment variables from .env files into the environment
|⚠️ This repository is archived as I'm no longer using Swift on Linux and so maintaining isn't appropriate.|
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.
Version 2 of this module has been tested with Swift
4.0. Version 1 has been tested with Swift
import DotEnv let env = DotEnv(withFile: ".env") let host = env.get("DB_HOST") ?? "localhost" let port = env.getAsInt("DB_PORT") ?? 3306 let isEnabled = env.getAsBool("IS_ENABLED") ?? true
.env file would be:
DB_HOST=test.com DB_PORT=1234 IS_ENABLED=0
There are three getter methods:
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.
Note that the
.env file is referenced relative to the directory where the binary is executed from.
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.