🇬🇧 Python Password Generator (CLI)

A secure and easy-to-use Python CLI application for generating strong passwords. The program uses the built-in secrets module to ensure cryptographically secure randomness and allows users to customize password length and character sets.

This project is intended both as a practical tool and as an educational example demonstrating best practices for password generation in Python.

---

Features

• 🔐 Cryptographically secure password generation (secrets module)
• 📏 Customizable password length (8–128 characters)
• 🔢 Optional numbers and special characters
• 🖥️ Simple and user-friendly CLI interface
• 🐍 Written in pure Python (no external dependencies)

---

Requirements

• Python 3.8+

---

Usage

Clone the repository:

git clone https://github.com/PotegaIT/python-password-generator-cli.git
cd python-password-generator-cli

Run the application:

python main.py

Follow the on-screen instructions to configure and generate your password.

---

Example

--- Secure Password Generator ---
Enter password length (min. 8, max. 128 characters): 16
Include special characters? (y/n): y
Include numbers? (y/n): y

Your secure password: Xf9!Aq7@LmP2#eR$

---

Project Structure

python-password-generator-cli/
├── main.py
├── README.md
└── LICENSE

---

Why secrets instead of random?

The secrets module is designed for generating cryptographically strong random numbers suitable for managing passwords, authentication tokens, and other security-sensitive data. Using random for password generation is not recommended.

---

License

This project is licensed under the MIT License.

---

Author

Created by PotegaIT Educational Python projects and tutorials.

---

🇵🇱 Generator Haseł w Pythonie (CLI)

Bezpieczna i prosta w użyciu aplikacja CLI napisana w Pythonie, służąca do generowania silnych haseł. Program wykorzystuje wbudowany moduł secrets, zapewniający kryptograficznie bezpieczną losowość oraz umożliwia konfigurację długości hasła i używanych zestawów znaków.

Projekt pełni zarówno funkcję praktycznego narzędzia, jak i materiału edukacyjnego pokazującego dobre praktyki tworzenia haseł w Pythonie.

---

Funkcje

• 🔐 Bezpieczne generowanie haseł (moduł secrets)
• 📏 Konfigurowalna długość hasła (8–128 znaków)
• 🔢 Opcjonalne cyfry i znaki specjalne
• 🖥️ Prosty i czytelny interfejs CLI
• 🐍 Czysty Python (brak zewnętrznych bibliotek)

---

Wymagania

• Python 3.8+

---

Użycie

Sklonuj repozytorium:

git clone https://github.com/PotegaIT/python-password-generator-cli.git
cd python-password-generator-cli

Uruchom program:

python main.py

Postępuj zgodnie z instrukcjami wyświetlanymi w terminalu.

---

Przykład

--- Secure Password Generator ---
Enter password length (min. 8, max. 128 characters): 16
Include special characters? (y/n): y
Include numbers? (y/n): y

Your secure password: Xf9!Aq7@LmP2#eR$

---

Dlaczego secrets, a nie random?

Moduł secrets został zaprojektowany do generowania losowych wartości odpornych na przewidywanie, odpowiednich do haseł i danych wrażliwych. Moduł random nie powinien być używany do celów bezpieczeństwa.

---

Licencja

Projekt udostępniony na licencji MIT.

---

Autor

Autor: PotegaIT Edukacyjne projekty i materiały do nauki Pythona.