需要理解的内容

• 密码短语生成方案通常通过使用配置结构来创建。这种结构将提供各种可配置字段，并基于它构建相应的方案以生成密码短语。

生成密码短语的一般步骤

• 构建并配置配置结构，例如 BasicConfig。
• 配置结构创建相应的密码短语生成方案。
• 使用该方案生成所需数量的密码短语。
• 相反，可以使用 passphrase() 辅助方法生成不带配置的密码短语，以方便使用。

看看，这并不困难，但允许极大的可扩展性。你可能不会使用这个包提供的大多数功能。
查看 BasicConfig 了解如何配置您的第一个密码短语生成器。

其他需要了解的内容

• 此包提供了一组用于特定任务的组件，可以构建自定义组件。
• 此包提供了一个 WordList 结构，用于存储静态词表，可以使用内置的词表或从指定的文件加载词表。
• 可以根据 WordList 构造一个 WordSampler，以允许以均匀的方式随机采样单词。这样的采样器通常用作配置结构中的单词提供者。

示例

以下是如何使用此包的一些基本示例。

首先在您的 Cargo.toml 中将 chbs 添加为依赖项

[dependencies]
chbs = "0.0.8"

使用辅助函数应用库默认值生成不带配置的密码短语（passphrase.rs）

extern crate chbs;
use chbs::passphrase;

println!("Passphrase: {:?}", passphrase());

使用 cargo run --example passphrase 运行它。

推荐使用配置生成密码短语，以下是一个基本示例（passphrase_config.rs）

extern crate chbs;
use chbs::{config::BasicConfig, prelude::*, probability::Probability};

// Build a custom configuration to:
let mut config = BasicConfig::default();
config.words = 8;
config.separator = "-".into();
config.capitalize_first = Probability::from(0.33);
config.capitalize_words = Probability::half();
let mut scheme = config.to_scheme();

println!("Passphrase: {:?}", scheme.generate());
println!("Entropy: {:?}", scheme.entropy().bits());

使用 cargo run --example passphrase_config 运行它。

使用单词采样器根据词表生成无限数量的随机单词（sampler.rs）

extern crate chbs;
use chbs::word::WordList;

let words = WordList::default();
let sampler = words.sampler().into_iter();

for word in sampler.take(8) {
    println!("Sampled word: {:?}", word);
}

使用 cargo run --example sampler 运行它。

查看 ./examples 目录中的所有示例。

附加说明

• 此包仍在开发中，因此应谨慎使用
• 此库生成的密码或密码短语的质量不提供任何保证
• 熵计算可能存在错误

许可证

本项目采用MIT许可证发布。请查看LICENSE文件获取更多信息。