Skip to content

Commit

Permalink
refactor: rename the project to word_otter
Browse files Browse the repository at this point in the history
  • Loading branch information
Schuwi committed Sep 14, 2024
1 parent 019972f commit 4c08e3c
Show file tree
Hide file tree
Showing 3 changed files with 174 additions and 38 deletions.
138 changes: 102 additions & 36 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

8 changes: 6 additions & 2 deletions Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,14 +1,18 @@
[package]
name = "password_generator"
version = "0.1.0"
name = "word_otter"
version = "0.1.1"
edition = "2021"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[features]
force-cross = ["gmp-mpfr-sys/force-cross"]

[dependencies]
clap = { version = "4.1.8", features = ["derive"] }
color-eyre = "0.6.2"
rand = "0.8.5"
regex = "1.10.4"
rug = "1.19.2"
unicode-normalization = "0.1.22"
gmp-mpfr-sys = "~1.6"
66 changes: 66 additions & 0 deletions README
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# WordOtter

WordOtter is a secure and user-friendly password generator that creates strong passphrases using a list of words. The project aims to provide an easy-to-use tool for generating memorable yet secure passwords.

## Why "WordOtter"?

The name "WordOtter" was chosen because otters are playful and intelligent animals, which reflects the nature of this password generator. Otters are known for their dexterity and problem-solving skills, symbolizing the efficiency and effectiveness of WordOtter in creating secure passphrases. Additionally, the playful aspect of otters makes the tool seem approachable and fun to use.

## Features

- Generates strong passphrases using a list of words
- User-friendly and approachable interface
- Secure and robust password generation
- Customizable options for passphrase length and complexity

## Installation

To install WordOtter, you need to have Rust and Cargo installed on your system. You can install Rust and Cargo by following the instructions at [rust-lang.org](https://www.rust-lang.org/).

Clone the repository and navigate to the project directory:

```sh
git clone https://github.com/Schuwi/word_otter.git
cd word_otter
```

Build the project using Cargo:

```sh
cargo build --release
```

## Usage

After building the project, you can show the help message with the following command:

```sh
cargo run --release -- -h
```

You need to provide a word list as a file. By default the program will look for `wordliste.txt` in the current directory.\
The format is quite simple. It's just a list of words separated by line breaks.

You can customize the passphrase generation by providing additional options. For example, to generate a passphrase with a specific number of words:

```sh
cargo run --release -- 5
```

## Dependencies

WordOtter uses the following dependencies:

- `clap` for command-line argument parsing
- `color-eyre` for enhanced error reporting
- `rand` for random number generation
- `regex` for regular expression support
- `rug` for arbitrary precision arithmetic
- `unicode-normalization` for Unicode normalization

## Contributing
Contributions are welcome! Please feel free to submit a pull request or open an issue if you have any suggestions or improvements.

---

Enjoy using WordOtter and stay secure!

0 comments on commit 4c08e3c

Please sign in to comment.