
# AdoLib

> A beginner-friendly utility library for Python developers.

**AdoLib** is a collection of small but helpful tools designed to make life easier for new Python developers. Whether you're just learning the language or building your first projects, AdoLib gives you lightweight, no-nonsense utilities like easy logging, formatting, and more — all in a beginner-friendly way.

---

## 🚀 Features

- ✅ **Simple Logger**: Color-coded console output with optional timestamps.
- 🔧 **Modular Structure**: Organized by feature (e.g., `adolib.logger`, `adolib.formatter`, etc.).
- 🧩 **Pluggable Utilities**: Add your own tools and utilities easily.
- 🐍 **Beginner-Centric**: Clean API design and easy-to-read source code.

---

## 📦 Installation

You can install AdoLib from PyPI:

```bash
pip install adolib
```

---

## 📘 Usage Example

```python
from adolib.logger import SimpleLogger

log = SimpleLogger()

log.info("Everything is running smoothly.")
log.warning("This might be a problem.")
log.error("Something went wrong.")
```

---

## 🔧 Contributing

Want to add your own utilities? Just fork the repo, add a new module under `adolib/`, and submit a pull request! We welcome beginner-friendly contributions and clear code.

---

## 📄 License

This project is licensed under the MIT License. See `LICENSE` for more information.

---

## ✨ Future Plans

- File and path utilities  
- Easy JSON/YAML handlers  
- CLI helper module  
- Decorators and timing tools  
- Educational examples in docs

---

> Built with ❤️ by Adovelopers
