Lines Matching +full:auto +full:- +full:request +full:- +full:review
1 .. _module-pw_rpc-design:
6 .. pigweed-module-subpage::
9 .. _module-pw_rpc-design-overview:
11 --------
13 --------
15 <https://grpc.io/docs/what-is-grpc/core-concepts/>`_.
17 .. _module-pw_rpc-design-lifecycle:
30 request or response payloads. There are four RPC types:
32 * **Unary**. The client sends one request and the server sends one
34 * **Server streaming**. The client sends one request and the server sends zero
41 .. _module-pw_rpc-design-events:
44 ------
50 * **Request**. The client sends a request protobuf. The server calls a callback
52 request and it is handled when the RPC starts.
58 * **Request Completion**. The client sends a message that it would like to
59 request call completion. The server calls a callback when it receives it. Some
60 servers may ignore the request completion message. In client and bidirectional
63 .. _module-pw_rpc-design-services:
69 user-defined RPCs are implemented.
76 service and prevents future calls to them, until the service is re-registered.
81 <https://developers.google.com/protocol-buffers/docs/proto3#services>`_
83 <https://grpc.io/docs/what-is-grpc/core-concepts/#service-definition>`_
85 .. _module-pw_rpc-design-status-codes:
93 * ``OK`` -- The operation succeeded.
94 * ``UNAVAILABLE`` -- The channel is not currently registered with the server or
96 * ``UNKNOWN`` -- Sending a packet failed due to an unrecoverable
99 .. _module-pw_rpc-design-unrequested-responses:
113 .. code-block:: c++
116 auto writer = RawServerWriter::Open<pw_rpc::raw::ServiceName::MethodName>(
126 .. _module-pw_rpc-design-errata:
129 ------
139 <https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/192311>`_, clients
147 .. _module-pw_rpc-design-naming:
149 ------
151 ------
154 some services created before this was established may use non-compliant
162 - ``Client``
163 - ``Service``
164 - Any reserved words in the languages ``pw_rpc`` supports (e.g. ``class``).
180 .. code-block:: protobuf
191 .. code-block:: cpp
199 void List(ConstByteSpan request, RawServerWriter& writer);
204 .. _module-pw_rpc-roadmap:
206 -------
208 -------
210 <https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/109077>`_, `Python
211 <https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/139610>`_, and
213 <https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/160792>`_). As a
214 result, some user-written service implementations may not expect or correctly