Ystok » Lisp » Projects

Ystok-URI

Ystok-URI is a portable Uniform Resource Identifier library for Common Lisp programs. It parses URI strings according to RFC3986 and supports userinfo and percent-encoding/decoding in full.

Ystok-URI is based on

uri.lisp from portableaserve, Jochen Schmidt;
uri.cl, Franz, Inc.
puri, a well-known portable follower of the above two, which does not support percent-encoding/decoding.

Implementation notes

small and fast,
compact internal structure,
functions percent-encode and percent-decode implements encoding/decoding according to the value of the :external-format argument (:UTF-8 by default),
the path and query components first are split into elements then decoded,
the userinfo part user:password@ is accepted within an URI string and saved but not rendered by default,
the completely empty URI, e.g. resulted from enough-uri, is represented as "#" instead of "/" (as in Franz's).

Dependencies

Ystok-URI requires

Ystok-Library,
the tester module from the ACL-Compat lite bundle for running regression tests.

Ystok-URI is required by YstokHTML and YstokHelp.

Platforms

The source code was tested on the following Lisp implementations:

LispWorks 4.4 and 5.0 for Windows,
SBCL 1.0.55 for Windows.

Download and installation

Ystok-URI is available from
http://lisp.ystok.ru/yuri/yuri-2-0-008.zip or
http://lisp.ystok.ru/yuri/yuri-2-0-008.tgz.

The distribution package contains

source files,
the Reference Manual (in English),
the two system definition files:
- ystok-uri.asd for both ASDF and ASDLite,
- defsys.lisp for LispWorks.

Running tests

Make sure the tester is loaded, for example, push :tester into the *features* list before loading ACL-Compat lite.
Compile and load the file test.lisp.
Evaluate the form (ystok.uri.test:do-tests).

Here is change.log.

Documentation

The help book on Ystok-URI in English is at http://lisp.ystok.ru/yuri/help/help.html.

Franz's original documentation on URI support in Allegro Common Lisp is here.