浏览代码

Merge pull request #19140 from gnossen/py-1.21.1.-documentation

Auto-update Python documentation to 1.21.1
Richard Belleville 6 年之前
父节点
当前提交
113a580bea

+ 1 - 1
python/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: f36f3b2a05b267a2ac62e8d15f44ea32
+config: 46f2d7dd7afa0963f47d898b718b65f7
 tags: 645f666f9bcd5a90fca523b33c5a78b7

二进制
python/.doctrees/environment.pickle


二进制
python/.doctrees/glossary.doctree


二进制
python/.doctrees/grpc.doctree


二进制
python/.doctrees/grpc_channelz.doctree


二进制
python/.doctrees/grpc_health_checking.doctree


二进制
python/.doctrees/grpc_reflection.doctree


二进制
python/.doctrees/grpc_status.doctree


二进制
python/.doctrees/grpc_testing.doctree


二进制
python/.doctrees/index.doctree


+ 84 - 16
python/_modules/grpc.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>grpc &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>grpc &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
@@ -31,7 +31,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 
@@ -111,6 +111,7 @@
 <span class="kn">import</span> <span class="nn">six</span>
 
 <span class="kn">from</span> <span class="nn">grpc._cython</span> <span class="k">import</span> <span class="n">cygrpc</span> <span class="k">as</span> <span class="n">_cygrpc</span>
+<span class="kn">from</span> <span class="nn">grpc</span> <span class="k">import</span> <span class="n">_compression</span>
 
 <span class="n">logging</span><span class="o">.</span><span class="n">getLogger</span><span class="p">(</span><span class="vm">__name__</span><span class="p">)</span><span class="o">.</span><span class="n">addHandler</span><span class="p">(</span><span class="n">logging</span><span class="o">.</span><span class="n">NullHandler</span><span class="p">())</span>
 
@@ -503,6 +504,8 @@
 <span class="sd">      credentials: An optional CallCredentials for the RPC.</span>
 <span class="sd">      wait_for_ready: This is an EXPERIMENTAL argument. An optional flag t</span>
 <span class="sd">        enable wait for ready mechanism.</span>
+<span class="sd">      compression: An element of grpc.compression, e.g.</span>
+<span class="sd">        grpc.compression.Gzip. This is an EXPERIMENTAL option.</span>
 <span class="sd">    &quot;&quot;&quot;</span></div>
 
 
@@ -759,7 +762,8 @@
                  <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                  <span class="n">metadata</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                  <span class="n">credentials</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+                 <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+                 <span class="n">compression</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;Synchronously invokes the underlying RPC.</span>
 
 <span class="sd">        Args:</span>
@@ -771,6 +775,8 @@
 <span class="sd">          credentials: An optional CallCredentials for the RPC.</span>
 <span class="sd">          wait_for_ready: This is an EXPERIMENTAL argument. An optional</span>
 <span class="sd">            flag to enable wait for ready mechanism</span>
+<span class="sd">          compression: An element of grpc.compression, e.g.</span>
+<span class="sd">            grpc.compression.Gzip. This is an EXPERIMENTAL option.</span>
 
 <span class="sd">        Returns:</span>
 <span class="sd">          The response value for the RPC.</span>
@@ -788,7 +794,8 @@
                   <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                   <span class="n">metadata</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                   <span class="n">credentials</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                  <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+                  <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+                  <span class="n">compression</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;Synchronously invokes the underlying RPC.</span>
 
 <span class="sd">        Args:</span>
@@ -800,6 +807,8 @@
 <span class="sd">          credentials: An optional CallCredentials for the RPC.</span>
 <span class="sd">          wait_for_ready: This is an EXPERIMENTAL argument. An optional</span>
 <span class="sd">            flag to enable wait for ready mechanism</span>
+<span class="sd">          compression: An element of grpc.compression, e.g.</span>
+<span class="sd">            grpc.compression.Gzip. This is an EXPERIMENTAL option.</span>
 
 <span class="sd">        Returns:</span>
 <span class="sd">          The response value for the RPC and a Call value for the RPC.</span>
@@ -817,7 +826,8 @@
                <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                <span class="n">metadata</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                <span class="n">credentials</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-               <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+               <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+               <span class="n">compression</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;Asynchronously invokes the underlying RPC.</span>
 
 <span class="sd">        Args:</span>
@@ -829,6 +839,8 @@
 <span class="sd">          credentials: An optional CallCredentials for the RPC.</span>
 <span class="sd">          wait_for_ready: This is an EXPERIMENTAL argument. An optional</span>
 <span class="sd">            flag to enable wait for ready mechanism</span>
+<span class="sd">          compression: An element of grpc.compression, e.g.</span>
+<span class="sd">            grpc.compression.Gzip. This is an EXPERIMENTAL option.</span>
 
 <span class="sd">        Returns:</span>
 <span class="sd">            An object that is both a Call for the RPC and a Future.</span>
@@ -849,7 +861,8 @@
                  <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                  <span class="n">metadata</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                  <span class="n">credentials</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+                 <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+                 <span class="n">compression</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;Invokes the underlying RPC.</span>
 
 <span class="sd">        Args:</span>
@@ -861,6 +874,8 @@
 <span class="sd">          credentials: An optional CallCredentials for the RPC.</span>
 <span class="sd">          wait_for_ready: This is an EXPERIMENTAL argument. An optional</span>
 <span class="sd">            flag to enable wait for ready mechanism</span>
+<span class="sd">          compression: An element of grpc.compression, e.g.</span>
+<span class="sd">            grpc.compression.Gzip. This is an EXPERIMENTAL option.</span>
 
 <span class="sd">        Returns:</span>
 <span class="sd">            An object that is both a Call for the RPC and an iterator of</span>
@@ -880,7 +895,8 @@
                  <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                  <span class="n">metadata</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                  <span class="n">credentials</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+                 <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+                 <span class="n">compression</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;Synchronously invokes the underlying RPC.</span>
 
 <span class="sd">        Args:</span>
@@ -893,6 +909,8 @@
 <span class="sd">          credentials: An optional CallCredentials for the RPC.</span>
 <span class="sd">          wait_for_ready: This is an EXPERIMENTAL argument. An optional</span>
 <span class="sd">            flag to enable wait for ready mechanism</span>
+<span class="sd">          compression: An element of grpc.compression, e.g.</span>
+<span class="sd">            grpc.compression.Gzip. This is an EXPERIMENTAL option.</span>
 
 <span class="sd">        Returns:</span>
 <span class="sd">          The response value for the RPC.</span>
@@ -910,7 +928,8 @@
                   <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                   <span class="n">metadata</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                   <span class="n">credentials</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                  <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+                  <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+                  <span class="n">compression</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;Synchronously invokes the underlying RPC on the client.</span>
 
 <span class="sd">        Args:</span>
@@ -923,6 +942,8 @@
 <span class="sd">          credentials: An optional CallCredentials for the RPC.</span>
 <span class="sd">          wait_for_ready: This is an EXPERIMENTAL argument. An optional</span>
 <span class="sd">            flag to enable wait for ready mechanism</span>
+<span class="sd">          compression: An element of grpc.compression, e.g.</span>
+<span class="sd">            grpc.compression.Gzip. This is an EXPERIMENTAL option.</span>
 
 <span class="sd">        Returns:</span>
 <span class="sd">          The response value for the RPC and a Call object for the RPC.</span>
@@ -940,7 +961,8 @@
                <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                <span class="n">metadata</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                <span class="n">credentials</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-               <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+               <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+               <span class="n">compression</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;Asynchronously invokes the underlying RPC on the client.</span>
 
 <span class="sd">        Args:</span>
@@ -952,6 +974,8 @@
 <span class="sd">          credentials: An optional CallCredentials for the RPC.</span>
 <span class="sd">          wait_for_ready: This is an EXPERIMENTAL argument. An optional</span>
 <span class="sd">            flag to enable wait for ready mechanism</span>
+<span class="sd">          compression: An element of grpc.compression, e.g.</span>
+<span class="sd">            grpc.compression.Gzip. This is an EXPERIMENTAL option.</span>
 
 <span class="sd">        Returns:</span>
 <span class="sd">            An object that is both a Call for the RPC and a Future.</span>
@@ -972,7 +996,8 @@
                  <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                  <span class="n">metadata</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                  <span class="n">credentials</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+                 <span class="n">wait_for_ready</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+                 <span class="n">compression</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;Invokes the underlying RPC on the client.</span>
 
 <span class="sd">        Args:</span>
@@ -984,6 +1009,8 @@
 <span class="sd">          credentials: An optional CallCredentials for the RPC.</span>
 <span class="sd">          wait_for_ready: This is an EXPERIMENTAL argument. An optional</span>
 <span class="sd">            flag to enable wait for ready mechanism</span>
+<span class="sd">          compression: An element of grpc.compression, e.g.</span>
+<span class="sd">            grpc.compression.Gzip. This is an EXPERIMENTAL option.</span>
 
 <span class="sd">        Returns:</span>
 <span class="sd">            An object that is both a Call for the RPC and an iterator of</span>
@@ -1187,6 +1214,17 @@
 <span class="sd">        &quot;&quot;&quot;</span>
         <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+<div class="viewcode-block" id="ServicerContext.set_compression"><a class="viewcode-back" href="../grpc.html#grpc.ServicerContext.set_compression">[docs]</a>    <span class="k">def</span> <span class="nf">set_compression</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">compression</span><span class="p">):</span>
+        <span class="sd">&quot;&quot;&quot;Set the compression algorithm to be used for the entire call.</span>
+
+<span class="sd">        This is an EXPERIMENTAL method.</span>
+
+<span class="sd">        Args:</span>
+<span class="sd">          compression: An element of grpc.compression, e.g.</span>
+<span class="sd">            grpc.compression.Gzip.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
+
 <div class="viewcode-block" id="ServicerContext.send_initial_metadata"><a class="viewcode-back" href="../grpc.html#grpc.ServicerContext.send_initial_metadata">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
     <span class="k">def</span> <span class="nf">send_initial_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">initial_metadata</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;Sends the initial metadata value to the client.</span>
@@ -1271,6 +1309,16 @@
 <span class="sd">        Args:</span>
 <span class="sd">          details: A UTF-8-encodable string to be sent to the client upon</span>
 <span class="sd">            termination of the RPC.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
+
+<div class="viewcode-block" id="ServicerContext.disable_next_message_compression"><a class="viewcode-back" href="../grpc.html#grpc.ServicerContext.disable_next_message_compression">[docs]</a>    <span class="k">def</span> <span class="nf">disable_next_message_compression</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+        <span class="sd">&quot;&quot;&quot;Disables compression for the next response message.</span>
+
+<span class="sd">        This is an EXPERIMENTAL method.</span>
+
+<span class="sd">        This method will override any compression configuration set during</span>
+<span class="sd">        server creation or set on the call.</span>
 <span class="sd">        &quot;&quot;&quot;</span>
         <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
