second-transfer: Second Transfer HTTP/2 web server

Versions [RSS]	0.1.0.0, 0.2.0.0, 0.3.0.2, 0.3.0.3, 0.3.0.4, 0.4.0.0, 0.5.0.0, 0.5.2.2, 0.5.3.1, 0.5.3.2, 0.5.4.0, 0.5.5.0, 0.5.5.1, 0.6.0.0, 0.6.1.0, 0.7.1.0, 0.10.0.1, 0.10.0.2, 0.10.0.4
Change log	changelog.md
Dependencies	attoparsec (>=0.12), base (>=4.7 && <=4.9), base16-bytestring (>=0.1.1), binary (>=0.7.1.0), bytestring (>=0.10.4), clock (>=0.4), conduit (>=1.2.4 && <1.3), containers (>=0.5.5), deepseq (>=1.4.1), exceptions (>=0.8 && <0.9), hashable (>=1.2), hashtables (>=1.2 && <1.3), hslogger (>=1.2.6), http2 (>=1.0.2), lens (>=4.7), network (>=2.6 && <2.7), network-uri (>=2.6 && <2.7), pqueue (>=1.3.0), SafeSemaphore (>=0.10), stm (>=2.3), text (>=1.2 && <1.3), time (>=1.5.0 && <1.8), transformers (>=0.3 && <=0.5) [details]
License	BSD-3-Clause
Copyright	Copyright 2015, Alcides Viamontes Esquivel
Author	Alcides Viamontes Esquivel
Maintainer	alcidesv@zunzun.se
Category	Network
Home page	https://www.httptwo.com/second-transfer/
Bug tracker	https://github.com/alcidesv/second-transfer/issues
Source repo	head: git clone git@github.com:alcidesv/second-transfer.git this: git clone git@github.com:alcidesv/second-transfer.git(tag 0.7.1.0)
Uploaded	by dsign at 2015-10-04T05:21:45Z
Distributions
Reverse Dependencies	1 direct, 0 indirect [details]
Downloads	10626 total (44 in the last 30 days)
Rating	2.0 (votes: 1) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs uploaded by user Build status unknown [no reports yet]

Readme for second-transfer-0.7.1.0

[back to package description]

Developer README

Introduction

This is an early-stage and very experimental library to create HTTP/2 servers using Haskell.

To see the package docs, please check the Hackage page or the file hs-src/SecondTransfer.hs.

Building and installing

You need Haskell GHC compiler installed (version 7.8.3 at least). You also need OpenSSL 1.0.2, since the ALPN feature and some very recent cypher-suites are needed by HTTP/2. this source distribution will try to find them at directory /opt/openssl-1.0.2, but you should be able to alter the options using cabal configure. This package uses Haskell's FFI to interface with OpenSSL.

Provided that you have all the dependencies, you should be able to just do:

$ cabal install second-transfer

Running the tests

$ cabal test

Debugging complicated scenarios

To access full debugging capabilities, for example from the test suite, use the following command from the project's directory:

$ cabal exec -- ghci -ihs-src -itests/tests-hs-src -itests/support -XCPP -Imacros/ dist/build/cbits/tlsinc.o

Example

There is a very basic example at tests/tests-hs-src/compiling_ok.hs, and a somewhat more complicated one at examples/attempt_bust; that one shows how to do HTTP/2.0 push from the library.

Development

Uploading documentation (provided you have access to the package in Hackage):

$ ./hackage-upload-docs.sh second-transfer 0.5.4.0 <hackage-user> <hackage-password>