This is the hunchentools Reference Manual, version 1.0.0, generated automatically by Declt version 4.0 beta 2 "William Riker" on Sun Jun 15 05:54:24 2025 GMT+0.
The main system appears first, followed by any subsystem dependency.
hunchentoolsHunchentoot utility library
Michael J. Forster <mike@forsterfamily.ca>
MIT
1.0.0
hunchentoot (system).
alexandria (system).
cl-ppcre (system).
ironclad (system).
package.lisp (file).
abort.lisp (file).
dispatcher.lisp (file).
string-escaping.lisp (file).
session-cookie.lisp (file).
session-user.lisp (file).
session-csrf-token.lisp (file).
Files are sorted by type and then listed depth-first from the systems components trees.
hunchentools/hunchentools.asdhunchentools/package.lisphunchentools/abort.lisphunchentools/dispatcher.lisphunchentools/string-escaping.lisphunchentools/session-cookie.lisphunchentools/session-user.lisphunchentools/session-csrf-token.lisphunchentools/abort.lisppackage.lisp (file).
hunchentools (system).
abort-with-bad-request (function).
abort-with-forbidden (function).
abort-with-internal-server-error (function).
abort-with-not-found (function).
abort-with-return-code (function).
hunchentools/dispatcher.lisppackage.lisp (file).
hunchentools (system).
create-prefix-methods-dispatcher (function).
create-regex-methods-dispatcher (function).
create-uri-methods-dispatcher (function).
hunchentools/string-escaping.lisppackage.lisp (file).
hunchentools (system).
escape-string-custom (function).
escape-string-js (function).
hunchentools/session-cookie.lisppackage.lisp (file).
hunchentools (system).
harden-session-cookie (function).
hunchentools/session-user.lisppackage.lisp (file).
hunchentools (system).
delete-session-user (function).
require-session-user (function).
session-user (function).
(setf session-user) (function).
hunchentools/session-csrf-token.lisppackage.lisp (file).
hunchentools (system).
delete-session-csrf-token (function).
require-session-csrf-token (function).
session-csrf-token (function).
*csrf-secret* (special variable).
*the-random-state* (special variable).
next-csrf-token (function).
random-string (function).
Packages are listed by definition order.
hunchentoolscommon-lisp.
abort-with-bad-request (function).
abort-with-forbidden (function).
abort-with-internal-server-error (function).
abort-with-not-found (function).
abort-with-return-code (function).
create-prefix-methods-dispatcher (function).
create-regex-methods-dispatcher (function).
create-uri-methods-dispatcher (function).
delete-session-csrf-token (function).
delete-session-user (function).
escape-string-custom (function).
escape-string-js (function).
harden-session-cookie (function).
require-session-csrf-token (function).
require-session-user (function).
session-csrf-token (function).
session-user (function).
(setf session-user) (function).
*csrf-secret* (special variable).
*the-random-state* (special variable).
next-csrf-token (function).
random-string (function).
Definitions are sorted by export status, category, package, and then by lexicographic order.
Abort handling of the request as if the handler had returned HUNCHENTOOT:+HTTP-BAD-REQUEST+.
Abort handling of the request as if the handler had returned HUNCHENTOOT:+HTTP-FORBIDDEN+.
Abort handling of the request as if the handler had returned HUNCHENTOOT:+HTTP-INTERNAL-SERVER-ERROR+.
Abort handling of the request as if the handler had returned HUNCHENTOOT:+HTTP-NOT-FOUND+.
Abort handling of the request as if the handler had returned RETURN-CODE.
Return a request dispatch function which will dispatch to the function denoted by HANDLER if the file name of the current request starts with the string PREFIX and the method of the current request is a member of the list denoted by METHODS. The dispatch function will return NIL if there is no match.
Return a request dispatch function which will dispatch to the function denoted by HANDLER if the file name of the current request matches the CL-PPCRE regular expression REGEX and the method of the current request is a member of the list denoted by METHODS. The dispatch function will return NIL if there is no match.
Return a request dispatch function which will dispatch to the function denoted by HANDLER if the file name of the current request matches the string URI and the method of the current request is a member of the list denoted by METHODS. The dispatch function will return NIL if there is no match.
Remove the CSRF token, if any, from the session.
Remove the user, if any, from the session.
Given a string STRING, return a new string, encoding with the
function denoted by ESCAPE-WRITE-FUNCTION every character for which the
function denoted by TEST returns true.
Use this in place of CL-WHO:ESCAPE-STRING where custom encoding is required.
Given a string STRING, return a new string, escaping all ASCII values less than 256 with the xHH format and those greater than or equal to 256 with the uHHHH format.
Set the HTTP-ONLY and secure flags of the outgoing cookie named NAME and set it to expire with the session. NAME defaults to "hunchentoot-session".
Abort handling the request, log a warning message, and remove any
session CSRF token if the request of type denoted by REQUEST-TYPE does
not provide a value for the parameter NAME, if the provided value does
not match the session CSRF token, or if the session CSRF token has not
been set. Othewise, do nothing. REQUEST-TYPE can be one
of :GET, :POST, :PUT, or :DELETE. NAME defaults to "csrf-token".
Log a warning message and redirect if no user is set for the session. Otherwise, do nothing. REDIRECT-ARGS are used as keyword arguments to HUNCHENTOOT:REDIRECT.
Return the current CSRF token set for the session or a new token if one has not been set. If the session does not exist, return NIL.
Return the user set for the session. Return NIL if the session does
not exist or if no user has been set.
SETF of SESSION-USER can be used to set a new user for the session. If the session does not exist then one is created. Signal a correctable error of type TYPE-ERROR if SETF of SESSION-USER is called with a NIL value for user.
| Jump to: | (
A C D E F H N R S |
|---|
| Jump to: | (
A C D E F H N R S |
|---|
| Jump to: | *
S |
|---|
| Jump to: | *
S |
|---|
| Jump to: | A D F H P S |
|---|
| Jump to: | A D F H P S |
|---|