Introduction
uri-template is a Common Lisp implementation of the URI Template proposed standard draft version 01 as a reader macro, used for both creating and parsing (destructuring) URIs.
Although uri-template does not implement the operators introduced in the 02 and later drafts of the URI Template standard, it does allow arbitrary Lisp expressions in template placeholders, which gives simpler and more powerful templates.
Examples
Template interpolation:
(let ((foo 1))
#Uhttps://www.example.com/widget/{foo}/parts)
=> "https://www.example.com/widget/1/parts"
Template destructuring:
(uri-template-bind (#Uhttps://www.example.com/{part}/{number})
"https://www.example.com/widget/1"
(list part (parse-integer number) %uri-host))
=> ("widget" 1 "www.example.com")
Download
The latest version of uri-template is 1.3.1, release on 2019-08-01, and can be downloaded here. Older versions can be downloaded from the release directory.
uri-template is available
via Quicklisp:
(ql:quickload :uri-template)
Documentation
Documentation is provided in the README file included with the distribution.
Source repository
https://gitlab.common-lisp.net/uri-template/uri-template.git
Parenscript integration
uri-template works with Parenscript to provide template interpolation for JavaScript. To enable this functionality, load Parenscript before loading uri-template. Note that destructuring is currently unsupported for Parenscript.
Mailing list
uri-template-devel@common-lisp.net
Subscription information and mailing list archives are available at:
https://mailman.common-lisp.net/listinfo/uri-template-devel
Contributing
Please send patches and bug reports to the mailing list: uri-template-devel@common-lisp.net
Authorship
uri-template is authored by Vladimir Sedach.
License
uri-template is distributed under the terms of GNU Lesser General Public License version 3 or any later version.