🪁 A simple, type-safe http server for PureScript
Go to file
Hardy Jones c208dffb7b Add HTTP version (#137)
* v0.8.1

* Add the HTTP version to `Request`

The `node-http` `Request` has the HTTP version on it.
We can make it available in our `Request` for consumers.

We went the naive approach first and typed it as a string.
There is some structure to the version,
so we could attempt to parse it.
It's unclear what we would do if parsing failed though.

Maybe we want something like:
```PureScript
data Version
  = Known { major :: Int, minor :: Int }
  | Unknown String
```

That would allow us to parse the known format,
and fallback to accepting anything else.
It's definitely something to discuss anyway.

* Make HTTP version its own data type

There are only a handful of HTTP versions that are commonly used.
We can talk about those explicitly and fallback to any arbitrary version.

The changes here try to follow the patterns elsewhere in the code base.
Hopefully, it's not too far off.
2019-04-25 10:13:04 -07:00
docs Fix markdown syntax (#116) 2018-09-18 08:39:05 -07:00
src Add HTTP version (#137) 2019-04-25 10:13:04 -07:00
test Add HTTP version (#137) 2019-04-25 10:13:04 -07:00
.bowerrc Rename top level directories to be purescript standard 2017-07-17 23:29:51 -07:00
.gitignore Switch from bower to psc-package 2019-02-16 23:25:42 -08:00
.travis.yml Turn off travis email notifications (#43) 2017-07-18 11:29:30 -07:00
bower.json Add missing packages 2019-02-26 22:15:34 -08:00
Contributing.md Fix incorrect docs (#87) 2017-10-26 17:42:08 -04:00
History.md Release notes for v0.8.0 2019-02-16 23:26:03 -08:00
License Clean up file naming and directory structure (#21) 2017-07-10 12:06:14 -07:00
Makefile Fix makefile 2019-02-17 10:30:54 -08:00
package.json Switch from bower to psc-package 2019-02-16 23:25:42 -08:00
psc-package.json Add missing packages 2019-02-26 22:15:34 -08:00
Readme.md Switch from bower to psc-package 2019-02-16 23:25:42 -08:00
Releasing.md Minor docs update 2017-10-26 13:28:47 -07:00
shell.nix Switch from bower to psc-package 2019-02-16 23:25:42 -08:00
yarn.lock Switch from bower to psc-package 2019-02-16 23:25:42 -08:00

HTTPure

License Latest release Build Status 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

psc-package install httpure

Quick Start

module Main where

import Prelude (($))

import Effect.Console as Console
import HTTPure as HTTPure

main :: HTTPure.ServerM
main =
  HTTPure.serve 8080 router $ Console.log "Server now up on port 8080"
  where
    router _ = HTTPure.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:

make example EXAMPLE=<Example Name>

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:

make 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