Python Mini Utilities Hub 🐍

A beginner‑friendly open‑source project created for ACWOC. This repository contains a collection of small, independent Python utilities that are easy to understand and easy to contribute to.

Perfect for:

• First‑time open‑source contributors
• Python beginners
• Anyone who wants to make a quick, meaningful PR

🧭 Who is this for?

• Students preparing for technical interviews
• Beginners practicing common interview questions
• Anyone wanting instant AI-based feedback

---

📌 What’s Inside

Each utility is a standalone Python script:

• 🔐 Password Strength Checker
• 🔑 password generator
• 📝 Word Counter
• 💬 Random Quote Generator
• 📁 File Renamer (coming soon)
• ✅ Simple CLI To‑Do List
• 📑 Priority Based CLI To-Do
• 📱 QR Code Generator
• 🔄 Unit Converter
• 🌡️ Temperature Converter
• 🧩 Maze generator
• 💱 Currency Converter

Contributors can add new tools or improve existing ones.

---

📁 Project Structure

python-mini-utilities/
│
├── tools/
│   ├── password_checker.py      # Validate password strength
│   ├── password_generator.py    # Generate secure random passwords
│   ├── qr_code_generator.py     # QR code generator from text/URL
│   ├── quote_generator.py       # Random programming quotes
│   ├── temperature_convertor.py # Temperature conversion tool
│   ├── todo_cli.py              # CLI To-Do list with priority support
│   ├── todo_flask.py            # Flask-based To-Do app
│   ├── word_counter.py          # Word/character counter for text files
│   ├── unit_converter.py        # Convert between length, weight, volume
│   ├── maze.py                  # Maze generator & solver (Unicode terminal)
│   └── currency_converter.py    # Convert between different currencies
│
├── docs/
│   └── contributing.md          # Contribution guidelines
│
├── README.md                    # This file
└── todos.txt                    # Example storage for To-Do CLI

🚀 How to Run

1. Clone the repository

git clone https://github.com/SwaraMishra07/python-mini-utilities.git
cd python-mini-utilities

2. Run any script

python tools/password_checker.py

No external libraries required (unless mentioned).

---

🧠 Beginner Friendly by Design

• No frameworks
• Simple Python concepts only
• Each issue is small and independent
• Clear instructions provided

If you know basic Python (input, print, functions), you’re good to go.

---

🧩 How to Contribute

1. Check the Issues tab
2. Pick an issue labeled good first issue
3. Fork the repo
4. Create a new branch
5. Make your changes
6. Open a Pull Request

Please keep PRs small and focused.

---

🏷 Issue Labels

• good first issue – Perfect for beginners
• beginner – Requires basic Python knowledge
• enhancement – Small feature additions

---

📜 Contribution Rules

• Follow basic Python style
• Add comments where needed
• Test your script before submitting
• Be respectful and beginner‑friendly

---

💡 Ideas for New Contributors

• Add a new utility script
• Improve input validation
• Refactor existing code
• Improve documentation

---

Happy coding & welcome to open source 🚀