Paz – Password Analyzer CLI

A simple Command Line Interface (CLI) tool for:

• Calculating password strength
• Checking if it has been leaked in well-known databases (Have I Been Pwned)

---

🚀 Features

• Strength Scoring
  Based on length, combination of uppercase/lowercase letters, digits, special characters, and avoiding very common words, gives your password a score out of 6.

• Breach Check
  Using the well-known Have I Been Pwned API, displays the number of times the password has been leaked in the past.

---

📦 Installation

From PyPI

pip install paz-cli

From Source

git clone https://github.com/MahdiMirshafiee/password-analyzer-cli
cd password-analyzer-cli
python3 -m venv venv
source venv/bin/activate       # Linux/macOS
# venv\Scripts\activate        # Windows PowerShell
pip install -e .

---

⚙️ Usage

Direct flag

paz -p 'MyP@ssw0rd!'
paz --password 'MyP@ssw0rd!'
# Password: MyP@ssw0rd!
# Strength: Strong (score: 5)
# Password found in 183 data breaches!

Hidden prompt

paz
# Enter password (input hidden): 
# Password: hidden input received
# Strength: Strong (score: 4)
# Password not found in known breaches

---

🆘 Help

paz --help

---

🛠 Contributing

1. Open an issue to suggest a feature or report a bug
2. Create a branch from dev:

git checkout dev
git checkout -b feature/your-feature-name

3. Commit and push your changes:

git add .
git commit -m "[Short description of changes]"
git push origin feature/your-feature-name

4. Open a Pull Request from your branch to dev

---

📄 License

This project is licensed under the MIT License – see the LICENSE file for details.