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

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

Merge uri-generic changes from release 4 into release 3

File size: 33.3 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)    (and (char? c) (char-set-contains? char-set:hex-digit c)))
148
149(define (reserved-char? c)    (and (char? c) (char-set-contains? char-set:reserved c)))
150
151(define (unreserved-char? c)  (and (char? c) (char-set-contains? char-set:unreserved c)))
152
153(define (scheme-char? c)      (and (char? c) (char-set-contains? char-set:scheme c)))
154
155(define (ipv-future-char? c)  (and (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 char-list #!optional (char-set char-set:unreserved))
246  (define (hex-digit i)
247    (and (>= i 0) (< i 16) (car (string->list (sprintf "~X" i)))))
248  (reverse (fold (lambda (c cl)
249                   (if (char-set-contains? char-set c)
250                       (let* ((x (char->integer c))
251                              (h1 (hex-digit (quotient x 16)))
252                              (h2 (hex-digit (remainder x 16))))
253                         (cons `(#\% ,h1 ,h2) cl))
254                       (cons c cl)))
255                 (list) char-list)))
256
257;; Inverse operation: 'pct-decode' a sequence of octets.
258
259(define (pct-decode char-list #!optional (char-set char-set:unreserved))
260  (define (octet-decode h1 h2)
261    (string->number (list->string (list h1 h2)) 16))
262  (map (lambda (c)
263        (match c
264               ((#\% h1 h2) (let ((dc (integer->char (octet-decode h1 h2))))
265                              (if (char-set-contains? char-set dc) dc c)))
266               (else c)))
267       char-list))
268
269
270;; RFC3986, section 2.2
271;;
272;; Reserved characters.
273;;
274
275(define char-set:gen-delims (string->char-set ":/?#[]@"))
276(define char-set:sub-delims (string->char-set "!$&'()*+,;="))
277
278(define char-set:reserved (char-set-union char-set:gen-delims char-set:sub-delims))
279
280;;  RFC3986, section 2.3
281;;
282;;  "Unreserved" characters.
283;;
284
285(define char-set:unreserved 
286  (char-set-union char-set:letter+digit (string->char-set "-_.~")))
287
288
289
290;;  RFC3986, section 3
291;;
292;;   URI         = scheme ":" hier-part [ "?" query ] [ "#" fragment ]
293;;
294;;   hier-part   = "//" authority path-abempty
295;;               / path-abs
296;;               / path-rootless
297;;               / path-empty
298
299(define (uri s)
300  (let ((s (if (string? s) (uri-string->normalized-char-list s) s)))
301    (match (scheme s)
302           ((us rst)
303            (match-let* (((ua up rst)   (hier-part rst))
304                         ((uq rst)      (match rst ((#\? . rst) (query rst))
305                                               (else (list #f rst))))
306                         ((uf rst)      (match rst ((#\# . rst) (fragment rst))
307                                               (else (list #f rst)))))
308                        (make-URI scheme: (string->symbol (list->string us)) authority: ua 
309                                  path: (uri-path-list->path up) query: (and uq (uri-char-list->string uq))
310                                  fragment: (and uf (uri-char-list->string uf)))))
311         (else #f))))
312
313(define (uri-path-list->path pcl)
314  (let ((cs (char-set-union char-set:unreserved (char-set #\/))))
315    (match pcl
316           (('/ . rst) (cons '/ (map (compose uri-char-list->string (cute pct-decode <> cs)) rst)))
317           (else (map (compose uri-char-list->string (cute pct-decode <> cs)) pcl)))))
318
319(define (hier-part s)
320  (match s ((#\/ #\/ . rst) 
321            (match-let* (((ua rst)  (authority rst))
322                         ((up rst)  (path-abempty rst)))
323                        (list ua up rst)))
324         (else (match-let (((up rst) (or (path-abs s) (path-rootless s) (list '() s))))
325                          (list #f up rst)))))
326
327;;  RFC3986, section 3.1
328
329(define scheme0 (many scheme-char?))
330(define (scheme s)
331  (match (scheme0 s)
332         ((ss (#\: . rst))  (list ss rst))
333         (else #f)))
334
335(define char-set:scheme
336  (char-set-union char-set:letter+digit (string->char-set "+-.")))
337
338
339;;  RFC3986, section 3.2
340
341(define (authority s)
342  (match-let* (((uu uw rst)   (or (userinfo s) (list #f #f s)))
343               ((uh rst)      (host rst))
344               ((up rst)      (or (port rst) (list #f rst))))
345              (list (make-URIAuth username: (and uu (uri-char-list->string uu)) 
346                                  password: (and uw (uri-char-list->string uw))
347                                  host: (uri-char-list->string uh) 
348                                  port: (and (pair? up) (string->number (list->string up))))
349                    rst)))
350
351;;  RFC3986, section 3.2.1
352
353(define userinfo0  (many (uchar ";&=+$,")))
354
355(define (userinfo s)
356  (match (userinfo0 s)
357         ((uu ( #\: . rst))   (match (userinfo0 rst)
358                                     ((up ( #\@ . rst) ) (list uu up rst))
359                                     (else #f)))
360         ((uu ( #\@ . rst)) (list uu (list) rst))
361         (else #f)))
362
363
364
365;;  RFC3986, section 3.2.2
366
367(define (host s)  (or (ip-literal s) (ipv4-address s) (reg-name s)))
368
369(define (ip-literal s)
370  (match s ((#\[ . rst) 
371            (match (or (ipv6-address rst) (ipv-future rst))
372                   ((ua (#\] . rst))  (list ua rst))
373                   (else (error 'ip-literal "malformed ip literal" (try-ip-literal->string rst)))))
374         (else #f)))
375
376(define ipv-future0  (many ipv-future-char?))
377
378(define (ipv-future s)
379  (match s ((#\v (? hexdigit-char?) #\. . rst)  (ipv-future0 rst))
380         (else #f)))
381
382(define char-set:ipv-future 
383  (char-set-union char-set:unreserved char-set:sub-delims (char-set #\;)))
384
385
386
387;; Pv6address =                            6( h16 ":" ) ls32
388;;                   /                       "::" 5( h16 ":" ) ls32
389;;                   / [               h16 ] "::" 4( h16 ":" ) ls32
390;;                   / [ *1( h16 ":" ) h16 ] "::" 3( h16 ":" ) ls32
391;;                   / [ *2( h16 ":" ) h16 ] "::" 2( h16 ":" ) ls32
392;;                   / [ *3( h16 ":" ) h16 ] "::"    h16 ":"   ls32
393;;                   / [ *4( h16 ":" ) h16 ] "::"              ls32
394;;                   / [ *5( h16 ":" ) h16 ] "::"              h16
395;;                   / [ *6( h16 ":" ) h16 ] "::"
396
397;;       ls32        = ( h16 ":" h16 ) / IPv4address
398;;                   ; least-significant 32 bits of address
399
400;;       h16         = 1*4HEXDIG
401;;                   ; 16 bits of address represented in hexadecimal
402
403
404(define (ipv6-address s)
405  (or (match (u6-h4c s) ;; 6( h16 ":" ) ls32
406
407             ((a2 rst)  (match (ls32 rst)
408                               ((a3 rst)  (list (append (concatenate a2) a3) rst))
409                               (else #f)))
410             (else #f))
411      (match s          ;; "::" 5( h16 ":" ) ls32
412             ((#\: #\: . rst) 
413              (match (u5-h4c rst)
414                     ((a2 rst)  (match (ls32 rst)
415                                       ((a3 rst)  (list (append (list #\: #\:) (concatenate a2) a3) rst))
416                                       (else #f)))))
417             (else #f))
418      (match (u_opt_n_h4c_h4 0 s)
419             ((a1 rst) (match rst
420                              ((#\: #\: . rst) 
421                               (match (u4-h4c rst)
422                                      ((a2 rst)  (match (ls32 rst)
423                                                        ((a3 rst) 
424                                                         (list (append (concatenate a1) (list #\: #\:) 
425                                                                       (concatenate a2) a3) rst))
426                                                        (else #f)))
427                                      (else #f)
428                                      ))
429                              (else #f)))
430              (else #f))
431      (match (u_opt_n_h4c_h4 1 s)
432             ((a1 rst) 
433                      (match rst       
434                              ((#\: #\: . rst) 
435                               (match (u3-h4c rst)
436                                      ((a2 rst)  (match (ls32 rst)
437                                                        ((a3 rst) 
438                                                         (list (append (concatenate a1) (list #\: #\:) 
439                                                                       (concatenate a2) a3) rst))
440                                                        (else #f)))
441                                      (else #f)
442                                      ))
443                              (else #f)))
444              (else #f))
445      (match (u_opt_n_h4c_h4 2 s)
446             ((a1 rst) (match rst       
447                              ((#\: #\: . rst) 
448                               (match (u2-h4c rst)
449                                      ((a2 rst)  (match (ls32 rst)
450                                                        ((a3 rst)  (list (append (concatenate a1) (list #\: #\:) 
451                                                                                 (concatenate a2) a3) rst))
452                                                        (else #f)))
453                                      (else #f)
454                                      ))
455                              (else #f)))
456              (else #f))
457      (match (u_opt_n_h4c_h4 3 s)
458             ((a1 rst) (match rst       
459                              ((#\: #\: . rst) 
460                               (match (h4c rst)
461                                      ((a2 rst)  (match (ls32 rst)
462                                                        ((a3 rst)  (list (append (concatenate a1) (list #\: #\:) 
463                                                                                 (concatenate a2) a3) rst))
464                                                        (else #f)))
465                                      (else #f)
466                                      ))
467                              (else #f)))
468              (else #f))
469      (match (u_opt_n_h4c_h4 4 s)
470             ((a1 rst) (match rst       
471                              ((#\: #\: . rst) 
472                               (match (ls32 rst)
473                                      ((a3 rst)  (list (append (concatenate a1) (list #\: #\:) a3) rst))
474                                      (else #f)))
475                              (else #f)))
476              (else #f))
477      (match (u_opt_n_h4c_h4 5 s)
478             ((a1 rst) (match rst       
479                              ((#\: #\: . rst) 
480                               (match (h4 rst)
481                                      ((a3 rst)  (list (append (concatenate a1) (list #\: #\:) a3) rst))
482                                      (else #f)))
483                              (else #f)))
484              (else #f))
485      (match (u_opt_n_h4c_h4 6 s)
486             ((a1 rst) (match rst       
487                              ((#\: #\: . rst) 
488                               (list (append (concatenate a1) (list #\: #\:)) rst))
489                              (else #f)))
490              (else #f))
491      (error 'ipv6-address "malformed ipv6 address" (try-ip-literal->string s))))
492
493
494
495(define (u_opt_n_h4c_h4 n s)
496  (match ((consume-min-max 0 n h4c) s)
497         ((a1 rst)  (match (h4 rst)
498                           ((a2 rst) (list (append a1 (list a2)) rst))
499                           (else #f)))
500         (else #f)))
501
502(define (ls32 s)
503  (match (h4c s)
504         ((a1 rst) (match (h4 rst)
505                          ((a2 rst)  (list (append a1 a2) rst))
506                          (else (ipv4-address s))))
507         (else (ipv4-address s))))
508
509(define (h4c s)
510  (match (h4 s)
511         ((a1 (#\: (and r1 (not #\:)) . rst))
512          (list (append a1 (list #\:)) (cons r1 rst)))
513         (else #f)))
514
515(define u6-h4c (consume-count 6 h4c))
516(define u5-h4c (consume-count 5 h4c))
517(define u4-h4c (consume-count 4 h4c))
518(define u3-h4c (consume-count 3 h4c))
519(define u2-h4c (consume-count 2 h4c))
520
521(define h4 (count-min-max 1 4 hexdigit-char?))
522
523(define (ipv4-address s)
524  (match (dec-octet s)
525         ((a1 (#\. rst)) 
526          (match (dec-octet rst)
527                 ((a2 (#\. rst)) 
528                  (match (dec-octet rst)
529                         ((a3 (#\. rst)) 
530                          (match (dec-octet rst)
531                                 ((a4 rst)  (list (append a1 #\. a2 #\. a3 #\. a4) rst))
532                                 (else #f)))
533                         (else #f)))
534                 (else #f)))
535         (else #f)))
536
537(define (ipv4-octet? lst)
538  (and (every (lambda (x) (char-set-contains? char-set:digit x)) lst)
539       (let ((num (string->number (list->string lst))))
540         (and num (>= num 0) (<= num 255)))))
541
542(define (dec-octet s)
543  (match ((count-min-max 1 3 char-numeric?) s)
544         (((and a1 (? ipv4-octet?)) rst)  (list a1 rst))
545         (else #f)))
546
547(define reg-name
548  (count-min-max 0 255 (lambda (c) (or (pct-encoded? c) 
549                                       (unreserved-char? c) 
550                                       (char-set-contains? char-set:sub-delims c) ))))
551
552;;  RFC3986, section 3.2.3
553
554(define port0 (many char-numeric?))
555
556(define (port s)
557  (match s ((#\: . rst)  (port0 rst))
558         (else #f)))
559
560
561;;
562;;  RFC3986, section 3.3
563;;
564;;   path          = path-abempty    ; begins with "/" or is empty
565;;                 / path-abs        ; begins with "/" but not "//"
566;;                 / path-noscheme   ; begins with a non-colon segment
567;;                 / path-rootless   ; begins with a segment
568;;                 / path-empty      ; zero characters
569;;
570;;   path-abempty  = *( "/" segment )
571;;   path-abs      = "/" [ segment-nz *( "/" segment ) ]
572;;   path-noscheme = segment-nzc *( "/" segment )
573;;   path-rootless = segment-nz *( "/" segment )
574;;   path-empty    = 0<pchar>
575;;
576;;   segment       = *pchar
577;;   segment-nz    = 1*pchar
578;;   segment-nzc   = 1*( unreserved / pct-encoded / sub-delims / "@" )
579;;
580;;   pchar         = unreserved / pct-encoded / sub-delims / ":" / "@"
581
582(define (path s)
583  (or (path-abempty s)  (path-abs s) (path-noscheme s) 
584      (path-rootless s) (list (list) s)))
585
586 
587(define (slash-segment s)
588  (match s
589         ((#\/ . rst)
590          (or (slash-segment rst)
591              (match (segment rst)
592                     ((ss rst)  (list ss rst))
593                     (else #f))))
594         (else  #f)))
595
596(define pchar (uchar ":@"))
597
598(define segment (many pchar))
599
600(define segment-nz (many1 pchar))
601
602(define segment-nzc (many1 (uchar "@")))
603
604(define (path-abempty s)
605  (match ((consume slash-segment) s)
606         ((() rst) (list (list) rst))
607         ((path rst) (list (cons '/ path) rst))))
608
609(define (path-abs s)
610  (match s
611         ((#\/)          (list (list '/ (list))  (list)))
612         ((#\/ . rst)    (match (path-rootless rst)
613                                ((lst rst) (list (cons '/ lst) rst))
614                                (else #f)))
615         (else #f)))
616
617(define (path-noscheme s)
618  (match (segment-nzc s)
619         ((s1 rst)  (match ((consume slash-segment) rst)
620                           ((ss rst) (list (cons s1 ss) rst))))
621         (else #f)))
622
623(define (path-rootless s)
624  (match (segment-nz s)
625         ((s1 rst)  (match ((consume slash-segment) rst)
626                           ((ss rst) (list (cons s1 ss) rst))))
627         (else #f)))
628
629;;  RFC3986, section 3.4
630;;
631;;   query         = *( pchar / "/" / "?" )
632
633(define query0  (many (uchar ":@/?")))
634(define (query s)
635  (match (query0 s)
636         ((ss rst)  (list ss rst))
637         (else #f)))
638
639;;  RFC3986, section 3.5
640;;   fragment         = *( pchar / "/" / "?" )
641
642(define fragment0  (many (uchar ":@/?")))
643(define (fragment s)
644  (match (fragment0 s)
645         ((ss rst)  (list ss rst))
646         (else #f)))
647
648;;  Reference, Relative and Absolute URI forms
649;;
650;;  RFC3986, section 4.1
651
652(define (uri-reference s)
653  (let ((s (if (string? s) (uri-string->normalized-char-list s) s)))
654    (or (uri s) (relative-ref s))))
655
656;;  RFC3986, section 4.2
657;;
658;;   relative-URI  = relative-part [ "?" query ] [ "#" fragment ]
659;;
660;;   relative-part = "//" authority path-abempty
661;;                 / path-abs
662;;                 / path-noscheme
663;;                 / path-empty
664
665(define (relative-ref s)
666  (and (not (scheme s))
667       (match-let* (((ua up rst)  (relative-part s))
668                    ((uq rst)     (match rst ((#\? . rst) (query rst))
669                                         (else (list #f rst))))
670                    ((uf rst)     (match rst ((#\# . rst) (fragment rst))
671                                         (else (list #f rst)))))
672                   (make-URI scheme: #f authority: ua path: (uri-path-list->path up) 
673                             query: (and uq (uri-char-list->string uq))
674                             fragment: (and uf (uri-char-list->string uf))))))
675
676(define (relative-part s)
677  (match s
678         ((#\/ #\/ . rst)
679          (match-let* (((ua rst)  (authority rst))
680                       ((up rst)  (path-abempty rst)))
681                      (list ua up rst)))
682         (else (match-let* (((up rst)  (or (path-abs s) (path-noscheme s) (list (list) s))))
683                           (list #f up rst))))) 
684
685
686
687;;  RFC3986, section 4.3
688
689(define (absolute-uri s)
690  (let ((s (if (string? s) (uri-string->normalized-char-list s) s)))
691    (match (scheme s)
692           ((us rst) 
693            (match-let* (((ua up rst)  (hier-part rst))
694                         ((uq rst)     (match rst ((#\? . rst)  (query rst))
695                                              (else (list #f rst)))))
696                        (make-URI scheme: (string->symbol (list->string us)) authority: ua 
697                                  path: (uri-path-list->path up) query: (and uq (uri-char-list->string uq))
698                                  fragment: #f)))
699           (error 'absolute-uri "no scheme found in URI string"))))
700                     
701
702;; Turns a URI into a string.
703;;
704;; Uses a supplied function to map the userinfo part of the URI.
705;;
706
707(define (uri->string uri . rest)
708   (let-optionals rest ((userinfomap (lambda (u pw) (string-append u ":******" ))))
709    (match uri
710           (($ URI scheme authority path query fragment)
711            (string-append
712             ((lambda (x) (or (and x (string-append (->string x) ":")) ""))  scheme)
713             (if authority
714                 (string-append (uri-auth->string authority userinfomap))
715                 "")
716             (path->string path)
717             (if query (string-append "?" query) "")
718             (if fragment (string-append  "#" fragment) "")))
719           (else #f))))
720
721(define (uri-auth->string uri-auth userinfomap)
722  (match uri-auth
723         (($ URIAuth username password host port)
724          (string-append "//" (if (and username password)
725                                  ((lambda (x) (or (and x (string-append x "@")) ""))
726                                   (userinfomap username password)) "")
727                         host ((lambda (x) (or (and x (string-append ":" (->string x))) ""))
728                               port)))
729         (else #f)))
730                         
731(define (path->string path)
732  (match path
733         (('/ . segments)     (string-append "/" (join-segments segments)))
734         (((? protect?) . _)  (join-segments (cons "." path)))
735         (else                (join-segments path))))
736
737(define (join-segments segments)
738  (string-intersperse
739   (map (lambda (segment)
740          (string-translate* segment '(("/" . "%2F"))))
741        segments) "/"))
742
743;; Section 4.2; if the first segment contains a colon, it must be prefixed "./"
744(define (protect? sa) (string-index sa #\:))
745
746; specific: ((uri-authority uri) (uri-path uri) (uri-query uri)).
747
748(define (uri->list uri . rest)
749  (let-optionals rest ((userinfomap (lambda (u pw) (string-append u ":******" ))))
750    (match uri
751           (($ URI scheme authority path query fragment)
752            `(,scheme (,(uri-auth->list authority userinfomap) ,path ,query) ,fragment))
753           (else #f))))
754
755(define (uri-auth->list uri-auth userinfomap)
756  (match uri-auth
757         (($ URIAuth username password regname port)
758          `(,(if (and username password) (userinfomap username password) #f) ,regname ,port ))
759         (else #f)))
760                         
761
762;;  Percent encoding and decoding
763
764(define (uri-encode-string str)
765  (let ((clst (string->list str)))
766    (uri-char-list->string
767     (pct-encode clst (char-set-union (char-set #\%) char-set:reserved)))))
768
769(define (uri-decode-string str)
770  (uri-char-list->string (pct-decode (uri-string->char-list str) char-set:full)))
771   
772(define (uri-string->normalized-char-list str)
773  (pct-decode (uri-string->char-list str)))
774
775
776;; Convert a URI character list to a string
777
778(define (uri-char-list->string s)
779  (list->string
780   (reverse
781    (fold (lambda (x ax)
782                  (cond ((char? x) (cons x ax))
783                        ((list? x) (append (reverse x) ax)))) (list) s))))
784   
785;; Convert a string to a URI character list
786
787(define (uri-string->char-list s)
788  (let loop ((cs (list)) (lst (string->list s)))
789    (if (null? lst) (reverse cs)
790        (match lst
791               ((#\% h1 h2 . rst)  (loop (cons (list #\% h1 h2) cs) rst))
792               (((and c (? char?)) . rst)  (loop (cons c cs) rst))))))
793   
794;;
795;;  Resolving a relative URI relative to a base URI
796;;
797;;  Returns a new URI which represents the value of the first URI
798;;  interpreted as relative to the second URI.
799;;
800;;  For example:
801;;
802;;  (uri->string (relative-to (uri-reference "foo") (uri "http://bar.org/")) )
803;;         => "http://bar.org/foo"
804;;
805;;  (uri->string (non-strict-relative-to (uri "http:foo") (uri "http://bar.org/")) )
806;;         => "http://bar.org/foo"
807;;
808;;  Algorithm from RFC3986, section 5.2.2
809;;
810
811(define (uri-relative-to ref base)
812  (and (uri? ref) (uri? base)
813       (cond ((uri-scheme ref)      (just-segments ref))
814             ((uri-authority ref)   (let ((x (just-segments ref)))
815                                      (URI-scheme-set! x (uri-scheme base))
816                                      x))
817
818             (((lambda (p) (and (not (null? p)) p))  (uri-path ref)) =>
819              (lambda (ref-path)
820                (if (and (pair? ref-path) (eq? '/ (car ref-path)))
821                    (let ((x (just-segments ref)))
822                      (URI-scheme-set! x (uri-scheme base))
823                      (URI-authority-set! x (uri-auth base))
824                      x)
825                    (let ((x (udup ref)))
826                      (URI-scheme-set! x (uri-scheme base))
827                      (URI-authority-set! x (uri-auth base))
828                      (URI-path-set! x (merge-paths base x))
829                      (just-segments x)))))
830             ((uri-query ref)       (let ((x (udup ref)))
831                                      (URI-scheme-set! x (uri-scheme base))
832                                      (URI-authority-set! x (uri-auth base))
833                                      (URI-path-set! x (list ""))
834                                      (URI-path-set! x (merge-paths base x))
835                                      (just-segments x)))
836
837             (else                  (let ((x (just-segments ref)))
838                                      (URI-scheme-set! x (uri-scheme base))
839                                      (URI-authority-set! x (uri-auth base))
840                                      (URI-path-set! x (uri-path base))
841                                      (URI-query-set! x (uri-query base))
842                                      x)))))
843
844(define (just-segments u)
845  (let ((p (remove-dot-segments (uri-path u))))
846    (make-URI scheme: (uri-scheme u) authority: (uri-auth u) path: p
847              query: (uri-query u) fragment: (uri-fragment u))))
848
849(define (merge0 pb pr)
850  (let* ((rpb  (reverse pb))
851         (pb1  (reverse (if (pair? rpb) (cdr rpb) rpb))))
852    (append pb1 pr)))
853
854(define (merge-paths b r)
855  (let ((ba (uri-authority b))
856        (pb (uri-path b))
857        (pr (uri-path r)))
858    (let ((mp  (if (and ba (null? pb)) pr (merge0 pb pr))))
859      mp)))
860
861(define (uri-non-strict-relative-to ref base)
862  (let ((rs (uri-scheme ref))
863        (rb (uri-scheme base)))
864    (let ((ref1 (make-URI scheme: (if (eq? rs rb) #f (uri-scheme ref))
865                          authority: (uri-auth ref) path: (uri-path ref)
866                          query: (uri-query ref) fragment: (uri-fragment ref))))
867      (uri-relative-to ref1 base))))
868
869
870;;  Remove dot segments, but protect leading '/' character
871
872(define (remove-dot-segments ps)
873  (match ps
874         (('/ . rst)   (cons '/ (elim-dots rst)))
875         (else         (elim-dots ps))))
876
877(define (elim-dots ps)
878  (let loop ((ps ps) (lst (list)))
879    (if (null? ps) (reverse lst)
880        (match ps
881               (("." . rst)
882                (loop rst (match lst
883                                 (("" dir . rest) lst)
884                                 ((file . rest) (cons "" lst))
885                                 (else (list "")))))
886               ((".." . rst)
887                (loop rst (match lst
888                                 (("" dir . rest) (cons "" rest))
889                                 ((file . rest) (cons "" rest))
890                                 (else (list "")))))
891               (("")
892                (loop (list) (match lst
893                                    (("" . rst2) lst)
894                                    (else (cons "" lst)))))
895               ((x . rst)
896                (loop rst (match lst
897                                 (("" . rst2) (cons x rst2))
898                                 (else (cons x lst)))))))))
899
900;;
901;; Finding a URI relative to a base URI
902;;
903;; Returns a new URI which represents the relative location of the
904;; first URI with respect to the second URI.  Thus, the values
905;; supplied are expected to be absolute URIs, and the result returned
906;; may be a relative URI.
907;;
908;; Example:
909;;
910;; (uri->string
911;;  (uri-relative-from (uri "http://example.com/Root/sub1/name2#frag")
912;;                     (uri "http://example.com/Root/sub2/name2#frag")))
913;;    ==> "../sub1/name2#frag"
914;;
915
916
917(define (uri-relative-from uabs base)
918  (cond ((ucdiff? uri-scheme uabs base)      (udup uabs))
919        ((ucdiff? uri-authority uabs base)   (let ((x (udup uabs)))
920                                               (URI-scheme-set! x #f)
921                                               x))
922        ;; Special case: no relative representation for http://a/ -> http://a
923        ;; ....unless that should be a path of ("..")
924        ((null? (uri-path uabs))             (let ((x (udup uabs)))
925                                               (URI-scheme-set! x #f)
926                                               x))
927        ((ucdiff? uri-path uabs base)       
928         (let ((x    (udup uabs))
929               (path (rel-path-from (remove-body-dot-segments (uri-path uabs))
930                                    (remove-body-dot-segments (uri-path base)))))
931           (URI-scheme-set! x #f)
932           (URI-authority-set! x #f)
933           (URI-path-set! x path)
934           x))
935        ((ucdiff? uri-query uabs base) 
936         (let ((x (udup uabs)))
937           (URI-scheme-set! x #f)
938           (URI-authority-set! x #f)
939           (URI-path-set! x (list))
940           x))
941        (else                            
942         (let ((x (udup uabs)))
943           (URI-scheme-set! x #f)
944           (URI-authority-set! x #f)
945           (URI-query-set! x #f)
946           (URI-path-set! x (list))
947           x))))
948
949
950(define (udup u)
951  (make-URI scheme: (uri-scheme u) authority: (uri-auth u) path: (uri-path u)
952            query: (uri-query u) fragment: (uri-fragment u)))
953
954(define (ucdiff? sel u1 u2)
955  (let ((s1 (sel u1))
956        (s2 (sel u2)))
957    (not (cond ((and (URIAuth? s1) (URIAuth? s2))
958                (not (or (ucdiff? uri-username u1 u2) (ucdiff? uri-host u1 u2) (ucdiff? uri-port u1 u2))))
959               ((and (list? s1) (list? s2))       (every equal? s1 s2))
960               ((and (string? s1) (string? s2))   (string=? s1 s2))
961               (else                              (eq? s1 s2))))))
962
963(define (remove-body-dot-segments p)
964  (or (and (pair? p)
965           (let ((r (reverse p)))
966             (reverse (cons (car r) (remove-dot-segments (cdr r))))))
967      p))
968
969(define (rel-path-from pabs base)
970  (match (list pabs base)
971         ((pabs ()) pabs)
972         ((() base) (list))
973         ;; Construct a relative path segment if the paths share a
974         ;; leading segment other than a leading '/'
975         ((('/ . (and sa1 (ra1 . ra2))) ('/ . (and sb1 (rb1 . rb2))))
976          (make-rel-path
977           (if (string=? ra1 rb1)
978               (rel-path-from1 sa1 sb1)
979               pabs)))
980         (else (error 'rel-path-from "Both URI paths must be absolute" pabs base))))
981
982(define (make-rel-path x)
983  (match x
984         ((or ('/ . rst) ("." . rst) (".." rst)) x)
985         (else (cons "." x))))
986
987;;  rel-path-from1 strips off trailing names from the supplied paths,
988
989(define (rel-path-from1 pabs base)
990  (match-let* (((na . sa)  (reverse pabs)) 
991               ((nb . sb)  (reverse base)))
992     (let ((rp (rel-segs-from (reverse sa) (reverse sb))))
993       (if (null? rp)  (cond ((string=? na nb)  (list))
994                             (else              (list na)))
995           (append rp (list na))))))
996
997                         
998;;  rel-segs-from discards any common leading segments from both paths,
999;;  then invokes dif-segs-from to calculate a relative path from the end
1000;;  of the base path to the end of the target path.  The final name is
1001;;  handled separately, so this deals only with "directory" segments.
1002
1003(define (rel-segs-from sabs base)
1004  (cond ((and (null? sabs) (null? base))  (list))
1005        ((or (null? sabs) (null? base))   (dif-segs-from sabs base))
1006        (else (match-let (((sa1 . ra1) sabs)
1007                          ((sb1 . rb1) base))
1008                         (if (string=? sa1 sb1)
1009                             (rel-segs-from ra1 rb1)
1010                             (dif-segs-from sabs base))))))
1011
1012;;  dif-segs-from calculates a path difference from base to target,
1013;;  not including the final name at the end of the path (i.e. results
1014;;  always ends with '/')
1015;;
1016;;  This function operates under the invariant that the supplied value
1017;;  of sabs is the desired path relative to the beginning of base.
1018;;  Thus, when base is empty, the desired path has been found.
1019
1020(define (dif-segs-from sabs base)
1021  (if (null? base) sabs (dif-segs-from (cons ".." sabs)  (cdr base))))
1022
1023
1024
1025;; Other normalization functions
1026;;
1027;; Case normalization; cf. RFC3986 section 6.2.2.1
1028
1029(define (uri-normalize-case uri)
1030  (let* ((normalized-uri (uri-reference (normalize-pct-encoding (uri->string uri (lambda (user pass) (conc user ":" pass))))))
1031         (scheme         (string->symbol (string-downcase (->string (uri-scheme uri)))))
1032         (host           (normalize-pct-encoding (string-downcase (uri-host uri)))))
1033    (update-uri normalized-uri scheme: scheme host: host)))
1034
1035(define (normalize-pct-encoding str)
1036  (uri-char-list->string
1037   (map (lambda (c) (match c
1038                           ((#\% h1 h2)  `(#\% ,(char-upcase h1) ,(char-upcase h2)))
1039                           (else c)))
1040        (uri-string->normalized-char-list str))))
1041
1042;;  Path segment normalization; cf. RFC3986 section 6.2.2.4
1043
1044(define (uri-normalize-path-segments uri)
1045  (let ((u1      (udup uri))
1046        (path    (remove-dot-segments (uri-path uri))))
1047    (URI-path-set! u1 path)
1048    u1))
Note: See TracBrowser for help on using the repository browser.