main.rkt
#lang racket/base
;
; Redis interface.
;

; Our dependencies.
(require racket/contract
         racket/match
         racket/tcp)

; Redis server specification.
(define-struct/contract
  redis-server ((in input-port?)
                (out output-port?)))

; Our exceptions.
(define-struct (exn:redis exn) ())

; Export our functions.
(provide redis-server?
         redis-connect
         redis-query
         redis-reply/c
         redis-disconnect!
         exn:redis?)


; Connects to specified Redis server.
(define/contract (redis-connect #:host (host "localhost")
                                #:port (port 6379))
                 (->* ()
                      (#:host string?
                       #:port (integer-in 1 65535))
                      redis-server?)
  (let-values (((in out) (tcp-connect host port)))
    (make-redis-server in out)))


; Disconnects from the the specified Redis server.
(define/contract (redis-disconnect! server)
                 (-> redis-server? void?)
  (void (begin (close-input-port (redis-server-in server))
               (close-output-port (redis-server-out server)))))


; Null character contract.
(define (null-char? value)
  (and (char? value)
       (char=? value #\null)))


; Contract for redis replies.
(define redis-reply/c (or/c integer?
                            bytes?
                            string?
                            null-char?
                            (listof (or/c integer?
                                          bytes?
                                          string?
                                          null-char?))))


; Reads Redis reply from input port.
(define/contract (read-reply in)
                 (-> input-port? redis-reply/c)
  (let ((b (read-bytes 1 in)))
    (match b
      (#"+" (bytes->string/utf-8 (read-bytes-line in 'return-linefeed)))
      (#"-" (raise (make-exn:redis (bytes->string/utf-8
                                     (read-bytes-line in 'return-linefeed))
                                   (current-continuation-marks))))
      (#":" (string->number (read-line in 'return-linefeed)))
      (#"$" (read-bulk-reply in))
      (#"*" (read-multi-bulk-reply in))
      (_ (raise (make-exn:redis
                  (format "unexpected server response: ~a" b)))))))


; Reads the stuff right after '*' that starts multi-bulk reply.
(define/contract (read-multi-bulk-reply in)
                 (-> input-port? redis-reply/c)
  (let ((nitems (string->number (read-line in 'return-linefeed))))
    (if (= -1 nitems)
      #\null
      (for/list ((i (in-range 0 nitems)))
        (read-reply in)))))


; Reads the stuff right after '$' that starts bulk reply.
(define/contract (read-bulk-reply in)
                 (-> input-port? redis-reply/c)
  (let ((nbytes (string->number (read-line in 'return-linefeed))))
    (if (= -1 nbytes)
      #\null
      (begin0
        (read-bytes nbytes in)
        (read-bytes-line in 'return-linefeed)))))


; Formats request as chunk of bytes.
(define/contract (format-request command args)
                 (-> (or/c string? bytes? symbol?)
                     (listof (or/c string? bytes? symbol? integer?))
                     bytes?)
  (bytes-append #"*"
                (string->bytes/utf-8 (number->string (+ 1 (length args))))
                #"\r\n"
                (format-value command)
                (apply bytes-append (map format-value args))))


; Formats given value as a byte sequence.
(define/contract (format-value value)
                 (-> (or/c string? bytes? symbol? integer?) bytes?)
  (cond
    ; Convert symbols to strings and strings to byte strings.
    ((symbol? value)
     (let ((bs (string->bytes/utf-8 (symbol->string value))))
       (bytes-append #"$"
                     (string->bytes/utf-8 (number->string (bytes-length bs)))
                     #"\r\n" bs #"\r\n")))

    ; Convert strings to byte strings.
    ((string? value)
     (let ((bs (string->bytes/utf-8 value)))
       (bytes-append #"$"
                     (string->bytes/utf-8 (number->string (bytes-length bs)))
                     #"\r\n" bs #"\r\n")))

    ; Use byte strings as they are.
    ((bytes? value)
     (bytes-append #"$"
                   (string->bytes/utf-8 (number->string (bytes-length value)))
                   #"\r\n" value #"\r\n"))

    ; Integers are converted to strings as well.
    ((integer? value)
     (let ((bs (string->bytes/utf-8 (number->string value))))
       (bytes-append #"$"
                     (string->bytes/utf-8 (number->string (bytes-length bs)))
                     #"\r\n" bs #"\r\n")))))


; Performs specified Redis command.
; No checks are done, so you better be right. ;-)
(define/contract (redis-query server command . args)
                 (->* (redis-server?
                       (or/c string? bytes? symbol?))
                      ()
                      #:rest (listof (or/c string? bytes? symbol? integer?))
                      redis-reply/c)
  (write-bytes (format-request command args) (redis-server-out server))
  (flush-output (redis-server-out server))
  (read-reply (redis-server-in server)))


; vim:set ts=2 sw=2 et: