summaryrefslogtreecommitdiffstats
path: root/network/grpcurl/README
diff options
context:
space:
mode:
Diffstat (limited to 'network/grpcurl/README')
-rw-r--r--network/grpcurl/README10
1 files changed, 10 insertions, 0 deletions
diff --git a/network/grpcurl/README b/network/grpcurl/README
new file mode 100644
index 0000000000..ea941d7dd5
--- /dev/null
+++ b/network/grpcurl/README
@@ -0,0 +1,10 @@
+grpcurl is a command-line tool that lets you interact with gRPC servers.
+It's basically curl for gRPC servers.
+
+The main purpose for this tool is to invoke RPC methods on a gRPC server
+from the command-line. gRPC servers use a binary encoding on the wire
+(protocol buffers, or "protobufs" for short). So they are basically
+impossible to interact with using regular curl (and older versions of
+curl that do not support HTTP/2 are of course non-starters). This
+program accepts messages using JSON encoding, which is much more
+friendly for both humans and scripts.