rust-http-server 0.0.1

A simple and fast HTTP server written in rust. 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

# Rust-HTTP-Server
[![Build Status](https://travis-ci.org/asoderman/rust-http-server.svg?branch=master)](https://travis-ci.org/asoderman/rust-http-server)

Rust-HTTP-Server is a small multi-threaded webserver that supports TLS and WSGI. Rust-HTTP-Server's goal is to be an easy to use, fast and lightweight http server.

# Table of Contents:
* [Installation](#installation)
* [Usage](#usage)
* [TODO](#todo)

# Installation:
Currently the only way to install rust-http-server is to download the project and build with cargo. crates.io support is coming soon!

# Usage:
### With Cargo:
* `cargo run` to start the server
* `cargo run -- -h` for help
* `cargo test` to run the tests (Note: Openssl must be installed on your system otherwise the TLS test will fail.)

rust-http-server will look for `config.json` in the current working directory. Config options include:
* host
* port
* app - a string `<module>:<callable>`. The server will search for a file with the same name as the module to run.
* static_folder - A path to a folder. This will register **everything** within the folder.
* https_cert
* cert_password
* threads

CLI usage:
```

            [DIRECTORY]            'Serves the contents of the directory'
            -h, --host=[HOST]       'Sets the host address'
            -p, --port=[PORT]       'Sets the port'
            -a, --app=[APP]         '<module>:<callable> The server application'
            -cert=[CERT],           'Path to pkcs12 certificate'
            -pwd=[PWD],             'Password for the pkcs12'
            -t, --threads=[THREADS] 'Sets the number of threads to use'
            -v...                   'Sets verbosity'
```

## TODO:
* More documentation
* HTTP passthrough
* Benchmarks