source: project/release/3/uri-generic/trunk/uri-generic.scm @ 12600

Last change on this file since 12600 was 12600, checked in by sjamaan, 13 years ago

Merge and backport latest changes from uri-generic release 4 into release 3

File size: 33.4 KB
Line 
1
2;;
3;; Definitions and parsing routines for Uniform Resource Identifiers (RFC 3986).
4;;
5;; Based on the Haskell URI library by  Graham Klyne <gk@ninebynine.org>.
6;;
7;; Copyright 2008 Ivan Raikov, Peter Bex.
8;;
9;;
10;;  Redistribution and use in source and binary forms, with or without
11;;  modification, are permitted provided that the following conditions
12;;  are met:
13;;
14;;  - Redistributions of source code must retain the above copyright
15;;  notice, this list of conditions and the following disclaimer.
16;;
17;;  - Redistributions in binary form must reproduce the above
18;;  copyright notice, this list of conditions and the following
19;;  disclaimer in the documentation and/or other materials provided
20;;  with the distribution.
21;;
22;;  - Neither name of the copyright holders nor the names of its
23;;  contributors may be used to endorse or promote products derived
24;;  from this software without specific prior written permission.
25;;
26;;  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND THE
27;;  CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
28;;  INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
29;;  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
30;;  DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR THE
31;;  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
32;;  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
33;;  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
34;;  USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
35;;  AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
36;;  LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
37;;  ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
38;;  POSSIBILITY OF SUCH DAMAGE.
39;;
40
41(require-extension syntax-case)
42(require-extension matchable)
43(require-extension defstruct)
44(require-extension srfi-1)
45(require-extension srfi-4)
46
47(define-extension uri-generic)
48
49(declare
50 (not usual-integrations)
51 (fixnum)
52 (inline)
53 (lambda-lift)
54 (export uri-reference update-uri update-authority
55         uri? uri-auth uri-authority uri-scheme uri-path uri-query
56         uri-fragment uri-host uri-port uri-username uri-password
57         authority? authority-host authority-port
58         authority-username authority-password
59         
60         absolute-uri uri->string uri->list 
61         uri-relative-to uri-relative-from 
62         uri-decode-string uri-encode-string 
63         uri-normalize-case uri-normalize-path-segments))
64
65(cond-expand
66   (utf8-strings (use utf8-srfi-13 utf8-srfi-14))
67   (else (use srfi-13 srfi-14)))
68
69(defstruct URI      scheme authority path query fragment)
70(defstruct URIAuth  username password host port)
71
72(define-record-printer (URI x out)
73  (fprintf out "#(URI scheme=~S authority=~A path=~S query=~S fragment=~S)"
74           (URI-scheme x)
75           (URI-authority x)
76           (URI-path x)
77           (URI-query x)
78           (URI-fragment x)))
79
80(define-record-printer (URIAuth x out)
81  (fprintf out "#(URIAuth host=~S port=~A)"
82           (URIAuth-host x)
83           (URIAuth-port x)))
84
85(define uri? URI?)
86
87(define uri-auth       URI-authority )
88(define uri-authority  URI-authority )
89(define uri-scheme     URI-scheme )
90(define uri-path       URI-path )
91(define uri-query      URI-query )
92(define uri-fragment   URI-fragment )
93
94(define (uri-host x)
95  (let ((auth (URI-authority x)))
96    (and auth (URIAuth-host auth))))
97
98(define (uri-port x)
99  (let ((auth (URI-authority x)))
100    (and auth (URIAuth-port auth))))
101
102(define (uri-username x)
103  (let ((auth (URI-authority x)))
104    (and auth (URIAuth-username auth))))
105
106(define (uri-password x)
107  (let ((auth (URI-authority x)))
108    (and auth (URIAuth-password auth))))
109
110(define authority? URIAuth?)
111(define authority-host URIAuth-host)
112(define authority-port URIAuth-port)
113(define authority-username URIAuth-username)
114(define authority-password URIAuth-password)
115
116(define update-authority
117  (let ((unset (list 'unset)))
118    (lambda (auth #!key (host unset) (port unset) (username unset) (password unset))
119      (make-URIAuth host: (if (eq? host unset) (URIAuth-host auth) host)
120                    port: (if (eq? port unset) (URIAuth-port auth) port)
121                    username: (if (eq? username unset) (URIAuth-username auth) username)
122                    password: (if (eq? password unset) (URIAuth-password auth) password)))))
123
124(define update-uri
125  (let ((unset (list 'unset)))
126   (lambda (uri . key/values)
127     (apply
128      (lambda (#!key
129               (scheme (URI-scheme uri)) (path (URI-path uri))
130               (query (URI-query uri)) (fragment (URI-fragment uri))
131               (auth unset) (authority unset))
132        (let* ((base-auth (or
133                           (cond
134                            ((not (eq? unset auth)) auth)
135                            ((not (eq? unset authority)) authority)
136                            (else (URI-authority uri)))
137                           (make-URIAuth)))
138               (updated-auth (apply update-authority base-auth key/values))
139               (final-auth (if (equal? (make-URIAuth) updated-auth)
140                               #f
141                               updated-auth)))
142          (make-URI scheme: scheme path: path query: query fragment: fragment
143                    authority: final-auth))) key/values))))
144
145;; Character classes
146 
147(define (hexdigit-char? c)    (char-set-contains? char-set:hex-digit c))
148
149(define (reserved-char? c)    (char-set-contains? char-set:reserved c))
150
151(define (unreserved-char? c)  (char-set-contains? char-set:unreserved c))
152
153(define (scheme-char? c)      (char-set-contains? char-set:scheme c))
154
155(define (ipv-future-char? c)  (char-set-contains? char-set:ipv-future c))
156
157(define (pct-encoded? c)      (match c ((#\% h1 h2) #t) (else #f)))
158
159
160;; Helper functions for character parsing
161 
162(define (uchar extras)
163  (let ((extras-set (or (and (char-set? extras) extras) (string->char-set extras))))
164    (lambda (c) (or (pct-encoded? c) (unreserved-char? c) 
165                    (char-set-contains? char-set:sub-delims c) 
166                    (char-set-contains? extras-set c) ))))
167 
168;; same as uchar, but without sub-delims
169(define (schar extras)
170  (let ((extras-set (or (and (char-set? extras) extras) (string->char-set extras))))
171    (lambda (c) (or (pct-encoded? c)  (unreserved-char? c) 
172                    (char-set-contains? extras-set c) ))))
173                 
174(define (many pred?)
175  (lambda (s)
176    (let loop ((lst (list)) (rst s))
177      (cond ((null? rst)        (list (reverse lst) rst))
178            ((pred? (car rst))  (loop (cons (car rst) lst) (cdr rst)))
179            (else               (list (reverse lst) rst))))))
180
181(define (many1 pred?)
182  (lambda (s)
183    (let ((a1 (and (not (null? s)) (pred? (car s)) (car s))))
184      (and a1 (match ((many pred?) (cdr s))
185                     ((as rst)  (list (cons a1 as) rst))
186                     (else #f))))))
187
188
189(define (count-min-max m n pred?)
190  (lambda (s) 
191    (let loop ((m m) (n n) (lst (list)) (rst s))
192      (cond ((and (pair? rst) (positive? m))
193             (if (pred? (car rst))
194                 (loop (- m 1) (- n 1) (cons (car rst) lst) (cdr rst)) #f))
195            ((or (<= n 0) (null? rst))   (list (reverse lst) rst))
196            (else
197             (if (pred? (car rst))
198                 (loop 0 (- n 1) (cons (car rst) lst) (cdr rst))
199                 (list (reverse lst) rst)))))))
200
201;; Parser combinators
202
203(define (consume f) 
204  (lambda (s)
205    (let loop ((lst (list)) (rst s))
206      (match (f rst)
207             ((a rst)  (loop (cons a lst) rst))
208             (else  (list (reverse lst) rst))))))
209
210
211(define (consume-count n f)
212  (lambda (s)
213    (let loop ((n n) (lst (list)) (rst s))
214      (if (positive? n)
215          (match (or (f rst) (list #f s))
216                 ((x rst)  (and x (loop (- n 1) (cons x lst) rst))))
217          (list (reverse lst) rst)))))
218
219
220(define (consume-min-max m n f)
221  (lambda (s) 
222    (let loop ((m m) (n n) (lst (list)) (rst s))
223      (cond ((positive? m)
224             (match (f rst)
225                    ((a1 rst) (loop (- m 1) (- n 1) (cons a1 lst) rst))
226                    (else #f)))
227            ((<= n 0)   (list (reverse lst) rst))
228            (else
229             (match (f rst)
230                    ((a1 rst) (loop 0 (- n 1) (cons a1 lst) rst))
231                    (else #f)))))))
232
233;; Helper function for malformed ip address error messages
234
235(define (try-ip-literal->string s)
236  (let loop ((lst (list))  (rst s))
237    (match rst ((#\] . rst)  (uri-char-list->string (reverse lst)))
238           (()  (uri-char-list->string (reverse lst)))
239           (else (loop (cons (car rst) lst) (cdr rst))))))
240
241;; RFC 3986, section 2.1
242;;
243;; Returns a 'pct-encoded' sequence of octets.
244;;
245(define (pct-encode lst)
246  (define (hex-digit i) (and (>= i 0) (< i 16) (car (string->list (sprintf "~X" i)))))
247  (reverse (fold (lambda (x ax)
248                   (let ((h1 (hex-digit (quotient x 16)))
249                         (h2 (hex-digit (remainder x 16))))
250                     (cons `(#\% ,h1 ,h2)  ax)))
251                 (list) lst)))
252
253 
254;; RFC3986, section 2.2
255;;
256;; Reserved characters.
257;;
258
259(define char-set:gen-delims (string->char-set ":/?#[]@"))
260(define char-set:sub-delims (string->char-set "!$&'()*+,;="))
261
262(define char-set:reserved (char-set-union char-set:gen-delims char-set:sub-delims))
263
264;;  RFC3986, section 2.3
265;;
266;;  "Unreserved" characters.
267;;
268
269(define char-set:unreserved 
270  (char-set-union char-set:letter+digit (string->char-set "-_.~")))
271
272
273
274;;  RFC3986, section 3
275;;
276;;   URI         = scheme ":" hier-part [ "?" query ] [ "#" fragment ]
277;;
278;;   hier-part   = "//" authority path-abempty
279;;               / path-abs
280;;               / path-rootless
281;;               / path-empty
282
283(define (uri s)
284  (let ((s (if (string? s) (uri-string->normalized-char-list s) s)))
285    (match (scheme s)
286           ((us rst)
287            (match-let* (((ua up rst)   (hier-part rst))
288                         ((uq rst)      (match rst ((#\? . rst) (query rst))
289                                               (else (list #f rst))))
290                         ((uf rst)      (match rst ((#\# . rst) (fragment rst))
291                                               (else (list #f rst)))))
292                        (make-URI scheme: (string->symbol (list->string us)) authority: ua 
293                                  path: (map uri-char-list->string up) query: (and uq (filter-map query->alist uq))
294                                  fragment: (and uf (uri-char-list->string uf)))))
295         (else #f))))
296
297(define (hier-part s)
298  (match s ((#\/ #\/ . rst) 
299            (match-let* (((ua rst)  (authority rst))
300                         ((up rst)  (path-abempty rst)))
301                        (list ua up rst)))
302         (else (match-let (((up rst) (or (path-abs s) (path-rootless s) (list '() s))))
303                          (list #f up rst)))))
304
305;;  RFC3986, section 3.1
306
307(define scheme0 (many scheme-char?))
308(define (scheme s)
309  (match (scheme0 s)
310         ((ss (#\: . rst))  (list ss rst))
311         (else #f)))
312
313(define char-set:scheme
314  (char-set-union char-set:letter+digit (string->char-set "+-.")))
315
316
317;;  RFC3986, section 3.2
318
319(define (authority s)
320  (match-let* (((uu uw rst)   (or (userinfo s) (list #f #f s)))
321               ((uh rst)      (host rst))
322               ((up rst)      (or (port rst) (list #f rst))))
323              (list (make-URIAuth username: (and uu (uri-char-list->string uu)) 
324                                  password: (and uw (uri-char-list->string uw))
325                                  host: (uri-char-list->string uh) 
326                                  port: (and (pair? up) (string->number (list->string up))))
327                    rst)))
328
329;;  RFC3986, section 3.2.1
330
331(define userinfo0  (many (uchar ";&=+$,")))
332
333(define (userinfo s)
334  (match (userinfo0 s)
335         ((uu ( #\: . rst))   (match (userinfo0 rst)
336                                     ((up ( #\@ . rst) ) (list uu up rst))
337                                     (else #f)))
338         ((uu ( #\@ . rst)) (list uu (list) rst))
339         (else #f)))
340
341
342
343;;  RFC3986, section 3.2.2
344
345(define (host s)  (or (ip-literal s) (ipv4-address s) (reg-name s)))
346
347(define (ip-literal s)
348  (match s ((#\[ . rst) 
349            (match (or (ipv6-address rst) (ipv-future rst))
350                   ((ua (#\] . rst))  (list ua rst))
351                   (else (error 'ip-literal "malformed ip literal" (try-ip-literal->string rst)))))
352         (else #f)))
353
354(define ipv-future0  (many ipv-future-char?))
355
356(define (ipv-future s)
357  (match s ((#\v (? hexdigit-char?) #\. . rst)  (ipv-future0 rst))
358         (else #f)))
359
360(define char-set:ipv-future 
361  (char-set-union char-set:unreserved char-set:sub-delims (char-set #\;)))
362
363
364
365;; Pv6address =                            6( h16 ":" ) ls32
366;;                   /                       "::" 5( h16 ":" ) ls32
367;;                   / [               h16 ] "::" 4( h16 ":" ) ls32
368;;                   / [ *1( h16 ":" ) h16 ] "::" 3( h16 ":" ) ls32
369;;                   / [ *2( h16 ":" ) h16 ] "::" 2( h16 ":" ) ls32
370;;                   / [ *3( h16 ":" ) h16 ] "::"    h16 ":"   ls32
371;;                   / [ *4( h16 ":" ) h16 ] "::"              ls32
372;;                   / [ *5( h16 ":" ) h16 ] "::"              h16
373;;                   / [ *6( h16 ":" ) h16 ] "::"
374
375;;       ls32        = ( h16 ":" h16 ) / IPv4address
376;;                   ; least-significant 32 bits of address
377
378;;       h16         = 1*4HEXDIG
379;;                   ; 16 bits of address represented in hexadecimal
380
381
382(define (ipv6-address s)
383  (or (match (u6-h4c s) ;; 6( h16 ":" ) ls32
384
385             ((a2 rst)  (match (ls32 rst)
386                               ((a3 rst)  (list (append (concatenate a2) a3) rst))
387                               (else #f)))
388             (else #f))
389      (match s          ;; "::" 5( h16 ":" ) ls32
390             ((#\: #\: . rst) 
391              (match (u5-h4c rst)
392                     ((a2 rst)  (match (ls32 rst)
393                                       ((a3 rst)  (list (append (list #\: #\:) (concatenate a2) a3) rst))
394                                       (else #f)))))
395             (else #f))
396      (match (u_opt_n_h4c_h4 0 s)
397             ((a1 rst) (match rst
398                              ((#\: #\: . rst) 
399                               (match (u4-h4c rst)
400                                      ((a2 rst)  (match (ls32 rst)
401                                                        ((a3 rst) 
402                                                         (list (append (concatenate a1) (list #\: #\:) 
403                                                                       (concatenate a2) a3) rst))
404                                                        (else #f)))
405                                      (else #f)
406                                      ))
407                              (else #f)))
408              (else #f))
409      (match (u_opt_n_h4c_h4 1 s)
410             ((a1 rst) 
411                      (match rst       
412                              ((#\: #\: . rst) 
413                               (match (u3-h4c rst)
414                                      ((a2 rst)  (match (ls32 rst)
415                                                        ((a3 rst) 
416                                                         (list (append (concatenate a1) (list #\: #\:) 
417                                                                       (concatenate a2) a3) rst))
418                                                        (else #f)))
419                                      (else #f)
420                                      ))
421                              (else #f)))
422              (else #f))
423      (match (u_opt_n_h4c_h4 2 s)
424             ((a1 rst) (match rst       
425                              ((#\: #\: . rst) 
426                               (match (u2-h4c rst)
427                                      ((a2 rst)  (match (ls32 rst)
428                                                        ((a3 rst)  (list (append (concatenate a1) (list #\: #\:) 
429                                                                                 (concatenate a2) a3) rst))
430                                                        (else #f)))
431                                      (else #f)
432                                      ))
433                              (else #f)))
434              (else #f))
435      (match (u_opt_n_h4c_h4 3 s)
436             ((a1 rst) (match rst       
437                              ((#\: #\: . rst) 
438                               (match (h4c rst)
439                                      ((a2 rst)  (match (ls32 rst)
440                                                        ((a3 rst)  (list (append (concatenate a1) (list #\: #\:) 
441                                                                                 (concatenate a2) a3) rst))
442                                                        (else #f)))
443                                      (else #f)
444                                      ))
445                              (else #f)))
446              (else #f))
447      (match (u_opt_n_h4c_h4 4 s)
448             ((a1 rst) (match rst       
449                              ((#\: #\: . rst) 
450                               (match (ls32 rst)
451                                      ((a3 rst)  (list (append (concatenate a1) (list #\: #\:) a3) rst))
452                                      (else #f)))
453                              (else #f)))
454              (else #f))
455      (match (u_opt_n_h4c_h4 5 s)
456             ((a1 rst) (match rst       
457                              ((#\: #\: . rst) 
458                               (match (h4 rst)
459                                      ((a3 rst)  (list (append (concatenate a1) (list #\: #\:) a3) rst))
460                                      (else #f)))
461                              (else #f)))
462              (else #f))
463      (match (u_opt_n_h4c_h4 6 s)
464             ((a1 rst) (match rst       
465                              ((#\: #\: . rst) 
466                               (list (append (concatenate a1) (list #\: #\:)) rst))
467                              (else #f)))
468              (else #f))
469      (error 'ipv6-address "malformed ipv6 address" (try-ip-literal->string s))))
470
471
472
473(define (u_opt_n_h4c_h4 n s)
474  (match ((consume-min-max 0 n h4c) s)
475         ((a1 rst)  (match (h4 rst)
476                           ((a2 rst) (list (append a1 (list a2)) rst))
477                           (else #f)))
478         (else #f)))
479
480(define (ls32 s)
481  (match (h4c s)
482         ((a1 rst) (match (h4 rst)
483                          ((a2 rst)  (list (append a1 a2) rst))
484                          (else (ipv4-address s))))
485         (else (ipv4-address s))))
486
487(define (h4c s)
488  (match (h4 s)
489         ((a1 (#\: (and r1 (not #\:)) . rst))
490          (list (append a1 (list #\:)) (cons r1 rst)))
491         (else #f)))
492
493(define u6-h4c (consume-count 6 h4c))
494(define u5-h4c (consume-count 5 h4c))
495(define u4-h4c (consume-count 4 h4c))
496(define u3-h4c (consume-count 3 h4c))
497(define u2-h4c (consume-count 2 h4c))
498
499(define h4 (count-min-max 1 4 hexdigit-char?))
500
501(define (ipv4-address s)
502  (match (dec-octet s)
503         ((a1 (#\. rst)) 
504          (match (dec-octet rst)
505                 ((a2 (#\. rst)) 
506                  (match (dec-octet rst)
507                         ((a3 (#\. rst)) 
508                          (match (dec-octet rst)
509                                 ((a4 rst)  (list (append a1 #\. a2 #\. a3 #\. a4) rst))
510                                 (else #f)))
511                         (else #f)))
512                 (else #f)))
513         (else #f)))
514
515(define (dec-char->num c)
516  (case c ((#\0) 0) ((#\1) 1) ((#\2) 2) ((#\3) 3) ((#\4) 4) ((#\5) 5) 
517         ((#\6) 6) ((#\7) 7) ((#\8) 8) ((#\9) 9) (else #f)))
518                 
519(define (ipv4-octet? lst)
520  (let loop ((n (reverse (map dec-char->num lst))) (i 1) (ax 0))
521    (if (null? n) (and (>= ax 0) (<= ax 255))
522        (loop (cdr n) (* i 10) (+ ax (* i (car n)))))))
523
524(define (dec-octet s)
525  (match ((count-min-max 1 3 char-numeric?) s)
526         (((and a1 (? ipv4-octet?)) rst)  (list a1 rst))
527         (else #f)))
528
529(define reg-name
530  (count-min-max 0 255 (lambda (c) (or (unreserved-char? c) 
531                                       (pct-encoded? c) 
532                                       (char-set-contains? char-set:sub-delims c) ))))
533
534;;  RFC3986, section 3.2.3
535
536(define port0 (many char-numeric?))
537
538(define (port s)
539  (match s ((#\: . rst)  (port0 rst))
540         (else #f)))
541
542
543;;
544;;  RFC3986, section 3.3
545;;
546;;   path          = path-abempty    ; begins with "/" or is empty
547;;                 / path-abs        ; begins with "/" but not "//"
548;;                 / path-noscheme   ; begins with a non-colon segment
549;;                 / path-rootless   ; begins with a segment
550;;                 / path-empty      ; zero characters
551;;
552;;   path-abempty  = *( "/" segment )
553;;   path-abs      = "/" [ segment-nz *( "/" segment ) ]
554;;   path-noscheme = segment-nzc *( "/" segment )
555;;   path-rootless = segment-nz *( "/" segment )
556;;   path-empty    = 0<pchar>
557;;
558;;   segment       = *pchar
559;;   segment-nz    = 1*pchar
560;;   segment-nzc   = 1*( unreserved / pct-encoded / sub-delims / "@" )
561;;
562;;   pchar         = unreserved / pct-encoded / sub-delims / ":" / "@"
563
564(define (path s)
565  (or (path-abempty s)  (path-abs s) (path-noscheme s) 
566      (path-rootless s) (list (list) s)))
567
568 
569(define (slash-segment s)
570  (match s
571         ((#\/ . rst)  (match (segment rst)
572                              ((ss rst)  (list (cons #\/ ss) rst))
573                              (else #f)))
574         (else  #f)))
575
576(define pchar (uchar ":@"))
577
578(define segment (many pchar))
579
580(define segment-nz (many1 pchar))
581
582(define segment-nzc (many1 (uchar "@")))
583
584(define path-abempty (consume slash-segment))
585
586(define (path-abs s)
587  (match s
588         ((#\/)          (list (list (list #\/))  (list)))
589         ((#\/ . rst)    (match (path-rootless rst)
590                                ((() rst)  (list  (list (list #\/))  rst))
591                                ((lst rst) (list  (cons (cons #\/ (car lst)) (cdr lst)) rst))
592                                (else #f)))
593         (else #f)))
594
595(define (path-noscheme s)
596  (match (segment-nzc s)
597         ((s1 rst)  (match (path-abempty rst)
598                           ((ss rst) (list (cons s1 ss) rst))
599                           (else (list (list s1) rst))))
600         (else #f)))
601
602(define (path-rootless s)
603  (match (segment-nz s)
604         ((s1 rst)  (match (path-abempty rst)
605                           ((ss rst) (list (cons s1 ss) rst))
606                           (else #f)))
607         (else #f)))
608
609;;  RFC3986, section 3.4
610
611
612(define query0  (many (schar ":@/?!$'()*+,;=")))
613(define (query1 s)
614  (match s ((#\& . rst) (query0 rst))
615         (else #f)))
616
617(define (query s)
618  (match (query0 s)
619         ((q1 rst)   
620                     (match ((consume query1) rst)
621                            ((qs rst)  (list (cons q1 qs) rst))
622                            (else (list (list q1) rst))))
623         (else #f)))
624
625(define query-part (many (schar ":@/?!$'()*+,;")))
626
627;; Convert an internal parser representation of a query to an alist
628;; of symbol-string pairs
629(define (query->alist s)
630  (match (query-part s)
631         ((p1 (#\= . rst))  (match (query-part rst)
632                                   ((p2 _) `(,(string->symbol (uri-char-list->string p1)) . ,(uri-char-list->string p2)))
633                                   (else #f)))
634         ((p1 ())   `(,(string->symbol (uri-char-list->string p1)) . #t))
635         (else #f)))
636 
637
638;;  RFC3986, section 3.5
639
640
641(define fragment0  (many (uchar ":@/?")))
642(define (fragment s)
643  (match (fragment0 s)
644         ((ss rst)  (list ss rst))
645         (else #f)))
646
647;;  Reference, Relative and Absolute URI forms
648;;
649;;  RFC3986, section 4.1
650
651(define (uri-reference s)
652  (let ((s (if (string? s) (uri-string->normalized-char-list s) s)))
653    (or (uri s) (relative-ref s))))
654
655;;  RFC3986, section 4.2
656;;
657;;   relative-URI  = relative-part [ "?" query ] [ "#" fragment ]
658;;
659;;   relative-part = "//" authority path-abempty
660;;                 / path-abs
661;;                 / path-noscheme
662;;                 / path-empty
663
664(define (relative-ref s)
665  (and (not (scheme s))
666       (match-let* (((ua up rst)  (relative-part s))
667                    ((uq rst)     (match rst ((#\? . rst) (query rst))
668                                         (else (list #f rst))))
669                    ((uf rst)     (match rst ((#\# . rst) (fragment rst))
670                                         (else (list #f rst)))))
671                   (make-URI scheme: #f authority: ua path: (map uri-char-list->string up) 
672                             query: (and uq (filter-map query->alist uq))
673                             fragment: (and uf (uri-char-list->string uf))))))
674
675(define (relative-part s)
676  (match s
677         ((#\/ #\/ . rst)
678          (match-let* (((ua rst)  (authority rst))
679                       ((up rst)  (path-abempty rst)))
680                      (list ua up rst)))
681         (else (match-let* (((up rst)  (or (path-abs s) (path-noscheme s) (list (list) s))))
682                           (list #f up rst))))) 
683
684
685
686;;  RFC3986, section 4.3
687
688(define (absolute-uri s)
689  (let ((s (if (string? s) (uri-string->normalized-char-list s) s)))
690    (match (scheme s)
691           ((us rst) 
692            (match-let* (((ua up rst)  (hier-part rst))
693                         ((uq rst)     (match rst ((#\? . rst)  (query rst))
694                                              (else (list #f rst)))))
695                        (make-URI scheme: (string->symbol (list->string us)) authority: ua 
696                                  path: (map uri-char-list->string up) query: (and uq (filter-map query->alist uq))
697                                  fragment: #f)))
698           (error 'absolute-uri "no scheme found in URI string"))))
699                     
700
701;; Turns a URI into a string.
702;;
703;; Uses a supplied function to map the userinfo part of the URI.
704;;
705
706(define (uri->string uri . rest)
707   (let-optionals rest ((userinfomap (lambda (u pw) (string-append u ":******" ))))
708    (match uri
709           (($ URI scheme authority path query fragment)
710            (string-append
711             ((lambda (x) (or (and x (string-append (->string x) ":")) ""))  scheme)
712             (if authority
713                 (string-append (uri-auth->string authority userinfomap))
714                 "")
715             (string-concatenate path)
716             (if (and query (not (null? query))) (string-concatenate (cons "?" (intersperse (map (lambda (p) (if (eq? (cdr p) #t) (symbol->string (car p)) (conc (car p) "=" (cdr p)))) query) "&"))) "")
717             (if fragment (string-append  "#" fragment) "")))
718           (else #f))))
719
720(define (uri-auth->string uri-auth userinfomap)
721  (match uri-auth
722         (($ URIAuth username password host port)
723          (string-append "//" (if (and username password)
724                                  ((lambda (x) (or (and x (string-append x "@")) ""))
725                                   (userinfomap username password)) "")
726                         host ((lambda (x) (or (and x (string-append ":" (->string x))) ""))
727                               port)))
728         (else #f)))
729                         
730; specific: ((uri-authority uri) (uri-path uri) (uri-query uri)).
731
732(define (uri->list uri . rest)
733  (let-optionals rest ((userinfomap (lambda (u pw) (string-append u ":******" ))))
734    (match uri
735           (($ URI scheme authority path query fragment)
736            `(,scheme (,(uri-auth->list authority userinfomap) ,path ,query) ,fragment))
737           (else #f))))
738
739(define (uri-auth->list uri-auth userinfomap)
740  (match uri-auth
741         (($ URIAuth username password regname port)
742          `(,(if (and username password) (userinfomap username password) #f) ,regname ,port ))
743         (else #f)))
744                         
745
746;;  Percent encoding and decoding
747
748(define (char-list-encode p enc str)
749  (reverse
750   (fold (lambda (c ax) 
751           (if (p c) (let* ((os (enc c)) 
752                            (cs (pct-encode os)))
753                       (append (reverse cs) ax))
754               (cons c ax)))
755         (list) str)))
756
757(define (integer->octets i)
758  (let loop ((i i) (lst (list)))
759    (if (zero? i) lst
760        (loop (quotient i 256) (cons (modulo i 256) lst)))))
761
762(define (pct? c) (char=? c #\%))
763
764(define (uri-encode-string str)
765  (let ((clst (string->list str)))
766    (uri-char-list->string
767     (char-list-encode (disjoin pct? reserved-char?) (compose integer->octets char->integer) clst))))
768
769
770(define (octets->integer lst)
771  (let loop ((i 0) (m 1) (lst (reverse lst)))
772    (if (null? lst) i
773        (loop (+ i (* (car lst) m)) (* m 256) (cdr lst)))))
774
775(define (pct-decode c)
776  (match c
777         ((#\% h1 h2)  (integer->char (octet-decode h1 h2)))
778         (else c)))
779
780(define (octet-decode h1 h2)
781  (string->number (list->string (list h1 h2)) 16))
782
783(define (uri-decode-string str)
784  (let loop ((clst (uri-string->char-list str)) (p (list))  (nlst (list)))
785    (if (null? clst)
786        (uri-char-list->string (reverse nlst))
787        (match (car clst)
788               ((and c (? char?)) 
789                (if (null? p) (loop (cdr clst) p (cons c nlst))
790                    (let ((pc (integer->char (octets->integer (reverse p)))))
791                      (loop (cdr clst) (list) (cons* c pc nlst)))))
792               ((#\% h1 h2) 
793                (loop (cdr clst) (cons (octet-decode h1 h2) p) nlst))
794               (else (error 'uri-decode-string "invalid URI string " str))))))
795   
796(define (uri-string->normalized-char-list str)
797  (let ((clst (uri-string->char-list str)))
798    (map (lambda (c) (if (pct-encoded? c) 
799                         (let ((e (pct-decode c)))
800                           (if (unreserved-char? e) e c)) c))
801         clst)))
802                         
803
804
805;; Convert a URI character list to a string
806
807(define (uri-char-list->string s)
808  (list->string
809   (reverse
810    (fold (lambda (x ax)
811                  (cond ((char? x) (cons x ax))
812                        ((list? x) (append (reverse x) ax)))) (list) s))))
813   
814;; Convert a string to a URI character list
815
816(define (uri-string->char-list s)
817  (let loop ((cs (list)) (lst (string->list s)))
818    (if (null? lst) (reverse cs)
819        (match lst
820               ((#\% h1 h2 . rst)  (loop (cons (list #\% h1 h2) cs) rst))
821               (((and c (? char?)) . rst)  (loop (cons c cs) rst))))))
822   
823;;
824;;  Resolving a relative URI relative to a base URI
825;;
826;;  Returns a new URI which represents the value of the first URI
827;;  interpreted as relative to the second URI.
828;;
829;;  For example:
830;;
831;;  (uri->string (relative-to (uri-reference "foo") (uri "http://bar.org/")) )
832;;         => "http://bar.org/foo"
833;;
834;;  (uri->string (non-strict-relative-to (uri "http:foo") (uri "http://bar.org/")) )
835;;         => "http://bar.org/foo"
836;;
837;;  Algorithm from RFC3986, section 5.2.2
838;;
839
840(define (uri-relative-to ref base)
841  (and (uri? ref) (uri? base)
842       (cond ((uri-scheme ref)      (just-segments ref))
843             ((uri-authority ref)   (let ((x (just-segments ref)))
844                                      (URI-scheme-set! x (uri-scheme base))
845                                      x))
846
847             (((lambda (p) (and (not (null? p)) p))  (uri-path ref)) =>
848              (lambda (ref-path)
849                (if (and (pair? ref-path) (string-prefix? "/" (car ref-path)))
850                    (let ((x (just-segments ref)))
851                      (URI-scheme-set! x (uri-scheme base))
852                      (URI-authority-set! x (uri-auth base))
853                      x)
854                    (let ((x (udup ref)))
855                      (URI-scheme-set! x (uri-scheme base))
856                      (URI-authority-set! x (uri-auth base))
857                      (URI-path-set! x (merge-paths base x))
858                      (just-segments x)))))
859
860             ((uri-query ref)       (let ((x (udup ref)))
861                                      (URI-scheme-set! x (uri-scheme base))
862                                      (URI-authority-set! x (uri-auth base))
863                                      (URI-path-set! x (list "/"))
864                                      (URI-path-set! x (merge-paths base x))
865                                      (just-segments x)))
866
867             (else                  (let ((x (just-segments ref)))
868                                      (URI-scheme-set! x (uri-scheme base))
869                                      (URI-authority-set! x (uri-auth base))
870                                      (URI-path-set! x (uri-path base))
871                                      (URI-query-set! x (uri-query base))
872                                      x)))))
873
874(define (just-segments u)
875  (let ((p (remove-dot-segments (uri-path u))))
876    (make-URI scheme: (uri-scheme u) authority: (uri-auth u) path: p
877              query: (uri-query u) fragment: (uri-fragment u))))
878
879(define (merge0 pb pr)
880  (let* ((rpb  (reverse pb))
881         (pb1  (reverse (if (and (pair? rpb) (not (string=? (car rpb) "/"))) (cdr rpb) rpb)))
882         (pr1  (or (and (pair? pr) (not (string=? ".." (car pr))) (not (string=? "." (car pr)))
883                        (not (string-prefix? "/" (car pr))) 
884                        (cons (string-append "/" (car pr)) (cdr pr)))
885                   pr)))
886    (append pb1 pr1)))
887
888(define (merge-paths b r)
889  (let ((ba (uri-authority b))
890        (pb (uri-path b))
891        (pr (uri-path r)))
892    (let ((mp  (if (and ba (null? pb)) (cons "/" pr) (merge0 pb pr))))
893      mp)))
894
895(define (uri-non-strict-relative-to ref base)
896  (let ((rs (uri-scheme ref))
897        (rb (uri-scheme base)))
898    (let ((ref1 (make-URI scheme: (if (eq? rs rb) #f (uri-scheme ref))
899                          authority: (uri-auth ref) path: (uri-path ref)
900                          query: (uri-query ref) fragment: (uri-fragment ref))))
901      (uri-relative-to ref1 base))))
902
903
904;;  Remove dot segments, but protect leading '/' character
905
906(define (remove-dot-segments ps)
907  (match ps (("/" . rst)   (cons "/" (elim-dots rst)))
908         (else             (elim-dots ps))))
909
910(define (elim-dots ps)
911  (let loop ((ps ps) (lst (list)))
912    (if (null? ps) (reverse lst)
913        (match ps
914               (((or "." "/."))
915                (loop (list) (if (and (pair? lst) (string=? "/" (car lst))) (cdr lst) (cons "/" lst))))
916               (((or "." "/.") . rst)
917                (loop rst (if (and (pair? lst) (string=? "/" (car lst))) (cdr lst) lst)))
918               (((or ".." "/.."))         
919                (loop (list) (if (pair? lst) (cons "/" (cdr lst)) lst)))
920               (((or ".." "/..") . rst)
921                (loop rst (if (pair? lst) (cdr lst) lst)))
922               ((x . rst)       (loop rst (cons x lst)))))))
923
924;;
925;; Finding a URI relative to a base URI
926;;
927;; Returns a new URI which represents the relative location of the
928;; first URI with respect to the second URI.  Thus, the values
929;; supplied are expected to be absolute URIs, and the result returned
930;; may be a relative URI.
931;;
932;; Example:
933;;
934;; (uri->string
935;;  (uri-relative-from (uri "http://example.com/Root/sub1/name2#frag")
936;;                     (uri "http://example.com/Root/sub2/name2#frag")))
937;;    ==> "../sub1/name2#frag"
938;;
939
940
941(define (uri-relative-from uabs base)
942  (cond ((ucdiff? uri-scheme uabs base)      (udup uabs))
943        ((ucdiff? uri-authority uabs base)   (let ((x (udup uabs)))
944                                               (URI-scheme-set! x #f)
945                                               x))
946        ((ucdiff? uri-path uabs base)       
947         (let ((x    (udup uabs))
948               (path (rel-path-from (remove-body-dot-segments (uri-path uabs))
949                                    (remove-body-dot-segments (uri-path base)))))
950           (URI-scheme-set! x #f)
951           (URI-authority-set! x #f)
952           (URI-path-set! x path)
953           x))
954        ((ucdiff? uri-query uabs base) 
955         (let ((x (udup uabs)))
956           (URI-scheme-set! x #f)
957           (URI-authority-set! x #f)
958           (URI-path-set! x (list))
959           x))
960        (else                            
961         (let ((x (udup uabs)))
962           (URI-scheme-set! x #f)
963           (URI-authority-set! x #f)
964           (URI-query-set! x #f)
965           (URI-path-set! x (list))
966           x))))
967
968
969(define (udup u)
970  (make-URI scheme: (uri-scheme u) authority: (uri-auth u) path: (uri-path u)
971            query: (uri-query u) fragment: (uri-fragment u)))
972
973(define (ucdiff? sel u1 u2)
974  (let ((s1 (sel u1))
975        (s2 (sel u2)))
976    (not (cond ((and (URIAuth? s1) (URIAuth? s2))
977                (not (or (ucdiff? uri-username u1 u2) (ucdiff? uri-host u1 u2) (ucdiff? uri-port u1 u2))))
978               ((and (list? s1) (list? s2))       (every string=? s1 s2))
979               ((and (string? s1) (string? s2))   (string=? s1 s2))
980               (else                              (eq? s1 s2))))))
981
982(define (remove-body-dot-segments p)
983  (or (and (pair? p)
984           (let ((r (reverse p)))
985             (reverse (cons (car r) (remove-dot-segments (cdr r))))))
986      p))
987
988(define (rel-path-from pabs base)
989  (cond  ((null? pabs)  (list "/"))
990         ((null? base)  pabs)
991         ;; Construct a relative path segment if the paths share a
992         ;; leading segment other than a leading '/'
993         (else  (match (list pabs base)
994                       (((sa1 . (and ra1 (sa2 . ra2))) (sb1 . (and rb1 (sb2 . rb2))))
995                        (if (string=? sa1 sb1)
996                            (make-rel-path
997                             (if (string=? "/" sa1)
998                                 (if (string=? sa2 sb2) (rel-path-from1 ra2 rb2) pabs)
999                                 (rel-path-from1 ra1 rb1)))
1000                            pabs))
1001                       (((sa1) (sb1 . rb1))
1002                        (if (string=? sa1 sb1)  (rel-segs-from (list) rb1)
1003                            pabs))))))
1004
1005(define (make-rel-path x)
1006  (if (pair? x) (if (string-prefix? "/" (car x)) (cons "." x) x) x))
1007
1008;;  rel-path-from1 strips off trailing names from the supplied paths,
1009
1010(define (rel-path-from1 pabs base)
1011  (match-let* (((na . sa)  (reverse pabs)) 
1012               ((nb . sb)  (reverse base)))
1013     (let ((rp (rel-segs-from (reverse sa) (reverse sb))))
1014       (if (null? rp)  (cond ((string=? na nb)  (list))
1015                             ((protect? na)     (list (string-append "./" na)))
1016                             (else              (list na)))
1017           (append rp (list na))))))
1018
1019                         
1020(define (protect? sa) (or (string-null? sa) (string-contains sa ":")))
1021             
1022
1023
1024;;  rel-segs-from discards any common leading segments from both paths,
1025;;  then invokes dif-segs-from to calculate a relative path from the end
1026;;  of the base path to the end of the target path.  The final name is
1027;;  handled separately, so this deals only with "directory" segments.
1028
1029(define (rel-segs-from sabs base)
1030  (cond ((and (null? sabs) (null? base))  (list))
1031        ((or (null? sabs) (null? base))   (dif-segs-from sabs base))
1032        (else (match-let (((sa1 . ra1) sabs)
1033                          ((sb1 . rb1) base))
1034                         (if (string=? sa1 sb1)
1035                             (rel-segs-from ra1 rb1)
1036                             (dif-segs-from sabs base))))))
1037
1038;;  dif-segs-from calculates a path difference from base to target,
1039;;  not including the final name at the end of the path (i.e. results
1040;;  always ends with '/')
1041;;
1042;;  This function operates under the invariant that the supplied value
1043;;  of sabs is the desired path relative to the beginning of base.
1044;;  Thus, when base is empty, the desired path has been found.
1045
1046(define (dif-segs-from sabs base)
1047  (if (null? base) sabs (dif-segs-from (cons ".." sabs)  (cdr base))))
1048
1049
1050
1051;; Other normalization functions
1052;;
1053;; Case normalization; cf. RFC3986 section 6.2.2.1
1054;; NOTE:  authority case normalization is not performed
1055
1056(define (uri-normalize-case uri)
1057  (let ((u1      (udup uri))
1058        (scheme  (string->symbol (string-downcase (->string (uri-scheme uri)))))
1059        (path    (map (lambda (c) (match c (('% h1 h2)  `(% ,(char-upcase h1) ,(char-upcase h2)))
1060                                         (else c))) (uri-path uri))))
1061    (URI-scheme-set! u1 scheme)
1062    (URI-path-set! u1 path)
1063    u1))
1064
1065
1066;;  Path segment normalization; cf. RFC3986 section 6.2.2.4
1067
1068(define (uri-normalize-path-segments uri)
1069  (let ((u1      (udup uri))
1070        (path    (remove-dot-segments (uri-path uri))))
1071    (URI-path-set! u1 path)
1072    u1))
Note: See TracBrowser for help on using the repository browser.