Mu.GRpc.Client.Optics

For further information over initialization of the connection, consult the http2-client-grpc docs.

Initialization of the gRPC client

data GRpcConnection (s :: Package') (p :: GRpcMessageProtocol)

Represents a connection to the service s.

Instances

(pkg ~ 'Package ('Just pkgName) '[service], service ~ 'Service serviceName methods, SearchMethodOptic p methods m t, KnownName serviceName, KnownName pkgName, KnownName m, MkRPC p) => LabelOptic m A_Getter (GRpcConnection pkg p) (GRpcConnection pkg p) t t

Defined in Mu.GRpc.Client.Optics

Methods

labelOptic :: Optic A_Getter NoIx (GRpcConnection pkg p) (GRpcConnection pkg p) t t

initGRpc

Arguments

:: MonadIO m

=> GrpcClientConfig

gRPC configuration

-> Proxy p

-> forall s. m (Either ClientError (GRpcConnection s p))

Initializes a connection to a gRPC server. Usually the service you are connecting to is inferred from the usage later on. However, it can also be made explicit by using

initGRpc config msgProtoBuf @Service

initGRpcZipkin

Arguments

:: (MonadIO m, MonadTrace m)

=> GrpcClientConfig

gRPC configuration

-> Proxy p

-> Text

-> forall s. m (Either ClientError (GRpcConnection s p))

Initializes a connection to a gRPC server, creating a new span for distributed tracing. Usually the service you are connecting to is inferred from the usage later on. However, it can also be made explicit by using

initGRpcZipkin config msgProtoBuf "person" @Service

data GRpcMessageProtocol

Serialization formats supported with gRPC.

Constructors

MsgProtoBuf

Protocol Buffers.

MsgAvro

Avro.

Instances

Eq GRpcMessageProtocol

Defined in Mu.GRpc.Bridge

Methods

(==) :: GRpcMessageProtocol -> GRpcMessageProtocol -> Bool

(/=) :: GRpcMessageProtocol -> GRpcMessageProtocol -> Bool

Show GRpcMessageProtocol

Defined in Mu.GRpc.Bridge

Methods

showsPrec :: Int -> GRpcMessageProtocol -> ShowS

show :: GRpcMessageProtocol -> String

showList :: [GRpcMessageProtocol] -> ShowS

msgProtoBuf :: Proxy 'MsgProtoBuf

Choose Protocol Buffers as serialization format for gRPC. This value is commonly used to create a client or server.

msgAvro :: Proxy 'MsgAvro

Choose Avro as serialization format for gRPC. This value is commonly used to create a client or server.

data GrpcClientConfig

Configuration to setup a GrpcClient.

grpcClientConfigSimple :: HostName -> PortNumber -> UseTlsOrNot -> GrpcClientConfig

Request arguments and responses

data CompressMode

data GRpcReply a

Constructors

GRpcTooMuchConcurrency TooMuchConcurrency

GRpcErrorCode ErrorCode

GRpcErrorString String

GRpcClientError ClientError

GRpcOk a

Instances

Functor GRpcReply

Defined in Mu.GRpc.Client.Internal

Methods

fmap :: (a -> b) -> GRpcReply a -> GRpcReply b

(<$) :: a -> GRpcReply b -> GRpcReply a

Show a => Show (GRpcReply a)

Defined in Mu.GRpc.Client.Internal

Methods

showsPrec :: Int -> GRpcReply a -> ShowS

show :: GRpcReply a -> String

showList :: [GRpcReply a] -> ShowS

Re-exported for convenience

module Optics.Core

module Mu.Schema.Optics