#!/usr/bin/env guile \ -e main -s !# ;; Minimal web server can be started from command line. Current example routes: ;; ;; localhost:8080/ ;; (use-modules (json) (ice-9 match) (ice-9 format) (ice-9 iconv) (ice-9 receive) (srfi srfi-1) (srfi srfi-26) (web http) (web client) (web request) (web response) (web uri) (fibers web server)) (define get-version "2.0") (define (base-url) "https://genenetwork.org") (define (prefix) "Build the API URL including version" (string-append (base-url) "/api/" get-version)) (define (mk-url postfix) "Add the path to the API URL" (string-append (prefix) "/" postfix)) (define (mk-doc postfix) "Create a pointer to HTML documentation" (string-append (base-url) "/" postfix ".html")) (define (meta url) "Adds /meta to the URL" (string-append url "/meta")) (define info `( ("name" . "GeneNetwork REST API") ("version" . ,get-version) ("comment" . "This is the official REST API for the GeneNetwork service hosted at https://genenetwork.org/") ("license" . (("source code" . "AGPL"))) ("note" . "work in progress (WIP)") ("see also". ,(meta (prefix))) )) (define info-meta `( ("doc" . ,(mk-doc "info")) ("API" . ((,(mk-url "species")."Get a list of all species") (,(mk-url "mouse")."Get information on mouse") (,(mk-url "datasets")."Get a list of datasets"))))) (define (sparql-scm query) (json-string->scm (bytevector->string (receive (response-status response-body) (http-request (string-append "https://sparql.genenetwork.org/sparql?default-graph-uri=&query=" (uri-encode query) "&format=application%2Fsparql-results%2Bjson")) response-body) "UTF-8" ))) (define (sparql-exec query) (sparql-scm query)) (define (sparql-results query) (cdr (assoc "bindings" (cdr (assoc "results" (sparql-exec query) ))))) (define (sparql-species) (sparql-results " PREFIX gn: PREFIX rdf: SELECT DISTINCT ?species WHERE { ?species rdf:type gn:species . }" )) (define (get-species-uris) (map (lambda (m) (cdr (assoc "value"(cdr (car m))))) (array->list (sparql-species))) ) (define (sparql-species-meta) (sparql-results " PREFIX gn: PREFIX rdf: SELECT DISTINCT ?species ?p ?o WHERE { ?species rdf:type gn:species . ?species ?p ?o . }" )) (define (get-species-all) (sparql-species-meta)) (define (triples) (array->list (get-species-all))) ;; from the triples first harvest the species URIs, followed by creating records of information (define (get-species-api-str) (scm->json-string #("https://genenetwork.org/api/v2/mouse/" "https://genenetwork.org/api/v2/rat/"))) ;; ---- REST API web server handler (define (not-found request) (values (build-response #:code 404) (string-append "Resource not found: " (uri->string (request-uri request))))) (define (render-json json) (list '((content-type . (application/json))) (lambda (port) (scm->json json port)))) (define (controller request body) (match-lambda (('GET) (render-json info)) (('GET "meta") (render-json info-meta)) (('GET "version") (render-json get-version)) (('GET "species") (render-json (get-species))) (('GET "species-all") (render-json (triples))) )) (define (request-path-components request) (split-and-decode-uri-path (uri-path (request-uri request)))) (define (handler request body) (format #t "~a ~a\n" (request-method request) (uri-path (request-uri request))) (apply values ((controller request body) (cons (request-method request) (request-path-components request))))) (define (start-web-server address port) (format (current-error-port) "GN REST API web server listening on http://~a:~a/~%" address port) ;; Wrap handler in another function to support live hacking via the ;; REPL. If handler is passed as is and is then redefined via the ;; REPL, the web server will still be using the old handler. The ;; only way to update the handler reference held by the web server ;; would be to restart the web server. (run-server (cut handler <> <>) #:addr (inet-pton AF_INET address) #:port port)) (define (main args) (write (string-append "Starting Guile REST API " get-version " server!")) (write args) (newline) (let ((listen (inexact->exact (string->number (car (cdr args)))))) (display `("listening on" ,listen)) ;; (write listen) ;; (run-server hello-world-handler 'http `(#:port ,listen)))) (start-web-server "127.0.0.1" listen)))