https://github.com/lionhat-collective/cobain

A (micro) web-framework for Deno. Utilizing function composition and proxies to create a cohesive and fluent web-framework.
https://github.com/lionhat-collective/cobain

deno web-framework

Last synced: 2 months ago
JSON representation

A (micro) web-framework for Deno. Utilizing function composition and proxies to create a cohesive and fluent web-framework.

• Host: GitHub
• URL: https://github.com/lionhat-collective/cobain
• Owner: lionhat-collective
• License: mit
• Created: 2021-06-13T09:07:03.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2022-01-01T19:01:11.000Z (over 4 years ago)
• Last Synced: 2025-07-11T21:33:02.768Z (12 months ago)
• Topics: deno, web-framework
• Language: TypeScript
• Homepage:
• Size: 35.2 KB
• Stars: 2
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![cobain](./cobain.svg)

## A web-framework for Deno

Utilizing function composition and proxies to create a cohesive and fluent web-framework.

### Todo:

 - [ ] Routing

   - [ ] Use Proxy for route function

        ```javascript

        route(/*...*/).get.post.put

        // or

        route(/*...*/).get(/* additional middleware/compositions */).post.put

        // or

        route(/*...*/) // => defaults to "get"

        ```

 - [ ] Custom App State/Context

 - [x] Middleware/Function Composition

 - [x] Server bootstrapping

 - [ ] First-class [Peep](https://github.com/lionhat-collective/peep) support

### Usage:

```typescript

import { pipe } from 'https://deno.land/x/rambda@v6.7.0/pipe.js'

import { cobain, router, mount } from './cobain.ts'

import type { CobainMiddleware, CobainRequestHandler } from './cobain.ts'

const middleware: CobainMiddleware = (handler) => (ctx) => {

    console.log(`middleware called`)

    if (typeof handler !== 'undefined') {

        console.log(`handler`)

        return handler(ctx)

    }

    ctx.req.respond({ status: 200, body: `MIDDLEWARE` })

}

const fallthroughMiddleware: CobainMiddleware = handler => async ctx => {

    if (handler) {

        console.log(`before:TEST`)

        await handler(ctx)

        console.log(`after:Test`)

    }

}

const allUsers: CobainRequestHandler = (ctx) => {

    console.log(ctx.local)

    console.log(`useriso`)

    ctx.req.respond({ status: 200, body: `hello world ${ctx?.local?.x ?? -1}, ${ctx?.local?.y ?? -1}` })

}

const authApp = cobain(

    fallthroughMiddleware(ctx => {

        ctx.req.respond({ status: 200, body: `auth` })

    })

)

const usersRouter = router(route => [

    route('/', pipe(

        fallthroughMiddleware,

        fallthroughMiddleware,

    )(allUsers))

])

const app = cobain(

    usersRouter,

    mount(authApp()),

)({ port: 3333, hostname: '127.0.0.1' })

await app.start()

```

### Attribution:

[KoaJS](https://github.com/koajs/koa) — Heavily inspired by their work, a lot of the design decisions came from the design of Koa.