Ystok-URI

К Истокам

Лисп

Проекты

YstokCard

YstokGrid

YstokHelp

YstokHTML

YstokSQL

YstokWidgets

Ystok-Library

Ystok-Local-Time

Ystok-MD5

Ystok-PDF

Ystok-URI

ACL-Compat lite

ASDLite

Русский LispWorks

Книги и статьи

Ссылки

Контакты

Форумы

yuri-2-0-007.zip (104КБ)

Ystok-URI — переносимая библиотека функций для работы с идентификаторами ресурсов в Интернет (Uniform Resource Identifier). Распознаёт формат, определенный в RFC3986.

История

Исходный код базируется на следующих источниках:

• uri.lisp из ранней версии portableaserve, Jochen Schmidt;
• uri.cl, Franz, Inc.

Существует ещё один клон упомянутых "первоисточников": puri. Эта библиотека, хотя и обладает большой переносимостью, не поддерживает URL-кодирование/декодирование идентификаторов (percent-encoding).

Отличительные особенности

• Компактный исходный код.
• Более эффективное внутреннее представление.
• Функции percent-encode и percent-decode поддерживают кодирование/декодирование в формате UTF-8 или другом,
  причем компоненты идентификаторов, например, path и query, сначала разбиваются на элементы, и лишь затем декодируются.
• Пустой URI, результат enough-uri, представляется как "#", а не "/".
• Глобальные переменные *query-char-p* и *fragment-char-p* позволяют расширить набор литер, разрешённых в части запроса и фрагмента соответственно; например, допустить буквы национального алфавита напрямую.

Зависимости

Библиотека требует

• Ystok-Library,
• ACL-Compat lite желательна, а для прогона тестов - необходима, так как используется тестер из этого модуля.

Библиотека необходима для расширенных функций YstokHTML и YstokHelp.

Платформы

Исходный код Ystok-URI тестировался под

• Lispworks 4.4 и 5.0 для Windows,
• SBCL 1.055 для Windows.

Загрузка и установка

Дистрибутив Ystok-URI общедоступен, загрузить его можно отсюда http://lisp.ystok.ru/yuri/yuri-2-0-007.zip. Он включает

• исходные тексты программ,
• справочную документацию (на английском языке),
• определение системы
  - как для ASDF и ASDLite (файл ystok-uri.asd),
  - так и для LispWorks (файл defsys.lisp).

Для прогона тестов выполните следующее.

1. Убедитесь, что тестер загружен, например, внесите :tester в списокe *features* перед тем как загружать ACL-Compat lite.
2. Откомпилируйте test.lisp и загрузите его объектный файл.
3. Оцените форму (ystok.uri.test:do-tests).

Документация

Справочник в формате HTML (книга помощи) доступен на английском языке здесь: http://lisp.ystok.ru/yuri/help/help.html.

Оригинальный файл документации от Franz Allegro Common Lisp прилагается.