Skip to content

README.md

Latest commit

 

History

History
169 lines (109 loc) · 3.44 KB

README.md

File metadata and controls

169 lines (109 loc) · 3.44 KB

🇬🇧 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.