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.
- Fast. (See Benchmark)
- Doesn't encode/decode URL implicitly.
- UTF-8 characters support.
- Supports userinfo. (ex.
git
in[email protected]
) - Supports IPv6 hostname. (ex.
ldap://[2001:db8::7]/
) - Allows byte vectors as input.
- Takes optional
:start
and:end
keyword arguments. - Low-level parser functions.
- URL encoding/decoding utilities.
url-decode
,url-decode-params
,url-encode
,url-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-scheme
uri-userinfo
uri-host
uri-domain
uri-tld
uri-port
uri-path
uri-authority
render-uri
Structure class as a representation of URNs. All methods of uri
are also available for this class.
urn-nid
urn-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-dn
uri-ldap-attributes
uri-ldap-scope
uri-ldap-filter
uri-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 times 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
- Eitaro Fukamachi ([email protected])
Copyright (c) 2014 Eitaro Fukamachi ([email protected])
Licensed under the BSD 3-Clause License.