hs-rustls — Rustls for Haskell

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

See the haddocks for documentation.

Also see:

• http-client-rustls: Make HTTPS requests using http-client and Rustls.

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

Install rustls-ffi 0.15 either by downloading a pre-built artifact from the release page, or by building it from source.

If you installed rustls-ffi globally, you should be good to go. Otherwise, assuming that you installed it to /path/to/some/dir, 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.

Testing

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