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.
git
in git@github.com
)ldap://[2001:db8::7]/
):start
and :end
keyword arguments.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)
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
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
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
Add :lenient
option uri-query-params
(default to T
).
Fix merge-uris
to accept strings as it did in 0.4.0.
Support MSVC on ECL.
Coerce URI path
to strings.
All constructors like make-uri-file
and make-uri-https
exported.
uri=
and uri-equal
normalize the path so that NIL and "" are considered equal.
The file
scheme 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-http
could be set to FTP).
merge-uris
has 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-uri
and uri-authority
build 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-equal
which normalizes the path when comparing URIs.
The empty path and the root path are no longer equal with uri=
. Use
uri-equal
if 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-string
and parse-uri-byte-vector
now return the scheme default
port when unspecified.
Copyright (c) 2014-2019 Eitaro Fukamachi (e.arrows@gmail.com)
Licensed under the BSD 3-Clause License.