A playful yet practical Python library packed with mini-modules for creative coding, automation experiments, and terminal fun.
py-libs is your mini-toolkit of Python scripts designed for quick creativity — whether you’re building a fun CLI project, testing logic, or exploring how small utilities evolve into full-fledged packages.
Each module is self-contained yet extendable — perfect for learners who want to practice Python concepts (functions, imports, randomness, data structures, file I/O) while creating something delightful.
| 🧩 Module | ⚙️ Description | 🧠 Concepts Practiced |
|---|---|---|
| 🎭 MadLibs Generator | Interactive word-based story builder. Input random words and watch a story unfold! | Strings, Input/Output, Randomization |
| 😂 Joke Generator | Returns a random programming or general joke every time. | Lists, Random module |
| 💬 Quote Generator | Displays a random motivational or witty quote from curated collections. | File handling, Functions |
| 🧮 Math Tricks (experimental) | Showcases small algorithmic tricks or fun numeric patterns. | Logic building, Loops |
| 🧠 Trivia & Riddles (planned) | Challenge mode with riddles or trivia questions. | Conditionals, Dictionaries |
| 🖼️ ASCII Art Engine (coming soon) | Convert text into ASCII visuals for terminal art. | Algorithms, Character mapping |
| 🧰 Utils (core) | Common helper functions and template code reused across modules. | Modular programming |
- 🧩 Plug-and-Play — Run any file directly or import into your own scripts.
- 🔁 Modular — Each module works independently but shares a common style.
- 🧠 Educational — Perfect for learning Python through creative tasks.
- 🎨 Expandable — Add your own mini-module and submit a PR!
- 💬 Community-Driven — Fun scripts from developers, for developers.
Think of
py-libsas your Python playground — where logic meets creativity.💡 From a simple quote generator today to a meme bot tomorrow — it’s all about small ideas evolving into big ones.
- Clone the repository:
git clone https://github.com/bugOpsX/py-libs.git
cd py-libs
cd src-
Make sure you have Python installed (Python 3.8+ recommended).
-
Install dependencies (if any):
pip install -r requirements.txt
I welcome contributions from the community! Here’s how you can contribute:
-
Fork the Repository Click the Fork button at the top-right corner of this page to create a copy of the repository in your GitHub account.
-
Clone Your Fork
git clone https://github.com/your-username/py-libs.git -
Create a Branch Create a new branch for your contribution:
git checkout -b feature/your-feature-name
-
Make Your Changes Add new programs, scripts, or improvements. Follow the folder structure (C++/PYTHON). Add comments and make your code clean and readable.
-
Commit Your Changes
git add .
git commit -m "Add your message here"
-
Push to Your Branch
git push origin feature/your-feature-name- Create a Pull Request
Go to your forked repository on GitHub. Click Compare & Pull Request. Provide a description of your changes and submit the PR.
Your contribution will be reviewed and merged if everything looks good! 🎉 Happy Coding! 🚀