2.1 clack-errors

Error page middleware for Clack.

Author

Fernando Borretti

Home Page

https://github.com/eudoxia0/clack-errors

License

LLGPL

Long Description

# clack-errors

[](https://travis-ci.org/eudoxia0/clack-errors) [](http://quickdocs.org/clack-errors/)


A clone of [better_errors](https://github.com/charliesome/better_errors)
for [Clack](https://github.com/fukamachi/clack).

By default, when Clack throws an exception when rendering a page, the server
waits for the response until it times out while the exception waits in the
REPL. This isn’t very useful. So now there’s this.

# Usage

This,

“‘lisp
(clack:clackup
(funcall clack-errors:*clack-error-middleware*
*my-clack-app*
:debug t)
:port 8000)))
“‘

will wrap your Clack up in the clack-errors middleware, start the server and
return a handler object.

By default, the middleware will show all information. In a production
environment, you’ll want to initialize this with the ‘:debug‘ parameter set to
NIL.

## Using a Custom Error Page

The middleware can be initialized with the ‘:fn‘ slot set to a lambda that takes
a condition as its argument and returns the HTML string to return to the client.

“‘lisp
(clack:clackup
(funcall clack-errors:*clack-error-middleware*
*app*
:fn (lambda (condition) "500 Internal Server Error")))
“‘

# License

Copyright (c) 2013–2019 Fernando Borretti (eudoxiahp@gmail.com)

Licensed under the LLGPL License.

Version

0.2

Dependencies

• clack (system).
• closer-mop (system).
• local-time (system).
• trivial-backtrace (system).
• djula (system).
• cl-ppcre (system).

Source

clack-errors.asd.

Child Component

src (module).

3.1 clack-errors/src

Source

clack-errors.asd.

Parent Component

clack-errors (system).

Child Component

clack-errors.lisp (file).

4.1 Lisp

• clack-errors/clack-errors.asd
• clack-errors/src/clack-errors.lisp

5.1 clack-errors

Source

clack-errors.lisp.

Nickname

lack.middleware.clack.errors

Use List

common-lisp.

Public Interface

*clack-error-middleware* (special variable).

Internals

• *dev-css-path* (special variable).
• *highlight-css* (special variable).
• *highlight-js* (special variable).
• *prod-css-path* (special variable).
• +backtrace-regex+ (special variable).
• +dev-template+ (special variable).
• +prod-template+ (special variable).
• condition-name (function).
• condition-slots (function).
• parse-backtrace (function).
• render (function).
• render-prod (function).
• slot-values (function).
• split-backtrace (function).

6.1 Public Interface

• Special variables

6.2 Internals

• Special variables
• Ordinary functions