dymokomi/luce-http-server
Source of release 0.4.1
## REST and session behavior. The package owns requests, wire framing, bounded
## storage and cleanup; the standard JSON value owns precise serialization.
from luce_server.http import Request, Response
from luce_json.json import Value
from luce_server.websocket import Session
from luce_server import http
func problem(status: int, message: str) -> Response!:
let result = Value()
result.set_text("error", message)
return Response.json(result, status)
pub class Api:
var upload_directory: str
pub func init(self, upload_directory: str):
self.upload_directory = upload_directory
pub func health(self, request: Request) -> Response!:
let result = Value()
result.set_text("status", "ok")
return Response.json(result)
pub func item(self, request: Request) -> Response!:
let identifier = request.integer_parameter("id") catch failure:
return problem(400, "id must be an integer")
if identifier < 1:
return problem(400, "id must be positive")
let result = Value()
result.set_integer("id", identifier)
result.set_text("name", f"Example item {identifier}")
return Response.json(result)
pub func greet(self, request: Request) -> Response!:
let value = request.query("name") catch failure:
if failure.code == http.invalid_request:
return problem(400, "invalid query value")
error(failure.code, failure.message)
let name = value else "world"
let result = Value()
result.set_text("message", f"Hello, {name}!")
return Response.json(result)
pub func echo(self, request: Request) -> Response!:
let body = request.body()
let data = body.bytes(1048576) catch failure:
if failure.code == http.limit_exceeded:
return problem(413, "echo body exceeds 1 MiB")
error(failure.code, failure.message)
return Response.bytes(data)
pub func upload(self, request: Request) -> Response!:
let name = request.parameter("name") else ""
let body = request.body()
body.save(self.upload_directory + "/" + name) catch failure:
if failure.code == http.file_exists:
return problem(409, "file already exists")
error(failure.code, failure.message)
let result = Value()
result.set_text("name", name)
result.set_boolean("stored", true)
return Response.json(result, 201)
pub func download(self, request: Request) -> Response!:
let name = request.parameter("name") else ""
return Response.file(self.upload_directory + "/" + name) catch failure:
if failure.code == http.file_missing:
return problem(404, "file not found")
error(failure.code, failure.message)
pub func websocket_echo(self, session: Session) -> unit!:
session.accept()
while let message = session.receive():
session.send(message)