Status codes

Every gRPC call ends with a status code. livery_grpc represents the 16 canonical codes as atoms; livery_grpc_status converts between the atom, the integer, and the wire value.

The codes

Using them

Return a code atom from a handler:

{error, permission_denied}
{error, {permission_denied, <<"token expired">>}}

Convert when you need to:

3  = livery_grpc_status:code(invalid_argument),
invalid_argument = livery_grpc_status:name(3),
<<"5">> = livery_grpc_status:to_binary(not_found),
not_found = livery_grpc_status:from_binary(<<"5">>).

An unknown integer maps to unknown, so a peer using a code livery_grpc does not model still yields a usable value.

See also

• Error handling for returning and reading errors.