LumosWeb is web framework, simple and effective usage
Project description
LumosWeb
- To ensure compatibility and access the latest features and improvements, it is highly recommended to use version 1.0.0 or higher of the package.
- LumosWeb is web framework written in python
- It's a WSGI framework and can be used with any WSGI application server such as Gunicorn.
- PyPI Release
- Sample App
Installation
pip install LumosWeb==<latest_version>
e.g. pip install LumosWeb==1.0.0
Getting Started
Basic usage
Define App
from LumosWeb.api import API()
app = API() # We created our api instance
@app.route("/home", allowed_methods=["get", "post", "put", "delete"])
def home(request, response):
if request.method == "get":
response.text = "Hello from the HOME page"
else:
raise AttributeError("Method not allowed.")
# Parameterized routes
@app.route("/book/{title}/page/{page:d}", allowed_methods=["get", "post"])
def book(request, response, title, page):
response.text = f"You are reading the Book: {title}, and you were on Page: {page}"
## Adding a route without a decorator
def handler(req, resp):
resp.text = "We don't have to use decorators!"
app.add_route("/sample", handler, allowed_methods=["get", "post"])
Run Server
Navigate to the directory in the Terminal where the file of your API instance is located
Lumosweb --app <module_name> run
And lights are on!
Unit Test
The recommended way of writing unit tests is with pytest. There are two built in fixtures
that you may want to use when writing unit tests with LumosWeb. The first one is app
which is an instance of the main API
class:
def test_basic_route_adding(api):
@api.route("/home", allowed_methods=["get", "post"])
def home(req, resp):
resp.text = "Lumos is on!"
with pytest.raises(AssertionError):
@api.route("/home", allowed_methods=["get", "post"])
def home2(req, resp):
resp.text = "Lumos is off!"
The other one is client
that you can use to send HTTP requests to your handlers. It is based on the famous requests and it should feel very familiar:
def test_lumos_test_client_can_send_requests(api, client):
RESPONSE_TEXT = "Yes it can :)!"
@api.route("/lumos", allowed_methods=["get", "post"])
def lumos(req, resp):
resp.text = RESPONSE_TEXT
assert client.get("http://testserver/lumos").text == RESPONSE_TEXT
Templates
The default folder for templates is templates
. You can change it when initializing the main API()
class:
app = API(templates_dir="templates_dir_name")
Then you can use HTML files in that folder like so in a handler:
@app.route("/show/template")
def handler_with_template(req, resp):
resp.html = app.template(
"example.html", context={"title": "Awesome Framework", "body": "welcome to the future!"})
Static Files
Just like templates, the default folder for static files is static
and you can override it:
app = API(static_dir="static_dir_name")
Then you can use the files inside this folder in HTML files:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>{{title}}</title>
<link href="/static/main.css" rel="stylesheet" type="text/css">
</head>
<body>
<h1>{{body}}</h1>
<p>This is a paragraph</p>
</body>
</html>
Middleware
You can create custom middleware classes by inheriting from the LumosWeb.middleware.Middleware
class and overriding its two methods
that are called before and after each request:
from LumosWeb.api import API
from LumosWeb.middleware import Middleware
app = API()
class SimpleCustomMiddleware(Middleware):
def process_request(self, req):
print("Before dispatch", req.url)
def process_response(self, req, res):
print("After dispatch", req.url)
app.add_middleware(SimpleCustomMiddleware)
Database
You can create custom middleware classes by inheriting from the LumosWeb.orm.Database
class
First create models file and create a class for each table in the database
models.py
from LumosWeb.orm import Table, Column
class Book(Table):
author = Column(str)
name = Column(str)
Then create a storage file and import the models storage.py
from models import Book
class BookStorage:
_id = 0
def __init__(self):
self._books = []
def all(self):
return [book._asdict() for book in self._books]
def get(self, id: int):
for book in self._books:
if book.id == id:
return book
return None
def create(self, **kwargs):
self._id += 1
kwargs["id"] = self._id
book = Book(**kwargs)
self._books.append(book)
return book
def delete(self, id):
for ind, book in enumerate(self._books):
if book.id == id:
del self._books[ind]
Then use them app.py
from LumosWeb.orm import Database
db = Database("./lumos.db") # lumos.db is the name of the database file
db.create(Book)
@app.route("/", allowed_methods=["get"])
def index(req, resp):
books = db.all(Book)
resp.html = app.template("index.html", context={"books": books})
@app.route("/books", allowed_methods=["post"])
def create_book(req, resp):
book = Book(**req.POST) # Creates a Book instance with the given data in the request.
db.save(book)
resp.status_code = 201 # Created
resp.json = {"name": book.name, "author": book.author}
@app.route("/books/{id:d}", allowed_methods=["delete"])
def delete_book(req, resp, id):
db.delete(Book, id=id)
resp.status_code = 204 # No content (resource has successfully been deleted.)
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.