dotenv~drum

Load .env files in crystal dotenv environment-variables
0.5.0 Latest release released
drum445/dotenv
17 4
Ed

dotenv

Loads a .env file in Crystal and optionally sets values directly into your ENV. Will always return the .env file as a hash regardless of whether you chose to load into your ENV or not. Will treat a non-existent .env file as an empty one.

Installation

  1. Add the dependency to your shard.yml:
dependencies:
  dotenv:
    github: drum445/dotenv
  1. Run shards install

Usage

require "dotenv"

Having a .env file

ENV=dev
PORT=3000
LOGGING=true
CORS=*

DB_DRIVER=mysql
DB_USERNAME=root
DB_PASSWORD=password
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=test
Using a file called .env and loading into your ENV
require "dotenv"

Dotenv.load # => {"ENV" => "dev", "PORT" => "3000", "LOGGING" => "true", "CORS" => "*", "DB_DRIVER" => "mysql", "DB_USERNAME" => "root", "DB_PASSWORD" => "password", "DB_HOST" => "localhost", "DB_PORT" => "3306", "DB_DATABASE" => "test"}
Using a file called .env and NOT loading into your ENV
require "dotenv"

hash = Dotenv.load(set_env: false)
Using a file NOT called .env and loading into your ENV
require "dotenv"

Dotenv.load(path: ".env.live")

Overriding

By default the existing environment will be overriden by contents of the .env file. To disable this behaviour pass false to override_env parameter:

require "dotenv"

hash = Dotenv.load(override_env: false)

Development

  1. Clone the repository: git clone git@github.com:drum445/dotenv.git. There are no dependencies, so no shards install is needed (but won't do any harm).
  2. Change into the project root directory: cd dotenv.
  3. Run specs: crystal spec.

Contributing

  1. Fork it (https://github.com/drum445/dotenv/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

dotenv:
  github: drum445/dotenv
  version: ~> 0.5.0
License MIT
Crystal 1.0.0

Authors

Dependencies 0

Development Dependencies 0

Dependents 0

Last synced .
search fire star recently