Go ENV

This utility is designed to allow you to let you interact with .env files in a manner consistent with .env.local, .env.develop, .env.production, etc., and we have shorter hand notations for interacting with .env files.

Installation

go get github.com/andreimerlescu/goenv@latest

Package env

The basis behind env is the env package, which can be used in other Go applications and is licensed as Apache 2.0.

go get -u github.com/andreimerlescu/goenv/env

The README.md has more information about using the package.

Usage

I wrote this package because sometimes I just need to work with an env file, even if it doesn't yet exist. This is particularly useful for input validation of env files and the ability to transform the syntax of the .env file into multiple formats. The test.sh file has the summary of arguments that are best to run for the package.

go install github.com:andreimerlescu/goenv@latest
goenv -init -write -file n8n.env
goenv -write -file n8n.env -add -env DATA_FOLDER -value "$(pwd)"
goenv -write -file n8n.env -add -env DOMAIN -value "gh.dev"
goenv -write -file n8n.env -add -env SUBDOMAIN -value "n8n"
goenv -write -file n8n.env -add -env SSL_EMAIL -value "webmaster@n8n.gh.dev"
goenv -file n8n.env -print
goenv -file n8n.env -xml
goenv -file n8n.env -toml
goenv -file n8n.env -has -env GENERIC_TIMEZONE

Testing

andrei@GitHub:~/repos/goenv|master⚡ ⇒  make all
Summary generated: summaries/summary.2025.08.09.19.28.57.UTC.md
Building goenv binary...
Clean successful: goenv
Build successful: goenv

andrei@goenv.git:. ⚡ Test #1 ⇒  goenv -file sample.env -has -env HOSTNAME
andrei@goenv.git:. ⚡ Test #2 ⇒  goenv -file sample.env -has -env NON_EXISTENT
andrei@goenv.git:. ⚡ Test #3 ⇒  goenv -file sample.env -is -env DATABASE -value test_data
andrei@goenv.git:. ⚡ Test #4 ⇒  goenv -file sample.env -is -env DATABASE -value wrong_data
andrei@goenv.git:. ⚡ Test #5 ⇒  goenv -file sample.env -print
AWS_REGION=us-west-2
OUTPUT=json
HOSTNAME=localhost
DBUSER=readonly
DBPASS=readonly
DATABASE=test_data
andrei@goenv.git:. ⚡ Test #6 ⇒  goenv -file sample.env -json
{
  "AWS_REGION": "us-west-2",
  "DATABASE": "test_data",
  "DBPASS": "readonly",
  "DBUSER": "readonly",
  "HOSTNAME": "localhost",
  "OUTPUT": "json"
}
andrei@goenv.git:. ⚡ Test #7 ⇒  goenv -file sample.env -yaml
---
AWS_REGION: "us-west-2" 
OUTPUT: "json" 
HOSTNAME: "localhost" 
DBUSER: "readonly" 
DBPASS: "readonly" 
DATABASE: "test_data" 
andrei@goenv.git:. ⚡ Test #8 ⇒  goenv -file sample.env -toml
DBPASS: "readonly" 
DATABASE: "test_data" 
AWS_REGION: "us-west-2" 
OUTPUT: "json" 
HOSTNAME: "localhost" 
DBUSER: "readonly" 
andrei@goenv.git:. ⚡ Test #9 ⇒  goenv -file sample.env -ini
[default]
OUTPUT = json
HOSTNAME = localhost
DBUSER = readonly
DBPASS = readonly
DATABASE = test_data
AWS_REGION = us-west-2
andrei@goenv.git:. ⚡ Test #10 ⇒  goenv -file sample.env -xml
<?xml version="1.0" encoding="UTF-8"?>
<env>
   <AWS_REGION>us-west-2</AWS_REGION>
   <OUTPUT>json</OUTPUT>
   <HOSTNAME>localhost</HOSTNAME>
   <DBUSER>readonly</DBUSER>
   <DBPASS>readonly</DBPASS>
   <DATABASE>test_data</DATABASE>
</env>
andrei@goenv.git:. ⚡ Test #11 ⇒  goenv -file sample.env -write -add -env NEW_KEY -value 'a new value'
andrei@goenv.git:. ⚡ Test #12 ⇒  goenv -file sample.env -has -env NEW_KEY
andrei@goenv.git:. ⚡ Test #13 ⇒  goenv -file sample.env -write -add -env HOSTNAME -value 'another-host'
andrei@goenv.git:. ⚡ Test #14 ⇒  goenv -file sample.env -is -env HOSTNAME -value localhost
andrei@goenv.git:. ⚡ Test #15 ⇒  goenv -file sample.env -write -rm -env OUTPUT
andrei@goenv.git:. ⚡ Test #16 ⇒  goenv -file sample.env -not -has -env OUTPUT
andrei@goenv.git:. ⚡ Test #17 ⇒  goenv -file new.env -add -env HELLO -value world -write
andrei@goenv.git:. ⚡ Test #18 ⇒  goenv -file new.env -is -env HELLO -value world
andrei@goenv.git:. ⚡ Test #19 ⇒  goenv -file sample.env -v
v0.0.2
andrei@goenv.git:. ⚡ Test #20 ⇒  goenv -file non_existent_file.env -add -env FOO -value bar || echo "Test success because we expected an error here."                                                                                                      
andrei@goenv.git:. ⚡ Test #21 ⇒  goenv -file non_existent_file.env -add -env FOO -value bar -write
All 21 tests PASS!
NEW: bin/goenv-darwin-amd64
NEW: bin/goenv-darwin-arm64
NEW: bin/goenv-linux-amd64
NEW: bin/goenv-darwin-arm64
NEW: bin/goenv.exe
NEW: /Users/andrei/go/bin/goenv