This module implements helper procs for CGI applications. Example:
import strtabs, cgi # Fill the values when debugging: when debug: setTestData("name", "Klaus", "password", "123456") # read the data into `myData` var myData = readData() # check that the data's variable names are "name" or "password" validateData(myData, "name", "password") # start generating content: writeContentType() # generate content: write(stdout, "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01//EN\">\n") write(stdout, "<html><head><title>Test</title></head><body>\n") writeLine(stdout, "your name: " & myData["name"]) writeLine(stdout, "your password: " & myData["password"]) writeLine(stdout, "</body></html>")
Procs
proc encodeUrl(s: string): string {.raises: [], tags: [].}
- Encodes a value to be HTTP safe: This means that characters in the set {'A'..'Z', 'a'..'z', '0'..'9', '_'} are carried over to the result, a space is converted to '+' and every other character is encoded as '%xx' where xx denotes its hexadecimal value. Source
proc decodeUrl(s: string): string {.raises: [], tags: [].}
- Decodes a value from its HTTP representation: This means that a '+' is converted to a space, '%xx' (where xx denotes a hexadecimal value) is converted to the character with ordinal number xx, and and every other character is carried over. Source
proc xmlEncode(s: string): string {.raises: [], tags: [].}
-
Encodes a value to be XML safe:
- " is replaced by "
- < is replaced by <
- > is replaced by >
- & is replaced by &
- every other character is carried over.
proc cgiError(msg: string) {.noreturn, raises: [CgiError], tags: [].}
- raises an ECgi exception with message msg. Source
proc readData(allowedMethods: set[RequestMethod] = {methodNone, methodPost, methodGet}): StringTableRef {. raises: [CgiError, OverflowError, ValueError], tags: [ReadEnvEffect, ReadIOEffect].}
- Read CGI data. If the client does not use a method listed in the allowedMethods set, an ECgi exception is raised. Source
proc validateData(data: StringTableRef; validKeys: varargs[string]) {. raises: [CgiError], tags: [].}
- validates data; raises ECgi if this fails. This checks that each variable name of the CGI data occurs in the validKeys array. Source
proc getContentLength(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the CONTENT_LENGTH environment variable Source
proc getContentType(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the CONTENT_TYPE environment variable Source
proc getDocumentRoot(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the DOCUMENT_ROOT environment variable Source
proc getGatewayInterface(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the GATEWAY_INTERFACE environment variable Source
proc getHttpAccept(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the HTTP_ACCEPT environment variable Source
proc getHttpAcceptCharset(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the HTTP_ACCEPT_CHARSET environment variable Source
proc getHttpAcceptEncoding(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the HTTP_ACCEPT_ENCODING environment variable Source
proc getHttpAcceptLanguage(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the HTTP_ACCEPT_LANGUAGE environment variable Source
proc getHttpConnection(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the HTTP_CONNECTION environment variable Source
proc getHttpCookie(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the HTTP_COOKIE environment variable Source
proc getHttpHost(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the HTTP_HOST environment variable Source
proc getHttpReferer(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the HTTP_REFERER environment variable Source
proc getHttpUserAgent(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the HTTP_USER_AGENT environment variable Source
proc getPathInfo(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the PATH_INFO environment variable Source
proc getPathTranslated(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the PATH_TRANSLATED environment variable Source
proc getQueryString(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the QUERY_STRING environment variable Source
proc getRemoteAddr(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the REMOTE_ADDR environment variable Source
proc getRemoteHost(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the REMOTE_HOST environment variable Source
proc getRemoteIdent(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the REMOTE_IDENT environment variable Source
proc getRemotePort(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the REMOTE_PORT environment variable Source
proc getRemoteUser(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the REMOTE_USER environment variable Source
proc getRequestMethod(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the REQUEST_METHOD environment variable Source
proc getRequestURI(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the REQUEST_URI environment variable Source
proc getScriptFilename(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the SCRIPT_FILENAME environment variable Source
proc getScriptName(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the SCRIPT_NAME environment variable Source
proc getServerAddr(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the SERVER_ADDR environment variable Source
proc getServerAdmin(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the SERVER_ADMIN environment variable Source
proc getServerName(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the SERVER_NAME environment variable Source
proc getServerPort(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the SERVER_PORT environment variable Source
proc getServerProtocol(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the SERVER_PROTOCOL environment variable Source
proc getServerSignature(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the SERVER_SIGNATURE environment variable Source
proc getServerSoftware(): string {.raises: [], tags: [ReadEnvEffect].}
- returns contents of the SERVER_SOFTWARE environment variable Source
proc setTestData(keysvalues: varargs[string]) {.raises: [OSError], tags: [WriteEnvEffect].}
-
fills the appropriate environment variables to test your CGI application. This can only simulate the 'GET' request method. keysvalues should provide embedded (name, value)-pairs. Example:
setTestData("name", "Hanz", "password", "12345")
Source proc writeContentType() {.raises: [IOError], tags: [WriteIOEffect].}
-
call this before starting to send your HTML data to stdout. This implements this part of the CGI protocol:
write(stdout, "Content-type: text/html\n\n")
Source proc writeErrorMessage(data: string) {.raises: [IOError], tags: [WriteIOEffect].}
- Tries to reset browser state and writes data to stdout in <plaintext> tag. Source
proc setStackTraceStdout() {.raises: [], tags: [].}
- Makes Nim output stacktraces to stdout, instead of server log. Source
proc setStackTraceNewLine() {.deprecated, raises: [], tags: [].}
- Makes Nim output stacktraces to stdout, instead of server log. Depracated alias for setStackTraceStdout. Source
proc setCookie(name, value: string) {.raises: [Exception], tags: [WriteIOEffect].}
- Sets a cookie. Source
proc getCookie(name: string): TaintedString {.raises: [], tags: [ReadEnvEffect].}
- Gets a cookie. If no cookie of name exists, "" is returned. Source
proc existsCookie(name: string): bool {.raises: [], tags: [ReadEnvEffect].}
- Checks if a cookie of name exists. Source
Iterators
iterator decodeData(data: string): tuple[key, value: TaintedString] {. raises: [CgiError], tags: [].}
- Reads and decodes CGI data and yields the (name, value) pairs the data consists of. Source
iterator decodeData(allowedMethods: set[RequestMethod] = {methodNone, methodPost, methodGet}): tuple[key, value: TaintedString] {. raises: [CgiError, OverflowError, ValueError], tags: [ReadEnvEffect, ReadIOEffect].}
- Reads and decodes CGI data and yields the (name, value) pairs the data consists of. If the client does not use a method listed in the allowedMethods set, an ECgi exception is raised. Source