🎉 Random Winner Picker

🛠️ A Python-based tool to fairly and randomly select a winner from a list of participants.

Project Overview • Features • Installation • Usage • Contributing • License

---

📜 Project Overview

The Random Winner Picker is a simple yet powerful Python application designed to randomly and fairly pick a winner from a provided list of participants. Ideal for giveaways, contests, or any scenario where a random selection is required.

---

✨ Features

• Fair Random Selection: Ensures unbiased and random selection of winners.
• Customizable Input: Accepts a list of participants via text file or manual entry.
• Lightweight and Easy to Use: Minimal dependencies and straightforward setup.
• Extensible: Codebase designed for easy modification and additional features.

---

⚙️ Installation

1. Clone the repository:

   git clone https://github.com/ronknight/random-winner-picker.git
   cd random-winner-picker

2. Create and activate a virtual environment (optional but recommended):

   python -m venv venv
   source venv/bin/activate   # On Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

---

🚀 Usage

1. Prepare your list of participants in a CSV file (e.g., data.csv), with each participant's email listed in the first column. Example of data.csv:

   email
   alice@example.com
   bob@example.com
   charlie@example.com
   

2. Run the script:

   python app.py

3. The script will:

   • Load the participant data from the specified CSV file.
   • Simulate a "spinning wheel" animation to pick a random winner.
   • Display the winner in the console output.

4. Example Output:

   Welcome to the Random Winner Picker! 🎲
   Spinning the wheel: 100%|################| 30/30 [00:09<00:00,  3.28it/s]
   
   🎉 And the winner is... 🎉
   
   🌟 alice@example.com! Congratulations! 🌟
   

---

🤝 Contributing

Contributions are welcome! To contribute:

1. Fork the repository.
2. Create a new branch for your feature or bug fix:

   git checkout -b feature-name

3. Commit your changes and push to your branch:

   git commit -m "Add new feature"
   git push origin feature-name

4. Open a pull request on GitHub.

---

📜 License

This project is licensed under the MIT License.

---

❤️ Acknowledgements

Special thanks to the open-source community for inspiring and supporting this project.

---

⚠️ Disclaimer

This tool is designed for educational and entertainment purposes. The developer assumes no responsibility for misuse.