Skip to main content

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

Project description

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:

Screenshot of the Dworshak CLI --help

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

dworshak helptree

Screenshot of the Dworshak CLI 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dworshak-1.2.1.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dworshak-1.2.1-py3-none-any.whl (8.2 kB view details)

Uploaded Python 3

File details

Details for the file dworshak-1.2.1.tar.gz.

File metadata

  • Download URL: dworshak-1.2.1.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for dworshak-1.2.1.tar.gz
Algorithm Hash digest
SHA256 6ce78c676c89d9d2682a43d68de8a28c45a21c259faa90ff6fa9289ad0d6c71c
MD5 a1ef73f8af6a76c248bbc47757b429a8
BLAKE2b-256 ca22424bc04568faf4d65ad3ad97c728547a629efdcf6ec8d97b3a92659696b9

See more details on using hashes here.

Provenance

The following attestation bundles were made for dworshak-1.2.1.tar.gz:

Publisher: publish.yml on City-of-Memphis-Wastewater/dworshak

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file dworshak-1.2.1-py3-none-any.whl.

File metadata

  • Download URL: dworshak-1.2.1-py3-none-any.whl
  • Upload date:
  • Size: 8.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for dworshak-1.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 91e01668bc8a2b5c4e8494a77a1deb805fc54eec5d964f1d776d8885e41eaac3
MD5 8274d1e17b017647bc1ca2ac69a9e35f
BLAKE2b-256 9afc5071660041096e36e7324d3563e44e3ac045456634f56eb420386deeb78d

See more details on using hashes here.

Provenance

The following attestation bundles were made for dworshak-1.2.1-py3-none-any.whl:

Publisher: publish.yml on City-of-Memphis-Wastewater/dworshak

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page