rs-env

Features

• Compile your environment variables from a hierarchical list of <name>.env files.
• Dependencies form a tree, each file can have one parent (no DAG).
• Last defined variable wins, i.e. child tops parent.
• Quick selection of environments via builtin FZF (fuzzy find).
• Quick edit via builtin FZF.
• Smart edit of dependency trees side-by-side
• Chain your dependencies with one command
• direnv integration: Have the resulting variable list documented in your .envrc file.
• JetBrains integration via EnvFile plugin.

Concept

Installation

bash cargo install rs-env

Usage

• branch: a linear list of files, each file can have one parent (no DAG). It defines the resulting set of variables.
• environment variables are defined in files <name>.env and must be prefixed with export command (see examples)
• tree: a collection of branches (environment files can be part of multiple branches)
• multiple trees per project are supported
• files are linked into a branch either manually by adding the comment line # rsenv: <name.env> or via rsenv link <root.env> <child1>.env <child2>.env.

That's it. Now you can source the resulting set of variables as usual: bash source <(rsenv build <leaf-node.env>)

```bash Hierarchical environment variable management

Usage: rsenv [OPTIONS] [NAME] [COMMAND]

Commands: build Build the resulting set of environment variables (evaluate branch) envrc Write the resulting set of variables to .envrc (requires direnv) files Show all files involved in branch, forming the resulting variable set edit Edit the FZF selected branch select FZF based selection of environment and update of .envrc file (requires direnv) link Link files into a dependency branch/tree branches Show all branches (linear representation) tree Show all trees (hierarchical representation) tree-edit Edit branches of all trees side-by-side (vim required in path) help Print this message or the help of the given subcommand(s)

Arguments: [NAME] Optional name to operate on

Options: -d, --debug... Turn debugging information on --generate [possible values: bash, elvish, fish, powershell, zsh] --info
-h, --help Print help -V, --version Print version ```

Basic

Select via FZF

Tree and Branch structure (Smart edit)

Integrations

direnv

direnv activates environments automatically. - rs-env can update the .envrc file with the selected dependency graph variables.

JetBrains Integration

Life injection of environment variables: - Plugin EnvFile can be used to life-inject environment variables. - Use the script runenv.sh as the "EnvFile" script (tick executable checkbox !). - The environment variable RUN_ENV parametrizes which environment to load. - It will look for a file <RUN_ENV>.env in the specified directory.

Development

• Tests for "skim" need valid terminal, so they are run via Makefile.
• Test for rsenv select: run debug target and check rsenv .envrc file.