Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Fugoes/Webe
https://github.com/Fugoes/Webe
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/Fugoes/Webe
- Owner: Fugoes
- Created: 2017-08-11T08:24:45.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-07-18T04:38:55.000Z (over 6 years ago)
- Last Synced: 2024-08-02T01:25:31.916Z (6 months ago)
- Language: C++
- Size: 76.2 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Webe
## Introduction
`Webe` is a web server. I wrote it to hand it in as homework... It uses event loop with non-blocking IO and epoll.
## How to Build
```bash
# For Debian 9 with gcc-6.3.0
$ apt install -y libboost-filesystem-dev
$ git clone https://github.com/Fugoes/Webe.git
$ cd Webe
$ mkdir cmake
$ cd cmake
$ cmake ..
$ make
```
To get release version which run much faster, use `cmake -DCMAKE_BUILD_TYPE=Release ..` instead of `cmake ..`.
## How to Use
```bash
$ cd Webe/cmake
$ ./webectl
Usage: webectl load-module
webectl unload-module
webectl list-server
webectl stop-server
webectl start-server [ OPTIONS ]
where OPTIONS = { -a
| -p }
```
You could directly run `./webed` instead. By default, it will load all modules.
## Demo
```shell
$ cd Webe/cmake
$ ln -s ../example/static static
$ ./webectl start-server 4 -a 0.0.0.0 -p 8080
$ ./webectl list-server
PID
----------
1906
1907
1905
1908
```
Now browse `http://127.0.0.1:8080/info`.
To unload some module:
```shell
$ ./webectl unload-module info
```
Now browse `http://127.0.0.1:8080/info`, it shall be `404 Not Found`.
To stop all server:
```shell
$ ./webectl stop-server
PID STATUS
---------- -------
1906 STOPPED
1907 STOPPED
1905 STOPPED
1908 STOPPED
```
You could also do some benchmark with ab from Apache2:
```shell
$ ab -k -n 1000000 -c 100 http://127.0.0.1:8080/static/nice.css
...
Concurrency Level: 100
Time taken for tests: 7.025 seconds
Complete requests: 1000000
Failed requests: 0
Non-2xx responses: 1000000
Keep-Alive requests: 1000000
Total transferred: 302000000 bytes
HTML transferred: 151000000 bytes
Requests per second: 142340.22 [#/sec] (mean)
Time per request: 0.703 [ms] (mean)
Time per request: 0.007 [ms] (mean, across all concurrent requests)
Transfer rate: 41979.25 [Kbytes/sec] received
...
```
This result is tested with an i5 4210H CPU.
## Available Modules
| Name | Description |
| ------------- | --------------------------------------- |
| `404` | Return `404 Not Found` page |
| `info` | Show information about the host machine |
| `file_server` | A static file server |
## License
`Webe` is licensed under the [WTFPL](http://www.wtfpl.net/). Note that you shall not hand it in as your homework...