rustls: TLS bindings for Rustls

[ cryptography, library, network ] [ Propose Tags ]

TLS bindings for Rustls via rustls-ffi.


[Skip to Readme]

Flags

Automatic Flags
NameDescriptionDefault
derive-storable-plugin

Use derive-storable-plugin

Enabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.0.0.0, 0.0.1.0
Change log CHANGELOG.md
Dependencies base (>=4.12 && <5), bytestring (>=0.10 && <0.12), derive-storable (>=0.3 && <0.4), derive-storable-plugin, network (>=3.1 && <3.2), resourcet (>=1.2 && <1.4), text (>=2.0.1 && <2.1), transformers (>=0.5.6 && <0.7) [details]
License CC0-1.0
Author amesgen
Maintainer amesgen@amesgen.de
Category Cryptography, Network
Home page https://github.com/amesgen/hs-rustls/tree/main/rustls
Bug tracker https://github.com/amesgen/hs-rustls/issues
Source repo head: git clone https://github.com/amesgen/hs-rustls
Uploaded by amesgen at 2023-03-12T19:28:01Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Downloads 109 total (6 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user
Build status unknown [no reports yet]

Readme for rustls-0.0.1.0

[back to package description]

hs-rustls — Rustls for Haskell

CI Hackage

Haskell bindings for the Rustls TLS library via rustls-ffi.

See the haddocks for documentation.

Also see:

Development

With Nix

When developing this library, just drop into a Nix shell.

If you want to depend on this library in another package, you have to make sure to include rustls-ffi as a native dependency. You can do so by depending on the github:amesgen/hs-rustls?dir=nix-rustls flake, and then using the nix-rustls.packages.${system}.default output.

Without Nix

rustls-ffi

Make sure to have Cargo installed. Then, clone and install rustls-ffi:

git clone https://github.com/rustls/rustls-ffi -b v0.9.2
cd rustls-ffi
make DESTDIR=/path/to/some/dir install

Then, in a cabal.project.local, add these lines:

extra-include-dirs: /path/to/some/dir/include
extra-lib-dirs:     /path/to/some/dir/lib

With this, Cabal should be able to find the rustls-ffi native library.

Note: This process might become less manual if sth like haskell/cabal#7906 lands in Cabal.

Testing

When running the tests in this repo, you have to have minica and miniserve installed.