Skip to content

leavelet/poetry-pass-rs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Poetry Pass

A memorable password generator using Chinese poetry and pinyin.

使用中国诗词和拼音生成易记密码的工具。

Features

  • Multiple modes: Full pinyin, initials, or original Chinese
  • Dual mode: Different transformations for different parts
  • Source specification: Choose specific combinations (word-poem, poem-word, etc.)
  • Configurable: Custom separators, optional numbers
  • Poetry & words: Mix classical poetry with common words

Installation

cargo add poetry-pass

Usage

use poetry_pass::{Generator, generate, generate_chinese};

// Default generation (full pinyin)
let password = generate();
// Example: "yingwu-guilaojianghubian-6694"

// Chinese original
let password = generate_chinese();
// Example: "鹦鹉-归老江湖边-5678"

// Initials only
let password = Generator::new().initials().generate();
// Example: "yw-gljhb-9012"

// Dual mode: front full pinyin, back initials
let password = Generator::new().front_full_back_init().generate();
// Example: "huaduo-hlzdc-1234" (花朵-红楼梦里的春天 -> huaduo-hlzdc)

// Dual mode: front initials, back full pinyin  
let password = Generator::new().front_init_back_full().generate();
// Example: "hd-honglouzichuntiande-5678" (花朵-红楼梦里的春天 -> hd-honglouzichuntiande)

// Custom configuration
let password = Generator::new()
    .poetry_only()
    .separator("_")
    .no_number()
    .random_capitalize()
    .generate();
// Example: "yingWu_guiLaojianghubIan"

// Generate with source for memorization
let (password, source) = Generator::new().generate_with_source();
println!("Password: {}", password);
println!("Source: {}", source);

// Specify source combinations
let password = Generator::new().words_poetry().generate();
// Example: "huaduo-yuelangxingxi-1234" (word-poem)

API

Generator Methods

  • new() - Create with default settings
  • initials() - Use pinyin initials
  • full_pinyin() - Use full pinyin (default)
  • chinese() - Keep original Chinese
  • poetry_only() - Use only poetry
  • words_only() - Use only words
  • words_poetry() - Front: words, back: poetry
  • poetry_words() - Front: poetry, back: words
  • words_words() - Front: words, back: words
  • poetry_poetry() - Front: poetry, back: poetry
  • dual_mode(front, back) - Set different transformation modes for front and back parts
  • front_full_back_init() - Front part uses full pinyin, back part uses initials
  • front_init_back_full() - Front part uses initials, back part uses full pinyin
  • separator(sep) - Set custom separator
  • no_number() - Don't add random number
  • random_capitalize() - Enable random capitalization
  • generate() - Generate password
  • generate_with_source() - Generate with source text
  • generate_multiple(count) - Generate multiple passwords

Convenience Functions

  • generate() - Quick generation with defaults
  • generate_chinese() - Quick Chinese generation

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

About

A memorable password generator using Chinese poetry and pinyin.

Resources

License

Stars

Watchers

Forks

Packages

No packages published