| .github/workflows | ||
| bench | ||
| bin | ||
| core | ||
| examples | ||
| nix | ||
| src/Network/GRPC | ||
| tests | ||
| .gitignore | ||
| default.nix | ||
| grpc-haskell.cabal | ||
| LICENSE | ||
| nixpkgs.nix | ||
| README.md | ||
| release.nix | ||
| Setup.hs | ||
| shell.nix | ||
| stack.yaml | ||
Attribution
This library is a fork of https://github.com/aloiscochard/grpc-haskell that we
have extended and released under the same LICENSE
Installation
The current version of this library requires gRPC version 1.34.1. Newer versions may work, but have not been tested.
Usage
There is a tutorial here
Building and testing
nix-build release.nix -A grpc-haskell will build and test the whole thing and
put the completed package into the nix store. nix-shell can be used to give
you a development environment where you can use cabal for development and
testing:
$ nix-shell
...
Running: cabal configure --extra-include-dirs ... --extra-lib-dirs ... --enable-tests
...
[nix-shell]$ cabal build && cabal test
Note that cabal configure is run automatically upon nix-shell entry so that
the build can reference include and library paths for the grpc library.
Using the Library
You must compile with -threaded, because we rely on being able to execute
Haskell while blocking on foreign calls to the gRPC library. If not using code
generation, the recommended place to start is in the
Network.GRPC.HighLevel.Server.Unregistered module, where serverLoop provides
a handler loop.