# xenv
![GitHub Actions](https://github.com/silver-panda/xenv/workflows/CI/badge.svg)
A cross-shell env sourcing command.
I use [fish](https://fishshell.com) a lot, but I also like to do
```bash
source .env
```
when I want to source specific environment variables for a shell session.
As far as I know `fish` doesn't have this capability (natively), and I figured I would write something that could work across different shells, just in case I switch to `zsh` or something else.
## installation and usage
To install it, you need `cargo` installed. Once installed run the following command:
```fish
cargo install xenv
```
```fish
# this will look for a .xenv file in your current working directory
xenv echo hello this is my command
# you can also override this with the XENV_PATH environment variable
# if using fish < 3.1, you'll need to do 'env XENV_PATH
XENV_PATH=xenv.env xenv env | rg foo
```
## .xenv file format
It'll follow the format for any `.env` file, but for reference, here's the [docker-compose .env rules](https://docs.docker.com/compose/env-file/#syntax-rules)
```bash
# here is an example
FOO=bar
# it's case insensitive
foo=bar
# empty keys will be skipped
=qux
# empty values are allowed
BANG=
```