🪁 A simple, type-safe http server for PureScript
Go to file
Thomas Honeyman 42bf4475e0
Update for PureScript 0.15 (#194)
* Update shell and packages

* Fix code for 0.15

* Fix tests

* Format

* Add check-pulp command

* Generate bowerfile

* Add check-pulp to CI

* Add nixfmt to formatting

* Fixup test helpers

* Take 2

* PR comments (#1)

* Nix cleanup from PR

* Use arrows functions

* Remove unnecessary step

Co-authored-by: Connor Prussin <connor@prussin.net>
2022-05-04 14:02:29 -07:00
.github/workflows Update for PureScript 0.15 (#194) 2022-05-04 14:02:29 -07:00
docs Update for PureScript 0.15 (#194) 2022-05-04 14:02:29 -07:00
src Update for PureScript 0.15 (#194) 2022-05-04 14:02:29 -07:00
test Update for PureScript 0.15 (#194) 2022-05-04 14:02:29 -07:00
.envrc #153 bind to 0.0.0.0 instead of localhost (#154) 2020-02-26 16:43:38 -08:00
.gitignore Update for PureScript 0.15 (#194) 2022-05-04 14:02:29 -07:00
.tidyrc.json Update for PureScript 0.15 (#194) 2022-05-04 14:02:29 -07:00
bower.json Update for PureScript 0.15 (#194) 2022-05-04 14:02:29 -07:00
Contributing.md Rename 'master' branch to 'main' (#173) 2021-03-22 12:34:49 -07:00
History.md Release notes for v0.14.0 2021-12-06 21:03:07 -08:00
License Clean up file naming and directory structure (#21) 2017-07-10 12:06:14 -07:00
packages.dhall Update for PureScript 0.15 (#194) 2022-05-04 14:02:29 -07:00
Readme.md Clean up imports (#185) 2021-11-18 22:16:35 -08:00
Releasing.md Update Releasing notes 2021-11-20 09:47:43 -08:00
shell.nix Update for PureScript 0.15 (#194) 2022-05-04 14:02:29 -07:00
sources.json Update for PureScript 0.15 (#194) 2022-05-04 14:02:29 -07:00
sources.nix Update for PureScript 0.15 (#194) 2022-05-04 14:02:29 -07:00
spago.dhall Update for PureScript 0.15 (#194) 2022-05-04 14:02:29 -07:00
test.dhall Update project setup (#183) 2021-11-12 23:46:59 -08:00

HTTPure

License Latest release purescript-httpure on Pursuit

A purescript HTTP server framework.

HTTPure is:

  • Well-tested (see our tests)
  • Well-documented (see our documentation)
  • Built to take advantage of PureScript language features for flexible and extensible routing
  • Pure (no set, get, use, etc)

Status

This project is currently fairly stable, but has not reached it's 1.0 release yet. You can track what's left before it gets there by looking at our roadmap. The API signatures are mostly stable, but are subject to change before the 1.0 release if there's a good reason to change them.

If you'd like to help us get to 1.0 quicker, please contribute! To get started, check our contributing guide.

Installation

spago install httpure

Quick Start

module Main where

import Prelude

import Effect.Console (log)
import HTTPure (ServerM, serve, ok)

main :: ServerM
main = serve 8080 router $ log "Server now up on port 8080"
  where
    router _ = ok "hello world!"

Documentation

Module documentation is published on Pursuit.

You can also take a look at our guides.

Examples

HTTPure ships with a number of examples. To run an example, in the project root, run:

nix-shell --run 'example <Example Name>'

Or, without nix:

spago -x test.dhall run --main Examples.<Example Name>.Main

Each example's startup banner will include information on routes available on the example server.

Testing

To run the test suite, in the project root run:

nix-shell --run check

Or, if nix isn't your thing:

purs-tidy check src test docs && spago -x test.dhall test

Contributing

We are open to accepting contributions! Please see the contributing guide.

People

HTTPure is written and maintained by Connor Prussin and Petri Lehtinen.

We are open to accepting contributions! Please see the contributing guide.

License

MIT