grepenv 1.0.2

grep's the env

grepenv

greps your env 🔎

About

A simple tool to search through your environment.
Provides additional options for highlighting, searching specifically keys or values, and extracting values from best match keys.

You can achieve similar results with a one liner bash alias, but after having rewritten that alias on every machine I've used, I decided to turn it into a package.

Installation

grepenv can be installed using pip, but pipx is recommended:

pipx install grepenv

This installs the grepenv shell script:

grepenv --help

Usage

grepenv takes a regex pattern, and matches it against currently available environment variables.
Calling grepenv --example will show some example usage.

$ grepenv xdg # Will find any key or value that contains the letters xdg (lower or upper case).

$ grepenv "_api_(key|token)_" -k # finds any environment that looks like an api key. Searches only keys.
GITHUB_API_TOKEN=abc_NlNhalNDL78NAhdKhNAk78bdf7f
OPENAI_API_KEY=123_abcdefghijklmno

$ grepenv -fk git # find-key 'git'- finds all keys matching the pattern 'git' and gets their values.
123_abcdefghijklmnop