grepenv 1.0.5

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.

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

Development

This repo uses poetry as a build system, and invoke for task running.

inv can then be used to run as follows:

$ inv lint
$ inv test
$ inv build
$ inv --list # Shows available commands

---

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 for maintainability.

Another language might have been more fun to use, but since pip is by FAR the most available package manager (compared to say cargo), here we are.