Nebula is a lightweight ASGI-based Python web framework that provides simple, decorator-based routing and middleware support for building fast, asynchronous web applications.
Project description
Nebula
Nebula is a lightweight ASGI-based Python web framework that provides simple, decorator-based routing and middleware support for building fast, asynchronous web applications.
Features
- Decorator-based Routing: Define your routes with simple and intuitive decorators.
- Asynchronous Support: Full
async/awaitsupport for handling requests and events. - Session Management & Authentication: Secure session handling and user authentication.
- WebSocket Support: Real-time communication with WebSocket routing.
- Template Loading: Easily load and serve HTML templates from a designated directory.
- Statics Loading: Easily load and serve files from designated directory.
- Middleware Support:
before_requestandafter_requesthooks for flexible request handling. - Flexible Error Handling: Easily handle HTTP errors with use of
error_handler(<http_code:int>). - Easy to Use: Get a server up and running in just a few lines of code.
Installation
Install Nebula from PyPI:
pip install nebula-core
or clone and install from GitHub.
git clone https://github.com/VxidDev/nebula.git
cd nebula
pip install .
Usage
Here's a basic example of creating a simple web server with Nebula.
main.py:
from nebula import Nebula
from nebula.response import HTMLResponse
app = Nebula(__file__, "localhost", 8000)
@app.get("/")
async def root() -> None:
return "<h1>Welcome to Nebula!</h1>"
if __name__ == "__main__":
app.run()
Run your app:
python main.py
Open your browser and navigate to http://localhost:8000 to see your page.
Contributions <3
amogus-gggy:
- refactoring Nebula 0.2.0.
- adding websockets support (2.0.0)
- adding session support
Huge thank you!
License
This project is licensed under the MIT License - see the LICENSE file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nebula_core-3.1.2.tar.gz.
File metadata
- Download URL: nebula_core-3.1.2.tar.gz
- Upload date:
- Size: 19.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fb406d87d365345088a656367d3bdfcca8fc70399f327084868558b4fb8dbaad
|
|
| MD5 |
b7221cdbd640c0a32a01067dcfea05e9
|
|
| BLAKE2b-256 |
1b61a6159e14e079f565a6c4e58e344e1b4536533657491a926fbdedf598af02
|
File details
Details for the file nebula_core-3.1.2-py3-none-any.whl.
File metadata
- Download URL: nebula_core-3.1.2-py3-none-any.whl
- Upload date:
- Size: 18.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
97720df3775240ce07e424915730443b87f93e5e17b085fca3b1e478f870b388
|
|
| MD5 |
78adf8a389d34fb5bbcc062dc6290bae
|
|
| BLAKE2b-256 |
8913aee7b1e7fbd4121fe770413b54d6e7f810c6d2beb2e1c36cc2c7f9a426a8
|