Skip to main content

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

PyPI Stars Contributors

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/await support 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_request and after_request hooks 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 , run_dev
from nebula.utils import htmlify

app = Nebula(__file__, "localhost", 8000)

@app.route("/")
async def root(request) -> None:
    return htmlify("<h1>Welcome to Nebula!</h1>")

run_dev(app) # run using uvicorn

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nebula_core-3.0.0.tar.gz (14.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nebula_core-3.0.0-py3-none-any.whl (15.0 kB view details)

Uploaded Python 3

File details

Details for the file nebula_core-3.0.0.tar.gz.

File metadata

  • Download URL: nebula_core-3.0.0.tar.gz
  • Upload date:
  • Size: 14.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.13

File hashes

Hashes for nebula_core-3.0.0.tar.gz
Algorithm Hash digest
SHA256 9104711f428877564740708e20dd8ef066c039b00b772f5c7e828ca30016180d
MD5 88fc8e957f91e759369b99cd1a5d3224
BLAKE2b-256 5d5173b0b67a216a96bedf9bdbf92aa100bf3703ad6ec3efbc91ecef802cd571

See more details on using hashes here.

File details

Details for the file nebula_core-3.0.0-py3-none-any.whl.

File metadata

  • Download URL: nebula_core-3.0.0-py3-none-any.whl
  • Upload date:
  • Size: 15.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.13

File hashes

Hashes for nebula_core-3.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4cff079c2fab0fca9a308cbfa862b70fd7fdde66e12c20a934c520f7476b9b78
MD5 acd8251f6d3d868a116fe9067c623067
BLAKE2b-256 45a17f37eba4c6276c692514fcb2c2567075b47c9f02dfa640f302ff9318bd21

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page