reitit/doc/http/pedestal.md

# Pedestal

[Pedestal](http://pedestal.io/) is a well known interceptor-based web framework for Clojure. To use `reitit-http` with Pedestal, we need to change the default routing interceptor into a new one. Examples projects show how to do this.

## Caveat

`reitit-http` defines Interceptors as `reitit.interceptor/Interceptor`. Compared to Pedestal 2-arity error handlers, reitit uses a simplified (1-arity) handlers. Differences in error handling are described in the [Sieppari README](https://github.com/metosin/sieppari#differences-to-pedestal).

* you can use any [pedestal-style interceptor](http://pedestal.io/reference/interceptors) within reitit router (as Pedestal is executing those anyway)
* you can use any reitit-style interceptor that doesn't have `:error`-stage defined
* using a reitit-style interceptor with `:error` defined will cause `ArityException` if invoked

See the [error handling guide](http://pedestal.io/reference/error-handling) on how to handle errors with Pedestal.

## Examples

### Simple

* simple example, with both sync & async code:
  * https://github.com/metosin/reitit/tree/master/examples/pedestal

### With batteries

* with [default interceptors](default_interceptors.md), [coercion](../coercion/coercion.md) and [swagger](../ring/swagger.md)-support (note: exception handling is disabled):
  * https://github.com/metosin/reitit/tree/master/examples/pedestal-swagger
Interceptor docs 2018-09-08 07:42:01 +00:00			`# Pedestal`

better docs 2018-09-09 18:50:23 +00:00			[Pedestal](http://pedestal.io/) is a well known interceptor-based web framework for Clojure. To use `reitit-http` with Pedestal, we need to change the default routing interceptor into a new one. Examples projects show how to do this.
Interceptor docs 2018-09-08 07:42:01 +00:00
			`## Caveat`

better docs 2018-09-09 18:50:23 +00:00			`reitit-http` defines Interceptors as `reitit.interceptor/Interceptor`. Compared to Pedestal 2-arity error handlers, reitit uses a simplified (1-arity) handlers. Differences in error handling are described in the [Sieppari README](https://github.com/metosin/sieppari#differences-to-pedestal).
Interceptor docs 2018-09-08 07:42:01 +00:00
			`* you can use any [pedestal-style interceptor](http://pedestal.io/reference/interceptors) within reitit router (as Pedestal is executing those anyway)`
			* you can use any reitit-style interceptor that doesn't have `:error`-stage defined
			* using a reitit-style interceptor with `:error` defined will cause `ArityException` if invoked

			`See the [error handling guide](http://pedestal.io/reference/error-handling) on how to handle errors with Pedestal.`

			`## Examples`

			`### Simple`

			`* simple example, with both sync & async code:`
			`* https://github.com/metosin/reitit/tree/master/examples/pedestal`

			`### With batteries`

			`* with [default interceptors](default_interceptors.md), [coercion](../coercion/coercion.md) and [swagger](../ring/swagger.md)-support (note: exception handling is disabled):`
			`* https://github.com/metosin/reitit/tree/master/examples/pedestal-swagger`