#mnemonic #word-list #docker

mnemonic-generator

A library to generate Docker-like mnemonics

2 releases

new 0.1.1 Dec 15, 2024
0.1.0 Dec 15, 2024

#319 in Unix APIs

Download history 94/week @ 2024-12-09

94 downloads per month

MIT license

71KB
429 lines

Mnemonic Generator

A lightweight Rust library for generating Docker-like mnemonics.

Installation

Add the following to your Cargo.toml:

[dependencies]
mnemonic-generator = "0.1.0"

Usage

Basic Usage

use mnemonic_generator::MnemonicGenerator;

fn main() {
    // Create a generator with default words
    let generator = MnemonicGenerator::new();

    // Generate a mnemonic with default underscore separator
    match generator.generate() {
        Ok(mnemonic) => println!("Generated mnemonic: {}", mnemonic),
        Err(e) => eprintln!("Error: {}", e)
    }
}

Custom Word Lists

use mnemonic_generator::MnemonicGenerator;

fn main() {
    // Create a generator with custom words
    let generator = MnemonicGenerator::with_words(
        vec!["amazing".to_string(), "legend".to_string()],
        vec!["jordan".to_string(), "larry".to_string()]
    );

    // Generate a mnemonic with a custom separator
    match generator.generate_with_separator("-") {
        Ok(mnemonic) => println!("Custom mnemonic: {}", mnemonic),
        Err(e) => eprintln!("Error: {}", e)
    }
}

Error Handling

The library provides a MnemonicError enum to handle potential generation errors:

  • EmptyWordList: Occurs when no words are available for generating a mnemonic

License

[MIT License]

Dependencies

~0.5–1MB
~22K SLoC