Photo by m-louis, licensed under the CC BY-SA 2.0 license.
QURI (pronounced "Q-ree") is yet another URI library for Common Lisp. It is intended to be a replacement of PURI.
It aims at implementing RFC 3986. Behaviour that deviates from it should be considered a bug; please report.
- Fast. (See Benchmark.)
- Doesn't encode/decode URL implicitly.
- UTF-8 characters support.
- Supports userinfo. (Example:
gitingit@github.com) - Supports IPv6 hostname. (Example:
ldap://[2001:db8::7]/) - Allows byte vectors as input.
- Takes optional
:startand:endkeyword arguments. - Low-level parser functions.
- URL encoding/decoding utilities.
url-decodeurl-decode-paramsurl-encodeurl-encode-params
(use-package :quri)
(defvar *uri* (uri "http://www.ics.uci.edu/pub/ietf/uri/#Related"))
*uri*
;=> #<QURI.URI.HTTP:URI-HTTP http://www.ics.uci.edu/pub/ietf/uri/#Related>
(uri-scheme *uri*)
;=> "http"
(uri-host *uri*)
;=> "www.ics.uci.edu"
(uri-domain *uri*)
;=> "uci.edu"
(uri-path *uri*)
;=> "/pub/ietf/uri/"
(uri-fragment *uri*)
;=> "Related"Parse a string or a byte vector and return a uri object.
Create a uri object.
(make-uri :scheme "http"
:host "8arrow.org"
:path "/")
;=> #<QURI.URI.HTTP:URI-HTTP http://8arrow.org/>
(make-uri :defaults "http://8arrow.org"
:query '(("guest" . 1)))
;=> #<QURI.URI.HTTP:URI-HTTP http://8arrow.org?guest=1>Return a copy of the given uri object.
Merge a reference URI into the base URI as described in RFC 2396 Section 5.2. The returned URI may or may not be a new instance. Neither REFERENCE nor BASE is mutated.
Structure class as a representation of URIs. The following methods are available for all classes extends this class.
uri-schemeuri-userinfouri-hosturi-domainuri-tlduri-porturi-pathuri-authorityrender-uri
Structure class as a representation of URNs. All methods of uri are also available for this class.
urn-nidurn-nss
Structure class for HTTP/HTTPS URIs.
uri-query-params
(defvar *uri* (quri:uri "http://quickdocs.org/search?q=web"))
(uri-query-params *uri*)
;=> (("q" . "web"))
(setf (uri-query-params *uri*) '(("q" . "system programming")))
*uri*
;=> #<QURI.URI.HTTP:URI-HTTP http://quickdocs.org/search?q=system%20programming>Structure class for FTP URIs.
uri-ftp-typecode
Structure class for LDAP/LDAPS URIs.
uri-ldap-dnuri-ldap-attributesuri-ldap-scopeuri-ldap-filteruri-ldap-extensions
Decode a Percent-Encoded string or byte vector.
(url-decode "%2Ffoo%E3%81%82")
;=> "/fooあ"Decode a form-urlencoded string or byte vector and return an association list.
Encode a string or a byte vector into a Percent-Encoded string.
(url-encode "/fooあ")
;=> "%2Ffoo%E3%81%82"Encode an association list into a form-urlencoded string.
Parse a URI string or a URI byte vector and return 7 URI components -- scheme, userinfo, host name, port, path, query and fragment.
(parse-uri "http://www.ics.uci.edu/pub/ietf/uri/#Related")
;=> "http"
; NIL
; "www.ics.uci.edu"
; NIL
; "/pub/ietf/uri/"
; NIL
; "Related"$ git clone https://github.com/fukamachi/quri
(ql:quickload :quri)- Parsing a URI string 100,000 times.
| QURI | PURI |
|---|---|
| 0.064s | 0.423s |
QURI is 6.6 times faster than PURI for URI parsing.
(time
(dotimes (i 100000)
(quri:uri "http://www.ics.uci.edu/pub/ietf/uri/#Related")))Evaluation took:
0.064 seconds of real time
0.063984 seconds of total run time (0.063745 user, 0.000239 system)
100.00% CPU
191,340,531 processor cycles
28,807,728 bytes consed
(time
(dotimes (i 100000)
(puri:uri "http://www.ics.uci.edu/pub/ietf/uri/#Related")))Evaluation took:
0.423 seconds of real time
0.425327 seconds of total run time (0.422234 user, 0.003093 system)
[ Run times consist of 0.004 seconds GC time, and 0.422 seconds non-GC time. ]
100.47% CPU
1,266,663,894 processor cycles
64,001,408 bytes consed
- Decoding a URL-encoded string 100,000 times.
| QURI | Hunchentoot | do-urlencode |
|---|---|---|
| 0.029s | 0.089s | 0.634s |
QURI is 3 times faster than Hunchentoot, and 21.8 times faster than do-urlencode.
(time
(dotimes (i 100000)
(quri:url-decode "foo%E3%81%82")))Evaluation took:
0.029 seconds of real time
0.028683 seconds of total run time (0.027934 user, 0.000749 system)
100.00% CPU
85,421,676 processor cycles
7,993,456 bytes consed
(time
(dotimes (i 100000)
(hunchentoot:url-decode "foo%E3%81%82")))Evaluation took:
0.089 seconds of real time
0.088946 seconds of total run time (0.087632 user, 0.001314 system)
100.00% CPU
265,341,714 processor cycles
17,611,968 bytes consed
(time
(dotimes (i 100000)
(do-urlencode:urldecode "foo%E3%81%82")))Evaluation took:
0.634 seconds of real time
0.637236 seconds of total run time (0.632224 user, 0.005012 system)
[ Run times consist of 0.023 seconds GC time, and 0.615 seconds non-GC time. ]
100.47% CPU
1,897,304,959 processor cycles
153,606,064 bytes consed
- URL-encoding a string 100,000 times.
| QURI | Hunchentoot | do-urlencode |
|---|---|---|
| 0.074s | 0.282s | 0.317s |
QURI is 3.8 times faster than Hunchentoot, and 4.2 times faster than do-urlencode.
(time
(dotimes (i 100000)
(quri:url-encode "fooあ")))Evaluation took:
0.074 seconds of real time
0.074284 seconds of total run time (0.072908 user, 0.001376 system)
100.00% CPU
221,267,517 processor cycles
31,993,520 bytes consed
(time
(dotimes (i 100000)
(hunchentoot:url-encode "fooあ")))Evaluation took:
0.282 seconds of real time
0.284922 seconds of total run time (0.280063 user, 0.004859 system)
[ Run times consist of 0.034 seconds GC time, and 0.251 seconds non-GC time. ]
101.06% CPU
845,204,850 processor cycles
214,382,672 bytes consed
(time
(dotimes (i 100000)
(do-urlencode:urlencode "fooあ")))Evaluation took:
0.317 seconds of real time
0.319419 seconds of total run time (0.314339 user, 0.005080 system)
[ Run ti
745F
mes consist of 0.026 seconds GC time, and 0.294 seconds non-GC time. ]
100.63% CPU
946,704,912 processor cycles
219,186,768 bytes consed
-
Add
:lenientoptionuri-query-params(default toT). -
Fix
merge-uristo accept strings as it did in 0.4.0. -
Support MSVC on ECL.
-
Coerce URI
pathto strings.
-
All constructors like
make-uri-fileandmake-uri-httpsexported. -
uri=anduri-equalnormalize the path so that NIL and "" are considered equal. -
The
filescheme renders the query and the fragment.
-
URI schemes are now read-only.
This preserves the integrity of the structures (or else the scheme of a
uri-httpcould be set to FTP).merge-urishas been updated accordingly, so now the following returns the right thing:(merge-uris (uri "/") (uri "https://en.wikipedia.org/wiki/URL")) ; => #<URI-HTTPS https://en.wikipedia.org/>
-
Prevent some functions from being affected by PRINT-BASE.
Functions
make-urianduri-authoritybuild strings from a number; they now do so with the standard value for*print-base*.
-
Query values accept numbers again. This should fix backward-compatibility issues.
-
New
uri-equalwhich normalizes the path when comparing URIs. -
The empty path and the root path are no longer equal with
uri=. Useuri-equalif you want the old behaviour. -
Dot segments are removed when merging URLs.
-
Fix parsing of the colon at the end of the scheme.
-
Handle strings and byte vectors in query values, and nothing else.
In particular, numbers are no longer supported. You'll have to convert them to a string or a byte-vector from the caller.
-
parse-uri-stringandparse-uri-byte-vectornow return the scheme default port when unspecified.
- Eitaro Fukamachi (e.arrows@gmail.com): author
- Pierre Neidhardt (mail@ambrevar.xyz): maintainer
Copyright (c) 2014-2019 Eitaro Fukamachi (e.arrows@gmail.com)
Licensed under the BSD 3-Clause License.