Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/http-kit/http-kit
Simple, high-performance event-driven HTTP client+server for Clojure
https://github.com/http-kit/http-kit
async clojure http-client http-server websockets
Last synced: 5 days ago
JSON representation
Simple, high-performance event-driven HTTP client+server for Clojure
- Host: GitHub
- URL: https://github.com/http-kit/http-kit
- Owner: http-kit
- License: apache-2.0
- Created: 2012-03-13T00:51:18.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2024-11-04T14:29:14.000Z (about 2 months ago)
- Last Synced: 2024-12-08T03:35:54.098Z (14 days ago)
- Topics: async, clojure, http-client, http-server, websockets
- Language: Java
- Homepage: https://www.taoensso.com/http-kit
- Size: 2.33 MB
- Stars: 2,455
- Watchers: 110
- Forks: 341
- Open Issues: 53
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-clojure - http-kit - performance event-driven HTTP client and server (HTTP)
README
[**Documentation**](#documentation) | [Latest releases](#latest-releases) | [Slack channel][]
# http-kit
### Simple, high-performance event-driven HTTP client+server for Clojure
http-kit is a minimalist and efficient Ring-compatible HTTP client+server for Clojure.
It uses an event-driven architecture to support highly concurrent a/synchronous web applications, and features a simple unified API for WebSocket and HTTP long-polling/streaming.
## Latest release/s
- `2024-02-30` `v2.8.0`: [release info](../../releases/tag/v2.8.0)
[![Main tests][Main tests SVG]][Main tests URL]
[![Graal tests][Graal tests SVG]][Graal tests URL]
See [here][GitHub releases] for earlier releases.
## Why http-kit?
- **Ring compliant**: http-kit is a drop-in replacement for the standard Ring Jetty adapter. You can use it with all your current libraries and middleware.
- **High performance**: http-kit uses an event-driven architecture like nginx, and is **fast**. See [here](#performance) for benchmarks.
- **High concurrency**: http-kit is **efficient**. Its RAM usage is O(n), with only few kB used per connection. Tests have [shown](https://http-kit.github.io/600k-concurrent-connection-http-kit.html) http-kit happily serving >600k concurrent connections.
- **Clean, simple, small**: written from the ground-up to be **lean**, the entire http-kit client+server JAR is ~90kB with **zero dependencies** and ~3k total lines of code.
- **Sync or async**: synchronous is simple, asynchronous fast & flexible. With http-kit you get the best of both with a simple API that lets you mix & match to best fit your use case.
- **WebSockets**: realtime web apps are a breeze with http-kit, with great out-the-box support for both WebSockets and efficient HTTP long-polling.
## Performance
http-kit now includes an extensive single-system **benchmark suite** that can be easily customized and run in your own environment.
See [here](../../wiki/4-Benchmarking) for http-kit's **benchmark philosophy**, usage info, detailed results, etc.
Selected example results:
> **Important**: as with all benchmarks - please be skeptical and check the details for important context!
## Project status
http-kit was created by [@shenfeng][], but is currently being maintained by its community.
A big thank-you to the [current contributors](../../graphs/contributors) for keeping the project going! **Additional contributors very welcome**: please ping me if you'd be interested in lending a hand.
\- [Peter Taoussanis][]
## Documentation
- [Wiki][GitHub wiki] (getting started, usage, etc.)
- API reference: [cljdoc][cljdoc docs], [Codox][Codox docs]
## License
Copyright © 2012-2024 [Feng Shen][@shenfeng] and contributors.
Licensed under [Apache 2.0](LICENSE.txt).
[GitHub releases]: ../../releases
[GitHub issues]: ../../issues
[GitHub wiki]: ../../wiki
[Slack channel]: https://www.taoensso.com/http-kit/slack
[Peter Taoussanis]: https://www.taoensso.com
[Codox docs]: https://http-kit.github.io/http-kit/
[cljdoc docs]: https://cljdoc.org/d/http-kit/http-kit/
[Clojars SVG]: https://img.shields.io/clojars/v/http-kit.svg
[Clojars URL]: https://clojars.org/http-kit
[Main tests SVG]: https://github.com/http-kit/http-kit/actions/workflows/main-tests.yml/badge.svg
[Main tests URL]: https://github.com/http-kit/http-kit/actions/workflows/main-tests.yml
[Graal tests SVG]: https://github.com/http-kit/http-kit/actions/workflows/graal-tests.yml/badge.svg
[Graal tests URL]: https://github.com/http-kit/http-kit/actions/workflows/graal-tests.yml
[@shenfeng]: https://github.com/shenfeng