Lapi

A full featured middleware based web framework for Deno.

NOTE: This project is a heavy WIP, therefore this may not be up to date.

Why

I started this project because I wanted a very easy to use framework to build APIs with in Deno. There are definitely some great ones that have already been created but they always seem to be difficult to get started with. This framework will contain the very basic implementation required to create a web application and include middleware to make building web applications easier.

Getting Started

To create a basic application, you first need to import Application into your program. This can be done with the following import statment:

import { Application } from "https://deno.land/x/lapi/mod.ts";

Once you have Application imported, you can create an application by calling the constructor:

import { Application } from "https://deno.land/x/lapi/mod.ts";

const application = new Application();

You can then add middleware by calling application.use:

import { Application } from "https://deno.land/x/lapi/mod.ts";

const application = new Application();

application.use((ctx) => {
  if (ctx.request.method === "GET") {
    ctx.response.body = "Hello";
  }
});

Now that you have a middleware added created, you can create the API:

import { Application } from "https://deno.land/x/lapi/mod.ts";

const application = new Application();

application.use((ctx) => {
  if (ctx.request.method === "GET") {
    ctx.response.body = "Hello";
  }
});

await application.start();

The full example can be found here

Search Parameters

Lapi supports search parameters but they do not need to be defined in your code. They can be accessed through the property ctx.request.searchParams in your handler function. Please see the example below.

import { Application } from "https://deno.land/x/lapi/mod.ts";

const application = new Application();

application.use((ctx) => {
  if (ctx.request.method === "GET") {
    ctx.response.body = `Hello, ${ctx.request.searchParams.get("name")}!`;
  }
});

await application.start();

Routing

There is a Middleware provided in middleware/router.ts that can handle routing and route specific middleware. The following is a basic example. More can be found in the examples directory.

import { Application } from "https://deno.land/x/lapi/mod.ts";
import { Router } from "https://deno.land/x/lapi/middleware/router.ts";

const application = new Application();
const router = new Router();

router.use("GET", "/", (ctx) => {
  ctx.response.body = { key: "value" };
});

application.use(router.routes()).start();

Path Parameters

The routing middleware provides path parameters as will. Under the hood, we are using pillarjs/path-to-regexp.

import { Application } from "https://deno.land/x/lapi/mod.ts";
import { Router } from "https://deno.land/x/lapi/middleware/router.ts";

const application = new Application();
const router = new Router();

router.use("GET", "/:name", (ctx) => {
  ctx.response.body = `Hello, ${ctx.request.pathParams.name}!`;
});

application.use(router.routes()).start();

Cors

There is a Middleware provided in middleware/cors.ts that will set up the headers for your application. This Middleware is configurable. The following is a basic example. More can be found in the examples directory.

import { Application } from "https://deno.land/x/lapi/mod.ts";
import { cors } from "https://deno.land/x/lapi/middleware/cors.ts";

const application = new Application();

application.use(cors()).use((ctx) => {
  if (ctx.request.method === "GET") {
    ctx.response.body = { key: "value" };
  }
});

application.start();

Native HTTP Server

Lapi is capable of using the standard and native http server. By default, Lapi will use the standard http server, but if you run with the --unstable flag, it will use the native http server. You can force Lapi to use either one of these.

note: you must run with --unstable for the native http server to start.

Force the standard http server:

import { Application, HttpServerStd } from "https://deno.land/x/lapi/mod.ts";

const application = new Application({ server: new HttpServerStd() });

application.use((ctx) => {
  if (ctx.request.method === "GET") {
    ctx.response.body = "Hello";
  }
});

await application.start();

Force the native http server:

import { Application, HttpServerNative } from "https://deno.land/x/lapi/mod.ts";

const application = new Application({ server: new HttpServerNative() });

application.use((ctx) => {
  if (ctx.request.method === "GET") {
    ctx.response.body = "Hello";
  }
});

await application.start();

Roadmap

The project roadmap can be found under the discussions tab of this repository.

Contributing

If you would like to contribute, you can open a pull request and assign it to @lukeshay. Please follow the styling rules found here..