Metadata-Version: 2.4
Name: slush
Version: 0.1.3
Summary: A lightweight Python web framework.
Author-email: Hasan Faraz Khan <farazkhan138@gmail.com>
License: BSD-3-Clause
Project-URL: Homepage, https://github.com/farazkhanfk7/slush
Project-URL: Documentation, https://github.com/farazkhanfk7/slush
Project-URL: Source, https://github.com/farazkhanfk7/slush
Keywords: web framework,python,wsgi,slush,backend,api
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: gunicorn==23.0.0
Requires-Dist: packaging==25.0
Requires-Dist: watchdog==6.0.0
Requires-Dist: click==8.2.1
Dynamic: license-file

<p align="center">
  <img src="https://i.ibb.co/M5Pv76X0/slushlogo.png" alt="Slush Logo" width="480" />
</p>

# Slush

**Slush** is a lightweight Python web framework designed for clarity, extensibility, and performance.

---

## 🚀 Introduction

**Slush** is a lightweight and efficient Python web framework designed for building modern APIs with speed and simplicity.

Slush gives you full control over routing, requests, responses, middleware, and cookies—without locking you into a rigid structure or heavy dependencies.

Whether you're building microservices, internal tools, or full-fledged backend systems, Slush helps you move fast with clean, readable code and a powerful core that just works.

Perfect for:

- Rapid API development without boilerplate.
- Minimalist backend systems with full control.
- Developers who want a lean, customizable foundation.

---

## 📦 Installation

```bash
$ pip install slush
```


## A Simple Example

```python
# save this as main.py
from slush.app import Slush
from slush.core.response import Response

app = Slush()

@app.route("/hello", methods=["GET"])
def hello(request):
    return {"message": "Hello from Slush!"}
```

```python
# save this as run.py
from main import app
from slush.server import run

run(app, port=8000, debug=True)
```

## ▶️ Run the Server
### ✅ Using built-in CLI command
```bash
$ python3 run.py
```

### ✅ Using built-in CLI
```bash
$ slush runserver main:app
```
> Set `DEBUG=TRUE` for

### ✅ Or use gunicorn
```bash
$ gunicorn main:app
```

## 📄 License
This project is licensed under the BSD 3-Clause License.

## 🌐 Links

### 📘 Documentation: Coming soon
### 🐙 GitHub: https://github.com/farazkhanfk7/slush
### 📦 PyPI: https://pypi.org/project/slush
