The dotenv Reference Manual

Table of Contents

The dotenv Reference Manual

This is the dotenv Reference Manual, version 0.1.0, generated automatically by Declt version 3.0 "Montgomery Scott" on Sun May 15 04:39:29 2022 GMT+0.

1 Introduction

dotenv

This is a project to parse dotenv (.env) files. You already know what that means, don't you?

Description

This project provides all the necessary functions for interaction with dotenv files (usually it is .env).

API

dot-env-load!

The function's prototype is:

(defun dot-env-load! (&optional names)

It reads the dotenv files provided in the optional list or reads only .env file is the list is empty or was not provided.

Usage:

;; Loads the `.env` only because the arguments list is empty.
(dot-env-load!)
;; Loads the provided files.
(dot-env-load! '(".env" "test.env"))

dot-env

The function's prototype is:

(defun dot-env (name &optional default)

It reads the value of a variable dotenv with passed name. If there is no such a variable there, it reads the process environment. If there is nothing too, it returns default or NIL.

Usage:

(dot-env-load!)
(dot-env "HOME")

License

MIT license

2 Systems

The main system appears first, followed by any subsystem dependency.

2.1 dotenv

Author

Victor Polevoy <fx@thefx.co>

License

MIT

Description

Ease pain with working with .env files.

Version

0.1.0

Dependency

str

Source

dotenv.asd (file)

Components

• package.lisp (file)
• dotenv.lisp (file)

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.

3.1 Lisp

3.1.1 dotenv.asd

Location

dotenv.asd

Systems

dotenv (system)

3.1.2 dotenv/package.lisp

Parent

dotenv (system)

Location

package.lisp

Packages

dotenv

3.1.3 dotenv/dotenv.lisp

Dependency

package.lisp (file)

Parent

dotenv (system)

Location

dotenv.lisp

Exported Definitions

• load! (function)
• read-vars (function)
• value (function)

Internal Definitions

• *dot-env-data* (special variable)
• get-env (function)
• parse-env-string (function)

4 Packages

Packages are listed by definition order.

4.1 dotenv

Source

package.lisp (file)

Use List

common-lisp

Exported Definitions

• load! (function)
• read-vars (function)
• value (function)

Internal Definitions

• *dot-env-data* (special variable)
• get-env (function)
• parse-env-string (function)

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.

5.1 Exported definitions

5.1.1 Functions

Function: load! &optional NAMES

Reads provided .env files.

Package

dotenv

Source

dotenv.lisp (file)

Function: read-vars VARS

Reads provided environment variables into *dot-env-data*.

Package

dotenv

Source

dotenv.lisp (file)

Function: value NAME &optional DEFAULT

Reads the .env or env variable with such name. Returns passed default value or nil if not found

Package

dotenv

Source

dotenv.lisp (file)

5.2 Internal definitions

5.2.1 Special variables

Special Variable: *dot-env-data*

Package

dotenv

Source

dotenv.lisp (file)

5.2.2 Functions

Function: get-env NAME &optional DEFAULT

Package

dotenv

Source

dotenv.lisp (file)

Function: parse-env-string STRING

Reads environment string (KEY=VALUE). Returns the pair on success, NIL otherwise.

Package

dotenv

Source

dotenv.lisp (file)

Appendix A Indexes

A.1 Concepts

A.2 Functions

A.3 Variables

A.4 Data types