#env #environment #export

app env-select

Easily switch between common values for arbitrary environment variables

15 releases (breaking)

0.11.0 Aug 24, 2023
0.9.0 Jul 31, 2023
0.2.0 Nov 12, 2022

#126 in Configuration

Download history 8/week @ 2023-08-01 20/week @ 2023-08-08 49/week @ 2023-08-15 22/week @ 2023-08-22 30/week @ 2023-08-29 12/week @ 2023-09-05 12/week @ 2023-09-19 4/week @ 2023-09-26 1/week @ 2023-10-03 5/week @ 2023-10-17 13/week @ 2023-10-24 16/week @ 2023-10-31 18/week @ 2023-11-14

51 downloads per month

MIT license

130KB
3K SLoC

env-select

license crates.io version

Easily switch between predefined values for arbitrary environment variables Features include (but are not limited to):

  • Interative prompts to select between variable profiles
  • Cascading config system, allowing for system and repo-level value definitions
  • Grab values dynamically via local commands or Kubernetes pods
  • Modify your shell environment with es set, or run a one-off command in a modified environment with es run
  • Re-use common variables between profiles with inheritance

Table of Contents

Simple Example

# .env-select.toml
[applications.server.profiles.dev]
variables = {SERVICE1 = "dev", SERVICE2 = "also-dev"}

[applications.server.profiles.prd]
variables = {SERVICE1 = "prd", SERVICE2 = "also-prd"}
> es set server
 === dev ===
SERVICE1=dev
SERVICE2=also-dev

  === prd ===
SERVICE1=prd
SERVICE2=also-prd
> echo $SERVICE1 $SERVICE2
dev also-dev

See the Usage Guide for more detailed examples.

Installation

Brew

brew install lucaspickering/tap/env-select

Cargo

cargo install env-select

Configure Your Shell

This may not be necessary, depending on what shell you use and how you installed env-select. The easiest way to check is to open a new shell and run es help. If it succeeds, you're good to go. If not, read on.

Because env-select modifies your shell environment, it requires a wrapper function defined in the shell that can call the env-select binary and automatically apply its output.

All commands in this README/usage guide assume you have the appropriate shell configuration. See the disclaimer for why this is needed.

Bash

echo 'eval "$(env-select --shell bash init)"' >> ~/.bashrc
source ~/.bashrc # Run this in every existing shell

Zsh

echo 'source <(env-select --shell zsh init)' >> ~/.zshrc
source ~/.zshrc # Run this in every existing shell

Fish

echo 'env-select --shell fish init | source' >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish # Run this in every existing shell

Restart your shell (or source <file>) after running the above command.

source Disclaimer

env-select runs as a subprocess to your shell (as all commands do), meaning it cannot modify your shell environment. To get around this, env-select will simply output shell commands that the shell plugins (or you) can then pipe to source (or eval) to modify your session.

If you think piping stuff to source is dangerous and sPoOky, you're right. But consider the fact that at this point, you've already downloaded and executed a mystery binary on your machine. You should've already done your due diligence.

Troubleshooting

es: command not found

Make sure you've configured your shell to load the es function automatically.

Bugs/Feedback

If you find a bug or have a feature request, please open an issue on GitHub.

Dependencies

~5–14MB
~177K SLoC