spork/http/read-request

    function
    /usr/local/lib/janet/spork/http.janet on line 97, column 1

    (read-request conn buf &opt no-query)

    Read an HTTP request header from a connection. Returns a table with 
    the following keys:

    * `:headers` - table mapping header names to header values. Header 
      names are lowercase.
    * `:connection` - the connection stream for the header.
    * `:buffer` - the buffer instance that may contain extra bytes.
    * `:head-size` - the number of bytes used by the header.
    * `:method` - the HTTP method used.
    * `:path` - the path of the resource requested.

    The following keys are also present, but omitted if the user passes 
    a truthy parameter to `no-query`.

    * `:route` - path of the resource requested without query string.
    * `:query-string` - segment of HTTP path after first ? character.
    * `:query` - the query string parsed into a table. Supports a 
      single string value for every string key, and any query 
      parameters that aren't given a value are mapped to true.

    Note that data is read in chunks and any data after the header 
    terminator is stored in `:buffer`.