https://github.com/kiran94/fuzzy-secret-stdout

Small utility to fuzzy search from a secret store and print the value to stdout
https://github.com/kiran94/fuzzy-secret-stdout

aws parameter-store secrets ssm

Last synced: about 1 month ago
JSON representation

Small utility to fuzzy search from a secret store and print the value to stdout

• Host: GitHub
• URL: https://github.com/kiran94/fuzzy-secret-stdout
• Owner: kiran94
• License: mit
• Created: 2023-12-23T09:49:44.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-01-20T09:39:30.000Z (over 2 years ago)
• Last Synced: 2025-09-28T01:03:55.399Z (9 months ago)
• Topics: aws, parameter-store, secrets, ssm
• Language: Python
• Homepage: https://pypi.org/project/fuzzy-secret-stdout/
• Size: 40 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# `fuzzy-secret-stdout`

> Small utility to fuzzy search from a secret store and print the value to stdout

[![main](https://github.com/kiran94/fuzzy-secret-stdout/actions/workflows/main.yml/badge.svg)](https://github.com/kiran94/fuzzy-secret-stdout/actions/workflows/main.yml)

![GitHub License](https://img.shields.io/github/license/kiran94/fuzzy-secret-stdout)

![PyPI - Version](https://img.shields.io/pypi/v/fuzzy-secret-stdout)

## Install

```bash

python -m pip install fuzzy-secret-stdout

```

Dependencies:

* Python 3.9+

* [`fzf`](https://github.com/junegunn/fzf?tab=readme-ov-file#installation)

* Valid [AWS Credentials](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html) available your terminal context

## Usage

```bash

# fuzzy search from secrets from aws parameter store

fuzzy-secret-stdout

# alias for the above

fss

# fuzzy search and explicitly specify the secret store to search

fss -i AWS_SECRET_MAN

# fuzzy search aws secret manager and pipe into jq

fss -i AWS_SECRET_MAN | jq .

```

## Integrations

`fuzzy-secret-stdout` supports the following secret stores:

| Secret Store                                                                                                                             | Command Line Argument  |

| -------------                                                                                                                            | ---------------------- |

| [AWS Systems Manager Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html) | `AWS_SSM`              |

| [AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html)                                            | `AWS_SECRET_MAN`       |

The *Command Line Argument* above is passed as the `-i` flag. `AWS_SSM` is the default.

## Environment Variables

| Environment Variables   | Description                                                                                                                                                                                                                       | Default  |

| ---------------------   | ----------                                                                                                                                                                                                                       | -------- |

| `FSS_MAX_BATCH_RESULTS` | The maximum number of results to request from the underlying secret service per batch. Note that this value might be rejected by the underlying secret service. For example `boto3` validates this value to be <= 50 for AWS SSM | `50`     |