konpeito

Crates.iokonpeito
lib.rskonpeito
version0.3.0
sourcesrc
created_at2022-09-02 05:50:17.950315
updated_at2024-06-28 20:32:03.08537
descriptionPersonal key-value store CLI
homepage
repositoryhttps://github.com/tau-OS/konpeito
max_upload_size
id657191
size61,248
crates.io Maintainer (github:fyralabs:crates-io-maintainer)

documentation

README

<img align="left" style="vertical-align: middle" width="120" height="120" src=https://user-images.githubusercontent.com/4886639/183321432-b17aa134-9f7a-41ee-91d2-778b6062813f.png>

Konpeito

Konpeito is a personal key-value store CLI that can be used to store anything securely to/from the system's keyring.

Crates.io License

How it works

Konpeito uses the Secret Service API (provided by the keyring crate) to store items. This means that the items are stored in the system's keyring, which is a secure(ish) way to store items. The keyring is encrypted and can only be accessed by the user that created it.

This mean that Konpeito is not an actual database, but a wrapper around the keyring API to store tokens, passwords, or any other kind of data and easily retrieve it for CLI usage or scripting. It also means that Konpeito relies on an existing keyring implementation, which means security is not guaranteed as the encryption is done by the keyring implementation, which varies depending on the OS, as follows:

OS Keyring implementation
Linux Linux keyutils, GNOME Keyring, or KWallet
macOS macOS Keychain
Windows Windows Credential Manager

Konpeito reads and writes values using Base64 encoding, this means that you can store any kinds of data, not limited to just text.

Usage

To store items:

konp set key value

If you want to store a file or something from stdin:

konp set key < file

To retrieve items:

konp get key

To delete keys:

konp delete key

To list all keys for konpeito:

konp list

Installation

Simply install this crate

From source:

cargo install --path .

From crates.io:

cargo install konpeito
Commit count: 7

cargo fmt