@@ -1772,7 +1820,7 @@
     <span class="k">return</span> <span class="n">_utilities</span><span class="o">.</span><span class="n">channel_ready_future</span><span class="p">(</span><span class="n">channel</span><span class="p">)</span></div>
 
 
-<div class="viewcode-block" id="insecure_channel"><a class="viewcode-back" href="../grpc.html#grpc.insecure_channel">[docs]</a><span class="k">def</span> <span class="nf">insecure_channel</span><span class="p">(</span><span class="n">target</span><span class="p">,</span> <span class="n">options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+<div class="viewcode-block" id="insecure_channel"><a class="viewcode-back" href="../grpc.html#grpc.insecure_channel">[docs]</a><span class="k">def</span> <span class="nf">insecure_channel</span><span class="p">(</span><span class="n">target</span><span class="p">,</span> <span class="n">options</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">compression</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
     <span class="sd">&quot;&quot;&quot;Creates an insecure Channel to a server.</span>
 
 <span class="sd">    The returned Channel is thread-safe.</span>
@@ -1781,15 +1829,18 @@
 <span class="sd">      target: The server address</span>
 <span class="sd">      options: An optional list of key-value pairs (channel args</span>
 <span class="sd">        in gRPC Core runtime) to configure the channel.</span>
+<span class="sd">      compression: An optional value indicating the compression method to be</span>
+<span class="sd">        used over the lifetime of the channel. This is an EXPERIMENTAL option.</span>
 
 <span class="sd">    Returns:</span>
 <span class="sd">      A Channel.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="kn">from</span> <span class="nn">grpc</span> <span class="k">import</span> <span class="n">_channel</span>  <span class="c1"># pylint: disable=cyclic-import</span>
-    <span class="k">return</span> <span class="n">_channel</span><span class="o">.</span><span class="n">Channel</span><span class="p">(</span><span class="n">target</span><span class="p">,</span> <span class="p">()</span> <span class="k">if</span> <span class="n">options</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">options</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
+    <span class="k">return</span> <span class="n">_channel</span><span class="o">.</span><span class="n">Channel</span><span class="p">(</span><span class="n">target</span><span class="p">,</span> <span class="p">()</span>
+                            <span class="k">if</span> <span class="n">options</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">options</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n">compression</span><span class="p">)</span></div>
 
 
-<div class="viewcode-block" id="secure_channel"><a class="viewcode-back" href="../grpc.html#grpc.secure_channel">[docs]</a><span class="k">def</span> <span class="nf">secure_channel</span><span class="p">(</span><span class="n">target</span><span class="p">,</span> <span class="n">credentials</span><span class="p">,</span> <span class="n">options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+<div class="viewcode-block" id="secure_channel"><a class="viewcode-back" href="../grpc.html#grpc.secure_channel">[docs]</a><span class="k">def</span> <span class="nf">secure_channel</span><span class="p">(</span><span class="n">target</span><span class="p">,</span> <span class="n">credentials</span><span class="p">,</span> <span class="n">options</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">compression</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
     <span class="sd">&quot;&quot;&quot;Creates a secure Channel to a server.</span>
 
 <span class="sd">    The returned Channel is thread-safe.</span>
@@ -1799,13 +1850,15 @@
 <span class="sd">      credentials: A ChannelCredentials instance.</span>
 <span class="sd">      options: An optional list of key-value pairs (channel args</span>
 <span class="sd">        in gRPC Core runtime) to configure the channel.</span>
+<span class="sd">      compression: An optional value indicating the compression method to be</span>
+<span class="sd">        used over the lifetime of the channel. This is an EXPERIMENTAL option.</span>
 
 <span class="sd">    Returns:</span>
 <span class="sd">      A Channel.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="kn">from</span> <span class="nn">grpc</span> <span class="k">import</span> <span class="n">_channel</span>  <span class="c1"># pylint: disable=cyclic-import</span>
     <span class="k">return</span> <span class="n">_channel</span><span class="o">.</span><span class="n">Channel</span><span class="p">(</span><span class="n">target</span><span class="p">,</span> <span class="p">()</span> <span class="k">if</span> <span class="n">options</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">options</span><span class="p">,</span>
-                            <span class="n">credentials</span><span class="o">.</span><span class="n">_credentials</span><span class="p">)</span></div>
+                            <span class="n">credentials</span><span class="o">.</span><span class="n">_credentials</span><span class="p">,</span> <span class="n">compression</span><span class="p">)</span></div>
 
 
 <div class="viewcode-block" id="intercept_channel"><a class="viewcode-back" href="../grpc.html#grpc.intercept_channel">[docs]</a><span class="k">def</span> <span class="nf">intercept_channel</span><span class="p">(</span><span class="n">channel</span><span class="p">,</span> <span class="o">*</span><span class="n">interceptors</span><span class="p">):</span>
@@ -1840,7 +1893,8 @@
            <span class="n">handlers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
            <span class="n">interceptors</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
            <span class="n">options</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-           <span class="n">maximum_concurrent_rpcs</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+           <span class="n">maximum_concurrent_rpcs</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+           <span class="n">compression</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
     <span class="sd">&quot;&quot;&quot;Creates a Server with which RPCs can be serviced.</span>
 
 <span class="sd">    Args:</span>
@@ -1858,6 +1912,9 @@
 <span class="sd">      maximum_concurrent_rpcs: The maximum number of concurrent RPCs this server</span>
 <span class="sd">        will service before returning RESOURCE_EXHAUSTED status, or None to</span>
 <span class="sd">        indicate no limit.</span>
+<span class="sd">      compression: An element of grpc.compression, e.g.</span>
+<span class="sd">        grpc.compression.Gzip. This compression algorithm will be used for the</span>
+<span class="sd">        lifetime of the server unless overridden. This is an EXPERIMENTAL option.</span>
 
 <span class="sd">    Returns:</span>
 <span class="sd">      A Server object.</span>
@@ -1867,7 +1924,7 @@
                                  <span class="k">if</span> <span class="n">handlers</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">handlers</span><span class="p">,</span> <span class="p">()</span>
                                  <span class="k">if</span> <span class="n">interceptors</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">interceptors</span><span class="p">,</span> <span class="p">()</span>
                                  <span class="k">if</span> <span class="n">options</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">options</span><span class="p">,</span>
-                                 <span class="n">maximum_concurrent_rpcs</span><span class="p">)</span></div>
+                                 <span class="n">maximum_concurrent_rpcs</span><span class="p">,</span> <span class="n">compression</span><span class="p">)</span></div>
 
 
 <span class="nd">@contextlib</span><span class="o">.</span><span class="n">contextmanager</span>
@@ -1878,6 +1935,16 @@
     <span class="n">context</span><span class="o">.</span><span class="n">_finalize_state</span><span class="p">()</span>  <span class="c1"># pylint: disable=protected-access</span>
 
 
+<div class="viewcode-block" id="Compression"><a class="viewcode-back" href="../grpc.html#grpc.Compression">[docs]</a><span class="k">class</span> <span class="nc">Compression</span><span class="p">(</span><span class="n">enum</span><span class="o">.</span><span class="n">IntEnum</span><span class="p">):</span>
+    <span class="sd">&quot;&quot;&quot;Indicates the compression method to be used for an RPC.</span>
+
+<span class="sd">       This enumeration is part of an EXPERIMENTAL API.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">NoCompression</span> <span class="o">=</span> <span class="n">_compression</span><span class="o">.</span><span class="n">NoCompression</span>
+    <span class="n">Deflate</span> <span class="o">=</span> <span class="n">_compression</span><span class="o">.</span><span class="n">Deflate</span>
+    <span class="n">Gzip</span> <span class="o">=</span> <span class="n">_compression</span><span class="o">.</span><span class="n">Gzip</span></div>
+
+
 <span class="c1">###################################  __all__  #################################</span>
 
 <span class="n">__all__</span> <span class="o">=</span> <span class="p">(</span>
@@ -1895,6 +1962,7 @@
     <span class="s1">&#39;AuthMetadataContext&#39;</span><span class="p">,</span>
     <span class="s1">&#39;AuthMetadataPluginCallback&#39;</span><span class="p">,</span>
     <span class="s1">&#39;AuthMetadataPlugin&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;Compression&#39;</span><span class="p">,</span>
     <span class="s1">&#39;ClientCallDetails&#39;</span><span class="p">,</span>
     <span class="s1">&#39;ServerCertificateConfiguration&#39;</span><span class="p">,</span>
     <span class="s1">&#39;ServerCredentials&#39;</span><span class="p">,</span>

+ 2 - 2
python/_modules/grpc_channelz/v1/channelz.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>grpc_channelz.v1.channelz &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>grpc_channelz.v1.channelz &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="../../../_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="../../../" src="../../../_static/documentation_options.js"></script>
@@ -31,7 +31,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 2 - 2
python/_modules/grpc_health/v1/health.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>grpc_health.v1.health &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>grpc_health.v1.health &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="../../../_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="../../../" src="../../../_static/documentation_options.js"></script>
@@ -31,7 +31,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 2 - 2
python/_modules/grpc_reflection/v1alpha/reflection.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>grpc_reflection.v1alpha.reflection &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>grpc_reflection.v1alpha.reflection &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="../../../_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="../../../" src="../../../_static/documentation_options.js"></script>
@@ -31,7 +31,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 2 - 2
python/_modules/grpc_status/rpc_status.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>grpc_status.rpc_status &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>grpc_status.rpc_status &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="../../" src="../../_static/documentation_options.js"></script>
@@ -31,7 +31,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 2 - 2
python/_modules/grpc_testing.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>grpc_testing &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>grpc_testing &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
@@ -31,7 +31,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 2 - 2
python/_modules/index.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>Overview: module code &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>Overview: module code &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
@@ -31,7 +31,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 6 - 0
python/_sources/grpc.rst.txt

@@ -172,3 +172,9 @@ Future Interfaces
 .. autoexception:: FutureTimeoutError
 .. autoexception:: FutureCancelledError
 .. autoclass:: Future
+
+
+Compression
+^^^^^^^^^^^
+
+.. autoclass:: Compression

+ 1 - 1
python/_static/documentation_options.js

@@ -1,6 +1,6 @@
 var DOCUMENTATION_OPTIONS = {
     URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
-    VERSION: '1.20.0',
+    VERSION: '1.21.1',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     FILE_SUFFIX: '.html',

+ 13 - 5
python/genindex.html

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>Index &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>Index &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
@@ -32,7 +32,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 
@@ -234,6 +234,10 @@
       <li><a href="grpc.html#grpc.composite_call_credentials">composite_call_credentials() (in module grpc)</a>
 </li>
       <li><a href="grpc.html#grpc.composite_channel_credentials">composite_channel_credentials() (in module grpc)</a>
+</li>
+      <li><a href="grpc.html#grpc.Compression">Compression (class in grpc)</a>
+</li>
+      <li><a href="grpc.html#grpc.ClientCallDetails.compression">compression (grpc.ClientCallDetails attribute)</a>
 </li>
       <li><a href="grpc.html#grpc.ChannelConnectivity.CONNECTING">CONNECTING (grpc.ChannelConnectivity attribute)</a>
 </li>
@@ -248,10 +252,12 @@
       <li><a href="grpc.html#grpc.StatusCode.DATA_LOSS">DATA_LOSS (grpc.StatusCode attribute)</a>
 </li>
       <li><a href="grpc.html#grpc.StatusCode.DEADLINE_EXCEEDED">DEADLINE_EXCEEDED (grpc.StatusCode attribute)</a>
+</li>
+      <li><a href="grpc.html#grpc.Call.details">details() (grpc.Call method)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="grpc.html#grpc.Call.details">details() (grpc.Call method)</a>
+      <li><a href="grpc.html#grpc.ServicerContext.disable_next_message_compression">disable_next_message_compression() (grpc.ServicerContext method)</a>
 </li>
       <li><a href="grpc.html#grpc.Future.done">done() (grpc.Future method)</a>
 </li>
@@ -541,12 +547,14 @@
 </li>
       <li><a href="grpc.html#grpc.ServicerContext.set_code">set_code() (grpc.ServicerContext method)</a>
 </li>
-      <li><a href="grpc.html#grpc.ServicerContext.set_details">set_details() (grpc.ServicerContext method)</a>
+      <li><a href="grpc.html#grpc.ServicerContext.set_compression">set_compression() (grpc.ServicerContext method)</a>
 </li>
-      <li><a href="grpc.html#grpc.ServicerContext.set_trailing_metadata">set_trailing_metadata() (grpc.ServicerContext method)</a>
+      <li><a href="grpc.html#grpc.ServicerContext.set_details">set_details() (grpc.ServicerContext method)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="grpc.html#grpc.ServicerContext.set_trailing_metadata">set_trailing_metadata() (grpc.ServicerContext method)</a>
+</li>
       <li><a href="grpc.html#grpc.ChannelConnectivity.SHUTDOWN">SHUTDOWN (grpc.ChannelConnectivity attribute)</a>
 </li>
       <li><a href="grpc_testing.html#grpc_testing.Time.sleep_for">sleep_for() (grpc_testing.Time method)</a>

+ 2 - 2
python/glossary.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>Glossary &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>Glossary &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
@@ -32,7 +32,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 79 - 13
python/grpc.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>gRPC &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>gRPC &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
@@ -33,7 +33,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 
@@ -68,6 +68,7 @@
 <li class="toctree-l3"><a class="reference internal" href="#service-side-interceptor">Service-Side Interceptor</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#multi-callable-interfaces">Multi-Callable Interfaces</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#future-interfaces">Future Interfaces</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#compression">Compression</a></li>
 </ul>
 </li>
 </ul>
@@ -138,7 +139,7 @@ Or, if you would like dive in with more extensive usage of gRPC Python, check <a
 <h3>Create Client<a class="headerlink" href="#create-client" title="Permalink to this headline">¶</a></h3>
 <dl class="function">
 <dt id="grpc.insecure_channel">
-<code class="descclassname">grpc.</code><code class="descname">insecure_channel</code><span class="sig-paren">(</span><em>target</em>, <em>options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#insecure_channel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.insecure_channel" title="Permalink to this definition">¶</a></dt>
+<code class="descclassname">grpc.</code><code class="descname">insecure_channel</code><span class="sig-paren">(</span><em>target</em>, <em>options=None</em>, <em>compression=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#insecure_channel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.insecure_channel" title="Permalink to this definition">¶</a></dt>
 <dd><p>Creates an insecure Channel to a server.</p>
 <p>The returned Channel is thread-safe.</p>
 <table class="docutils field-list" frame="void" rules="none">
@@ -149,6 +150,8 @@ Or, if you would like dive in with more extensive usage of gRPC Python, check <a
 <li><strong>target</strong> – The server address</li>
 <li><strong>options</strong> – An optional list of key-value pairs (channel args
 in gRPC Core runtime) to configure the channel.</li>
+<li><strong>compression</strong> – An optional value indicating the compression method to be
+used over the lifetime of the channel. This is an EXPERIMENTAL option.</li>
 </ul>
 </td>
 </tr>
@@ -161,7 +164,7 @@ in gRPC Core runtime) to configure the channel.</li>
 
 <dl class="function">
 <dt id="grpc.secure_channel">
-<code class="descclassname">grpc.</code><code class="descname">secure_channel</code><span class="sig-paren">(</span><em>target</em>, <em>credentials</em>, <em>options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#secure_channel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.secure_channel" title="Permalink to this definition">¶</a></dt>
+<code class="descclassname">grpc.</code><code class="descname">secure_channel</code><span class="sig-paren">(</span><em>target</em>, <em>credentials</em>, <em>options=None</em>, <em>compression=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#secure_channel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.secure_channel" title="Permalink to this definition">¶</a></dt>
 <dd><p>Creates a secure Channel to a server.</p>
 <p>The returned Channel is thread-safe.</p>
 <table class="docutils field-list" frame="void" rules="none">
@@ -173,6 +176,8 @@ in gRPC Core runtime) to configure the channel.</li>
 <li><strong>credentials</strong> – A ChannelCredentials instance.</li>
 <li><strong>options</strong> – An optional list of key-value pairs (channel args
 in gRPC Core runtime) to configure the channel.</li>
+<li><strong>compression</strong> – An optional value indicating the compression method to be
+used over the lifetime of the channel. This is an EXPERIMENTAL option.</li>
 </ul>
 </td>
 </tr>
@@ -332,7 +337,7 @@ authorization header, for example
 <h3>Create Server<a class="headerlink" href="#create-server" title="Permalink to this headline">¶</a></h3>
 <dl class="function">
 <dt id="grpc.server">
-<code class="descclassname">grpc.</code><code class="descname">server</code><span class="sig-paren">(</span><em>thread_pool</em>, <em>handlers=None</em>, <em>interceptors=None</em>, <em>options=None</em>, <em>maximum_concurrent_rpcs=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#server"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.server" title="Permalink to this definition">¶</a></dt>
+<code class="descclassname">grpc.</code><code class="descname">server</code><span class="sig-paren">(</span><em>thread_pool</em>, <em>handlers=None</em>, <em>interceptors=None</em>, <em>options=None</em>, <em>maximum_concurrent_rpcs=None</em>, <em>compression=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#server"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.server" title="Permalink to this definition">¶</a></dt>
 <dd><p>Creates a Server with which RPCs can be serviced.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
@@ -353,6 +358,9 @@ to configure the channel.</li>
 <li><strong>maximum_concurrent_rpcs</strong> – The maximum number of concurrent RPCs this server
 will service before returning RESOURCE_EXHAUSTED status, or None to
 indicate no limit.</li>
+<li><strong>compression</strong> – An element of grpc.compression, e.g.
+grpc.compression.Gzip. This compression algorithm will be used for the
+lifetime of the server unless overridden. This is an EXPERIMENTAL option.</li>
 </ul>
 </td>
 </tr>
@@ -1330,6 +1338,13 @@ the service-side of the RPC.</p>
 enable wait for ready mechanism.</p>
 </dd></dl>
 
+<dl class="attribute">
+<dt id="grpc.ClientCallDetails.compression">
+<code class="descname">compression</code><a class="headerlink" href="#grpc.ClientCallDetails.compression" title="Permalink to this definition">¶</a></dt>
+<dd><p>An element of grpc.compression, e.g.
+grpc.compression.Gzip. This is an EXPERIMENTAL option.</p>
+</dd></dl>
+
 </dd></dl>
 
 <dl class="class">
@@ -1575,6 +1590,15 @@ RPC to the gRPC runtime.</td>
 </table>
 </dd></dl>
 
+<dl class="method">
+<dt id="grpc.ServicerContext.disable_next_message_compression">
+<code class="descname">disable_next_message_compression</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServicerContext.disable_next_message_compression"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext.disable_next_message_compression" title="Permalink to this definition">¶</a></dt>
+<dd><p>Disables compression for the next response message.</p>
+<p>This is an EXPERIMENTAL method.</p>
+<p>This method will override any compression configuration set during
+server creation or set on the call.</p>
+</dd></dl>
+
 <dl class="method">
 <dt id="grpc.ServicerContext.invocation_metadata">
 <code class="descname">invocation_metadata</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServicerContext.invocation_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext.invocation_metadata" title="Permalink to this definition">¶</a></dt>
@@ -1670,6 +1694,22 @@ the gRPC runtime to determine the status code of the RPC.</p>
 </table>
 </dd></dl>
 
+<dl class="method">
+<dt id="grpc.ServicerContext.set_compression">
+<code class="descname">set_compression</code><span class="sig-paren">(</span><em>compression</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServicerContext.set_compression"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext.set_compression" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the compression algorithm to be used for the entire call.</p>
+<p>This is an EXPERIMENTAL method.</p>
+<table class="docutils field-list" frame="void" rules="none">
+<col class="field-name" />
+<col class="field-body" />
+<tbody valign="top">
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>compression</strong> – An element of grpc.compression, e.g.
+grpc.compression.Gzip.</td>
+</tr>
+</tbody>
+</table>
+</dd></dl>
+
 <dl class="method">
 <dt id="grpc.ServicerContext.set_details">
 <code class="descname">set_details</code><span class="sig-paren">(</span><em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServicerContext.set_details"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext.set_details" title="Permalink to this definition">¶</a></dt>
@@ -1891,7 +1931,7 @@ interceptor chooses to service this RPC, or None otherwise.</p>
 <dd><p>Affords invoking a unary-unary RPC from client-side.</p>
 <dl class="method">
 <dt id="grpc.UnaryUnaryMultiCallable.__call__">
-<code class="descname">__call__</code><span class="sig-paren">(</span><em>request</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#UnaryUnaryMultiCallable.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryUnaryMultiCallable.__call__" title="Permalink to this definition">¶</a></dt>
+<code class="descname">__call__</code><span class="sig-paren">(</span><em>request</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em>, <em>compression=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#UnaryUnaryMultiCallable.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryUnaryMultiCallable.__call__" title="Permalink to this definition">¶</a></dt>
 <dd><p>Synchronously invokes the underlying RPC.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
@@ -1906,6 +1946,8 @@ service-side of the RPC.</li>
 <li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 <li><strong>wait_for_ready</strong> – This is an EXPERIMENTAL argument. An optional
 flag to enable wait for ready mechanism</li>
+<li><strong>compression</strong> – An element of grpc.compression, e.g.
+grpc.compression.Gzip. This is an EXPERIMENTAL option.</li>
 </ul>
 </td>
 </tr>
@@ -1923,7 +1965,7 @@ metadata, status code, and details.</p>
 
 <dl class="method">
 <dt id="grpc.UnaryUnaryMultiCallable.future">
-<code class="descname">future</code><span class="sig-paren">(</span><em>request</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#UnaryUnaryMultiCallable.future"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryUnaryMultiCallable.future" title="Permalink to this definition">¶</a></dt>
+<code class="descname">future</code><span class="sig-paren">(</span><em>request</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em>, <em>compression=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#UnaryUnaryMultiCallable.future"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryUnaryMultiCallable.future" title="Permalink to this definition">¶</a></dt>
 <dd><p>Asynchronously invokes the underlying RPC.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
@@ -1938,6 +1980,8 @@ service-side of the RPC.</li>
 <li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 <li><strong>wait_for_ready</strong> – This is an EXPERIMENTAL argument. An optional
 flag to enable wait for ready mechanism</li>
+<li><strong>compression</strong> – An element of grpc.compression, e.g.
+grpc.compression.Gzip. This is an EXPERIMENTAL option.</li>
 </ul>
 </td>
 </tr>
@@ -1954,7 +1998,7 @@ the returned Call-Future’s exception value will be an RpcError.</p>
 
 <dl class="method">
 <dt id="grpc.UnaryUnaryMultiCallable.with_call">
-<code class="descname">with_call</code><span class="sig-paren">(</span><em>request</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#UnaryUnaryMultiCallable.with_call"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryUnaryMultiCallable.with_call" title="Permalink to this definition">¶</a></dt>
+<code class="descname">with_call</code><span class="sig-paren">(</span><em>request</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em>, <em>compression=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#UnaryUnaryMultiCallable.with_call"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryUnaryMultiCallable.with_call" title="Permalink to this definition">¶</a></dt>
 <dd><p>Synchronously invokes the underlying RPC.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
@@ -1969,6 +2013,8 @@ service-side of the RPC.</li>
 <li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 <li><strong>wait_for_ready</strong> – This is an EXPERIMENTAL argument. An optional
 flag to enable wait for ready mechanism</li>
+<li><strong>compression</strong> – An element of grpc.compression, e.g.
+grpc.compression.Gzip. This is an EXPERIMENTAL option.</li>
 </ul>
 </td>
 </tr>
@@ -1992,7 +2038,7 @@ metadata, status code, and details.</p>
 <dd><p>Affords invoking a unary-stream RPC from client-side.</p>
 <dl class="method">
 <dt id="grpc.UnaryStreamMultiCallable.__call__">
-<code class="descname">__call__</code><span class="sig-paren">(</span><em>request</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#UnaryStreamMultiCallable.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryStreamMultiCallable.__call__" title="Permalink to this definition">¶</a></dt>
+<code class="descname">__call__</code><span class="sig-paren">(</span><em>request</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em>, <em>compression=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#UnaryStreamMultiCallable.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryStreamMultiCallable.__call__" title="Permalink to this definition">¶</a></dt>
 <dd><p>Invokes the underlying RPC.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
@@ -2007,6 +2053,8 @@ service-side of the RPC.</li>
 <li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 <li><strong>wait_for_ready</strong> – This is an EXPERIMENTAL argument. An optional
 flag to enable wait for ready mechanism</li>
+<li><strong>compression</strong> – An element of grpc.compression, e.g.
+grpc.compression.Gzip. This is an EXPERIMENTAL option.</li>
 </ul>
 </td>
 </tr>
@@ -2028,7 +2076,7 @@ RPC with non-OK status.</p>
 <dd><p>Affords invoking a stream-unary RPC from client-side.</p>
 <dl class="method">
 <dt id="grpc.StreamUnaryMultiCallable.__call__">
-<code class="descname">__call__</code><span class="sig-paren">(</span><em>request_iterator</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#StreamUnaryMultiCallable.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamUnaryMultiCallable.__call__" title="Permalink to this definition">¶</a></dt>
+<code class="descname">__call__</code><span class="sig-paren">(</span><em>request_iterator</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em>, <em>compression=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#StreamUnaryMultiCallable.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamUnaryMultiCallable.__call__" title="Permalink to this definition">¶</a></dt>
 <dd><p>Synchronously invokes the underlying RPC.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
@@ -2044,6 +2092,8 @@ service-side of the RPC.</li>
 <li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 <li><strong>wait_for_ready</strong> – This is an EXPERIMENTAL argument. An optional
 flag to enable wait for ready mechanism</li>
+<li><strong>compression</strong> – An element of grpc.compression, e.g.
+grpc.compression.Gzip. This is an EXPERIMENTAL option.</li>
 </ul>
 </td>
 </tr>
@@ -2061,7 +2111,7 @@ such as metadata, code, and details.</p>
 
 <dl class="method">
 <dt id="grpc.StreamUnaryMultiCallable.future">
-<code class="descname">future</code><span class="sig-paren">(</span><em>request_iterator</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#StreamUnaryMultiCallable.future"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamUnaryMultiCallable.future" title="Permalink to this definition">¶</a></dt>
+<code class="descname">future</code><span class="sig-paren">(</span><em>request_iterator</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em>, <em>compression=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#StreamUnaryMultiCallable.future"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamUnaryMultiCallable.future" title="Permalink to this definition">¶</a></dt>
 <dd><p>Asynchronously invokes the underlying RPC on the client.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
@@ -2076,6 +2126,8 @@ service-side of the RPC.</li>
 <li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 <li><strong>wait_for_ready</strong> – This is an EXPERIMENTAL argument. An optional
 flag to enable wait for ready mechanism</li>
+<li><strong>compression</strong> – An element of grpc.compression, e.g.
+grpc.compression.Gzip. This is an EXPERIMENTAL option.</li>
 </ul>
 </td>
 </tr>
@@ -2092,7 +2144,7 @@ be an RpcError.</p>
 
 <dl class="method">
 <dt id="grpc.StreamUnaryMultiCallable.with_call">
-<code class="descname">with_call</code><span class="sig-paren">(</span><em>request_iterator</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#StreamUnaryMultiCallable.with_call"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamUnaryMultiCallable.with_call" title="Permalink to this definition">¶</a></dt>
+<code class="descname">with_call</code><span class="sig-paren">(</span><em>request_iterator</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em>, <em>compression=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#StreamUnaryMultiCallable.with_call"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamUnaryMultiCallable.with_call" title="Permalink to this definition">¶</a></dt>
 <dd><p>Synchronously invokes the underlying RPC on the client.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
@@ -2108,6 +2160,8 @@ service-side of the RPC.</li>
 <li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 <li><strong>wait_for_ready</strong> – This is an EXPERIMENTAL argument. An optional
 flag to enable wait for ready mechanism</li>
+<li><strong>compression</strong> – An element of grpc.compression, e.g.
+grpc.compression.Gzip. This is an EXPERIMENTAL option.</li>
 </ul>
 </td>
 </tr>
@@ -2131,7 +2185,7 @@ metadata, status code, and details.</p>
 <dd><p>Affords invoking a stream-stream RPC on client-side.</p>
 <dl class="method">
 <dt id="grpc.StreamStreamMultiCallable.__call__">
-<code class="descname">__call__</code><span class="sig-paren">(</span><em>request_iterator</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#StreamStreamMultiCallable.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamStreamMultiCallable.__call__" title="Permalink to this definition">¶</a></dt>
+<code class="descname">__call__</code><span class="sig-paren">(</span><em>request_iterator</em>, <em>timeout=None</em>, <em>metadata=None</em>, <em>credentials=None</em>, <em>wait_for_ready=None</em>, <em>compression=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#StreamStreamMultiCallable.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamStreamMultiCallable.__call__" title="Permalink to this definition">¶</a></dt>
 <dd><p>Invokes the underlying RPC on the client.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
@@ -2146,6 +2200,8 @@ service-side of the RPC.</li>
 <li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 <li><strong>wait_for_ready</strong> – This is an EXPERIMENTAL argument. An optional
 flag to enable wait for ready mechanism</li>
+<li><strong>compression</strong> – An element of grpc.compression, e.g.
+grpc.compression.Gzip. This is an EXPERIMENTAL option.</li>
 </ul>
 </td>
 </tr>
@@ -2378,6 +2434,16 @@ does not terminate within the allotted time.</li>
 
 </dd></dl>
 
+</div>
+<div class="section" id="compression">
+<h3>Compression<a class="headerlink" href="#compression" title="Permalink to this headline">¶</a></h3>
+<dl class="class">
+<dt id="grpc.Compression">
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">Compression</code><a class="reference internal" href="_modules/grpc.html#Compression"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Compression" title="Permalink to this definition">¶</a></dt>
+<dd><p>Indicates the compression method to be used for an RPC.</p>
+<p>This enumeration is part of an EXPERIMENTAL API.</p>
+</dd></dl>
+
 </div>
 </div>
 </div>

+ 2 - 2
python/grpc_channelz.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>gRPC Channelz &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>gRPC Channelz &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
@@ -33,7 +33,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 2 - 2
python/grpc_health_checking.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>gRPC Health Checking &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>gRPC Health Checking &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
@@ -33,7 +33,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 2 - 2
python/grpc_reflection.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>gRPC Reflection &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>gRPC Reflection &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
@@ -33,7 +33,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 2 - 2
python/grpc_status.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>gRPC Status &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>gRPC Status &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
@@ -33,7 +33,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 2 - 2
python/grpc_testing.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>gRPC Testing &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>gRPC Testing &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
@@ -33,7 +33,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 4 - 3
python/index.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>Welcome to gRPC Python’s documentation! &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>Welcome to gRPC Python’s documentation! &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
@@ -32,7 +32,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 
@@ -89,7 +89,7 @@
             
   <div class="section" id="welcome-to-grpc-python-s-documentation">
 <h1>Welcome to gRPC Python’s documentation!<a class="headerlink" href="#welcome-to-grpc-python-s-documentation" title="Permalink to this headline">¶</a></h1>
-<p>Version: 1.20.0 Release: 1.20.0</p>
+<p>Version: 1.21.1 Release: 1.21.1</p>
 </div>
 <div class="section" id="api-reference">
 <h1>API Reference<a class="headerlink" href="#api-reference" title="Permalink to this headline">¶</a></h1>
@@ -121,6 +121,7 @@
 <li class="toctree-l3"><a class="reference internal" href="grpc.html#service-side-interceptor">Service-Side Interceptor</a></li>
 <li class="toctree-l3"><a class="reference internal" href="grpc.html#multi-callable-interfaces">Multi-Callable Interfaces</a></li>
 <li class="toctree-l3"><a class="reference internal" href="grpc.html#future-interfaces">Future Interfaces</a></li>
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#compression">Compression</a></li>
 </ul>
 </li>
 </ul>

二进制
python/objects.inv


+ 2 - 2
python/py-modindex.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>Python Module Index &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>Python Module Index &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
@@ -34,7 +34,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

+ 2 - 2
python/search.html

@@ -6,7 +6,7 @@
   <head>
     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>Search &#8212; gRPC Python 1.20.0 documentation</title>
+    <title>Search &#8212; gRPC Python 1.21.1 documentation</title>
     <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     
@@ -40,7 +40,7 @@
 
 
 
-<p class="blurb">1.20.0</p>
+<p class="blurb">1.21.1</p>
 
 
 

文件差异内容过多而无法显示
+ 0 - 0
python/searchindex.js


部分文件因为文件数量过多而无法显示