Renus
Renus is a lightweight, async-first ASGI framework and toolkit for building Python web applications and services. It provides routing, HTTP and WebSocket handling, middleware, lifecycle hooks, caching, scheduling, validation, and an async database layer while keeping the core dependency footprint small.
- Current version: 3.0.0
- Python: 3.11+
- License: BSD-3-Clause
- Documentation: codenus.com/renus
- Source: github.com/kak-smko/renus
Features
- ASGI application support for HTTP, WebSockets, and lifespan events
- Decorator-based and fluent routing with typed path parameters
- Text, HTML, JSON, redirect, file, streaming, and private responses
- Application, router, and route-level middleware
- Request parsing for headers, cookies, query parameters, JSON, forms, and uploads
- Built-in XSS protection for form and WebSocket input helpers
- Background tasks and startup/shutdown hooks
- File- and Redis-backed caching, including route and function caching
- Async ORM with models, validation, repositories, queries, mutations, and transactions
- SQLite, MySQL, and MongoDB integrations through optional dependencies
- Database migrations, backup/restore, and plugin hooks
- Fluent task scheduling and a built-in
renusCLI
Installation
Renus requires Python 3.11 or newer. Install the core package with pip:
python -m pip install renus
Renus is an ASGI framework. Install the server extra when you want to run an
application with Uvicorn or with App.run():
python -m pip install "renus[server]"
Optional extras are available for additional integrations:
| Extra | Provides |
|---|---|
server |
Uvicorn |
mongo |
MongoDB support via pymongo |
mysql |
MySQL support via aiomysql |
redis |
Redis caching support |
all |
All runtime integrations |
dev |
Development and benchmarking dependencies |
Install from source in editable mode:
git clone https://github.com/kak-smko/renus.git
cd renus
python -m pip install -e ".[dev]"
Quick start
Create main.py:
from renus.app import App
from renus.response import JsonResponse, TextResponse
app = App()
@app.get("/")
def home():
return TextResponse("Hello, world!")
@app.get("/users/{username}")
def user(username):
return JsonResponse({"name": username})
Run the application with Uvicorn:
uvicorn main:app --host 127.0.0.1 --port 8000 --reload
Then visit http://127.0.0.1:8000/ or call the parameterized route:
curl http://127.0.0.1:8000/users/renus
# {"name":"renus"}
You can also use Renus's convenience runner:
if __name__ == "__main__":
app.run(host="127.0.0.1", port=8000, reload=True)
python main.py
WebSockets
WebSocket routes use @app.route(..., method="WS"):
from renus.websockets import WebSocketDisconnect
@app.route("/echo", method="WS")
async def echo(ws):
await ws.accept()
try:
async for message in ws.iter_text():
await ws.send_text(message)
except WebSocketDisconnect:
pass
Database example
Renus includes an async ORM. The following example uses the built-in SQLite adapter:
from renus.db import Database, DatabaseField, Field, Model, SQLiteAdapter
class User(Model):
id: int = Field(database=DatabaseField(primary_key=True, generated=True))
username: str = Field(database=DatabaseField(unique=True))
email: str
async def create_user():
async with Database(SQLiteAdapter({"database": "storage/app.sqlite"})) as db:
await db.create_schema([User])
users = db.repository(User)
return await users.create(
User(username="ada", email="ada@example.com")
)
For production applications, initialize shared database resources in an application lifespan hook and use migrations for schema changes.
CLI
The package exposes both a renus command and a module entry point:
renus --help
renus --version
python -m renus --help
Project commands can be added under a project's commands/ directory. See the
CLI documentation for command discovery,
scaffolding, database commands, and extensions.
Documentation
The full documentation covers:
- Installation
- Quick start
- Project structure
- Application and routing
- Requests and responses
- Middleware
- WebSockets
- Lifespan and background tasks
- Caching and scheduling
- Database, models, queries, and migrations
- Validation and security
- CLI reference
Development
Install the development dependencies and run the test suite:
python -m pip install -e ".[dev]"
pytest
Run a focused test module while developing:
pytest tests/test_routing.py
Contributing
Bug reports, documentation improvements, tests, and code contributions are welcome. Please keep changes focused, add regression tests for behavior changes, and follow the existing project style.
Support Renus
If Renus is useful to you, please consider giving the project a star on GitHub. It helps others discover the framework and supports continued development.
A GitHub star is appreciated but voluntary; it is not a condition of using, copying, modifying, or distributing Renus under the BSD 3-Clause License.
License
Renus is distributed under the BSD 3-Clause License.
1 maintainer
Metadata
1 maintainer
Release files for renus 3.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| renus-3.0.0.tar.gz | 303.6 kB | Details |
Built distributions (wheels)
Total release size: 6.6 MB
Release files / renus-3.0.0.tar.gz
| Download URL | renus-3.0.0.tar.gz |
|---|---|
| Size | 303.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dc8f245bd61dc1924f6bec0474ab4016b183e47f9fd1d7d4c2e90ae35d7b8552
|
|
BLAKE2b-256 checksum How to use checksums |
003f110db78d84093f5c7b0be0329dd165ad00bf7387582a7ec29f36e53c1032
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp312-cp312-win_amd64.whl
| Download URL | renus-3.0.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 347.8 kB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
bb8dadce92020b0a7047bae03ccb4b6e7582a58a45b157978eba1c503dbc1f91
|
|
BLAKE2b-256 checksum How to use checksums |
3e056013e66c1f32313d94e0d7748d6c7e2b5cc1ba34b9987c8b26a27bd658b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp312-cp312-musllinux_1_2_x86_64.whl
| Download URL | renus-3.0.0-cp312-cp312-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 536.7 kB |
| Tags | CPython 3.12 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
b3cea08dcb442a9028e4fa4f60fcb61648f0137a961ca989fa374e58d86fbb58
|
|
BLAKE2b-256 checksum How to use checksums |
1c64e033a476261ed0cc4bbe476d2887454e6fc2bc86d161d8a357f203252fc6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp312-cp312-musllinux_1_2_aarch64.whl
| Download URL | renus-3.0.0-cp312-cp312-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 530.0 kB |
| Tags | CPython 3.12 Linux musl 1.2+ ARM64 |
|
SHA-256 checksum How to use checksums |
f657f5291398501685c0583544b3a063e58fff3e192fcf36066eb1c2337546b2
|
|
BLAKE2b-256 checksum How to use checksums |
0f379e44f1dfb8e2a0633b0de849644d615b2e20913898d5b1b0081721f8ba44
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | renus-3.0.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 531.2 kB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
8c5ff0db564d10e64774fec68e90b90ee519d5205506cf221eadadd7e66f37b8
|
|
BLAKE2b-256 checksum How to use checksums |
6cc7bf04bcf441e3884adfa66321a83aec40dbd1c49d4db726bc94857e52ada9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl
| Download URL | renus-3.0.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl |
|---|---|
| Size | 535.9 kB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 Linux glibc 2.5+ x86-64 |
|
SHA-256 checksum How to use checksums |
3701d189f4903533e9ca9160836468f58a62548fb4bb51e5f4e6f9c70262fe91
|
|
BLAKE2b-256 checksum How to use checksums |
3b84e13b2b4b62f2a5c862015cef601f4c4cb220977ad946db97cad4360a7976
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | renus-3.0.0-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 352.5 kB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
32e425a6376b6ae74127efcaa58510b769f9f984e87bce1078a1af61131cfb65
|
|
BLAKE2b-256 checksum How to use checksums |
bebe5a26910ca6b3ea4721bb0b0732003f9fe95d624906239bee68c97be4106a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp312-cp312-macosx_10_13_x86_64.whl
| Download URL | renus-3.0.0-cp312-cp312-macosx_10_13_x86_64.whl |
|---|---|
| Size | 352.3 kB |
| Tags | CPython 3.12 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
1e11aaaa57c1e6a61b831982aecef46167f36ed2f999b11f5fc042915d39604d
|
|
BLAKE2b-256 checksum How to use checksums |
d078e0b3fdd4f5ca82b419468bb9f701e92ef5594b0caf180c19a3741a3de51d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp311-cp311-win_amd64.whl
| Download URL | renus-3.0.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 347.6 kB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
0351408f6747b910f5ede7ad80a2fd4e48ef5e52c7f7bc2c610d453021d8bdb9
|
|
BLAKE2b-256 checksum How to use checksums |
a436f5acce994305fbeee7ab00ef48be54ce7527f63298ce94b1b236d47f7145
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp311-cp311-musllinux_1_2_x86_64.whl
| Download URL | renus-3.0.0-cp311-cp311-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 523.1 kB |
| Tags | CPython 3.11 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
06c7460001819ee82c1e6c608462404d82de42b4f0f9b04e4f6e60173e096075
|
|
BLAKE2b-256 checksum How to use checksums |
14a45ac0ebc814cd8964ef261046aedbb658df63e405ab36a26ed0e0d9a599d7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp311-cp311-musllinux_1_2_aarch64.whl
| Download URL | renus-3.0.0-cp311-cp311-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 519.8 kB |
| Tags | CPython 3.11 Linux musl 1.2+ ARM64 |
|
SHA-256 checksum How to use checksums |
ce87e0a74670d3c8d5164b88c3b9b791c81f2e92c1cc972fa63751dd8a41d6a1
|
|
BLAKE2b-256 checksum How to use checksums |
dae1e43016b6b37999b45af1ea29cc90f0e4a0389dbf7c82772b595e31e1ebc8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | renus-3.0.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 520.7 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
60e4ad7532480fd0a39240f42475aac14c109e203356675566e0f1138c6a759f
|
|
BLAKE2b-256 checksum How to use checksums |
d042e49fa4ac88097e315027dded8bbf5f2025db2e4a15ab3b864b871e5f5078
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl
| Download URL | renus-3.0.0-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl |
|---|---|
| Size | 520.6 kB |
| Tags | CPython 3.11 Linux glibc 2.28+ x86-64 Linux glibc 2.5+ x86-64 |
|
SHA-256 checksum How to use checksums |
b9a388a15a7081b21e2f1044570446a8c8906c4ed9cc584736fd4db4747a0ac6
|
|
BLAKE2b-256 checksum How to use checksums |
6b3ec3b169f223d019cef79b840629297b4e3455c5979d9225d3dbb171cbb055
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | renus-3.0.0-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 352.6 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
80e8d1e0d0a39f1cc77e6763a8c0bff93edb6df881123b0ed75b659ac0d1f2ae
|
|
BLAKE2b-256 checksum How to use checksums |
b9bd40214d87c43590a2b4633199ebb6547f1a0e6fc7e24bdddbc427b98bdb20
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / renus-3.0.0-cp311-cp311-macosx_10_9_x86_64.whl
| Download URL | renus-3.0.0-cp311-cp311-macosx_10_9_x86_64.whl |
|---|---|
| Size | 352.5 kB |
| Tags | CPython 3.11 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
bfb0ec2bd82b998c8aa46e3f8e7b8e171fed82883c7602a35c93c20c1fd0f528
|
|
BLAKE2b-256 checksum How to use checksums |
f2d8bb3b9930b5c89539934543da4f01497c2f35e3288ad9fe040c0b1860ee10
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency log
