reitit/README.md

48 lines
1.9 KiB
Markdown
Raw Normal View History

2017-08-07 11:08:39 +00:00
# reitit [![Build Status](https://travis-ci.org/metosin/reitit.svg?branch=master)](https://travis-ci.org/metosin/reitit) [![Dependencies Status](https://jarkeeper.com/metosin/reitit/status.svg)](https://jarkeeper.com/metosin/reitit)
A friendly data-driven router for Clojure(Script).
2017-08-07 11:08:39 +00:00
2017-09-08 05:34:34 +00:00
* Simple data-driven [route syntax](#route-syntax)
* First-class [route meta-data](#route-meta-data)
* Generic, not tied to HTTP
2017-08-22 15:33:02 +00:00
* [Route conflict resolution](#route-conflicts)
2017-08-30 10:24:01 +00:00
* [Pluggable coercion](#parameter-coercion) ([clojure.spec](https://clojure.org/about/spec))
2017-09-08 05:34:34 +00:00
* both [Middleware](#middleware) & Interceptors
* Extendable
* Fast
2017-08-17 06:24:23 +00:00
Ships with example router for [Ring](#ring). See [Issues](https://github.com/metosin/reitit/issues) for roadmap.
2017-08-07 11:08:39 +00:00
## Latest version
[![Clojars Project](http://clojars.org/metosin/reitit/latest-version.svg)](http://clojars.org/metosin/reitit)
2017-09-14 13:33:36 +00:00
## Documentation
2017-08-07 11:08:39 +00:00
2017-09-14 13:33:36 +00:00
[Check out the full documentation!](https://metosin.github.io/reitit/)
## Special thanks
To all Clojure(Script) routing libs out there, expecially to
[Ataraxy](https://github.com/weavejester/ataraxy), [Bide](https://github.com/funcool/bide), [Bidi](https://github.com/juxt/bidi), [Compojure](https://github.com/weavejester/compojure) and
2017-08-09 07:36:57 +00:00
[Pedestal](https://github.com/pedestal/pedestal/tree/master/route).
2017-08-07 11:08:39 +00:00
2017-09-08 05:29:39 +00:00
Also to [Compojure-api](https://github.com/metosin/compojure-api), [Kekkonen](https://github.com/metosin/kekkonen) and [Ring-swagger](https://github.com/metosin/ring-swagger) and for the data-driven syntax, coercion & stuff.
And some [Yada](https://github.com/juxt/yada) too.
## Development instructions
The documentation is built with [gitbook](https://toolchain.gitbook.com). To preview your changes locally:
```bash
npm install -g gitbook-cli
gitbook serve
```
2017-08-07 11:08:39 +00:00
## License
Copyright © 2017 [Metosin Oy](http://www.metosin.fi)
2017-08-07 11:08:39 +00:00
Distributed under the Eclipse Public License, the same as Clojure.