34 lines
1.3 KiB
Markdown
34 lines
1.3 KiB
Markdown
# 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:
|
|
```d
|
|
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](https://git.andrewlalis.com/Handy-Http/primitives)
|
|
for basic HTTP types and functions.
|
|
- [Handy-HTTP Transport](https://git.andrewlalis.com/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!
|