Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dom96/httpbeast
A highly performant, multi-threaded HTTP 1.1 server written in Nim.
https://github.com/dom96/httpbeast
async http nim
Last synced: 15 days ago
JSON representation
A highly performant, multi-threaded HTTP 1.1 server written in Nim.
- Host: GitHub
- URL: https://github.com/dom96/httpbeast
- Owner: dom96
- License: mit
- Created: 2017-10-29T19:23:12.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-01-07T21:29:05.000Z (10 months ago)
- Last Synced: 2024-08-03T18:21:02.377Z (3 months ago)
- Topics: async, http, nim
- Language: Nim
- Homepage:
- Size: 98.6 KB
- Stars: 442
- Watchers: 14
- Forks: 52
- Open Issues: 22
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
- web-gelistirme-101 - Httpbeast
- awesome-nim - httpbeast - A highly performant, multi-threaded HTTP 1.1 server ([top 10 in FrameworkBenchmarks](https://www.techempower.com/benchmarks/#section=data-r18&test=json)). (Web / HTTP Servers)
README
# httpbeast
A highly performant, multi-threaded HTTP 1.1 server written in Nim.
The main goal of this project is performance, when it was started the goal was to get the fastest possible HTTP server written in pure Nim, it has held the title of the fastest Nim HTTP server since its initial release. In 2018 HttpBeast reached the [top 10 in the TechEmpower benchmarks](https://www.techempower.com/benchmarks/#section=data-r18&hw=ph&test=json) beating many established HTTP servers implemented in other programming languages. Httpbeast has been used successfully in many projects, for example the [Nim Forum](https://forum.nim-lang.org).
> :information_source: Unless you know what you're doing (for example writing something resource constrained or your own web framework), you are better off using [Jester](https://github.com/dom96/jester) (which is built on Httpbeast) or another web framework.
> :information_source: This HTTP server has been designed to utilise epoll-like OS APIs and as such does not support Windows by-design.
> :warning: This library is not yet hardened against common HTTP security exploits. If you're using it in production you should do so behind a reverse proxy like nginx.
## Features
Current features include:
* Built on the Nim ``selectors`` module which makes efficient use of epoll on
Linux and kqueue on macOS.
* Automatic parallelization, just make sure to compile with ``--threads:on``.
* Support for HTTP pipelining.
* On-demand parser so that only the requested data is parsed.
* Integration with Nim's ``asyncdispatch`` allowing async/await to be used in
the request callback whenever necessary.
## Getting started
Create a `helloHttp.nimble` file:
```
# Package
version = "0.1.0"
author = "Your Name"
description = "Your Description"
license = "MIT"
srcDir = "src"
bin = @["helloHttp"]
# Dependencies
requires "nim >= 1.0.0"
requires "httpbeast >= 0.4.0"
```
Create a `src/helloHttp.nim` file:
```nim
import options, asyncdispatch
import httpbeast
proc onRequest(req: Request): Future[void] =
if req.httpMethod == some(HttpGet):
case req.path.get()
of "/":
req.send("Hello World")
else:
req.send(Http404)
run(onRequest)
```
Run via: `nimble c -r helloHttp.nim`