Skip to content
box

GitHub Action

Simple Dotenv

v2.3.0 Latest version

Simple Dotenv

box

Simple Dotenv

This action will read the .env file and add variables to GITHUB_ENV

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Simple Dotenv

uses: xom9ikk/dotenv@v2.3.0

Learn more about this action in xom9ikk/dotenv

Choose a version

dotenv@v2

GitHub Action to read .env file and add variables to GITHUB_ENV

🔥 Usage

- name: Load .env file
  uses: xom9ikk/dotenv@v2
  with:
    path: custom/path/to/folder/with/env
    mode: development
    load-mode: strict

- name: Some other action
  run: |
    echo "Variable 1: ${{ env.VARIABLE_1 }}"
    echo "Variable 2: ${{ env.VARIABLE_2 }}"
    echo "Variable 3: ${{ env.VARIABLE_3 }}"

✨ Features

  • ⛳ ability to specify the path to the folder;
  • 🎨 setup mode;
  • 💎 simple API;
  • 🍃 variable expansion;

💡 Input

property isRequired default comment example
path x ./ path to the folder where the .env file is located. ./custom/path/to/folder/with/env
mode x empty mode for loading the .env file. test
load-mode x strict sets whether the program should fail when the .env file is not present (strict) or continue (skip) skip

🧩 Notes

This action is built on top of the dotenv and dotenv-expand libraries. When starting the action, the file is read from the target folder in the path property and using the mode specified in mode.

The name of the .env file depends on the startup mode. If you do not specify the launch mode, the .env file will be loaded. If you need to load a .env file for a specific mode, you should specify the mode property.

Thus, specifying mode: test will read the .env.test file. mode: development will read .env.development and so on.

After reading and parsing the variables from the .env file, it writes them to GITHUB_ENV.

If the action should continue when the .env file is not present, the optional load-mode flag can be set to skip. This can be particularly, for example, useful in secondary branches, where some aspects of the action may not be relevant.

Action also supports variable expansion, e.g.

PASSWORD="s1mpl3"
DB_PASS=$PASSWORD