A collection of Handy-HTTP dependencies and common boilerplate code for starting a web server in minutes.
Go to file
Andrew Lalis a91a1915a2 Changed to x.y for versions, and added more complete readme. 2025-01-14 18:32:59 -05:00
source/handy_http_starter Added initial code. 2025-01-14 18:14:18 -05:00
.gitignore Added initial code. 2025-01-14 18:14:18 -05:00
LICENSE Added initial code. 2025-01-14 18:14:18 -05:00
README.md Changed to x.y for versions, and added more complete readme. 2025-01-14 18:32:59 -05:00
dub.json Changed to x.y for versions, and added more complete readme. 2025-01-14 18:32:59 -05:00
dub.selections.json Added initial code. 2025-01-14 18:14:18 -05:00

README.md

Handy-HTTP Starter

A collection of Handy-HTTP dependencies and common boilerplate code for starting a web server in minutes.

Here's how you can use this:

  1. Create your new project with dub init.
  2. Add the handy-http-starter dependency when prompted by Dub to add dependencies, or afterwards with dub add handy-http-starter.
  3. Start your server using the startServer function, as shown in the following example:
import handy_http_starter;

void main() {
    startServer((ref request, ref response) {
        response.headers.add("Content-Type", "text/plain");
        response.headers.add("Content-Length", "12");
        response.outputStream.write(cast(ubyte[]) "Hello world!")
    });
}

What's included?

When you add handy-http-starter to your project, you'll be transitively adding dependencies for all of the following components, at the highest version matching the major version of the starter:

  • Handy-HTTP Primitives for basic HTTP types and functions.
  • Handy-HTTP Transport for the HTTP server that handles connections and all the boring stuff in between the client and your request handler logic.
  • More to come as Handy-HTTP is developed!