thunderlight 0.5.0

A Python HTTP Server.

⚡️Thunderlight is the fastest Python HTTP Server

Thunderlight is the fastest Python HTTP Server. It's dedicated for micro service and JSON API. In the future, a C version of this API is also supported. You can write Python or C in your server project to speed things up.

Installation

Install Thunderlight with pip.

pip install thunderlight

Documentation

get

Register a get request handler to the default app.

@get('/posts/:id')
async def posts(ctx: Ctx) -> None:
    ctx.res.json((await Post.id(ctx.req.args.id)).tojson())

post

Register a post request handler to the default app.

@post('/posts')
async def posts(ctx: Ctx) -> None:
    ctx.res.json(Post(**(await ctx.req.json())).save().tojson())

patch

Register a patch request handler to the default app.

@patch('/posts/:id')
async def posts(ctx: Ctx) -> None:
    ctx.res.json((await Post.id(ctx.req.args.id)).set(await ctx.req.json()).save().tojson())

delete

Register a delete request handler to the default app.

@delete('/posts/:id')
async def posts(ctx: Ctx) -> None:
    ctx.res.empty((await Post.id(ctx.req.args.id)).delete())

use

Append this middleware to the default app's middleware stack.

@use
async def measure_time(ctx: Ctx, next: Next) -> None:
    start = time()
    await next(ctx)
    time_elapsed = time() - start
    print(f'request {ctx.req.path} takes {time_elapsed} second.')

apply

Apply a middleware to a request handler. This is aka middleware for a single request handler.

async def validate_user(ctx: Ctx, next: Next) -> None:
    if ctx.req.headers['Authorization'] is not None:
        await next(ctx)
    else:
        ctx.res.code = 401
        ctx.res.json({"error": {"type": "Unauthorized"}})


@get('/users')
@apply(validate_user)
async def users(ctx: Ctx) -> None:
    ctx.res.json(await User.find())

App

Create a new server application.

app = App()
@app.get('/articles')
async def articles(ctx: Ctx) -> None:
    ctx.res.json(await Article.find())

Changelog

0.5.0 (Feb 24th, 2022)

• Revert to Python implementation as the C implementation is not stable

0.2.8 (Jan 28th, 2022)

• Fixed a bug that causes patch and delete requests to crash

0.2.7 (Jan 25th, 2022)

• Fixed a bug that causes errors in handlers not propagated
• Add __contains__ method to ReqHeaders

0.2.6 (Jan 25th, 2022)

• Fixed a bug that would cause delete routes crashing

0.2.5 (Jan 24th, 2022)

• Remove uvicorn and related dependencies
• Rewrite with C
• Fix req.json property

0.1.0 (Dec 10th, 2021)

• Global methods added: get, post, patch, delete, use and apply.
• Classes added: App, Ctx, Req, Res, State.
• Function definition added: Handler, Next and Middleware.
• Global helper methods added: main, gimme and make.