https://github.com/fgm/envrun

Run a command with environment default loaded from a .env file
https://github.com/fgm/envrun

ci cicd env environment environment-variables go golang

Last synced: 12 days ago
JSON representation

Run a command with environment default loaded from a .env file

• Host: GitHub
• URL: https://github.com/fgm/envrun
• Owner: fgm
• License: mit
• Created: 2022-05-20T10:03:20.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-02-16T13:37:57.000Z (9 months ago)
• Last Synced: 2024-11-01T18:51:39.801Z (19 days ago)
• Topics: ci, cicd, env, environment, environment-variables, go, golang
• Language: Go
• Homepage:
• Size: 6.84 KB
• Stars: 9
• Watchers: 1
• Forks: 1
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# envrun

The `envrun` command allows running any command with default environment

variables taken from a file, copying its standard error and standard output to

its own standard error and standard output.

Variables already present in the environment override the one in the file.

The command may have arguments, and it will be looked up in the `$PATH` if its

name does not contain a `/`.

## Installing

Install from source, using a Go SDK: `go install github.com/fgm/envrun@latest`

## Running

### Examples

- `envrun foo`: run `foo` with the environment defaults loaded from `.env` if it exists,

  or fail if it cannot be read.

- `envrun -f .env.demo env`: run the `env` command with the environment defaults

  loaded from `.env.demo` or fail if it cannot be read

### Exit status

- If the command exits, `envrun` will return its exit status

- If the command is killed, `envrun` will return exit status 1

## Why ?

Many programs support reading their environment from a `.env` file, and many IDEs

support that feature in run configurations.

This command is provided for situations outside an IDE (e.g. CI/CD) and where the

program to be run does not include this feature.

## Support

- Non-security questions: use [Github issues](https://github.com/fgm/envrun/issues)

- Security questions or direct support: use https://osinet.fr/contact