# 🔐 EntroPy Password Generator - Issue Report

Thank you for contributing to the **EntroPy Password Generator**! Please fill out the sections below to help us understand and address your issue or suggestion. For guidelines on contributing, see our [CONTRIBUTING.md](https://github.com/gerivanc/entropy-password-generator/blob/main/CONTRIBUTING.md).

## 📌 Issue Description
Provide a clear and detailed description of the problem or suggestion. For example:
- "Running `entropy-password-generator --mode 1` raises an `ImportError`."
- "Suggest adding support for custom character sets in the CLI."

## 🔄 Steps to Reproduce
List the steps to reproduce the issue. For example:
1. Install the package via `pip install -i https://test.pypi.org/simple/ entropy-password-generator`.
2. Run `entropy-password-generator --mode 1`.
3. Observe the error: `[Error message]`.

## ✅ Expected Behavior
Describe what should happen instead. For example:
- "The command should generate a 24-character password with lowercase and special characters, with 139.92 bits of entropy."

## 🖥️ Environment Details
- **Operating System**: [e.g., Ubuntu 24.04, Windows 11, macOS Sonoma]
- **Python Version**: [e.g., 3.8, 3.10, 3.12]
- **Project Version**: [e.g., 0.4.8 from Test PyPI, or commit SHA]
- **Installation Method**: [e.g., Test PyPI, cloned repository, direct script execution]
- **Additional Context**: [e.g., dependencies, terminal output, system configurations]

## 📸 Screenshots or Logs
If applicable, include screenshots, terminal output, or log files to illustrate the issue. Use code blocks for logs:
```bash
[Insert terminal output or error message here]
```

## 🛠️ Possible Solutions
Share any ideas or suggestions for resolving the issue. For example:
- "Check for missing dependencies in `pyproject.toml`."
- "Add a validation step for CLI arguments."

## 🔗 Related Links
Provide links to similar issues, documentation, or discussions. For example:
- [CHANGELOG.md](https://github.com/gerivanc/entropy-password-generator/blob/main/CHANGELOG.md)
- [PASSWORDENTROPYCALCULATION.md](https://github.com/gerivanc/entropy-password-generator/blob/main/PASSWORDENTROPYCALCULATION.md)
- Related issue: #[Issue number]

## 💡 Additional Information
Include any other details that could help, such as:
- Frequency of the issue (e.g., always, intermittent).
- Workarounds attempted.
- Impact on usage (e.g., blocks CLI execution, affects specific modes).

## 🔒 Security Note
If this issue involves a security vulnerability, please follow the instructions in [SECURITY.md](https://github.com/gerivanc/entropy-password-generator/blob/main/SECURITY.md) to report it privately instead of posting here.

---

**Upvote or comment** if this issue affects you to help us prioritize it. Thank you for helping improve the **EntroPy Password Generator**! 🚀🔑

---

#### Copyright © 2025 Gerivan Costa dos Santos
