dworshak 1.2.4

Manage local, encrypted credentials. The dworshak CLI leverages openssl, sqlite3, and cryptography.

Dworshak 🌊

Dworshak a cross-platform credential management solution. It is a sister project of the dworshak-secret library.

---

Quick Start

# Install the CLI (for most environments)
pipx install "dworshak[crypto]"

# Bootstrap the security layer
dworshak setup

# Register your first API
dworshak store --service rjn_api --item username

---

dworshak --help:

See the helptree, imported from the typer-helptree library.

• GitHub: https://github.com/City-of-Memphis-Wastewater/typer-helptree
• PyPI: https://pypi.org/project/typer-helptree/

dworshak helptree

---

Sister Project:

Library: dworshak-secret

GitHub: https://github.com/City-of-Memphis-Wastewater/dworshak-secret

PyPI: https://pypi.org/project/dworshak-secret/

pip install dworshak-secret
# or,  uv add dworshak-secret

---

🏗 The Ultimate Vision

To become a stable credential management tool for scripting the flow of Emerson Ovation data and related APIs, supporting multiple projects in and beyond at the Maxson Wastewater Treatment Plant.

• The Method: "Do one boring thing well." Use Industry-standard AES (Fernet) encryption to manage a local ~/.dworshak/ directory which includes a .key file, a vault.db encrypted credential file, and a config.json file for controlling defaults.

🚀 Attributes

• Secure Vault: Fernet-encrypted SQLite storage for API credentials.
• Root of Trust: A local .key file architecture that works identically on Windows and Termux.
• CLI Entry: A typer-based interface for setup and credential management.

---

Typical installation

pipx install "dworshak[crypto]"

Termux installation

pkg install python-cryptography
pipx install dworshak --system-site-packages

iSH Apline installation

apk add py3-cryptography 
pipx install dworshak --system-site-packages