# Fastro
Fast and simple web application framework for deno.
With [near-native perfomance](https://deno.land/x/fastro@v{{version}}/benchmarks),you can manage your routing, middlewares, and dependencies cleanly. You can alsotake advantage of existing the standard deno objects and methods:[Request](https://deno.com/deploy/docs/runtime-request),[Response](https://deno.com/deploy/docs/runtime-request),[Headers](https://deno.com/deploy/docs/runtime-headers), and[Cookie](https://deno.land/std@0.133.0/http).
### Examples
- [Getting Started](#getting-started)- [Custom Port](#custom-port)- [HTML response](#html-response)- [Set, Get, and Delete a Cookie](#set-get-and-delete-a-cookie)- [Render with Eta Template Engine](#render-with-eta-template-engine)- [Routing](#routing)- [Route Parameters](#route-parameters)- [Router Middleware](#router-middleware)- [Router Middleware with Array](#route-level-middleware-with-array)- [Application Level Middleware](#application-level-middleware)- [Application Level Middleware with Array](#application-level-middleware-with-array)- [Route Level Middleware](#route-level-middleware)- [Route Level Middleware with Array](#route-level-middleware-with-array)- [SQLite and Dependency Injection](#sqlite-and-dependency-injection)### Getting started
```tsimport application from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"
const app = application()
app.get("/", () => "Hello world")
await app.serve()```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/main.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/main.ts)
### Custom port
```tsimport application from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"
const app = application()
app.get("/", () => new Response("Hello world!"))
await app.serve({ port: 3000 })```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/custom_port.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/custom_port.ts)
### HTML Response
```tsimport application from "https://deno.land/x/fastro@v0.51.0/server/mod.ts";
const app = application();
app.get("/", () => { return new Response("<html> Hello world </html>", { status: 200, headers: { "content-type": "text/html", }, });});
console.log("Listening on: http://localhost:8000");
await app.serve();```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/html_response.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/html_response.ts)
### Render with Eta Template Engine
```tsimport application from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"import { render } from "https://deno.land/x/eta@v1.12.3/mod.ts"
const app = application()
const headers = new Headers()headers.set("Content-Type", "text/html charset=UTF-8")
app.get("/", () => { const html = <string> render( "<h4>The answer to everything is <%= it.answer %></h4>", { answer: 42, }, ) return new Response(html, { headers })})
console.log("Listening on: http://localhost:8000")
await app.serve()```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/render.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/render.ts)
### Set, Get, and Delete a Cookie
```tsimport { Cookie, deleteCookie, getCookies, setCookie,} from "https://deno.land/std@0.133.0/http/cookie.ts"
import application from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"
const app = application()
app.post("/", () => { const headers = new Headers() const cookie: Cookie = { name: "Space", value: "Cat" } setCookie(headers, cookie) return new Response(JSON.stringify(cookie), { headers })})
app.get("/", (req: Request) => { const headers = req.headers const cookies = getCookies(headers) return new Response(JSON.stringify(cookies))})
app.delete("/", () => { const headers = new Headers() deleteCookie(headers, "Space") const cookies = getCookies(headers) return new Response(JSON.stringify(cookies), { headers, })})
console.log("Listening on: http://localhost:8000")
await app.serve()```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/cookies.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/cookies.ts)
### Routing
```tsimport application from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"
const app = application()
app.get("/abcd", () => new Response("/abcd"))
app.get("/ef?gh", () => new Response("/ef?gh"))
app.get("/ij+kl", () => new Response("/ij+kl"))
app.get("/mn*op", () => new Response("mn*op"))
app.get("/qr(st)?u", () => new Response("qr(st)?u"))
app.get(/v/, () => new Response("/v/"))
app.get(/.*fast$/, () => new Response("/.*fast$/"))
await app.serve()```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/routing.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/routing.ts)
### Route parameters
```tsimport application, { getParam, getParams,} from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"
const app = application()
app.get("/:id/user/:name", (req: Request) => { const params = getParams(req) return new Response(JSON.stringify({ params }))})
app.get("/post/:id", (req: Request) => { const param = getParam("id", req) return new Response(param)})
await app.serve()```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/route_params.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/route_params.ts)
### Router Middleware
```tsimport application, { ConnInfo, Next, router,} from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"
const app = application()const r = router()const middleware = (_req: Request, _connInfo: ConnInfo, next: Next) => { console.log("v2 - 1") next()}
r.get("/", () => new Response("Get")) .post("/", () => new Response("Post")) .put("/", () => new Response("Put")) .delete("/", () => new Response("Delete"))app.use("/v1", r)app.use("/v2", middleware, r)
await app.serve()```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/router_middleware.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/router_middleware.ts)
### Router Middleware with Array
```tsimport application, { ConnInfo, Next, router,} from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"
const app = application()const r = router()const middlewares = [(_req: Request, _connInfo: ConnInfo, next: Next) => { console.log("v2 - 1") next()}, (_req: Request, _connInfo: ConnInfo, next: Next) => { console.log("v2 - 2") next()}]
r.get("/", () => new Response("Get")) .post("/", () => new Response("Post")) .put("/", () => new Response("Put")) .delete("/", () => new Response("Delete"))app.use("/v1", r)app.use("/v2", middlewares, r)
await app.serve()```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/router_middleware_with_array.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/router_middleware_with_array.ts)
### Application Level Middleware
```tsimport application, { ConnInfo, Next,} from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"
const app = application()
app.use((_req: Request, _conn: ConnInfo, next: Next) => { console.log("app middleware #1") next()})
app.use((_req: Request, _conn: ConnInfo, next: Next) => { console.log("app middleware #2") next()})
app.use((_req: Request, _conn: ConnInfo, next: Next) => { console.log("app middleware #3") next()}, (_req: Request, _conn: ConnInfo, next: Next) => { console.log("app middleware #4") next()})
app.get("/", () => new Response("App level #1"))
await app.serve()```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/application_level_middleware.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/application_level_middleware.ts)
### Application Level Middleware with Array
```tsimport application, { ConnInfo, Next,} from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"
const app = application()
const middlewares = [(_req: Request, _conn: ConnInfo, next: Next) => { console.log("middleware #1") next()}, (_req: Request, _conn: ConnInfo, next: Next) => { console.log("middleware #2") next()}, (_req: Request, _conn: ConnInfo, next: Next) => { console.log("middleware #3") next()}, (_req: Request, _conn: ConnInfo, next: Next) => { console.log("middleware #4") next()}]
app.use(middlewares)
app.get("/", () => new Response("App level #1"))
await app.serve()```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/application_level_middleware_with_array.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/application_level_middleware_with_array.ts)
### Route Level Middleware
```tsimport application, { ConnInfo, Next,} from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"
const app = application()
app.use((_req: Request, _conn: ConnInfo, next: Next) => { console.log("app middleware #1") next()})
app.use((_req: Request, _conn: ConnInfo, next: Next) => { console.log("app middleware #2") next()})
app.use((_req: Request, _conn: ConnInfo, next: Next) => { console.log("app middleware #3") next()}, (_req: Request, _conn: ConnInfo, next: Next) => { console.log("app middleware #4") next()})
app.get("/", () => new Response("App level #1"))
await app.serve()```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/route_level_middleware.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/route_level_middleware.ts)
### Route Level Middleware with Array
```tsimport application, { ConnInfo, Next,} from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"
const app = application()
const middlewares = [(_req: Request, _conn: ConnInfo, next: Next) => { console.log("middleware #1") next()}, (_req: Request, _conn: ConnInfo, next: Next) => { console.log("middleware #2") next()}, (_req: Request, _conn: ConnInfo, next: Next) => { console.log("middleware #3") next()}, (_req: Request, _conn: ConnInfo, next: Next) => { console.log("middleware #4") next()}]
app.get("/mnop", middlewares, () => new Response("Route level middleware #3"))
await app.serve()```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/route_level_middleware_with_array.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/route_level_middleware_with_array.ts)
### SQLite and Dependency Injection
```tsimport application, { dependency } from "https://deno.land/x/fastro@v{{version}}/server/mod.ts"import { DB } from "https://deno.land/x/sqlite@v3.3.0/mod.ts"
const app = application()const db = new DB("test.db")
const deps = dependency()deps.set("hello", () => "Hello world")deps.set("db", db)app.use(deps)
app.get("/", () => { type FunctionType = () => string const fn = <FunctionType> app.getDeps("hello") return new Response(fn())})
app.post("/name", () => { const db = <DB> app.getDeps("db") db.query(`CREATE TABLE IF NOT EXISTS people ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT)`) const names = ["Peter Parker", "Clark Kent", "Bruce Wayne"] for (const name of names) { db.query("INSERT INTO people (name) VALUES (?)", [name]) } return new Response(JSON.stringify(names))})
app.get("/name", () => { const db = <DB> app.getDeps("db") const res = db.query("SELECT name FROM people") return new Response(JSON.stringify(res))})
console.log("Listening on: http://localhost:8000")
await app.serve()
```
```deno run -A https://deno.land/x/fastro@v{{version}}/examples/deps_injection.ts```
[](https://dash.deno.com/new?url=https://deno.land/x/fastro@{{version}}/examples/deps_injection.ts)