The snooze Reference Manual

Table of Contents

The snooze Reference Manual

This is the snooze Reference Manual, version 1.0.0, generated automatically by Declt version 3.0 "Montgomery Scott" on Mon Dec 02 11:22:29 2019 GMT+0.

1 Introduction

Snooze

Snooze is an URL router for Common Lisp designed around REST web services.

An URL router lets you open URL routes to your application that are friendlier, easier to remember and better supported by other applications, such as search engines. RESTful routes are near universal in web APIs and look like this.

All Snooze does is establish a tight fit between this type of route and plain old Common Lisp. For example, in Snooze, routes are just functions and HTTP conditions are just Lisp conditions.

Since you stay inside Lisp, if you know how to make a function, you know how to make a route. There are no regular expressions to write or extra route-defining syntax to learn.

Snooze is web-server-backend-agnostic: it can work with any web server.

Here's an example you can try out quickly: a micro-REST service to read and write Lisp docstrings over HTTP:

(defpackage #:readme-demo (:use #:cl #:snooze))
(in-package #:readme-demo)

(defun find-symbol-or-lose (name package)
  (or (find-symbol (string name) (find-package package))
      (http-condition 404 "Sorry, no such symbol")))

(defroute lispdoc (:get :text/* name &key (package :cl) (doctype 'function))
  (or (documentation (find-symbol-or-lose name package) doctype)
      (http-condition 404 "Sorry, ~a doesn't have any ~a doc" name doctype)))

(defroute lispdoc (:post :text/plain name &key (package :cl) (doctype 'function))
  (setf (documentation (find-symbol-or-lose name package) doctype)
        (payload-as-string)))

;; Let's use clack as a server backend
(clack:clackup (snooze:make-clack-app) :port 9003)

This establishes two routes (GET for reading and POST for writing) on the URI localhost:9003/lispdoc/<symbol>. Here's an illustration of how they respond:

GET /lispdoc/defun                         => 200 OK
GET /lispdoc/funny-syntax?package=snooze   => 404 Not found
GET /lispdoc/in/?valid=args                => 400 Bad Request
                                           
GET /lispdoc/defun                         => 406 Not Acceptable 
Accept: application/json

POST /lispdoc/scan?package=cl-ppcre        => 200 OK 
Content-type: text/plain

POST /lispdoc/defun                        => 415 Unsupported Media Type 
Content-type: application/json

The error codes 400, 406 and 415 are error reporting that you get "for free": if the HTTP client strays off these routes, be it for improper syntax or unsupported content types, the correct HTTP condition is signalled.

The rest of this README contains the rationale for building Snooze and a tutorial that builds on the simple application presented above.

Status

Ah, Snooze is kinda BETA. The usual disclaimer of warranty applies.

Rationale

There are already some Common Lisp systems for HTTP routing, like caveman, cl-rest-server,restas and ningle. Unfortunately, they tend to make you learn some extra route-defining syntax.

On the contrary Snooze maps REST/HTTP concepts to Common Lisp concepts:

| HTTP/REST concept | Snooze CL concept | | :----------------------------------- | ----------------------------------: | | REST resource | CLOS generic function | | Route | CLOS method | | Verbs (GET, POST, DELETE, etc) | CLOS specializer on first argument | | Accept: and Content-Type: | CLOS specializer on second argument | | URI path (/path1/path2/path3)) | Required and optional arguments | | URL queries (?param=value&p2=v2) | Keyword arguments | | Status codes (404, 500, etc) | CL conditions |

This has many advantages, for example

• since every route is a method, you can trace it like a regular function, find its definition with M-. or even use :around qualifiers;
• using a regular lambda-list guarantees that URI errors can be spotted early by your compiler;
• there is no need to write code to "extract" arguments from the URI.
• Since Snooze knows the lambda-list of a route, it can use it to do the reverse of URI matching: generate URIs that perfectly match that same route.

Tutorial

Consider the code sample presented above. Let's pick up where we left off, and build a bit more of lispdoc, our docstring-manipulating application. We'll see how to:

• understand Snooze's REST resources
• dispatch on HTTP methods and content-types
• generate and encode compatible URIs
• grafully handle failure conditions
• control conversion of URI arguments
• refactor routes without changing the API
• hook Snooze into the backend of your choice

This tutorial assumes you're using a recent version of quicklisp so start by entering this into your REPL.

(push "path/to/snoozes/parent/dir" quicklisp:*local-project-directories*)
(ql:quickload :snooze)

Make sure you keep an eye on the docstrings of the functions mentioned, they are where the real API reference lives. Find them all, appropriately, in the api.lisp file.

Resources as generic functions

An important detail that was elided from the initial sample is that, in Snooze:

• a REST resource is implemented a CLOS generic function.
• The operations (GET, POST, DELETE, etc...) accepted by a resource are implemented as CLOS methods on that generic function

When a HTTP request is received, Snooze arranges for its URI to be translated into a generic function name and its remaining properties (verb, content-type, additional URI bits) to be translated into arguments for that function. Snooze then calls that function with those arguments and CLOS does the rest:

• if one of the methods of this generic function matches, its body is called and the HTTP client sees a nice response;

• otherwise a condition is signalled and Snooze takes care that the HTTP client sees the correct error code.

Under the hood, defroute is actually a really thin wrapper on defmethod. You can even use defmethod directly if you prefer:

(defmethod lispdoc
            ((snooze-verbs:http-verb snooze-verbs:post)
             (snooze-types:type snooze-types:text/plain) name
             &key (package :cl) (doctype 'function))
   (setf (documentation (find-symbol-or-lose name package) doctype)
         (payload-as-string)))

Likewise there is a defresource form that is equivalent to defgeneric. It may be left out since it is implicit in the first defroute call.

This means we could have defined the above application in an equivalent terser form:

(defresource lispdoc (verb content-type name &key)
  (:route (:get :text/* name &key (package :cl) (doctype 'function))
    (or (documentation (find-symbol-or-lose name package) doctype)
        (http-condition 404 "Sorry, ~a doesn't have any ~a doc" name doctype)))
  (:route (:post :text/plain name &key (package :cl) (doctype 'function))
    (setf (documentation (find-symbol-or-lose name package) doctype)
          (payload-as-string))))

Content-Types

Let's start by serving docstrings in HTML. As seen above, we already have a route which serves plain text:

(defroute lispdoc (:get :text/* name &key (package :cl) (type 'function))
  (or (documentation (find-symbol-or-lose name package) type)
      (http-condition 404 "Sorry no ~a doc for ~a" type name)))

To add a similar route for the content-type text/html, we just notice that text/html is text/*. Also because routes are really only CLOS methods, the easiest way is:

(defroute lispdoc :around (:get :text/html name &key &allow-other-keys)
  (format nil "<h1>Docstring for ~a</h1><p>~a</p>"
          name (call-next-method)))

This will do fine for now. Of course, later we should probably escape the HTML with something like cl-who's escape-string-all. We might also consider removing the :around qualifier and use a helper function shared by two routes.

Let's try our hand at implementing an important part of the API: POST requests with JSON content:

(defroute lispdoc (:post "application/json" name &key (package :cl) (doctype 'function))
  (let* ((json (handler-case
                   ;; you'll need to quickload :cl-json
                   (json:decode-json-from-string
                    (payload-as-string))
                 (error (e)
                   (http-condition 400 "Malformed JSON (~a)!" e))))
         (sym (find-symbol-or-lose name package))
         (docstring (cdr (assoc :docstring json))))
    (if (and sym docstring doctype)
        (setf (documentation sym doctype) docstring)
        (http-condition 400 "JSON missing some properties"))))

URI generation

Our application has a growing number of routes that work fine, provided the use knows how to type them. Because this is increasingly complicated as more and more routes are added, it is very often the case that we'll want parts of the our REST application to generate URI's that match its own routes. Probably, the most common case is providing a link to a specific resource in an HTML response.

This is very easy to do in Snooze, as it can automatically generate the URIs for a resource. You first need to get a "genpath" function for your resource. Just do:

(defgenpath lispdoc lispdoc-path)

Or, alternatively, pass :genpath to defresource.

(defresource lispdoc (verb ct symbol) (:genpath lispdoc-path))

The newly generated lispdoc-path has an argument list that perfectly matches your route's arguments:

(lispdoc-path 'defroute :package 'snooze)
  ;; => "/lispdoc/defroute?package=snooze"
(lispdoc-path 'defun)
  ;; => "/lispdoc/defun"
(lispdoc-path '*standard-output* :doctype 'variable)
  ;; => "/lispdoc/%2Astandard-output%2A?doctype=variable"
(lispdoc-path '*standard-output* :FOO 'hey)
  ;; error! unknown &KEY argument: :FOO

Notice the automatic URI-encoding of the * character and how the function errors on invalid keyword arguments that would produce an invalid route.

Path generators are useful, for example, when write HTML links to your resources. In our example, let's use it to guide the user to the correct URL when an easily-fixed 404 happens:

(defun doc-not-found-message (name package doctype)
  (let* ((othertype (if (eq doctype 'function) 'variable 'function))
         (otherdoc (documentation (find-symbol-or-lose name package) othertype)))
    (with-output-to-string (s)
      (format s "There is no ~a doc for ~a." doctype name)
      (when otherdoc
        (format s "<p>But try <a href=~a>here</a></p>"
                (lispdoc-path name :package package :doctype othertype))))))

(defroute lispdoc (:get :text/html name &key (package :cl) (doctype 'function))
  (or (documentation (find-symbol-or-lose name package) doctype)
      (http-condition 404 (doc-not-found-message name package doctype))))

If you now point your browser to:

http://localhost:9003/lispdoc/%2Astandard-output%2A?doctype=variable

You should see a nicer 404 error message. Except you don't (!), because, by default, Snooze is very terse with error messages and we haven't told it not to be. So don't worry, the next sections explains how to change that.

Controlling errors

Errors and unexpected situations are part of normal HTTP life. Many websites and REST services not only return an HTTP status code, but also serve information about the conditions that lead to an error, be it in a pretty HTML error page or a JSON object describing the problem.

Snooze tries to make it possible to precisely control what information gets sent to the client. It uses a generic function and two variables:

• explain-condition (condition resource content-type)
• *catch-errors*
• *catch-http-conditions*

Out of the box, there are no methods on explain-condition and the two variables are set to t.

This means that any HTTP condition or a Lisp error in your application will generate a very terse reply in plain-text containing only the status code and the standard reason phrase.

You can amend this selectively by addingexplain-condition methods that explain HTTP conditions politely in, say, HTML:

(defmethod explain-condition ((condition http-condition)
                              (resource (eql #'lispdoc))
                              (ct snooze-types:text/html))
               (with-output-to-string (s)
                 (format s "<h1>Terribly sorry</h1><p>You might have made a mistake, I'm afraid</p>")
                 (format s "<p>~a</p>" condition)))

The above explains only HTTP conditions that are the client's fault, but you can use the same technique to explain any error, like so:

(defmethod explain-condition ((error error) (resource (eql #'lispdoc)) (ct snooze-types:text/html))
               (with-output-to-string (s)
                 (format s "<h1>Oh dear</h1><p>It seems I've messed up somehow</p>")))

Finally, you can play around with *catch-errors* and *catch-http-conditions (see their docstrings). I normally leave *catch-http-conditions* set to t and *catch-errors* set to either :verbose or nil depending on whether I want to do debugging in the browser or in Emacs.

How Snooze converts URI components to arguments

You might have noticed already that the arguments passed to the CLOS generic functions that represent resources are actual Lisp symbols extracted from the URI, whereas other frameworks normally pass them as strings.

What are the advantages of this? Let's drift from the lispdoc example a bit. Consider this fragment of a Beatle-listing app.

(defclass beatle () ((id      :initarg :id)
                     (name    :initarg :name    :accessor name)
                     (guitars :initarg :guitars :accessor number-of-guitars)))

(defparameter *beatles*
           (list (make-instance 'beatle :id 1 :name "John" :guitars 1)
                 (make-instance 'beatle :id 2 :name "Paul" :guitars 2)
                 (make-instance 'beatle :id 3 :name "Ringo" :guitars 0)
                 (make-instance 'beatle :id 4 :name "George" :guitars 10)))

(defroute beatles (:get "text/plain" &key (key 'number-of-guitars) (predicate '>))
  (assert-safe-functions key predicate)
  (format nil "~{~a~^~%~}"
          (mapcar #'name
                  (sort (copy-list *beatles*) predicate :key key))))

(defgenpath beatles beatles-path)

The defgenpath form makes beatles-path be a function of two keyword arguments, :key and :predicate that returns the perfect URI for accessing the beatles route. Among other things you can name regular functions (like < and string-lessp in this example) by their symbols, as you would in pure Lisp.

CL-USER> (beatles-path :key 'number-of-guitars :predicate '<)
"/beatles/?key=number-of-guitars&predicate=%3C"
CL-USER> (beatles-path :key 'name :predicate 'string-lessp)
"/beatles/?key=name&predicate=string-lessp"

Sure enough, feeding these URIs to the HTTP client causes the function beatles to be called with exactly the same symbols that you passed to beatles-path.

Now, if you're thinking that this doesn't fit needs, know that it is merely a default behaviour, and entirely configurable: if you really want to have the URI path foo/bar/baz become the strings "foo", "bar" and "baz" in your application you merely need to add a CLOS method to the each of the generic functions read-for-resource and write-for-resource.

Nevertheless, I recommend you keep the default:

• The default read-for-resource uses a very locked down version of cl:read-to-string that doesn't intern symbols (for security), allow any kind of reader macros or read anything more complicated than a number, a string or a symbol.

• The default write-for-resource does the inverse: it writes onto a string of any object so that read-for-resource can reconstruct that object from the string (so long as the object is a secure thing to serialize over URI).

There is perhaps a better way to influence the mapping between URIs and arguments. To that effect, two other functions are discussed in the next section: arguments-to-uri and uri-to-arguments.

Tighter routes

Let's recall the lispdoc app. The routes we have until now are functions of a string. To convert them into actual symbols they need:

• the find-symbol-or-lose helper;
• an additional :package keyword arg.

This isn't pretty: it would be nicer if routes were functions of a symbol. After all, in Common Lisp, passing symbols around shouldn't force you to pass their packages separately!

So basically, we want to write our methods like this:

(defroute lispdoc (:get :text/* (sym symbol) &key (doctype 'function))
  (or (documentation sym doctype)
      (http-condition 404 (doc-not-found-message sym doctype))))

Actually, this will work just fine out of the box. Oh wait, now our routes look like this:

(lispdoc-path 'cl-ppcre:scan)
  ;; => "/lispdoc/cl-ppcre%3Ascan"
(lispdoc-path 'ql:quickload)
  ;; => "/lispdoc/quicklisp-client%3Aquickload"

Compare these to the routes at the very top of this document:

  /lispdoc/scan?package=cl-ppcre
  /lispdoc/quickload?package=ql

You might be dissapointed that the new ones are not as human-readable (the %3A encoding for the : looks would look slightly bizarre to a user reading it in the browser's address bar). But even if you don't care about appearance and find them perfectly acceptable, it is conceivable that we had already published the routes of the older REST API to the world.

So, to keep that API, we need to change the implementation without changing the interface. This is where uri-to-arguments and its reciprocal arguments-to-uri come in handy. These generic functions have default implementations for all resources that can be leveraged for surgical tweaks like the one we need here:

• uri-to-arguments receives an URI string, and make it compute a values-list of "plain" and keyword arguments that are passed to the route (after the verb and content type). In our case, we first parse the plain symbol name and :package using call-next-method, then compute an actual symbol. We also make sure to not pass :package to our new route, as it doesn't accept it.

• arguments-to-uri is the function that allows the genpath function to produce matching URIs. It does the reverse, producing an URI string. In this case it takes a symbol in plain-args, After extracting its package and massaging it into an uninterned symbol, we also use call-next-method to simplify things.

(defmethod uri-to-arguments ((resource (eql #'lispdoc)) uri)
  (multiple-value-bind (plain-args keyword-args)
      (call-next-method)
    (let* ((sym-name (string (first plain-args)))
           (package-name (or (cdr (assoc :package keyword-args)) 'cl))
           (sym (find-symbol sym-name package-name)))
      (unless sym
        (http-condition 404 "Sorry, no such symbol"))
      (values (cons sym (cdr plain-args))
              (remove :package keyword-args :key #'car)))))

(defmethod arguments-to-uri ((resource (eql #'lispdoc)) plain-args keyword-args)
  (let ((sym (first plain-args)))
    (call-next-method resource
                      (list sym)
                      (cons `(:package . ,(make-symbol
                                           (package-name (symbol-package sym))))
                            keyword-args))))

We can now safely rewrite the remaining routes in much simpler fashion. Here's the rest of the application now (notice also how doc-not-found-message was also simplified)

(defun doc-not-found-message (symbol doctype)
  (let* ((othertype (if (eq doctype 'function) 'variable 'function))
         (otherdoc (documentation symbol othertype)))
    (with-output-to-string (s)
      (format s "There is no ~a doc for ~a." doctype symbol)
      (when otherdoc
        (format s "<p>But try <a href=~a>here</a></p>"
                (lispdoc-path symbol :doctype othertype))))))

(defroute lispdoc (:get :text/* (sym symbol) &key (doctype 'function))
  (or (documentation sym doctype)
      (http-condition 404 "No doc found for ~a" sym)))

(defroute lispdoc (:post :text/plain (sym symbol) &key (doctype 'function))
  (setf (documentation sym doctype)
        (payload-as-string)))

(defroute lispdoc (:get :text/html (sym symbol) &key (doctype 'function))
  (or (documentation sym doctype)
      (http-condition 404 (doc-not-found-message sym doctype))))

(defroute lispdoc (:post :application/json (sym symbol) &key (doctype 'function))
  (let* ((json (handler-case
                   (json:decode-json-from-string
                    (payload-as-string))
                 (error (e)
                   (http-condition 400 "Malformed JSON! (~a)" e))))
         (docstring (cdr (assoc :docstring json))))
    (setf (documentation sym doctype) docstring)))

Other backends

Snooze is web-server agnostic: it's just an URL router. It does come with two utility functions, make-clack-app and make-hunchentoot-app that will plug into two popular web servers and quickly let you jump into the action:

;;; Use hunchentoot directly
(push (snooze:make-hunchentoot-app) hunchentoot:*dispatch-table*)
(hunchentoot:start (make-instance 'hunchentoot:easy-acceptor :port 9003))

;;; Use clack
(clack:clackup (snooze:make-clack-app) :port 9003)

But Snooze doesn't "require" Clack or Hunchentoot in any sense. So if you want to use any other backend, I suggest you take a look at the implementations of make-hunchentoot-app and make-clack-app functions, particularly their use of snooze:handle-request.

Support

To ask questions, report bugs, or just discuss matters open an issue or send me email.

2 Systems

The main system appears first, followed by any subsystem dependency.

2.1 snooze

Author

João Távora <https://github.com/capitaomorte>

License

LLGPL

Description

A framework for building REST services using CLOS.

Version

1.0.0

Dependencies

• alexandria
• cl-ppcre
• closer-mop
• quri
• uiop
• parse-float
• rfc2388

Source

snooze.asd (file)

Components

• package.lisp (file)
• constants.lisp (file)
• safe-simple-read.lisp (file)
• common.lisp (file)
• api.lisp (file)

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.

3.1 Lisp

3.1.1 snooze.asd

Location

snooze.asd

Systems

snooze (system)

3.1.2 snooze/package.lisp

Parent

snooze (system)

Location

package.lisp

Packages

• snooze-types
• snooze-common
• snooze-safe-simple-read
• snooze

3.1.3 snooze/constants.lisp

Dependency

package.lisp (file)

Parent

snooze (system)

Location

constants.lisp

Exported Definitions

• *mime-type-hash* (special variable)
• reason-for (function)

Internal Definitions

• *mime-type-list* (special variable)
• *reason-phrase-hash* (special variable)

3.1.4 snooze/safe-simple-read.lisp

Dependency

constants.lisp (file)

Parent

snooze (system)

Location

safe-simple-read.lisp

Exported Definitions

safe-simple-read-from-string (function)

Internal Definitions

• parse-integer-then-float (function)
• parse-symbol (function)
• read-name (function)
• read-string (function)
• snooze-reader-error (condition)

3.1.5 snooze/common.lisp

Dependency

safe-simple-read.lisp (file)

Parent

snooze (system)

Location

common.lisp

Packages

snooze-verbs

Exported Definitions

• *all-resources* (special variable)
• all-defined-resources (function)
• application (class)
• application/andrew-inset (class)
• application/cu-seeme (class)
• application/dsptype (class)
• application/futuresplash (class)
• application/hta (class)
• application/java-archive (class)
• application/java-serialized-object (class)
• application/java-vm (class)
• application/json (class)
• application/mac-binhex40 (class)
• application/mac-compactpro (class)
• application/mathematica (class)
• application/msaccess (class)
• application/msword (class)
• application/octet-stream (class)
• application/oda (class)
• application/ogg (class)
• application/pdf (class)
• application/pgp-keys (class)
• application/pgp-signature (class)
• application/pics-rules (class)
• application/postscript (class)
• application/rar (class)
• application/rdf+xml (class)
• application/rss+xml (class)
• application/smil (class)
• application/vnd.cinderella (class)
• application/vnd.mozilla.xul+xml (class)
• application/vnd.ms-excel (class)
• application/vnd.ms-pki.seccat (class)
• application/vnd.ms-pki.stl (class)
• application/vnd.ms-powerpoint (class)
• application/vnd.oasis.opendocument.chart (class)
• application/vnd.oasis.opendocument.database (class)
• application/vnd.oasis.opendocument.formula (class)
• application/vnd.oasis.opendocument.graphics (class)
• application/vnd.oasis.opendocument.graphics-template (class)
• application/vnd.oasis.opendocument.image (class)
• application/vnd.oasis.opendocument.presentation (class)
• application/vnd.oasis.opendocument.presentation-template (class)
• application/vnd.oasis.opendocument.spreadsheet (class)
• application/vnd.oasis.opendocument.spreadsheet-template (class)
• application/vnd.oasis.opendocument.text (class)
• application/vnd.oasis.opendocument.text-master (class)
• application/vnd.oasis.opendocument.text-template (class)
• application/vnd.oasis.opendocument.text-web (class)
• application/vnd.rim.cod (class)
• application/vnd.smaf (class)
• application/vnd.stardivision.calc (class)
• application/vnd.stardivision.draw (class)
• application/vnd.stardivision.impress (class)
• application/vnd.stardivision.math (class)
• application/vnd.stardivision.writer (class)
• application/vnd.stardivision.writer-global (class)
• application/vnd.sun.xml.calc (class)
• application/vnd.sun.xml.calc.template (class)
• application/vnd.sun.xml.draw (class)
• application/vnd.sun.xml.draw.template (class)
• application/vnd.sun.xml.impress (class)
• application/vnd.sun.xml.impress.template (class)
• application/vnd.sun.xml.math (class)
• application/vnd.sun.xml.writer (class)
• application/vnd.sun.xml.writer.global (class)
• application/vnd.sun.xml.writer.template (class)
• application/vnd.symbian.install (class)
• application/vnd.visio (class)
• application/vnd.wap.wbxml (class)
• application/vnd.wap.wmlc (class)
• application/vnd.wap.wmlscriptc (class)
• application/wordperfect (class)
• application/wordperfect5.1 (class)
• application/x-123 (class)
• application/x-abiword (class)
• application/x-apple-diskimage (class)
• application/x-bcpio (class)
• application/x-bittorrent (class)
• application/x-cdf (class)
• application/x-cdlink (class)
• application/x-chess-pgn (class)
• application/x-cpio (class)
• application/x-csh (class)
• application/x-debian-package (class)
• application/x-director (class)
• application/x-dms (class)
• application/x-doom (class)
• application/x-dvi (class)
• application/x-flac (class)
• application/x-font (class)
• application/x-freemind (class)
• application/x-futuresplash (class)
• application/x-gnumeric (class)
• application/x-go-sgf (class)
• application/x-graphing-calculator (class)
• application/x-gtar (class)
• application/x-hdf (class)
• application/x-httpd-php (class)
• application/x-httpd-php-source (class)
• application/x-httpd-php3 (class)
• application/x-httpd-php3-preprocessed (class)
• application/x-httpd-php4 (class)
• application/x-ica (class)
• application/x-internet-signup (class)
• application/x-iphone (class)
• application/x-iso9660-image (class)
• application/x-java-jnlp-file (class)
• application/x-javascript (class)
• application/x-jmol (class)
• application/x-kchart (class)
• application/x-killustrator (class)
• application/x-koan (class)
• application/x-kpresenter (class)
• application/x-kspread (class)
• application/x-kword (class)
• application/x-latex (class)
• application/x-lha (class)
• application/x-lzh (class)
• application/x-lzx (class)
• application/x-maker (class)
• application/x-mif (class)
• application/x-ms-wmd (class)
• application/x-ms-wmz (class)
• application/x-msdos-program (class)
• application/x-msi (class)
• application/x-netcdf (class)
• application/x-ns-proxy-autoconfig (class)
• application/x-nwc (class)
• application/x-object (class)
• application/x-oz-application (class)
• application/x-pkcs7-certreqresp (class)
• application/x-pkcs7-crl (class)
• application/x-python-code (class)
• application/x-quicktimeplayer (class)
• application/x-redhat-package-manager (class)
• application/x-sh (class)
• application/x-shar (class)
• application/x-shockwave-flash (class)
• application/x-stuffit (class)
• application/x-sv4cpio (class)
• application/x-sv4crc (class)
• application/x-tar (class)
• application/x-tcl (class)
• application/x-tex-gf (class)
• application/x-tex-pk (class)
• application/x-texinfo (class)
• application/x-trash (class)
• application/x-troff (class)
• application/x-troff-man (class)
• application/x-troff-me (class)
• application/x-troff-ms (class)
• application/x-ustar (class)
• application/x-wais-source (class)
• application/x-wingz (class)
• application/x-www-form-urlencoded (class)
• application/x-x509-ca-cert (class)
• application/x-xcf (class)
• application/x-xfig (class)
• application/x-xpinstall (class)
• application/xhtml+xml (class)
• application/xml (class)
• application/zip (class)
• audio (class)
• audio/basic (class)
• audio/midi (class)
• audio/mpeg (class)
• audio/mpegurl (class)
• audio/prs.sid (class)
• audio/x-aiff (class)
• audio/x-gsm (class)
• audio/x-mpegurl (class)
• audio/x-ms-wax (class)
• audio/x-ms-wma (class)
• audio/x-pn-realaudio (class)
• audio/x-realaudio (class)
• audio/x-scpls (class)
• audio/x-sd2 (class)
• audio/x-wav (class)
• chemical (class)
• chemical/x-alchemy (class)
• chemical/x-cache (class)
• chemical/x-cache-csf (class)
• chemical/x-cactvs-binary (class)
• chemical/x-cdx (class)
• chemical/x-cerius (class)
• chemical/x-chem3d (class)
• chemical/x-chemdraw (class)
• chemical/x-cif (class)
• chemical/x-cmdf (class)
• chemical/x-cml (class)
• chemical/x-compass (class)
• chemical/x-crossfire (class)
• chemical/x-csml (class)
• chemical/x-ctx (class)
• chemical/x-cxf (class)
• chemical/x-embl-dl-nucleotide (class)
• chemical/x-galactic-spc (class)
• chemical/x-gamess-input (class)
• chemical/x-gaussian-checkpoint (class)
• chemical/x-gaussian-cube (class)
• chemical/x-gaussian-input (class)
• chemical/x-gaussian-log (class)
• chemical/x-gcg8-sequence (class)
• chemical/x-genbank (class)
• chemical/x-hin (class)
• chemical/x-isostar (class)
• chemical/x-jcamp-dx (class)
• chemical/x-kinemage (class)
• chemical/x-macmolecule (class)
• chemical/x-macromodel-input (class)
• chemical/x-mdl-molfile (class)
• chemical/x-mdl-rdfile (class)
• chemical/x-mdl-rxnfile (class)
• chemical/x-mdl-sdfile (class)
• chemical/x-mdl-tgf (class)
• chemical/x-mmcif (class)
• chemical/x-mol2 (class)
• chemical/x-molconn-z (class)
• chemical/x-mopac-graph (class)
• chemical/x-mopac-input (class)
• chemical/x-mopac-out (class)
• chemical/x-mopac-vib (class)
• chemical/x-ncbi-asn1 (class)
• chemical/x-ncbi-asn1-ascii (class)
• chemical/x-ncbi-asn1-binary (class)
• chemical/x-ncbi-asn1-spec (class)
• chemical/x-pdb (class)
• chemical/x-rosdal (class)
• chemical/x-swissprot (class)
• chemical/x-vamas-iso14976 (class)
• chemical/x-vmd (class)
• chemical/x-xtel (class)
• chemical/x-xyz (class)
• content (class)
• content-class-name (function)
• content-classes-in-accept-string (function)
• content-type-spec-or-lose (function)
• content-verb (class)
• default-resource-name (function)
• delete (class)
• delete-resource (function)
• destructive-p (function)
• ensure-atom (function)
• ensure-uri (function)
• find-content-class (function)
• find-resource (function)
• find-verb-or-lose (function)
• get (class)
• gf-primary-method-specializer (function)
• http-condition (condition)
• http-error (condition)
• http-verb (class)
• image (class)
• image/gif (class)
• image/ief (class)
• image/jpeg (class)
• image/pcx (class)
• image/png (class)
• image/svg+xml (class)
• image/tiff (class)
• image/vnd.djvu (class)
• image/vnd.wap.wbmp (class)
• image/x-cmu-raster (class)
• image/x-coreldraw (class)
• image/x-coreldrawpattern (class)
• image/x-coreldrawtemplate (class)
• image/x-corelphotopaint (class)
• image/x-icon (class)
• image/x-jg (class)
• image/x-jng (class)
• image/x-ms-bmp (class)
• image/x-photoshop (class)
• image/x-portable-anymap (class)
• image/x-portable-bitmap (class)
• image/x-portable-graymap (class)
• image/x-portable-pixmap (class)
• image/x-rgb (class)
• image/x-xbitmap (class)
• image/x-xpixmap (class)
• image/x-xwindowdump (class)
• invalid-resource-arguments (condition)
• model (class)
• model/iges (class)
• model/mesh (class)
• model/vrml (class)
• no-such-resource (condition)
• no-such-route (condition)
• parse-content-type-header (function)
• parse-defroute-args (function)
• parse-resource (function)
• post (class)
• probe-class-sym (function)
• put (class)
• receiving-verb (class)
• resource-generic-function (class)
• resource-name (function)
• scan-to-strings* (function)
• search-for-extension-content-type (function)
• sending-verb (class)
• status-code (method)
• text (class)
• text/calendar (class)
• text/comma-separated-values (class)
• text/css (class)
• text/h323 (class)
• text/html (class)
• text/iuls (class)
• text/javascript (class)
• text/mathml (class)
• text/plain (class)
• text/richtext (class)
• text/rtf (class)
• text/scriptlet (class)
• text/tab-separated-values (class)
• text/texmacs (class)
• text/vnd.sun.j2me.app-descriptor (class)
• text/vnd.wap.wml (class)
• text/vnd.wap.wmlscript (class)
• text/x-bibtex (class)
• text/x-boo (class)
• text/x-c++hdr (class)
• text/x-c++src (class)
• text/x-chdr (class)
• text/x-component (class)
• text/x-csh (class)
• text/x-csrc (class)
• text/x-dsrc (class)
• text/x-haskell (class)
• text/x-java (class)
• text/x-literate-haskell (class)
• text/x-moc (class)
• text/x-pascal (class)
• text/x-pcs-gcd (class)
• text/x-perl (class)
• text/x-python (class)
• text/x-setext (class)
• text/x-sh (class)
• text/x-tcl (class)
• text/x-tex (class)
• text/x-vcalendar (class)
• text/x-vcard (class)
• unconvertible-argument (condition)
• unconvertible-argument-key (method)
• (setf unconvertible-argument-key) (method)
• unconvertible-argument-value (method)
• (setf unconvertible-argument-value) (method)
• verb-spec-or-lose (function)
• video (class)
• video/dl (class)
• video/dv (class)
• video/fli (class)
• video/gl (class)
• video/mp4 (class)
• video/mpeg (class)
• video/quicktime (class)
• video/vnd.mpegurl (class)
• video/x-la-asf (class)
• video/x-m4v (class)
• video/x-mng (class)
• video/x-ms-asf (class)
• video/x-ms-wm (class)
• video/x-ms-wmv (class)
• video/x-ms-wmx (class)
• video/x-ms-wvx (class)
• video/x-msvideo (class)
• video/x-sgi-movie (class)
• x-conference (class)
• x-conference/x-cooltalk (class)
• x-world (class)
• x-world/x-vrml (class)

Internal Definitions

• *resource* (special variable)
• actual-args (method)
• (setf actual-args) (method)
• arguments-to-uri-1 (function)
• brutally-explaining-conditions (macro)
• call-brutally-explaining-conditions (function)
• call-politely-explaining-conditions (function)
• check-arglist-compatible (function)
• check-optional-args (function)
• content-type-spec-or-lose-1 (function)
• defgenpath-1 (function)
• define-content (macro)
• define-known-content-types (macro)
• defresource-1 (function)
• defroute-1 (function)
• error-when-explaining (condition)
• explain-condition-failsafe (method)
• explain-failsafe (method)
• explain-failsafe (method)
• explain-failsafe (method)
• explain-failsafe (method)
• explain-failsafe (method)
• explain-failsafe (method)
• explain-failsafe (method)
• genpath-fn-lambda-list (function)
• handle-request-1 (function)
• incompatible-lambda-list (condition)
• intern-safe (function)
• invalid-uri (method)
• (setf invalid-uri) (method)
• invalid-uri-structure (condition)
• lambda-list (method)
• (setf lambda-list) (method)
• make-genpath-form (function)
• matching-content-type-or-lose (function)
• original-condition (method)
• original-condition-backtrace (method)
• politely-explaining-conditions (macro)
• read-for-resource-1 (function)
• resignalled-condition (condition)
• resource (type)
• resource-p (function)
• resource-package (function)
• unsupported-content-type (condition)
• uri-to-arguments-1 (function)
• write-for-resource-1 (function)

3.1.6 snooze/api.lisp

Dependency

common.lisp (file)

Parent

snooze (system)

Location

api.lisp

Exported Definitions

• *backend* (special variable)
• *catch-errors* (special variable)
• *catch-http-conditions* (special variable)
• *clack-request-env* (special variable)
• *home-resource* (special variable)
• *resource-filter* (special variable)
• *resource-name-function* (special variable)
• *uri-content-types-function* (special variable)
• arguments-to-uri (generic function)
• arguments-to-uri (method)
• backend-payload (generic function)
• backend-payload (method)
• backend-payload (method)
• defgenpath (macro)
• defresource (macro)
• defroute (macro)
• explain-condition (generic function)
• handle-request (function)
• http-condition (function)
• make-clack-app (function)
• make-hunchentoot-app (function)
• payload-as-string (function)
• read-for-resource (generic function)
• read-for-resource (method)
• uri-to-arguments (generic function)
• uri-to-arguments (method)
• write-for-resource (generic function)
• write-for-resource (method)

4 Packages

Packages are listed by definition order.

4.1 snooze-types

Source

package.lisp (file)

Exported Definitions

• application (class)
• application/andrew-inset (class)
• application/cu-seeme (class)
• application/dsptype (class)
• application/futuresplash (class)
• application/hta (class)
• application/java-archive (class)
• application/java-serialized-object (class)
• application/java-vm (class)
• application/json (class)
• application/mac-binhex40 (class)
• application/mac-compactpro (class)
• application/mathematica (class)
• application/msaccess (class)
• application/msword (class)
• application/octet-stream (class)
• application/oda (class)
• application/ogg (class)
• application/pdf (class)
• application/pgp-keys (class)
• application/pgp-signature (class)
• application/pics-rules (class)
• application/postscript (class)
• application/rar (class)
• application/rdf+xml (class)
• application/rss+xml (class)
• application/smil (class)
• application/vnd.cinderella (class)
• application/vnd.mozilla.xul+xml (class)
• application/vnd.ms-excel (class)
• application/vnd.ms-pki.seccat (class)
• application/vnd.ms-pki.stl (class)
• application/vnd.ms-powerpoint (class)
• application/vnd.oasis.opendocument.chart (class)
• application/vnd.oasis.opendocument.database (class)
• application/vnd.oasis.opendocument.formula (class)
• application/vnd.oasis.opendocument.graphics (class)
• application/vnd.oasis.opendocument.graphics-template (class)
• application/vnd.oasis.opendocument.image (class)
• application/vnd.oasis.opendocument.presentation (class)
• application/vnd.oasis.opendocument.presentation-template (class)
• application/vnd.oasis.opendocument.spreadsheet (class)
• application/vnd.oasis.opendocument.spreadsheet-template (class)
• application/vnd.oasis.opendocument.text (class)
• application/vnd.oasis.opendocument.text-master (class)
• application/vnd.oasis.opendocument.text-template (class)
• application/vnd.oasis.opendocument.text-web (class)
• application/vnd.rim.cod (class)
• application/vnd.smaf (class)
• application/vnd.stardivision.calc (class)
• application/vnd.stardivision.draw (class)
• application/vnd.stardivision.impress (class)
• application/vnd.stardivision.math (class)
• application/vnd.stardivision.writer (class)
• application/vnd.stardivision.writer-global (class)
• application/vnd.sun.xml.calc (class)
• application/vnd.sun.xml.calc.template (class)
• application/vnd.sun.xml.draw (class)
• application/vnd.sun.xml.draw.template (class)
• application/vnd.sun.xml.impress (class)
• application/vnd.sun.xml.impress.template (class)
• application/vnd.sun.xml.math (class)
• application/vnd.sun.xml.writer (class)
• application/vnd.sun.xml.writer.global (class)
• application/vnd.sun.xml.writer.template (class)
• application/vnd.symbian.install (class)
• application/vnd.visio (class)
• application/vnd.wap.wbxml (class)
• application/vnd.wap.wmlc (class)
• application/vnd.wap.wmlscriptc (class)
• application/wordperfect (class)
• application/wordperfect5.1 (class)
• application/x-123 (class)
• application/x-abiword (class)
• application/x-apple-diskimage (class)
• application/x-bcpio (class)
• application/x-bittorrent (class)
• application/x-cdf (class)
• application/x-cdlink (class)
• application/x-chess-pgn (class)
• application/x-cpio (class)
• application/x-csh (class)
• application/x-debian-package (class)
• application/x-director (class)
• application/x-dms (class)
• application/x-doom (class)
• application/x-dvi (class)
• application/x-flac (class)
• application/x-font (class)
• application/x-freemind (class)
• application/x-futuresplash (class)
• application/x-gnumeric (class)
• application/x-go-sgf (class)
• application/x-graphing-calculator (class)
• application/x-gtar (class)
• application/x-hdf (class)
• application/x-httpd-php (class)
• application/x-httpd-php-source (class)
• application/x-httpd-php3 (class)
• application/x-httpd-php3-preprocessed (class)
• application/x-httpd-php4 (class)
• application/x-ica (class)
• application/x-internet-signup (class)
• application/x-iphone (class)
• application/x-iso9660-image (class)
• application/x-java-jnlp-file (class)
• application/x-javascript (class)
• application/x-jmol (class)
• application/x-kchart (class)
• application/x-killustrator (class)
• application/x-koan (class)
• application/x-kpresenter (class)
• application/x-kspread (class)
• application/x-kword (class)
• application/x-latex (class)
• application/x-lha (class)
• application/x-lzh (class)
• application/x-lzx (class)
• application/x-maker (class)
• application/x-mif (class)
• application/x-ms-wmd (class)
• application/x-ms-wmz (class)
• application/x-msdos-program (class)
• application/x-msi (class)
• application/x-netcdf (class)
• application/x-ns-proxy-autoconfig (class)
• application/x-nwc (class)
• application/x-object (class)
• application/x-oz-application (class)
• application/x-pkcs7-certreqresp (class)
• application/x-pkcs7-crl (class)
• application/x-python-code (class)
• application/x-quicktimeplayer (class)
• application/x-redhat-package-manager (class)
• application/x-sh (class)
• application/x-shar (class)
• application/x-shockwave-flash (class)
• application/x-stuffit (class)
• application/x-sv4cpio (class)
• application/x-sv4crc (class)
• application/x-tar (class)
• application/x-tcl (class)
• application/x-tex-gf (class)
• application/x-tex-pk (class)
• application/x-texinfo (class)
• application/x-trash (class)
• application/x-troff (class)
• application/x-troff-man (class)
• application/x-troff-me (class)
• application/x-troff-ms (class)
• application/x-ustar (class)
• application/x-wais-source (class)
• application/x-wingz (class)
• application/x-www-form-urlencoded (class)
• application/x-x509-ca-cert (class)
• application/x-xcf (class)
• application/x-xfig (class)
• application/x-xpinstall (class)
• application/xhtml+xml (class)
• application/xml (class)
• application/zip (class)
• audio (class)
• audio/basic (class)
• audio/midi (class)
• audio/mpeg (class)
• audio/mpegurl (class)
• audio/prs.sid (class)
• audio/x-aiff (class)
• audio/x-gsm (class)
• audio/x-mpegurl (class)
• audio/x-ms-wax (class)
• audio/x-ms-wma (class)
• audio/x-pn-realaudio (class)
• audio/x-realaudio (class)
• audio/x-scpls (class)
• audio/x-sd2 (class)
• audio/x-wav (class)
• chemical (class)
• chemical/x-alchemy (class)
• chemical/x-cache (class)
• chemical/x-cache-csf (class)
• chemical/x-cactvs-binary (class)
• chemical/x-cdx (class)
• chemical/x-cerius (class)
• chemical/x-chem3d (class)
• chemical/x-chemdraw (class)
• chemical/x-cif (class)
• chemical/x-cmdf (class)
• chemical/x-cml (class)
• chemical/x-compass (class)
• chemical/x-crossfire (class)
• chemical/x-csml (class)
• chemical/x-ctx (class)
• chemical/x-cxf (class)
• chemical/x-embl-dl-nucleotide (class)
• chemical/x-galactic-spc (class)
• chemical/x-gamess-input (class)
• chemical/x-gaussian-checkpoint (class)
• chemical/x-gaussian-cube (class)
• chemical/x-gaussian-input (class)
• chemical/x-gaussian-log (class)
• chemical/x-gcg8-sequence (class)
• chemical/x-genbank (class)
• chemical/x-hin (class)
• chemical/x-isostar (class)
• chemical/x-jcamp-dx (class)
• chemical/x-kinemage (class)
• chemical/x-macmolecule (class)
• chemical/x-macromodel-input (class)
• chemical/x-mdl-molfile (class)
• chemical/x-mdl-rdfile (class)
• chemical/x-mdl-rxnfile (class)
• chemical/x-mdl-sdfile (class)
• chemical/x-mdl-tgf (class)
• chemical/x-mmcif (class)
• chemical/x-mol2 (class)
• chemical/x-molconn-z (class)
• chemical/x-mopac-graph (class)
• chemical/x-mopac-input (class)
• chemical/x-mopac-out (class)
• chemical/x-mopac-vib (class)
• chemical/x-ncbi-asn1 (class)
• chemical/x-ncbi-asn1-ascii (class)
• chemical/x-ncbi-asn1-binary (class)
• chemical/x-ncbi-asn1-spec (class)
• chemical/x-pdb (class)
• chemical/x-rosdal (class)
• chemical/x-swissprot (class)
• chemical/x-vamas-iso14976 (class)
• chemical/x-vmd (class)
• chemical/x-xtel (class)
• chemical/x-xyz (class)
• content (class)
• image (class)
• image/gif (class)
• image/ief (class)
• image/jpeg (class)
• image/pcx (class)
• image/png (class)
• image/svg+xml (class)
• image/tiff (class)
• image/vnd.djvu (class)
• image/vnd.wap.wbmp (class)
• image/x-cmu-raster (class)
• image/x-coreldraw (class)
• image/x-coreldrawpattern (class)
• image/x-coreldrawtemplate (class)
• image/x-corelphotopaint (class)
• image/x-icon (class)
• image/x-jg (class)
• image/x-jng (class)
• image/x-ms-bmp (class)
• image/x-photoshop (class)
• image/x-portable-anymap (class)
• image/x-portable-bitmap (class)
• image/x-portable-graymap (class)
• image/x-portable-pixmap (class)
• image/x-rgb (class)
• image/x-xbitmap (class)
• image/x-xpixmap (class)
• image/x-xwindowdump (class)
• model (class)
• model/iges (class)
• model/mesh (class)
• model/vrml (class)
• text (class)
• text/calendar (class)
• text/comma-separated-values (class)
• text/css (class)
• text/h323 (class)
• text/html (class)
• text/iuls (class)
• text/javascript (class)
• text/mathml (class)
• text/plain (class)
• text/richtext (class)
• text/rtf (class)
• text/scriptlet (class)
• text/tab-separated-values (class)
• text/texmacs (class)
• text/vnd.sun.j2me.app-descriptor (class)
• text/vnd.wap.wml (class)
• text/vnd.wap.wmlscript (class)
• text/x-bibtex (class)
• text/x-boo (class)
• text/x-c++hdr (class)
• text/x-c++src (class)
• text/x-chdr (class)
• text/x-component (class)
• text/x-csh (class)
• text/x-csrc (class)
• text/x-dsrc (class)
• text/x-haskell (class)
• text/x-java (class)
• text/x-literate-haskell (class)
• text/x-moc (class)
• text/x-pascal (class)
• text/x-pcs-gcd (class)
• text/x-perl (class)
• text/x-python (class)
• text/x-setext (class)
• text/x-sh (class)
• text/x-tcl (class)
• text/x-tex (class)
• text/x-vcalendar (class)
• text/x-vcard (class)
• video (class)
• video/dl (class)
• video/dv (class)
• video/fli (class)
• video/gl (class)
• video/mp4 (class)
• video/mpeg (class)
• video/quicktime (class)
• video/vnd.mpegurl (class)
• video/x-la-asf (class)
• video/x-m4v (class)
• video/x-mng (class)
• video/x-ms-asf (class)
• video/x-ms-wm (class)
• video/x-ms-wmv (class)
• video/x-ms-wmx (class)
• video/x-ms-wvx (class)
• video/x-msvideo (class)
• video/x-sgi-movie (class)
• x-conference (class)
• x-conference/x-cooltalk (class)
• x-world (class)
• x-world/x-vrml (class)

4.2 snooze-common

Source

package.lisp (file)

Use List

common-lisp

Used By List

snooze

Exported Definitions

• *all-resources* (special variable)
• *home-resource* (special variable)
• *mime-type-hash* (special variable)
• *resource-filter* (special variable)
• *resource-name-function* (special variable)
• *uri-content-types-function* (special variable)
• content-class-name (function)
• content-classes-in-accept-string (function)
• content-type-spec-or-lose (function)
• delete-resource (function)
• destructive-p (function)
• ensure-atom (function)
• ensure-uri (function)
• find-content-class (function)
• find-resource (function)
• find-verb-or-lose (function)
• gf-primary-method-specializer (function)
• parse-content-type-header (function)
• parse-defroute-args (function)
• parse-resource (function)
• probe-class-sym (function)
• reason-for (function)
• resource-generic-function (class)
• resource-name (function)
• scan-to-strings* (function)
• verb-spec-or-lose (function)

Internal Definitions

• *mime-type-list* (special variable)
• *reason-phrase-hash* (special variable)
• content-type-spec-or-lose-1 (function)
• define-content (macro)
• define-known-content-types (macro)
• intern-safe (function)
• resource (type)
• resource-p (function)

4.3 snooze-safe-simple-read

Source

package.lisp (file)

Use List

common-lisp

Exported Definitions

safe-simple-read-from-string (function)

Internal Definitions

• parse-integer-then-float (function)
• parse-symbol (function)
• read-name (function)
• read-string (function)
• snooze-reader-error (condition)

4.4 snooze

Source

package.lisp (file)

Nickname

rip

Use List

• snooze-common
• common-lisp

Exported Definitions

• *backend* (special variable)
• *catch-errors* (special variable)
• *catch-http-conditions* (special variable)
• *clack-request-env* (special variable)
• all-defined-resources (function)
• arguments-to-uri (generic function)
• arguments-to-uri (method)
• backend-payload (generic function)
• backend-payload (method)
• backend-payload (method)
• default-resource-name (function)
• defgenpath (macro)
• defresource (macro)
• defroute (macro)
• explain-condition (generic function)
• handle-request (function)
• http-condition (function)
• http-condition (condition)
• http-error (condition)
• invalid-resource-arguments (condition)
• make-clack-app (function)
• make-hunchentoot-app (function)
• no-such-resource (condition)
• no-such-route (condition)
• payload-as-string (function)
• read-for-resource (generic function)
• read-for-resource (method)
• search-for-extension-content-type (function)
• status-code (generic function)
• status-code (method)
• unconvertible-argument (condition)
• unconvertible-argument-key (generic function)
• unconvertible-argument-key (method)
• (setf unconvertible-argument-key) (method)
• (setf unconvertible-argument-key) (generic function)
• unconvertible-argument-value (generic function)
• unconvertible-argument-value (method)
• (setf unconvertible-argument-value) (method)
• (setf unconvertible-argument-value) (generic function)
• uri-to-arguments (generic function)
• uri-to-arguments (method)
• write-for-resource (generic function)
• write-for-resource (method)

Internal Definitions

• *resource* (special variable)
• actual-args (generic function)
• actual-args (method)
• (setf actual-args) (method)
• (setf actual-args) (generic function)
• arguments-to-uri-1 (function)
• brutally-explaining-conditions (macro)
• call-brutally-explaining-conditions (function)
• call-politely-explaining-conditions (function)
• check-arglist-compatible (function)
• check-optional-args (function)
• defgenpath-1 (function)
• defresource-1 (function)
• defroute-1 (function)
• error-when-explaining (condition)
• explain-condition-failsafe (generic function)
• explain-condition-failsafe (method)
• explain-failsafe (generic function)
• explain-failsafe (method)
• explain-failsafe (method)
• explain-failsafe (method)
• explain-failsafe (method)
• explain-failsafe (method)
• explain-failsafe (method)
• explain-failsafe (method)
• genpath-fn-lambda-list (function)
• handle-request-1 (function)
• incompatible-lambda-list (condition)
• invalid-uri (generic function)
• invalid-uri (method)
• (setf invalid-uri) (method)
• (setf invalid-uri) (generic function)
• invalid-uri-structure (condition)
• lambda-list (generic function)
• lambda-list (method)
• (setf lambda-list) (method)
• (setf lambda-list) (generic function)
• make-genpath-form (function)
• matching-content-type-or-lose (function)
• original-condition (generic function)
• original-condition (method)
• original-condition-backtrace (generic function)
• original-condition-backtrace (method)
• politely-explaining-conditions (macro)
• read-for-resource-1 (function)
• resignalled-condition (condition)
• resource-package (function)
• unsupported-content-type (condition)
• uri-to-arguments-1 (function)
• write-for-resource-1 (function)

4.5 snooze-verbs

Source

common.lisp (file)

Exported Definitions

• content-verb (class)
• delete (class)
• get (class)
• http-verb (class)
• post (class)
• put (class)
• receiving-verb (class)
• sending-verb (class)

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.

5.1 Exported definitions

5.1.1 Special variables

Special Variable: *all-resources*

Package

snooze-common

Source

common.lisp (file)

Special Variable: *backend*

Bound to a keyword identifying the server backend handling a request. Examples of values to find here are :HUNCHENTOOT or :CLACK.

Package

snooze

Source

api.lisp (file)

Special Variable: *catch-errors*

If non-NIL, catch any error and explain them to the client.

If T (the default), *any* erroneous conditions that are a *fault of the server and not of the user-agent*, including errors *and* HTTP 500-class conditions voluntarily signalled by the program logic, will still result in a response to the user-agent.

To compose this response, Snooze will first try EXPLAIN-CONDITION to "politely" explain the condition in a format accepted by the user-agent, as indicated in the "Accept:" header. If that fails, the error is presented very succintly to the client.

If the value is the keyword :VERBOSE, don’t call EXPLAIN-CONDITION and offer a plain text explanation with a full Lisp backtrace indicating where the condition originated. This option is useful during development.

If set to NIL, errors will bubble up out of snooze and possible land you in the debugger. This option is also useful during development if you prefer an interactive debugger

Package

snooze

Source

api.lisp (file)

Special Variable: *catch-http-conditions*

If non-NIL, catch HTTP conditions and explain them to the client.

If T (the default), any conditions which are *not a fault of the server* (thus excluding HTTP 500-class conditions), will result in a response to the user-agent.

To compose this response, Snooze will first try EXPLAIN-CONDITION to "politely" explain the condition in a format accepted by the user-agent, as indicated in the "Accept:" header. If that fails, the condition is presented very succintly to the client.

If the value is the keyword :VERBOSE, don’t call EXPLAIN-CONDITION and present a plain-text explanation with a full Lisp backtrace indicating where the condition originated. This option is useful during development.

If set to NIL, HTTP conditions will bubble up out of snooze and possible land you in the debugger. This option also is useful during development if you prefer an interactive debugger.

Package

snooze

Source

api.lisp (file)

Special Variable: *clack-request-env*

Bound in function made by MAKE-CLACK-APP to Clack environment.

Package

snooze

Source

api.lisp (file)

Special Variable: *home-resource*

Default resource to serve when request’s URI path is empty.
Value is a resource designator: a string, a keyword, a symbol or generic function designating a resource as given by *ALL-RESOURCES*.

A string or keyword value causes *ALL-RESOURCES* to be scanned by the resource’s name.

Package

snooze-common

Source

api.lisp (file)

Special Variable: *mime-type-hash*

A hash table which maps file suffixes to MIME types.

Package

snooze-common

Source

constants.lisp (file)

Special Variable: *resource-filter*

Tell if a resource should be considered when handling requests.

Value is a function designator called with a resource. This function should return a boolean.

The default value is (CONSTANTLY T) matching every resource defined so far by DEFRESOURCE and DEFROUTE.

Can be let-bound to restrict searches by a particular server to a specific set of resources.

Package

snooze-common

Source

api.lisp (file)

Special Variable: *resource-name-function*

How to search for resource names in URI paths.

Value is a function designator called on every request with the request’s URI path. The function might be called with the empty string.

This function should return two values: a resource designator (a string, symbol or a resource) and relative URI string stripped of the resource-designating part. If the first value returned is nil, *HOME-RESOURCE* is used to lookup a suitable resource.

The function should *not* attempt any URI-decoding of the component string. That is done automatically elsewhere.

The default value is DEFAULT-RESOURCE-NAME, which return the first path component as the first value and the remaining URI as the second value..

Can be let-bound to modify the URI scheme used by a particular server.

Package

snooze-common

Source

api.lisp (file)

Special Variable: *uri-content-types-function*

Compute list of content types encoded in URI paths.
If the value is non-NIL, it must be a function of a single argument, a string representing a (quite possibly) encoded URI.

This function should return two values: a list of content-type designators and the rewritten URI path stripped of its content-designating components. The function may also return NIL.

The default value is SEARCH-FOR-EXTENSION-CONTENT-TYPE looks for the first filename know extension inside the URI path. If found, it returns a singleton list with that content type as the first value and, as the second value, the URI path stripped of the extension thus found.

Can be let-bound to modify the URI scheme used by a particular server.

Package

snooze-common

Source

api.lisp (file)

5.1.2 Macros

Macro: defgenpath RESOURCE FUNCTION

Define FUNCTION as a path-generating function for RESOURCE. RESOURCE is a symbol or a string designating a resource

Package

snooze

Source

api.lisp (file)

Macro: defresource NAME LAMBDA-LIST &rest OPTIONS

Define NAME as a generic REST resource.
LAMBDA-LIST is a lambda list with at least two mandatory arguments, which stand for the HTTP method and content-type respectively. Further arguments (mandatory, optional or keyword) determine how the resource can be accessed. OPTIONS is a list of options like in CL:DEFGENERIC, with the following additional options: :GENPATH and :ROUTE

Package

snooze

Source

api.lisp (file)

Macro: defroute NAME &body ARGS

Define NAME as a specific route on a generic REST resource. ARGS are just as in CL:DEFMETHOD with the exception that its specialized-lambda-list portion accepts some simplifications.

Package

snooze

Source

api.lisp (file)

5.1.3 Functions

Function: all-defined-resources ()

Default value for *RESOURCES-FUNCTION*, which see.

Package

snooze

Source

common.lisp (file)

Function: content-class-name DESIGNATOR

Package

snooze-common

Source

common.lisp (file)

Function: content-classes-in-accept-string STRING

Package

snooze-common

Source

common.lisp (file)

Function: content-type-spec-or-lose TYPE-SPEC VERB

Package

snooze-common

Source

common.lisp (file)

Function: default-resource-name URI

Default value for *RESOURCE-NAME-FUNCTION*, which see.

Package

snooze

Source

common.lisp (file)

Function: delete-resource DESIGNATOR

Package

snooze-common

Source

common.lisp (file)

Function: destructive-p VERB

Package

snooze-common

Source

common.lisp (file)

Function: ensure-atom THING

Package

snooze-common

Source

common.lisp (file)

Function: ensure-uri MAYBE-URI

Package

snooze-common

Source

common.lisp (file)

Function: find-content-class DESIGNATOR

Return class for DESIGNATOR if it defines a content-type or nil.

Package

snooze-common

Source

common.lisp (file)

Function: find-resource DESIGNATOR &key FILTER

Package

snooze-common

Source

common.lisp (file)

Function: find-verb-or-lose DESIGNATOR

Package

snooze-common

Source

common.lisp (file)

Function: gf-primary-method-specializer GF ARGS CT-ARG-POS

Compute proper content-type for calling GF with ARGS

Package

snooze-common

Source

common.lisp (file)

Function: handle-request URI &key METHOD ACCEPT CONTENT-TYPE

Dispatches an HTTP request for URI to the appropriate resource.

METHOD a keyword, string or symbol designating the HTTP method (or "verb").

ACCEPT is a string in the format of the "Accept:" header.

IN-CONTENT-TYPE is a string in the format of the "Content-Type" header in the request, used when METHOD is :POST or :PUT, in which case it must be non-nil.

Returns three values CODE, PAYLOAD and OUT-CONTENT-TYPE, which should be used by the application to craft a response to the request.

Package

snooze

Source

api.lisp (file)

Function: http-condition STATUS-CODE &optional FORMAT-CONTROL &rest FORMAT-ARGS

Signal an HTTP condition with STATUS-CODE with with CL:ERROR.

Package

snooze

Source

api.lisp (file)

Function: make-clack-app &optional BINDINGS

Make a basic Clack app that calls HANDLE-REQUEST.

Pass this to CLACK:CLACKUP.

Dynamically binds *CLACK-REQUEST-ENV* around every call to HANDLE-REQUEST so you can access the backend-specific from routes and/or EXPLAIN-CONDITION. Also binds *BACKEND* to :CLACK.

BINDINGS is an alist of (SYMBOL . VALUE) which is are also dynamically-bound around HANDLE-REQUEST. You can use it to pass values of special variables that affect Snooze, like *HOME-RESOURCE*, *RESOURCES-FUNCTION*, *RESOURCE-NAME-FUNCTION*, or *URI-CONTENT-TYPES-FUNCTION*.

Package

snooze

Source

api.lisp (file)

Function: make-hunchentoot-app &optional BINDINGS

Make a basic Hunchentoot dispatcher that calls HANDLE-REQUEST.

Add this to HUNCHENTOOT:*DISPATCH-TABLE*, possibly after some static file dispatcher or other dispatcher you wish to kick in before Snooze. Then start an HUNCHENTOOT:EASY-ACCEPTOR at whichever port you choose.

BINDINGS is an alist of (SYMBOL . VALUE) which is are also dynamically-bound around HANDLE-REQUEST. You can use it to pass values of special variables that affect Snooze, like *HOME-RESOURCE*, *RESOURCES-FUNCTION*, *RESOURCE-NAME-FUNCTION*, or *URI-CONTENT-TYPES-FUNCTION*.

Package

snooze

Source

api.lisp (file)

Function: parse-content-type-header STRING

Return a class associated with the content-type described by STRING. As a second value, return what RFC2388:PARSE-HEADER

Package

snooze-common

Source

common.lisp (file)

Function: parse-defroute-args DEFMETHOD-ARGLIST

Return values QUALIFIERS, LAMBDA-LIST, BODY for DEFMETHOD-ARGLIST

Package

snooze-common

Source

common.lisp (file)

Function: parse-resource URI

Parse URI for a resource and how it should be called.

Honours of *RESOURCE-NAME-FUNCTION*, *RESOURCES-FUNCTION*, *HOME-RESOURCE* and *URI-CONTENT-TYPES-FUNCTION*.

Returns nil if the resource cannot be found, otherwise returns 3 values: RESOURCE, URI-CONTENT-TYPES and RELATIVE-URI. RESOURCE is a generic function verifying RESOURCE-P discovered in URI. URI-CONTENT-TYPES is a list of subclasses of SNOOZE-TYPES:CONTENT discovered in directly URI by
*URI-CONTENT-TYPES-FUNCTION*. RELATIVE-URI is the remaining URI after these discoveries.

Package

snooze-common

Source

common.lisp (file)

Function: payload-as-string &optional BACKEND

Return the current HTTP request’s payload as a string.

BACKEND defaults to *BACKEND*

Package

snooze

Source

api.lisp (file)

Function: probe-class-sym SYM

Like CL:FIND-CLASS but don’t error and return SYM or nil

Package

snooze-common

Source

common.lisp (file)

Function: reason-for STATUS-CODE

Package

snooze-common

Source

constants.lisp (file)

Function: resource-name RESOURCE

Package

snooze-common

Source

common.lisp (file)

Function: safe-simple-read-from-string STRING &optional MAKE-SYMBOL-P

Reads some objects represented by STRING.
Can only read in numbers, strings or existing symbols. Symbols may be package-designated according to how they are written by of WRITE-TO-STRING.

No new symbols are ever interned. A STRING value that would generate interning of a symbol generates an error, but, if MAKE-SYMBOL-P is non-NIL, a new uninterned symbol is returned with the name of the would-be-interned symbol.

No macro-characters exist, not even #(. So, where STRING would normally represent a list to READ-FROM-STRING, it is taken as a peculiar symbol name, that, at any rate, either exists in *PACKAGE* or is never interned anywhere

Package

snooze-safe-simple-read

Source

safe-simple-read.lisp (file)

Function: scan-to-strings* REGEX STRING

Package

snooze-common

Source

common.lisp (file)

Function: search-for-extension-content-type URI-PATH

Default value for *URI-CONTENT-TYPES-FUNCTION*, which see.

Package

snooze

Source

common.lisp (file)

Function: verb-spec-or-lose VERB-SPEC

Convert VERB-SPEC into something CL:DEFMETHOD can grok.

Package

snooze-common

Source

common.lisp (file)

5.1.4 Generic functions

Generic Function: arguments-to-uri RESOURCE PLAIN-ARGS KEYWORD-ARGS

Generate an URI path string to fit RESOURCE.

PLAIN-ARGS and KEYWORD-ARGS are like the return values of URI-TO-ARGUMENTS.

Should return a propertly escaped URI path that will display in the address bar and/or be sent on future requests.

This method is the inverse of URI-TO-ARGUMENTS.

Package

snooze

Source

api.lisp (file)

Methods

Method: arguments-to-uri (RESOURCE resource-generic-function) PLAIN-ARGS KEYWORD-ARGS

Default method of ARGUMENTS-TO-URI.

Tries to WRITE-TO-STRING (with *PRINT-CASE* set to :DOWNCASE) every object, except for keywords, which are written without the leading ":" character. Afterwards the whole URI is escaped for invalid sequences.

Generic Function: backend-payload BACKEND TYPE

Ask BACKEND to return the current HTTP request’s payload as TYPE.

BACKEND is a value suitable for *BACKEND* (which see).

Type is an instance of SNOOZE-TYPES:CONTENT.

Package

snooze

Source

api.lisp (file)

Methods

Method: backend-payload (BACKEND (eql hunchentoot)) (TYPE text)

Method: backend-payload (BACKEND (eql clack)) (TYPE text)

Generic Function: explain-condition CONDITION RESOURCE CONTENT-TYPE

Explain CONDITION for RESOURCE in CONTENT-TYPE.

Package

snooze

Source

api.lisp (file)

Generic Function: read-for-resource RESOURCE STRING

Like READ-FROM-STRING, but for RESOURCE.

Reads the object represented in STRING into a CL representation, considering RESOURCE.

Package

snooze

Source

api.lisp (file)

Methods

Method: read-for-resource (RESOURCE resource-generic-function) STRING

Defaut method for READ-FOR-RESOURCE.

Vaguely resembles READ-FROM-STRING, but will only read in numbers, symbols or strings. Unqualified symbols are read in the package where RESOURCE belongs, otherwise they must be package-qualified. If a symbol, package, qualified or not, does not exist, it is *not* created. Instead, an uninterned symbol of the intended name is returned instead.

This means that:

(loop for outgoing in ’(cl:defun :just-interned-this and-this #:uninterned)
for readback = (read-for-resource res (write-for-resource res outgoing)) collect
(list (eq outgoing readback)
(string= (string outgoing)
(string readback))))

Returns ((T T) (T T) (T T) (NIL T)).

Generic Function: status-code CONDITION

Package

snooze

Methods

Method: status-code (CONDITION http-condition)

Source

common.lisp (file)

Generic Function: unconvertible-argument-key CONDITION

Generic Function: (setf unconvertible-argument-key) NEW-VALUE CONDITION

Package

snooze

Methods

Method: unconvertible-argument-key (CONDITION unconvertible-argument)

Method: (setf unconvertible-argument-key) NEW-VALUE (CONDITION unconvertible-argument)

Source

common.lisp (file)

Generic Function: unconvertible-argument-value CONDITION

Generic Function: (setf unconvertible-argument-value) NEW-VALUE CONDITION

Package

snooze

Methods

Method: unconvertible-argument-value (CONDITION unconvertible-argument)

Method: (setf unconvertible-argument-value) NEW-VALUE (CONDITION unconvertible-argument)

Source

common.lisp (file)

Generic Function: uri-to-arguments RESOURCE RELATIVE-URI

Extract arguments for RESOURCE from RELATIVE-URI.

RELATIVE-URI is a string, where everything but the part designating RESOURCE has been kept untouched (and potentially URI-encoded)

Should return two values: a list of "plain" arguments and an alist (*not* a plist) used as keyword arguments.

It’s reasonable for user-written specializaions of this method to error out with 400 (malformed) or 404 not found status codes.

This method is the inverse of ARGUMENTS-TO-URI

Package

snooze

Source

api.lisp (file)

Methods

Method: uri-to-arguments (RESOURCE resource-generic-function) RELATIVE-URI

Default method of URI-TO-ARGUMENTS.

Converts the path section of RELATIVE-URI into "plain" arguments and the query and fragment sections of URI into keyword
arguments. READ-FROM-STRING is used to convert every individual argument’s value. If an argument is unconvertible, an HTTP 400 condition of type UNCONVERTIBLE-ARGUMENT is signalled.

Generic Function: write-for-resource RESOURCE OBJ

Like WRITE-TO-STRING, but for RESOURCE.

Returns a string representing the object OBJ, considering RESOURCE.

The default implementation

Package

snooze

Source

api.lisp (file)

Methods

Method: write-for-resource (RESOURCE resource-generic-function) STRING

Defaut method for WRITE-FOR-RESOURCE.

Calls WRITE-TO-STRING on OBJECT with the current package set to the package of the RESOURCE’s symbol, except in the case that OBJECT is an uninterned symbol, whereupon PRINC-TO-STRING is used on its downcased name instead.

5.1.5 Conditions

Condition: http-condition ()

Package

snooze

Source

common.lisp (file)

Direct superclasses

simple-condition (condition)

Direct subclasses

• invalid-resource-arguments (condition)
• http-error (condition)
• no-such-resource (condition)
• no-such-route (condition)

Direct methods

• print-object (method)
• status-code (method)

Direct slots

Slot: status-code

Initargs

:status-code

Initform

(quote (error "must supply a http status code."))

Readers

status-code (generic function)

Direct Default Initargs

Initarg	Value
:format-control	"http condition"

Condition: http-error ()

Package

snooze

Source

common.lisp (file)

Direct superclasses

• simple-error (condition)
• http-condition (condition)

Direct subclasses

unsupported-content-type (condition)

Direct methods

initialize-instance (method)

Direct Default Initargs

Initarg	Value
:status-code	500
:format-control	"http internal server error"

Condition: invalid-resource-arguments ()

Package

snooze

Source

common.lisp (file)

Direct superclasses

http-condition (condition)

Direct subclasses

• unconvertible-argument (condition)
• invalid-uri-structure (condition)
• incompatible-lambda-list (condition)

Direct Default Initargs

Initarg	Value
:format-control	"resource exists but invalid arguments passed"
:status-code	400

Condition: no-such-resource ()

Package

snooze

Source

common.lisp (file)

Direct superclasses

http-condition (condition)

Direct Default Initargs

Initarg	Value
:format-control	"resource does not exist"
:status-code	404

Condition: no-such-route ()

Package

snooze

Source

common.lisp (file)

Direct superclasses

http-condition (condition)

Direct Default Initargs

Initarg	Value
:format-control	"resource exists but no such route"

Condition: unconvertible-argument ()

Package

snooze

Source

common.lisp (file)

Direct superclasses

• resignalled-condition (condition)
• invalid-resource-arguments (condition)

Direct methods

• explain-failsafe (method)
• unconvertible-argument-key (method)
• unconvertible-argument-key (method)
• unconvertible-argument-value (method)
• unconvertible-argument-value (method)

Direct slots

Slot: unconvertible-argument-value

Initargs

:unconvertible-argument-value

Readers

unconvertible-argument-value (generic function)

Writers

(setf unconvertible-argument-value) (generic function)

Slot: unconvertible-argument-key

Initargs

:unconvertible-argument-key

Readers

unconvertible-argument-key (generic function)

Writers

(setf unconvertible-argument-key) (generic function)

Direct Default Initargs

Initarg	Value
:format-control	"an argument in the uri cannot be read"

5.1.6 Classes

Class: application ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

content (class)

Direct subclasses

• application/andrew-inset (class)
• application/cu-seeme (class)
• application/dsptype (class)
• application/futuresplash (class)
• application/hta (class)
• application/java-archive (class)
• application/java-serialized-object (class)
• application/java-vm (class)
• application/json (class)
• application/mac-binhex40 (class)
• application/mac-compactpro (class)
• application/mathematica (class)
• application/msaccess (class)
• application/msword (class)
• application/octet-stream (class)
• application/oda (class)
• application/ogg (class)
• application/pdf (class)
• application/pgp-keys (class)
• application/pgp-signature (class)
• application/pics-rules (class)
• application/postscript (class)
• application/rar (class)
• application/rdf+xml (class)
• application/rss+xml (class)
• application/smil (class)
• application/wordperfect (class)
• application/wordperfect5.1 (class)
• application/xhtml+xml (class)
• application/xml (class)
• application/zip (class)
• application/vnd.cinderella (class)
• application/vnd.mozilla.xul+xml (class)
• application/vnd.ms-excel (class)
• application/vnd.ms-pki.seccat (class)
• application/vnd.ms-pki.stl (class)
• application/vnd.ms-powerpoint (class)
• application/vnd.oasis.opendocument.chart (class)
• application/vnd.oasis.opendocument.database (class)
• application/vnd.oasis.opendocument.formula (class)
• application/vnd.oasis.opendocument.graphics (class)
• application/vnd.oasis.opendocument.graphics-template (class)
• application/vnd.oasis.opendocument.image (class)
• application/vnd.oasis.opendocument.presentation (class)
• application/vnd.oasis.opendocument.presentation-template (class)
• application/vnd.oasis.opendocument.spreadsheet (class)
• application/vnd.oasis.opendocument.spreadsheet-template (class)
• application/vnd.oasis.opendocument.text (class)
• application/vnd.oasis.opendocument.text-master (class)
• application/vnd.oasis.opendocument.text-template (class)
• application/vnd.oasis.opendocument.text-web (class)
• application/vnd.rim.cod (class)
• application/vnd.smaf (class)
• application/vnd.stardivision.calc (class)
• application/vnd.stardivision.draw (class)
• application/vnd.stardivision.impress (class)
• application/vnd.stardivision.math (class)
• application/vnd.stardivision.writer (class)
• application/vnd.stardivision.writer-global (class)
• application/vnd.sun.xml.calc (class)
• application/vnd.sun.xml.calc.template (class)
• application/vnd.sun.xml.draw (class)
• application/vnd.sun.xml.draw.template (class)
• application/vnd.sun.xml.impress (class)
• application/vnd.sun.xml.impress.template (class)
• application/vnd.sun.xml.math (class)
• application/vnd.sun.xml.writer (class)
• application/vnd.sun.xml.writer.global (class)
• application/vnd.sun.xml.writer.template (class)
• application/vnd.symbian.install (class)
• application/vnd.visio (class)
• application/vnd.wap.wbxml (class)
• application/vnd.wap.wmlc (class)
• application/vnd.wap.wmlscriptc (class)
• application/x-123 (class)
• application/x-abiword (class)
• application/x-apple-diskimage (class)
• application/x-bcpio (class)
• application/x-bittorrent (class)
• application/x-cdf (class)
• application/x-cdlink (class)
• application/x-chess-pgn (class)
• application/x-cpio (class)
• application/x-csh (class)
• application/x-debian-package (class)
• application/x-director (class)
• application/x-dms (class)
• application/x-doom (class)
• application/x-dvi (class)
• application/x-flac (class)
• application/x-font (class)
• application/x-freemind (class)
• application/x-futuresplash (class)
• application/x-gnumeric (class)
• application/x-go-sgf (class)
• application/x-graphing-calculator (class)
• application/x-gtar (class)
• application/x-hdf (class)
• application/x-httpd-php (class)
• application/x-httpd-php-source (class)
• application/x-httpd-php3 (class)
• application/x-httpd-php3-preprocessed (class)
• application/x-httpd-php4 (class)
• application/x-ica (class)
• application/x-internet-signup (class)
• application/x-iphone (class)
• application/x-iso9660-image (class)
• application/x-java-jnlp-file (class)
• application/x-javascript (class)
• application/x-jmol (class)
• application/x-kchart (class)
• application/x-killustrator (class)
• application/x-koan (class)
• application/x-kpresenter (class)
• application/x-kspread (class)
• application/x-kword (class)
• application/x-latex (class)
• application/x-lha (class)
• application/x-lzh (class)
• application/x-lzx (class)
• application/x-maker (class)
• application/x-mif (class)
• application/x-ms-wmd (class)
• application/x-ms-wmz (class)
• application/x-msdos-program (class)
• application/x-msi (class)
• application/x-netcdf (class)
• application/x-ns-proxy-autoconfig (class)
• application/x-nwc (class)
• application/x-object (class)
• application/x-oz-application (class)
• application/x-pkcs7-certreqresp (class)
• application/x-pkcs7-crl (class)
• application/x-python-code (class)
• application/x-quicktimeplayer (class)
• application/x-redhat-package-manager (class)
• application/x-sh (class)
• application/x-shar (class)
• application/x-shockwave-flash (class)
• application/x-stuffit (class)
• application/x-sv4cpio (class)
• application/x-sv4crc (class)
• application/x-tar (class)
• application/x-tcl (class)
• application/x-tex-gf (class)
• application/x-tex-pk (class)
• application/x-texinfo (class)
• application/x-trash (class)
• application/x-troff (class)
• application/x-troff-man (class)
• application/x-troff-me (class)
• application/x-troff-ms (class)
• application/x-ustar (class)
• application/x-wais-source (class)
• application/x-wingz (class)
• application/x-x509-ca-cert (class)
• application/x-xcf (class)
• application/x-xfig (class)
• application/x-xpinstall (class)
• application/x-www-form-urlencoded (class)

Class: application/andrew-inset ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/cu-seeme ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/dsptype ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/futuresplash ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/hta ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/java-archive ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/java-serialized-object ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/java-vm ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/json ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/mac-binhex40 ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/mac-compactpro ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/mathematica ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/msaccess ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/msword ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/octet-stream ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/oda ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/ogg ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/pdf ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/pgp-keys ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/pgp-signature ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/pics-rules ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/postscript ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/rar ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/rdf+xml ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/rss+xml ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/smil ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.cinderella ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.mozilla.xul+xml ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.ms-excel ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.ms-pki.seccat ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.ms-pki.stl ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.ms-powerpoint ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.chart ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.database ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.formula ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.graphics ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.graphics-template ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.image ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.presentation ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.presentation-template ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.spreadsheet ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.spreadsheet-template ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.text ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.text-master ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.text-template ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.oasis.opendocument.text-web ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.rim.cod ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.smaf ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.stardivision.calc ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.stardivision.draw ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.stardivision.impress ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.stardivision.math ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.stardivision.writer ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.stardivision.writer-global ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.sun.xml.calc ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.sun.xml.calc.template ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.sun.xml.draw ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.sun.xml.draw.template ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.sun.xml.impress ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.sun.xml.impress.template ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.sun.xml.math ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.sun.xml.writer ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.sun.xml.writer.global ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.sun.xml.writer.template ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.symbian.install ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.visio ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.wap.wbxml ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.wap.wmlc ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/vnd.wap.wmlscriptc ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/wordperfect ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/wordperfect5.1 ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)

Class: application/x-123 ()

Package

snooze-types

Source

common.lisp (file)

Direct superclasses

application (class)