Welcome to the Password Generator project! This project is a simple Flask web application that allows users to generate passwords with specific requirements, such as containing numbers, letters, and symbols. Users can also choose the number of characters they want in their passwords.
Follow the instructions below to set up the project and create a virtual environment to work on the Password Generator application.
Make sure you have the following software installed on your system:
- Python 3.x
- pip (Python package manager)
-
Clone the repository:
git clone https://github.com/your-username/password-generator.git cd password-generator -
Create a virtual environment:
I recommend creating a virtual environment to manage the dependencies of this project and ensure isolation from other projects.
On macOS and Linux:
python3 -m venv venv
source venv/bin/activate
On windows
python -m venv venv
venv\Scripts\activate
After activation, your command prompt should show the name of the virtual environment in the prompt, indicating that you are now working within the virtual environment.
- Install project dependencies:
pip install -r requirements.txt
To run the Password Generator application, follow these steps:
- Ensure you have activated the virtual environment (if you haven't already done so):
On macOS and Linux:
source venv/bin/activate
On Windows:
venv\Scripts\activate
- Start the Flask development server:
python app.py
-
Open your web browser and navigate to http://127.0.0.1:5000/.
-
Use the form on the webpage to specify the password length and choose the types of characters you want in the generated password (digits, letters, symbols).
-
Click on the "Generate Password" button to get a password that meets your requirements. The first and last characters of the password will always be letters if you select the "Include Letters" option.
-
To stop the Flask development server, press Ctrl + C in the terminal.
Remember to deactivate the virtual environment when you are done working on the project:
deactivate
We welcome contributions from the community to make this project better. If you'd like to contribute, please follow these steps:
-
Fork the repository on GitHub.
-
Clone your forked repository to your local machine.
-
Create a new branch for your contribution:
git checkout -b feature/your-feature-name
-
Make your changes and commit them with a descriptive commit message.
-
Push the changes to your forked repository:
git push origin feature/your-feature-name
- Create a pull request (PR) on the original repository.
I will review your contribution and merge it if it aligns with the project's goals. Thank you for your contribution!