net: A clojure Netty companion

⚠️ use of net is now discouraged in favor of aleph ⚠️

Net provides a clojure foundation to implement asynchronous networking based on Netty.

It is much narrower in scope and features than aleph, which you might want to look into if you want a full-fledged asynchronous programming toolkit for clojure.

net is rather geared towards people with prior Netty knowledge wanting to keep the same workflow in, hopefully, idiomatic Clojure, and nothing but standard clojure facilities.

Light facades around Netty concepts such as channels, pipelines, channel initializers and bootstraps
Facilities to create TLS client and server contexts from PEM files
Ring-like HTTP(S) server facade
HTTP(S) client
Simple interface to create TCP server with optional TLS support
Clojure core.async support
Memory-efficient transducers for collections of ByteBufs

Documentation

Net now has full API Documentation and Guides.

Installation

    [[spootnik/net "0.3.3-beta39"]]

Changelog

0.3.3-beta36

Support SNI for TLS requests

0.3.3-beta34

Add draining facilities for unexpectedly closed channels

0.3.3-beta32

Reliability fixes in HTTP client
Allow disabling of SSL certificate validation
Allow more options to be supplied to the HTTP server

0.3.3-beta28

Ensure lost clients do not result in filled core.async channel buffers

0.3.3-beta27

Start introducing bridged channels for tighter integration between Netty and core.async.
Ensure event-loop-groups can be parameterized
Allow supplying query args as a map in HTTP requests

0.3.3-beta26

Play nice with non-epoll systems

0.3.3-beta23

Adapt net.http.client to match server behavior: responses contain a core.async Channel body
Handle transforms over the body, i.e: help callers supply a transducer when requesting
Better handle error conditions
Add net.core.async/timeout-pipe to help ensure upstream feeds a channel fast enough

0.3.3-beta19

Handle Netty out-of-band /bad-request requests from HttpObjectDecoder

0.3.3-beta18

Improve behavior on early downstream channel closing

0.3.3-beta17

Fix a memory leak when closing the body channel from a handler
Add clojure tools.deps.alpha support

0.3.3-beta16

Fix all reflection warnings
Fix calls to deprecated signatures in Netty

0.3.3-beta15

No more dependency on tools.logging
Better dispatch for pipelines

0.3.3-beta14

Depend on Netty 4.1.19.Final
Add ByteBuf collection transducers
Handle Http server callback on an executor
Improve Netty facade
Add ByteBuf manipulation tooling
Circumvent CLJ-1814 as much as possible

0.3.3-beta9

Depend on Netty 4.1.8.Final

0.3.3-beta8

specs for http server options

0.3.3-beta7

Small fixes

0.3.3-beta6

Allow user-supplied executor for responses (thanks @mpenet).
Fix HTTP-related regressions introduced by reflection work.

0.3.3-beta4

Ensure all calls do not need reflection.
Correctly terminate clients in tcp server shutdown fn.

0.3.3-beta3

Break HandlerAdapter into several protocols

0.3.3-beta2

Add documentation and guides
Improved specs

0.3.3-beta1

Rework HTTP support to be aligned with jet
Provide a single HTTP server interface, which allows aggregating or streaming body content.

0.2.20

Allow user-supplied max body size

0.2.19

Bugfix release for 0.2.18
More restrictive specs

0.2.18

Convenience macros to create encoders and decoders.

0.2.17

core.spec schemas instead of prismatic schema
Rely on Netty 4.1.6
Additional sugar for futures and channels

Thanks

CRHough (https://github.com/CRHough) for a number of small fixes.
Max Penet (https://github.com/mpenet) for most of the reflection fixes.

clonekim/net