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
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


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.1.2.tar.gz (19.0 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.1.2-py3-none-any.whl (18.3 kB view details)

Uploaded Python 3

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

Hashes for nebula_core-3.1.2.tar.gz
Algorithm Hash digest
SHA256 fb406d87d365345088a656367d3bdfcca8fc70399f327084868558b4fb8dbaad
MD5 b7221cdbd640c0a32a01067dcfea05e9
BLAKE2b-256 1b61a6159e14e079f565a6c4e58e344e1b4536533657491a926fbdedf598af02

See more details on using hashes here.

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

Hashes for nebula_core-3.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 97720df3775240ce07e424915730443b87f93e5e17b085fca3b1e478f870b388
MD5 78adf8a389d34fb5bbcc062dc6290bae
BLAKE2b-256 8913aee7b1e7fbd4121fe770413b54d6e7f810c6d2beb2e1c36cc2c7f9a426a8

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