When I try to run a script that contains the envsubst command, I get this error. Looking online, this seems to be a standard bash command, so I am not sure what to install in order to get it to work.
Edit: @cobberboy 's anwer is more correct. upvote him.
brew install gettext
brew link --force gettext
Following is my old answer:
envsubst is included in gettext package.
Therefore you may compile it by your own, using standard build tools such as make or using homebrew.
However, it seems to have little issue when installing gettext in MacOS.
See following url for details: How to install gettext on MacOS X
-
8While
envsubstis part of gettext (as installed by homebrew) it is not linked by default. I expect this is because gettext is a keg-only formula. You could tell homebrew to link the keg, but this might have unintended side-effects. A less intrusive approach is to setup an alias by addingalias envsubst='/usr/local/Cellar/gettext/0.19.6/bin/envsubst'to your.profile(or equivalent). Of course, you may have another version of gettext installed. You can learn about it by runningbrew info gettext. – trkoch Nov 10 '15 at 18:30 -
1@trkoch You probably want to alias
/usr/local/opt/gettext/bin/envsubstwhich survives upgrades – Christoph Hösler Dec 20 '17 at 17:40 -
1While this is the accepted answer, please scroll down to @cobberboy's answer, as it is also a common probably that you need to force the link. – Big Money Jun 8 '18 at 23:00
-
I wondered why I was suddenly getting more upvotes. Thanks for your generosity @ymonad – cobberboy Dec 3 '18 at 12:28
-
1Linking /usr/local/Cellar/gettext/0.19.8.1... 194 symlinks created ... wtf 194 symlinks? – Alexander Mills Jun 3 '19 at 21:12
brew install gettext
brew link --force gettext
This will enable envsubst on OS X, and force it to link properly. It requires homebrew to be installed.
-
1
Linking /usr/local/Cellar/gettext/0.19.8.1... 194 symlinks created... wtf 194 symlinks? – Alexander Mills Jun 3 '19 at 21:12 -
@AlexanderMills yeah
gettextincludes a hell of a lot of stuff; it seems like overkill just to getenvsubstinstalled but it's the quickest and simplest way. – cobberboy Jun 5 '19 at 2:10 -
seems like they're symlinking every file instead of just symlinking a folder – Alexander Mills Jun 5 '19 at 3:31
To clear up potential confusion:
envsubstis an external executable and thus not part of Bash; external executables are platform-dependent, both in terms of which ones are available as well as their specific behavior and the specific options they support (though, hopefully, there is a common subset based on the POSIX specifications)- Commands directly built into
bashare called builtins, and only they can be relied upon to be present on all platforms.
To test whether a given command is a builtin, use
type <cmdName>
In the case at hand, running type envsubst on macOS 10.13 returns -bash: type: envsubst: not found, from which you can infer:
envsubstis NOT a builtinenvsubstis not in your system's$PATH(and thus likely not present on your system)
(By contrast, running the same on command on, e.g., a Ubuntu 12.04 system returns envsubst is hashed (/usr/bin/envsubst), which tells you that the utility is present and where it is located.)
A makeshift alternative to envsubst is to use eval, although the usual caveat applies: use eval only on strings whose content you control or trust:
Assume a sample.txt file containing text with unexpanded variable references; e.g.:
cat > sample.txt <<'EOF'
Honey, I'm $USER
and I'm $HOME.
EOF
The equivalent of:
envsubst < sample.txt
is:
eval "echo \"$(sed 's/"/\\"/g' sample.txt)\""
There is a crucial difference, however:
envsubstexpands only environment variable references- whereas
evalwill expand shell variable references too - as well as embedded command substitutions, which is what makes use ofevala security concern.
-
I like the idea of
eval echobecause I trust the source but it's not the same..envsubst < .env.examplecan not just beeval echo < .env.example– iRaS Oct 20 '17 at 9:53
I'm using this now in my bash script that requires envsubst:
if ! which envsubst > /dev/null 2>&1; then
envsubst() {
while read line; do
line=$( echo $line | sed 's/"/\\"/g' )
eval echo $line
done
}
fi
you can use it as the envsubst command - of course it's not feature complete or something else:
envsubst <<<'Honey, I am $HOME.'
envsubst < input > output 2> corrupt
-
-
as said this is a workaround that is not feature complete. you could try adding
"around $line but I did not try this yet – iRaS Jul 20 '18 at 6:08
If you don't want to bother installing homebrew and gettext, a one line perl executable will do:
#!/usr/bin/perl -p
$_ =~ s/\Q${$1||$2}/$ENV{$1?$2:$4}/ while $_ =~ /(\$\{([^}]+)})|(\$(\w+))/g;
envsubstis included ingettextpackage. you may compile by your own. see stackoverflow.com/questions/14940383/… – ymonad May 13 '14 at 0:13