Introduction

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

A Uniform Resource Identifier is a string of characters used to identify a resource. Such identification enables interaction with representations of the resource over a network (typically the World Wide Web) using specific protocols.

Dependencies

Ystok-URI requires

• Ystok-Library,
• the tester module from the ACL-Compat 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

The latest version of Ystok-URI 2.0.007 is available at http://lisp.ystok.ru/yuri/. The distribution package contains the two system definition files:

• ystok-uri.asd for both ASDF and ASDLite,
• defsys.lisp for LispWorks.

To run tests, do the following:

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

• Implementation notes
• Conditions
• Core primitives
• Percent-encoding and decoding
• Utilities

See also

• RFC3986 - Uniform Resource Identifier (URI): Generic Syntax
• URI in Wikipedia