cl-dotenv

2018-10-18

cl-dotenv - Load .env files from Common Lisp

Build Status Coverage Status

Tiny utility library for loading .env files.

Currently tested with: SBCL, Allegro, ECL

Usage

Calling load-env loads the environment from the specified .env file. Use any of the available nicknames cl-dotenv, .env or dotenv.

  (.env:load-env (merge-pathnames "./path/.env"))

Parsing rules

  • Empty lines are skipped.
  • Lines beginning with # are treated as comments
  • Empty values are treated as empty strings, For example: EMPTY=
  • Malformed or duplicated entries will trigger a restart to let you decide on how to proceed with the parsing.

Installation

The package is available through Quicklisp.

(ql:quickload :cl-dotenv)

Dependencies

Contributing

All contributions are very much welcome. Please get familiar with the contributing guide.

Commands

  • make install: Install the packages cl-dotenv and cl-dotenv-test locally using Roswell
  • make test: Run the tests using Prove
  • make coverage: Run the tests and generate a coverage report
  • make sbcl: Start SBCL and load cl-dotenv

Author

  • Olle Lauri Bostr?m (ollebostr@gmail.com)

Inspiration

License

Licensed under the MIT License.

Author
Olle Lauri Bostr?m
License
MIT