https://github.com/luzifer/envrun

Helper utility to inject environment variables stored in a file into processes
https://github.com/luzifer/envrun

encryption environment-variables golang helper

Last synced: 2 months ago
JSON representation

Helper utility to inject environment variables stored in a file into processes

• Host: GitHub
• URL: https://github.com/luzifer/envrun
• Owner: Luzifer
• License: apache-2.0
• Created: 2016-02-06T15:23:42.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-02-28T21:53:41.000Z (10 months ago)
• Last Synced: 2024-06-24T02:07:53.128Z (7 months ago)
• Topics: encryption, environment-variables, golang, helper
• Language: Go
• Homepage:
• Size: 1.1 MB
• Stars: 5
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: History.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Go Report Card](https://goreportcard.com/badge/github.com/Luzifer/envrun)](https://goreportcard.com/report/github.com/Luzifer/envrun)

![](https://badges.fyi/github/license/Luzifer/envrun)

![](https://badges.fyi/github/downloads/Luzifer/envrun)

![](https://badges.fyi/github/latest-release/Luzifer/envrun)

# Luzifer / envrun

`envrun` is a small helper utility to inject environment variables stored in a file into processes.

It reads a `.env` file (configurable) from the current directory and then either takes its own environment variables or a clean set and adds the env variables found in `.env` to it. The resulting set is passed to the command you put as arguments to `envrun`.

## Examples

To visualize the effect of the utility the test command is `python test.py` with this simple python script:

```python

import os

for k in os.environ.keys():

  print "{} = {}".format(k, os.environ[k])

```

It just prints the current environment to `STDOUT` and exits.

```console

$ cat .env

MY_TEST_VAR=hello world

ANOTHER_VAR=foo

$ python test.py | grep MY_TEST_VAR

## No output on this command

$ envrun --help

Usage of envrun:

      --clean                  Do not pass current environment to child process

      --encryption string      Encryption method used for encrypted env-file (Available: gpg-symmetric, openssl-md5, openssl-sha256) (default "openssl-md5")

      --env-file string        Location of the environment file (default ".env")

      --log-level string       Log level (debug, info, warn, error, fatal) (default "info")

  -p, --password string        Password to decrypt environment file

      --password-file string   Read encryption key from file

      --version                Prints current version and exits

$ envrun python test.py | grep MY_TEST_VAR

MY_TEST_VAR = hello world

$ envrun python test.py | wc -l

      45

$ envrun --clean python test.py | wc -l

       3

$ envrun --clean python test.py

__CF_USER_TEXT_ENCODING = 0x1F5:0x0:0x0

ANOTHER_VAR = foo

MY_TEST_VAR = hello world

```

## Encrypted `.env`-file

In case you don't want to put the environment variables into a plain text file onto your disk you can use an encrypted file and provide a password to `envrun`:

### GnuPG symmetric encryption

In this example an armored (`-a`) encryption is used. This is not required and you can leave out the `-a` flag.

```console

$ echo "MYVAR=myvalue" | gpg --passphrase justatest --batch --quiet --yes -c -a -o .env

$ cat .env

-----BEGIN PGP MESSAGE-----

jA0ECQMCIsGVKNlJw1Py0kMB542XJvekKyuPi2LHQrnFlhD5ALm6orvE3WFAzp7D

kAisTMr10fmjLuENfQhxqd9MB0Kd2mfd3b1mgOzei5IMDLJc

=7k9M

-----END PGP MESSAGE-----

$ envrun -p justatest --encryption gpg-symmetric --clean -- env

MYVAR=myvalue

INFO[0000] Process exitted with code 0

```

### OpenSSL AES256 encryption

```console

$ echo 'MYVAR=myvalue' | openssl enc -e -aes-256-cbc -pass pass:justatest -base64 -out .env

$ cat .env

U2FsdGVkX18xcVIMejjwWzh1DppzptJCHhORH/JDj10=

$ envrun -p justatest --clean -- env

MYVAR=myvalue

INFO[0000] Process exitted with code 0

```