cl-dotenv - Load .env files from Common Lisp

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

• alexandria
• serapeum

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

• dotenv

License

Licensed under the MIT License.