Metadata-Version: 2.4
Name: luvz
Version: 0.0.4
Summary: Lazy script builder
Author-email: luvbyte <lovemelong@protonmail.com>
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: cmd2
Requires-Dist: rich
Requires-Dist: pydantic
Dynamic: license-file

# luvz 💤  
A lightweight framework for building interactive Python scripts

`luvz` is a Python package built on top of [`cmd2`](https://cmd2.readthedocs.io) that makes it easy to build interactive, command-driven Python programs.  
It gives you a simple API for defining commands, handling user input, and extending functionality — perfect for creating REPL-like tools, admin shells, or prototypes.

---

## ✨ Features

- Simple API to create interactive command-line applications  
- Built on `cmd2` for history, tab completion, transcripts, and more  
- Minimal setup — just subclass and add commands  
- Great for prototypes, admin utilities, or sharing interactive tools  

---

## 📦 Installation

```bash
pip install luvz
```

(or clone and install locally:)
```bash
git clone https://github.com/luvbyte/luvz.git
cd luvz
pip install .
```
---
## ⚡ Why luvz?

Save time — skip boilerplate when building interactive shells

Enjoy rich features from cmd2 without the setup

Create professional-feeling CLI tools quickly

