/cl-dotenv

Load .env files from Common Lisp

Primary LanguageCommon LispMIT LicenseMIT

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 not yet available through Quicklisp. (Issue)

Manual installation steps:

  cd ~/quicklisp/local-projects/   
  git clone https://github.com/ollelauribostrom/cl-dotenv.git
  (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

Inspiration

License

Licensed under the MIT License.