Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/njs-guy/keysmith-rs

Create keys, uuid's, timestamps, and more with Rust.
https://github.com/njs-guy/keysmith-rs

database library rust rust-crate rust-lang rust-library rustlang utilities utility utility-library

Last synced: 24 days ago
JSON representation

Create keys, uuid's, timestamps, and more with Rust.

Awesome Lists containing this project

README

        

# Keysmith

Create keys, uuid's, timestamps, and more with Rust.

Here's some example keys:

```text
[email protected]
[email protected]
M3rkxIbrD0lz-SpUBe704X2)Gd(_WprzRJW7N51O@_58180Gs9esIVBO5.OdFOlY
```

This looks like gibberish, but that's the point.
Two id's in a database should not overlap.
So if you need a lot of entries, you need to reduce the odds of that happening.
If the odds of two identical id's are astronomically low,
you shouldn't even need to check for an existing id in the first place.
Keysmith does that generation for you and outputs it as a String.

You can also generate version 4 UUID's.

```text
be3b5529-931b-6b75-1678-a057bccf71c9
440146ab-a19a-8a36-2d4b-ba19a79570d4
0090da40-6ce2-59d3-629d-11b293c9e2d3
```

Keysmith also supports many other data formats.
- Keys strings from custom character sets
- "Nonstandard" V4 UUID's using any letter as opposed to just a-f
- Timestamps (ex: 50546851)
- Dates (ex: 2023-07-17), times (ex: 19:34:07), and datetimes (ex: 2023-07-17T19:34:07)
- Individual characters

## Usage

For usage, see the [documentation](https://docs.rs/keysmith/latest/keysmith/).

For installation, see [crates.io](https://crates.io/crates/keysmith).

## Changelog

You can find the changelog in [CHANGELOG.md](CHANGELOG.md).

## Building

1. Install [rustup](https://www.rust-lang.org/tools/install) if you haven't already.
2. Clone this repo. Usually with `git clone https://github.com/njshockey/keysmith-rs.git`.
3. Run `cargo build` or `cargo build --release` to build.
- To run the test package, run `cargo run -p usage` instead.

## License

Keysmith uses the Rust standard MIT/Apache-2.0 dual license for best
compatibility. See
[LICENSE-APACHE.txt](LICENSE-APACHE.txt) and [LICENSE-MIT.txt](LICENSE-MIT.txt)
for the full licenses.