首頁 探索 說明
登入
carto
/
grpc
2
0
複刻 0
Files 問題管理 0 合併請求 0 Wiki
瀏覽代碼

Update the Python documentation to v1.16.0
Related PR 17074 and 17194

Lidi Zheng 6 年之前
父節點
4d24ed5573
當前提交
d8cf6a09d0
共有 93 個文件被更改，包括 8595 次插入 和 14770 次删除
分割檢視 顯示文件統計
  1. 1 1
      python/.buildinfo
  2. 二進制
      python/.doctrees/api.doctree
  3. 二進制
      python/.doctrees/environment.pickle
  4. 二進制
      python/.doctrees/glossary.doctree
  5. 二進制
      python/.doctrees/grpc.beta.doctree
  6. 二進制
      python/.doctrees/grpc.doctree
  7. 二進制
      python/.doctrees/grpc.framework.common.doctree
  8. 二進制
      python/.doctrees/grpc.framework.doctree
  9. 二進制
      python/.doctrees/grpc.framework.foundation.doctree
  10. 二進制
      python/.doctrees/grpc.framework.interfaces.base.doctree
  11. 二進制
      python/.doctrees/grpc.framework.interfaces.doctree
  12. 二進制
      python/.doctrees/grpc.framework.interfaces.face.doctree
  13. 二進制
      python/.doctrees/grpc_health_checking.doctree
  14. 二進制
      python/.doctrees/grpc_reflection.doctree
  15. 二進制
      python/.doctrees/grpc_testing.doctree
  16. 二進制
      python/.doctrees/index.doctree
  17. 369 397
      python/_modules/grpc.html
  18. 0 536
      python/_modules/grpc/beta/implementations.html
  19. 0 391
      python/_modules/grpc/beta/interfaces.html
  20. 0 373
      python/_modules/grpc/beta/utilities.html
  21. 0 252
      python/_modules/grpc/framework/common/cardinality.html
  22. 0 250
      python/_modules/grpc/framework/common/style.html
  23. 0 248
      python/_modules/grpc/framework/foundation/abandonment.html
  24. 0 320
      python/_modules/grpc/framework/foundation/callable_util.html
  25. 0 447
      python/_modules/grpc/framework/foundation/future.html
  26. 0 295
      python/_modules/grpc/framework/foundation/logging_pool.html
  27. 0 271
      python/_modules/grpc/framework/foundation/stream.html
  28. 0 373
      python/_modules/grpc/framework/foundation/stream_util.html
  29. 0 556
      python/_modules/grpc/framework/interfaces/base/base.html
  30. 0 290
      python/_modules/grpc/framework/interfaces/base/utilities.html
  31. 0 1271
      python/_modules/grpc/framework/interfaces/face/face.html
  32. 0 394
      python/_modules/grpc/framework/interfaces/face/utilities.html
  33. 174 0
      python/_modules/grpc_health/v1/health.html
  34. 270 0
      python/_modules/grpc_reflection/v1alpha/reflection.html
  35. 819 0
      python/_modules/grpc_testing.html
  36. 84 197
      python/_modules/index.html
  37. 153 0
      python/_sources/api.rst.txt
  38. 16 0
      python/_sources/glossary.rst.txt
  39. 0 38
      python/_sources/grpc.beta.rst.txt
  40. 0 30
      python/_sources/grpc.framework.common.rst.txt
  41. 0 62
      python/_sources/grpc.framework.foundation.rst.txt
  42. 0 30
      python/_sources/grpc.framework.interfaces.base.rst.txt
  43. 0 30
      python/_sources/grpc.framework.interfaces.face.rst.txt
  44. 0 18
      python/_sources/grpc.framework.interfaces.rst.txt
  45. 0 19
      python/_sources/grpc.framework.rst.txt
  46. 158 25
      python/_sources/grpc.rst.txt
  47. 7 0
      python/_sources/grpc_health_checking.rst.txt
  48. 19 0
      python/_sources/grpc_reflection.rst.txt
  49. 7 0
      python/_sources/grpc_testing.rst.txt
  50. 10 7
      python/_sources/index.rst.txt
  51. 703 0
      python/_static/alabaster.css
  52. 35 2
      python/_static/basic.css
  53. 0 0
      python/_static/css/badge_only.css
  54. 0 0
      python/_static/css/theme.css
  55. 1 0
      python/_static/custom.css
  56. 9 5
      python/_static/doctools.js
  57. 296 0
      python/_static/documentation_options.js
  58. 二進制
      python/_static/fonts/Inconsolata-Bold.ttf
  59. 二進制
      python/_static/fonts/Inconsolata-Regular.ttf
  60. 二進制
      python/_static/fonts/Lato-Bold.ttf
  61. 二進制
      python/_static/fonts/Lato-Regular.ttf
  62. 二進制
      python/_static/fonts/RobotoSlab-Bold.ttf
  63. 二進制
      python/_static/fonts/RobotoSlab-Regular.ttf
  64. 二進制
      python/_static/fonts/fontawesome-webfont.eot
  65. 0 196
      python/_static/fonts/fontawesome-webfont.svg
  66. 二進制
      python/_static/fonts/fontawesome-webfont.ttf
  67. 二進制
      python/_static/fonts/fontawesome-webfont.woff
  68. 338 190
      python/_static/jquery-3.2.1.js
  69. 0 1
      python/_static/jquery.js
  70. 0 3
      python/_static/js/modernizr.min.js
  71. 0 169
      python/_static/js/theme.js
  72. 73 65
      python/_static/pygments.css
  73. 37 316
      python/_static/searchtools.js
  74. 2 2
      python/_static/websupport.js
  75. 2374 0
      python/api.html
  76. 127 580
      python/genindex.html
  77. 139 0
      python/glossary.html
  78. 0 737
      python/grpc.beta.html
  79. 0 311
      python/grpc.framework.common.html
  80. 0 763
      python/grpc.framework.foundation.html
  81. 0 300
      python/grpc.framework.html
  82. 0 811
      python/grpc.framework.interfaces.base.html
  83. 0 1815
      python/grpc.framework.interfaces.face.html
  84. 0 277
      python/grpc.framework.interfaces.html
  85. 664 428
      python/grpc.html
  86. 161 0
      python/grpc_health_checking.html
  87. 171 0
      python/grpc_reflection.html
  88. 1072 0
      python/grpc_testing.html
  89. 124 204
      python/index.html
  90. 二進制
      python/objects.inv
  91. 92 284
      python/py-modindex.html
  92. 90 190
      python/search.html
  93. 0 0
      python/searchindex.js

+ 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: e6fe31370f5cb513ac919a7ae583f0c7
 
+config: d1b2928324f0f131368304581717ea1d
 
 tags: 645f666f9bcd5a90fca523b33c5a78b7

二進制
python/.doctrees/api.doctree
查看文件


二進制
python/.doctrees/environment.pickle
查看文件


二進制
python/.doctrees/glossary.doctree
查看文件


二進制
python/.doctrees/grpc.beta.doctree
查看文件


二進制
python/.doctrees/grpc.doctree
查看文件


二進制
python/.doctrees/grpc.framework.common.doctree
查看文件


二進制
python/.doctrees/grpc.framework.doctree
查看文件


二進制
python/.doctrees/grpc.framework.foundation.doctree
查看文件


二進制
python/.doctrees/grpc.framework.interfaces.base.doctree
查看文件


二進制
python/.doctrees/grpc.framework.interfaces.doctree
查看文件


二進制
python/.doctrees/grpc.framework.interfaces.face.doctree
查看文件


二進制
python/.doctrees/grpc_health_checking.doctree
查看文件


二進制
python/.doctrees/grpc_reflection.doctree
查看文件


二進制
python/.doctrees/grpc_testing.doctree
查看文件


二進制
python/.doctrees/index.doctree
查看文件


File diff suppressed because it is too large
+ 369 - 397
python/_modules/grpc.html


+ 0 - 536
python/_modules/grpc/beta/implementations.html
查看文件 

@@ -1,536 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.beta.implementations &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../grpc.html"/> 
-
 
-  
-  <script src="../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.beta.implementations</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.beta.implementations</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015-2016 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;Entry points into the Beta API of gRPC Python.&quot;&quot;&quot;</span>
 
-
 
-<span class="c1"># threading is referenced from specification in this module.</span>
 
-<span class="kn">import</span> <span class="nn">threading</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-
 
-<span class="c1"># interfaces, cardinality, and face are referenced from specification in this</span>
 
-<span class="c1"># module.</span>
 
-<span class="kn">import</span> <span class="nn">grpc</span>
 
-<span class="kn">from</span> <span class="nn">grpc</span> <span class="k">import</span> <span class="n">_auth</span>
 
-<span class="kn">from</span> <span class="nn">grpc.beta</span> <span class="k">import</span> <span class="n">_client_adaptations</span>
 
-<span class="kn">from</span> <span class="nn">grpc.beta</span> <span class="k">import</span> <span class="n">_metadata</span>
 
-<span class="kn">from</span> <span class="nn">grpc.beta</span> <span class="k">import</span> <span class="n">_server_adaptations</span>
 
-<span class="kn">from</span> <span class="nn">grpc.beta</span> <span class="k">import</span> <span class="n">interfaces</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.common</span> <span class="k">import</span> <span class="n">cardinality</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.interfaces.face</span> <span class="k">import</span> <span class="n">face</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-
 
-<span class="c1"># pylint: disable=too-many-arguments</span>
 
-
 
-<span class="n">ChannelCredentials</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">ChannelCredentials</span>
 
-<span class="n">ssl_channel_credentials</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">ssl_channel_credentials</span>
 
-<span class="n">CallCredentials</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">CallCredentials</span>
 
-
 
-
 
-<div class="viewcode-block" id="metadata_call_credentials"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.metadata_call_credentials">[docs]</a><span class="k">def</span> <span class="nf">metadata_call_credentials</span><span class="p">(</span><span class="n">metadata_plugin</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-
 
-    <span class="k">def</span> <span class="nf">plugin</span><span class="p">(</span><span class="n">context</span><span class="p">,</span> <span class="n">callback</span><span class="p">):</span>
 
-
 
-        <span class="k">def</span> <span class="nf">wrapped_callback</span><span class="p">(</span><span class="n">beta_metadata</span><span class="p">,</span> <span class="n">error</span><span class="p">):</span>
 
-            <span class="n">callback</span><span class="p">(</span><span class="n">_metadata</span><span class="o">.</span><span class="n">unbeta</span><span class="p">(</span><span class="n">beta_metadata</span><span class="p">),</span> <span class="n">error</span><span class="p">)</span>
 
-
 
-        <span class="n">metadata_plugin</span><span class="p">(</span><span class="n">context</span><span class="p">,</span> <span class="n">wrapped_callback</span><span class="p">)</span>
 
-
 
-    <span class="k">return</span> <span class="n">grpc</span><span class="o">.</span><span class="n">metadata_call_credentials</span><span class="p">(</span><span class="n">plugin</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="google_call_credentials"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.google_call_credentials">[docs]</a><span class="k">def</span> <span class="nf">google_call_credentials</span><span class="p">(</span><span class="n">credentials</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Construct CallCredentials from GoogleCredentials.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    credentials: A GoogleCredentials object from the oauth2client library.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    A CallCredentials object for use in a GRPCCallOptions object.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">metadata_call_credentials</span><span class="p">(</span><span class="n">_auth</span><span class="o">.</span><span class="n">GoogleCallCredentials</span><span class="p">(</span><span class="n">credentials</span><span class="p">))</span></div>
 
-
 
-
 
-<span class="n">access_token_call_credentials</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">access_token_call_credentials</span>
 
-<span class="n">composite_call_credentials</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">composite_call_credentials</span>
 
-<span class="n">composite_channel_credentials</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">composite_channel_credentials</span>
 
-
 
-
 
-<div class="viewcode-block" id="Channel"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.Channel">[docs]</a><span class="k">class</span> <span class="nc">Channel</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;A channel to a remote host through which RPCs may be conducted.</span>
 
-
 
-<span class="sd">  Only the &quot;subscribe&quot; and &quot;unsubscribe&quot; methods are supported for application</span>
 
-<span class="sd">  use. This class&#39; instance constructor and all other attributes are</span>
 
-<span class="sd">  unsupported.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">channel</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_channel</span> <span class="o">=</span> <span class="n">channel</span>
 
-
 
-<div class="viewcode-block" id="Channel.subscribe"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.Channel.subscribe">[docs]</a>    <span class="k">def</span> <span class="nf">subscribe</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">callback</span><span class="p">,</span> <span class="n">try_to_connect</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Subscribes to this Channel&#39;s connectivity.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      callback: A callable to be invoked and passed an</span>
 
-<span class="sd">        interfaces.ChannelConnectivity identifying this Channel&#39;s connectivity.</span>
 
-<span class="sd">        The callable will be invoked immediately upon subscription and again for</span>
 
-<span class="sd">        every change to this Channel&#39;s connectivity thereafter until it is</span>
 
-<span class="sd">        unsubscribed.</span>
 
-<span class="sd">      try_to_connect: A boolean indicating whether or not this Channel should</span>
 
-<span class="sd">        attempt to connect if it is not already connected and ready to conduct</span>
 
-<span class="sd">        RPCs.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_channel</span><span class="o">.</span><span class="n">subscribe</span><span class="p">(</span><span class="n">callback</span><span class="p">,</span> <span class="n">try_to_connect</span><span class="o">=</span><span class="n">try_to_connect</span><span class="p">)</span></div>
 
-
 
-<div class="viewcode-block" id="Channel.unsubscribe"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.Channel.unsubscribe">[docs]</a>    <span class="k">def</span> <span class="nf">unsubscribe</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">callback</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Unsubscribes a callback from this Channel&#39;s connectivity.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      callback: A callable previously registered with this Channel from having</span>
 
-<span class="sd">        been passed to its &quot;subscribe&quot; method.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_channel</span><span class="o">.</span><span class="n">unsubscribe</span><span class="p">(</span><span class="n">callback</span><span class="p">)</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="insecure_channel"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.insecure_channel">[docs]</a><span class="k">def</span> <span class="nf">insecure_channel</span><span class="p">(</span><span class="n">host</span><span class="p">,</span> <span class="n">port</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates an insecure Channel to a remote host.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    host: The name of the remote host to which to connect.</span>
 
-<span class="sd">    port: The port of the remote host to which to connect.</span>
 
-<span class="sd">      If None only the &#39;host&#39; part will be used.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    A Channel to the remote host through which RPCs may be conducted.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="n">channel</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">insecure_channel</span><span class="p">(</span><span class="n">host</span>
 
-                                    <span class="k">if</span> <span class="n">port</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">:</span><span class="si">%d</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">host</span><span class="p">,</span> <span class="n">port</span><span class="p">))</span>
 
-    <span class="k">return</span> <span class="n">Channel</span><span class="p">(</span><span class="n">channel</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="secure_channel"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.secure_channel">[docs]</a><span class="k">def</span> <span class="nf">secure_channel</span><span class="p">(</span><span class="n">host</span><span class="p">,</span> <span class="n">port</span><span class="p">,</span> <span class="n">channel_credentials</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates a secure Channel to a remote host.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    host: The name of the remote host to which to connect.</span>
 
-<span class="sd">    port: The port of the remote host to which to connect.</span>
 
-<span class="sd">      If None only the &#39;host&#39; part will be used.</span>
 
-<span class="sd">    channel_credentials: A ChannelCredentials.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    A secure Channel to the remote host through which RPCs may be conducted.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="n">channel</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">secure_channel</span><span class="p">(</span><span class="n">host</span> <span class="k">if</span> <span class="n">port</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span>
 
-                                  <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">:</span><span class="si">%d</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">host</span><span class="p">,</span> <span class="n">port</span><span class="p">),</span> <span class="n">channel_credentials</span><span class="p">)</span>
 
-    <span class="k">return</span> <span class="n">Channel</span><span class="p">(</span><span class="n">channel</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="StubOptions"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.StubOptions">[docs]</a><span class="k">class</span> <span class="nc">StubOptions</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;A value encapsulating the various options for creation of a Stub.</span>
 
-
 
-<span class="sd">  This class and its instances have no supported interface - it exists to define</span>
 
-<span class="sd">  the type of its instances and its instances exist to be passed to other</span>
 
-<span class="sd">  functions.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">host</span><span class="p">,</span> <span class="n">request_serializers</span><span class="p">,</span> <span class="n">response_deserializers</span><span class="p">,</span>
 
-                 <span class="n">metadata_transformer</span><span class="p">,</span> <span class="n">thread_pool</span><span class="p">,</span> <span class="n">thread_pool_size</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">host</span> <span class="o">=</span> <span class="n">host</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">request_serializers</span> <span class="o">=</span> <span class="n">request_serializers</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">response_deserializers</span> <span class="o">=</span> <span class="n">response_deserializers</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">metadata_transformer</span> <span class="o">=</span> <span class="n">metadata_transformer</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">thread_pool</span> <span class="o">=</span> <span class="n">thread_pool</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">thread_pool_size</span> <span class="o">=</span> <span class="n">thread_pool_size</span></div>
 
-
 
-
 
-<span class="n">_EMPTY_STUB_OPTIONS</span> <span class="o">=</span> <span class="n">StubOptions</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
 
-
 
-
 
-<div class="viewcode-block" id="stub_options"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.stub_options">[docs]</a><span class="k">def</span> <span class="nf">stub_options</span><span class="p">(</span><span class="n">host</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                 <span class="n">request_serializers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                 <span class="n">response_deserializers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                 <span class="n">metadata_transformer</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                 <span class="n">thread_pool</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                 <span class="n">thread_pool_size</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates a StubOptions value to be passed at stub creation.</span>
 
-
 
-<span class="sd">  All parameters are optional and should always be passed by keyword.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    host: A host string to set on RPC calls.</span>
 
-<span class="sd">    request_serializers: A dictionary from service name-method name pair to</span>
 
-<span class="sd">      request serialization behavior.</span>
 
-<span class="sd">    response_deserializers: A dictionary from service name-method name pair to</span>
 
-<span class="sd">      response deserialization behavior.</span>
 
-<span class="sd">    metadata_transformer: A callable that given a metadata object produces</span>
 
-<span class="sd">      another metadata object to be used in the underlying communication on the</span>
 
-<span class="sd">      wire.</span>
 
-<span class="sd">    thread_pool: A thread pool to use in stubs.</span>
 
-<span class="sd">    thread_pool_size: The size of thread pool to create for use in stubs;</span>
 
-<span class="sd">      ignored if thread_pool has been passed.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    A StubOptions value created from the passed parameters.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">StubOptions</span><span class="p">(</span><span class="n">host</span><span class="p">,</span> <span class="n">request_serializers</span><span class="p">,</span> <span class="n">response_deserializers</span><span class="p">,</span>
 
-                       <span class="n">metadata_transformer</span><span class="p">,</span> <span class="n">thread_pool</span><span class="p">,</span> <span class="n">thread_pool_size</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="generic_stub"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.generic_stub">[docs]</a><span class="k">def</span> <span class="nf">generic_stub</span><span class="p">(</span><span class="n">channel</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="sd">&quot;&quot;&quot;Creates a face.GenericStub on which RPCs can be made.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    channel: A Channel for use by the created stub.</span>
 
-<span class="sd">    options: A StubOptions customizing the created stub.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    A face.GenericStub on which RPCs can be made.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="n">effective_options</span> <span class="o">=</span> <span class="n">_EMPTY_STUB_OPTIONS</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="k">return</span> <span class="n">_client_adaptations</span><span class="o">.</span><span class="n">generic_stub</span><span class="p">(</span>
 
-        <span class="n">channel</span><span class="o">.</span><span class="n">_channel</span><span class="p">,</span>  <span class="c1"># pylint: disable=protected-access</span>
 
-        <span class="n">effective_options</span><span class="o">.</span><span class="n">host</span><span class="p">,</span>
 
-        <span class="n">effective_options</span><span class="o">.</span><span class="n">metadata_transformer</span><span class="p">,</span>
 
-        <span class="n">effective_options</span><span class="o">.</span><span class="n">request_serializers</span><span class="p">,</span>
 
-        <span class="n">effective_options</span><span class="o">.</span><span class="n">response_deserializers</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="dynamic_stub"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.dynamic_stub">[docs]</a><span class="k">def</span> <span class="nf">dynamic_stub</span><span class="p">(</span><span class="n">channel</span><span class="p">,</span> <span class="n">service</span><span class="p">,</span> <span class="n">cardinalities</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="sd">&quot;&quot;&quot;Creates a face.DynamicStub with which RPCs can be invoked.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    channel: A Channel for the returned face.DynamicStub to use.</span>
 
-<span class="sd">    service: The package-qualified full name of the service.</span>
 
-<span class="sd">    cardinalities: A dictionary from RPC method name to cardinality.Cardinality</span>
 
-<span class="sd">      value identifying the cardinality of the RPC method.</span>
 
-<span class="sd">    options: An optional StubOptions value further customizing the functionality</span>
 
-<span class="sd">      of the returned face.DynamicStub.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    A face.DynamicStub with which RPCs can be invoked.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="n">effective_options</span> <span class="o">=</span> <span class="n">_EMPTY_STUB_OPTIONS</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="k">return</span> <span class="n">_client_adaptations</span><span class="o">.</span><span class="n">dynamic_stub</span><span class="p">(</span>
 
-        <span class="n">channel</span><span class="o">.</span><span class="n">_channel</span><span class="p">,</span>  <span class="c1"># pylint: disable=protected-access</span>
 
-        <span class="n">service</span><span class="p">,</span>
 
-        <span class="n">cardinalities</span><span class="p">,</span>
 
-        <span class="n">effective_options</span><span class="o">.</span><span class="n">host</span><span class="p">,</span>
 
-        <span class="n">effective_options</span><span class="o">.</span><span class="n">metadata_transformer</span><span class="p">,</span>
 
-        <span class="n">effective_options</span><span class="o">.</span><span class="n">request_serializers</span><span class="p">,</span>
 
-        <span class="n">effective_options</span><span class="o">.</span><span class="n">response_deserializers</span><span class="p">)</span></div>
 
-
 
-
 
-<span class="n">ServerCredentials</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">ServerCredentials</span>
 
-<span class="n">ssl_server_credentials</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">ssl_server_credentials</span>
 
-
 
-
 
-<div class="viewcode-block" id="ServerOptions"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.ServerOptions">[docs]</a><span class="k">class</span> <span class="nc">ServerOptions</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;A value encapsulating the various options for creation of a Server.</span>
 
-
 
-<span class="sd">  This class and its instances have no supported interface - it exists to define</span>
 
-<span class="sd">  the type of its instances and its instances exist to be passed to other</span>
 
-<span class="sd">  functions.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">multi_method_implementation</span><span class="p">,</span> <span class="n">request_deserializers</span><span class="p">,</span>
 
-                 <span class="n">response_serializers</span><span class="p">,</span> <span class="n">thread_pool</span><span class="p">,</span> <span class="n">thread_pool_size</span><span class="p">,</span>
 
-                 <span class="n">default_timeout</span><span class="p">,</span> <span class="n">maximum_timeout</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">multi_method_implementation</span> <span class="o">=</span> <span class="n">multi_method_implementation</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">request_deserializers</span> <span class="o">=</span> <span class="n">request_deserializers</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">response_serializers</span> <span class="o">=</span> <span class="n">response_serializers</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">thread_pool</span> <span class="o">=</span> <span class="n">thread_pool</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">thread_pool_size</span> <span class="o">=</span> <span class="n">thread_pool_size</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">default_timeout</span> <span class="o">=</span> <span class="n">default_timeout</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">maximum_timeout</span> <span class="o">=</span> <span class="n">maximum_timeout</span></div>
 
-
 
-
 
-<span class="n">_EMPTY_SERVER_OPTIONS</span> <span class="o">=</span> <span class="n">ServerOptions</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
 
-
 
-
 
-<div class="viewcode-block" id="server_options"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.server_options">[docs]</a><span class="k">def</span> <span class="nf">server_options</span><span class="p">(</span><span class="n">multi_method_implementation</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                   <span class="n">request_deserializers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                   <span class="n">response_serializers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                   <span class="n">thread_pool</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                   <span class="n">thread_pool_size</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                   <span class="n">default_timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                   <span class="n">maximum_timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates a ServerOptions value to be passed at server creation.</span>
 
-
 
-<span class="sd">  All parameters are optional and should always be passed by keyword.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    multi_method_implementation: A face.MultiMethodImplementation to be called</span>
 
-<span class="sd">      to service an RPC if the server has no specific method implementation for</span>
 
-<span class="sd">      the name of the RPC for which service was requested.</span>
 
-<span class="sd">    request_deserializers: A dictionary from service name-method name pair to</span>
 
-<span class="sd">      request deserialization behavior.</span>
 
-<span class="sd">    response_serializers: A dictionary from service name-method name pair to</span>
 
-<span class="sd">      response serialization behavior.</span>
 
-<span class="sd">    thread_pool: A thread pool to use in stubs.</span>
 
-<span class="sd">    thread_pool_size: The size of thread pool to create for use in stubs;</span>
 
-<span class="sd">      ignored if thread_pool has been passed.</span>
 
-<span class="sd">    default_timeout: A duration in seconds to allow for RPC service when</span>
 
-<span class="sd">      servicing RPCs that did not include a timeout value when invoked.</span>
 
-<span class="sd">    maximum_timeout: A duration in seconds to allow for RPC service when</span>
 
-<span class="sd">      servicing RPCs no matter what timeout value was passed when the RPC was</span>
 
-<span class="sd">      invoked.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    A StubOptions value created from the passed parameters.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">ServerOptions</span><span class="p">(</span><span class="n">multi_method_implementation</span><span class="p">,</span> <span class="n">request_deserializers</span><span class="p">,</span>
 
-                         <span class="n">response_serializers</span><span class="p">,</span> <span class="n">thread_pool</span><span class="p">,</span> <span class="n">thread_pool_size</span><span class="p">,</span>
 
-                         <span class="n">default_timeout</span><span class="p">,</span> <span class="n">maximum_timeout</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="server"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.implementations.server">[docs]</a><span class="k">def</span> <span class="nf">server</span><span class="p">(</span><span class="n">service_implementations</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="sd">&quot;&quot;&quot;Creates an interfaces.Server with which RPCs can be serviced.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    service_implementations: A dictionary from service name-method name pair to</span>
 
-<span class="sd">      face.MethodImplementation.</span>
 
-<span class="sd">    options: An optional ServerOptions value further customizing the</span>
 
-<span class="sd">      functionality of the returned Server.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    An interfaces.Server with which RPCs can be serviced.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="n">effective_options</span> <span class="o">=</span> <span class="n">_EMPTY_SERVER_OPTIONS</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="k">return</span> <span class="n">_server_adaptations</span><span class="o">.</span><span class="n">server</span><span class="p">(</span>
 
-        <span class="n">service_implementations</span><span class="p">,</span> <span class="n">effective_options</span><span class="o">.</span><span class="n">multi_method_implementation</span><span class="p">,</span>
 
-        <span class="n">effective_options</span><span class="o">.</span><span class="n">request_deserializers</span><span class="p">,</span>
 
-        <span class="n">effective_options</span><span class="o">.</span><span class="n">response_serializers</span><span class="p">,</span> <span class="n">effective_options</span><span class="o">.</span><span class="n">thread_pool</span><span class="p">,</span>
 
-        <span class="n">effective_options</span><span class="o">.</span><span class="n">thread_pool_size</span><span class="p">)</span></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 391
python/_modules/grpc/beta/interfaces.html
查看文件 

@@ -1,391 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.beta.interfaces &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../grpc.html"/> 
-
 
-  
-  <script src="../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.beta.interfaces</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.beta.interfaces</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;Constants and interfaces of the Beta API of gRPC Python.&quot;&quot;&quot;</span>
 
-
 
-<span class="kn">import</span> <span class="nn">abc</span>
 
-
 
-<span class="kn">import</span> <span class="nn">six</span>
 
-
 
-<span class="kn">import</span> <span class="nn">grpc</span>
 
-
 
-<span class="n">ChannelConnectivity</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">ChannelConnectivity</span>
 
-<span class="c1"># FATAL_FAILURE was a Beta-API name for SHUTDOWN</span>
 
-<span class="n">ChannelConnectivity</span><span class="o">.</span><span class="n">FATAL_FAILURE</span> <span class="o">=</span> <span class="n">ChannelConnectivity</span><span class="o">.</span><span class="n">SHUTDOWN</span>
 
-
 
-<span class="n">StatusCode</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">StatusCode</span>
 
-
 
-
 
-<div class="viewcode-block" id="GRPCCallOptions"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.interfaces.GRPCCallOptions">[docs]</a><span class="k">class</span> <span class="nc">GRPCCallOptions</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;A value encapsulating gRPC-specific options passed on RPC invocation.</span>
 
-
 
-<span class="sd">  This class and its instances have no supported interface - it exists to</span>
 
-<span class="sd">  define the type of its instances and its instances exist to be passed to</span>
 
-<span class="sd">  other functions.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">disable_compression</span><span class="p">,</span> <span class="n">subcall_of</span><span class="p">,</span> <span class="n">credentials</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">disable_compression</span> <span class="o">=</span> <span class="n">disable_compression</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">subcall_of</span> <span class="o">=</span> <span class="n">subcall_of</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">credentials</span> <span class="o">=</span> <span class="n">credentials</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="grpc_call_options"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.interfaces.grpc_call_options">[docs]</a><span class="k">def</span> <span class="nf">grpc_call_options</span><span class="p">(</span><span class="n">disable_compression</span><span class="o">=</span><span class="kc">False</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="sd">&quot;&quot;&quot;Creates a GRPCCallOptions value to be passed at RPC invocation.</span>
 
-
 
-<span class="sd">  All parameters are optional and should always be passed by keyword.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    disable_compression: A boolean indicating whether or not compression should</span>
 
-<span class="sd">      be disabled for the request object of the RPC. Only valid for</span>
 
-<span class="sd">      request-unary RPCs.</span>
 
-<span class="sd">    credentials: A CallCredentials object to use for the invoked RPC.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">GRPCCallOptions</span><span class="p">(</span><span class="n">disable_compression</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n">credentials</span><span class="p">)</span></div>
 
-
 
-
 
-<span class="n">GRPCAuthMetadataContext</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">AuthMetadataContext</span>
 
-<span class="n">GRPCAuthMetadataPluginCallback</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">AuthMetadataPluginCallback</span>
 
-<span class="n">GRPCAuthMetadataPlugin</span> <span class="o">=</span> <span class="n">grpc</span><span class="o">.</span><span class="n">AuthMetadataPlugin</span>
 
-
 
-
 
-<div class="viewcode-block" id="GRPCServicerContext"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.interfaces.GRPCServicerContext">[docs]</a><span class="k">class</span> <span class="nc">GRPCServicerContext</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Exposes gRPC-specific options and behaviors to code servicing RPCs.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="GRPCServicerContext.peer"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.interfaces.GRPCServicerContext.peer">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">peer</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Identifies the peer that invoked the RPC being serviced.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A string identifying the peer that invoked the RPC being serviced.</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="GRPCServicerContext.disable_next_response_compression"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.interfaces.GRPCServicerContext.disable_next_response_compression">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">disable_next_response_compression</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Disables compression of the next response passed by the application.&quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="GRPCInvocationContext"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.interfaces.GRPCInvocationContext">[docs]</a><span class="k">class</span> <span class="nc">GRPCInvocationContext</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Exposes gRPC-specific options and behaviors to code invoking RPCs.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="GRPCInvocationContext.disable_next_request_compression"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.interfaces.GRPCInvocationContext.disable_next_request_compression">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">disable_next_request_compression</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Disables compression of the next request passed by the application.&quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="Server"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.interfaces.Server">[docs]</a><span class="k">class</span> <span class="nc">Server</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Services RPCs.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="Server.add_insecure_port"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.interfaces.Server.add_insecure_port">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">add_insecure_port</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">address</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Reserves a port for insecure RPC service once this Server becomes active.</span>
 
-
 
-<span class="sd">    This method may only be called before calling this Server&#39;s start method is</span>
 
-<span class="sd">    called.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      address: The address for which to open a port.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      An integer port on which RPCs will be serviced after this link has been</span>
 
-<span class="sd">        started. This is typically the same number as the port number contained</span>
 
-<span class="sd">        in the passed address, but will likely be different if the port number</span>
 
-<span class="sd">        contained in the passed address was zero.</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="Server.add_secure_port"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.interfaces.Server.add_secure_port">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">add_secure_port</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">address</span><span class="p">,</span> <span class="n">server_credentials</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Reserves a port for secure RPC service after this Server becomes active.</span>
 
-
 
-<span class="sd">    This method may only be called before calling this Server&#39;s start method is</span>
 
-<span class="sd">    called.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      address: The address for which to open a port.</span>
 
-<span class="sd">      server_credentials: A ServerCredentials.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      An integer port on which RPCs will be serviced after this link has been</span>
 
-<span class="sd">        started. This is typically the same number as the port number contained</span>
 
-<span class="sd">        in the passed address, but will likely be different if the port number</span>
 
-<span class="sd">        contained in the passed address was zero.</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="Server.start"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.interfaces.Server.start">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">start</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Starts this Server&#39;s service of RPCs.</span>
 
-
 
-<span class="sd">    This method may only be called while the server is not serving RPCs (i.e. it</span>
 
-<span class="sd">    is not idempotent).</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="Server.stop"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.interfaces.Server.stop">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">stop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">grace</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Stops this Server&#39;s service of RPCs.</span>
 
-
 
-<span class="sd">    All calls to this method immediately stop service of new RPCs. When existing</span>
 
-<span class="sd">    RPCs are aborted is controlled by the grace period parameter passed to this</span>
 
-<span class="sd">    method.</span>
 
-
 
-<span class="sd">    This method may be called at any time and is idempotent. Passing a smaller</span>
 
-<span class="sd">    grace value than has been passed in a previous call will have the effect of</span>
 
-<span class="sd">    stopping the Server sooner. Passing a larger grace value than has been</span>
 
-<span class="sd">    passed in a previous call will not have the effect of stopping the server</span>
 
-<span class="sd">    later.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      grace: A duration of time in seconds to allow existing RPCs to complete</span>
 
-<span class="sd">        before being aborted by this Server&#39;s stopping. May be zero for</span>
 
-<span class="sd">        immediate abortion of all in-progress RPCs.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A threading.Event that will be set when this Server has completely</span>
 
-<span class="sd">      stopped. The returned event may not be set until after the full grace</span>
 
-<span class="sd">      period (if some ongoing RPC continues for the full length of the period)</span>
 
-<span class="sd">      of it may be set much sooner (such as if this Server had no RPCs underway</span>
 
-<span class="sd">      at the time it was stopped or if all RPCs that it had underway completed</span>
 
-<span class="sd">      very early in the grace period).</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 373
python/_modules/grpc/beta/utilities.html
查看文件 

@@ -1,373 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.beta.utilities &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../grpc.html"/> 
-
 
-  
-  <script src="../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.beta.utilities</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.beta.utilities</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;Utilities for the gRPC Python Beta API.&quot;&quot;&quot;</span>
 
-
 
-<span class="kn">import</span> <span class="nn">threading</span>
 
-<span class="kn">import</span> <span class="nn">time</span>
 
-
 
-<span class="c1"># implementations is referenced from specification in this module.</span>
 
-<span class="kn">from</span> <span class="nn">grpc.beta</span> <span class="k">import</span> <span class="n">implementations</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-<span class="kn">from</span> <span class="nn">grpc.beta</span> <span class="k">import</span> <span class="n">interfaces</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.foundation</span> <span class="k">import</span> <span class="n">callable_util</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.foundation</span> <span class="k">import</span> <span class="n">future</span>
 
-
 
-<span class="n">_DONE_CALLBACK_EXCEPTION_LOG_MESSAGE</span> <span class="o">=</span> <span class="p">(</span>
 
-    <span class="s1">&#39;Exception calling connectivity future &quot;done&quot; callback!&#39;</span><span class="p">)</span>
 
-
 
-
 
-<span class="k">class</span> <span class="nc">_ChannelReadyFuture</span><span class="p">(</span><span class="n">future</span><span class="o">.</span><span class="n">Future</span><span class="p">):</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">channel</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Condition</span><span class="p">()</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_channel</span> <span class="o">=</span> <span class="n">channel</span>
 
-
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_matured</span> <span class="o">=</span> <span class="kc">False</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_cancelled</span> <span class="o">=</span> <span class="kc">False</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_done_callbacks</span> <span class="o">=</span> <span class="p">[]</span>
 
-
 
-    <span class="k">def</span> <span class="nf">_block</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">timeout</span><span class="p">):</span>
 
-        <span class="n">until</span> <span class="o">=</span> <span class="kc">None</span> <span class="k">if</span> <span class="n">timeout</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span> <span class="o">+</span> <span class="n">timeout</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
 
-                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cancelled</span><span class="p">:</span>
 
-                    <span class="k">raise</span> <span class="n">future</span><span class="o">.</span><span class="n">CancelledError</span><span class="p">()</span>
 
-                <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">_matured</span><span class="p">:</span>
 
-                    <span class="k">return</span>
 
-                <span class="k">else</span><span class="p">:</span>
 
-                    <span class="k">if</span> <span class="n">until</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
 
-                        <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="o">.</span><span class="n">wait</span><span class="p">()</span>
 
-                    <span class="k">else</span><span class="p">:</span>
 
-                        <span class="n">remaining</span> <span class="o">=</span> <span class="n">until</span> <span class="o">-</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span>
 
-                        <span class="k">if</span> <span class="n">remaining</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">:</span>
 
-                            <span class="k">raise</span> <span class="n">future</span><span class="o">.</span><span class="n">TimeoutError</span><span class="p">()</span>
 
-                        <span class="k">else</span><span class="p">:</span>
 
-                            <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="o">.</span><span class="n">wait</span><span class="p">(</span><span class="n">timeout</span><span class="o">=</span><span class="n">remaining</span><span class="p">)</span>
 
-
 
-    <span class="k">def</span> <span class="nf">_update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">connectivity</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="k">if</span> <span class="p">(</span><span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cancelled</span> <span class="ow">and</span>
 
-                    <span class="n">connectivity</span> <span class="ow">is</span> <span class="n">interfaces</span><span class="o">.</span><span class="n">ChannelConnectivity</span><span class="o">.</span><span class="n">READY</span><span class="p">):</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_matured</span> <span class="o">=</span> <span class="kc">True</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_channel</span><span class="o">.</span><span class="n">unsubscribe</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_update</span><span class="p">)</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="o">.</span><span class="n">notify_all</span><span class="p">()</span>
 
-                <span class="n">done_callbacks</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_done_callbacks</span><span class="p">)</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_done_callbacks</span> <span class="o">=</span> <span class="kc">None</span>
 
-            <span class="k">else</span><span class="p">:</span>
 
-                <span class="k">return</span>
 
-
 
-        <span class="k">for</span> <span class="n">done_callback</span> <span class="ow">in</span> <span class="n">done_callbacks</span><span class="p">:</span>
 
-            <span class="n">callable_util</span><span class="o">.</span><span class="n">call_logging_exceptions</span><span class="p">(</span>
 
-                <span class="n">done_callback</span><span class="p">,</span> <span class="n">_DONE_CALLBACK_EXCEPTION_LOG_MESSAGE</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span>
 
-
 
-    <span class="k">def</span> <span class="nf">cancel</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_matured</span><span class="p">:</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_cancelled</span> <span class="o">=</span> <span class="kc">True</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_channel</span><span class="o">.</span><span class="n">unsubscribe</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_update</span><span class="p">)</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="o">.</span><span class="n">notify_all</span><span class="p">()</span>
 
-                <span class="n">done_callbacks</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_done_callbacks</span><span class="p">)</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_done_callbacks</span> <span class="o">=</span> <span class="kc">None</span>
 
-            <span class="k">else</span><span class="p">:</span>
 
-                <span class="k">return</span> <span class="kc">False</span>
 
-
 
-        <span class="k">for</span> <span class="n">done_callback</span> <span class="ow">in</span> <span class="n">done_callbacks</span><span class="p">:</span>
 
-            <span class="n">callable_util</span><span class="o">.</span><span class="n">call_logging_exceptions</span><span class="p">(</span>
 
-                <span class="n">done_callback</span><span class="p">,</span> <span class="n">_DONE_CALLBACK_EXCEPTION_LOG_MESSAGE</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span>
 
-
 
-    <span class="k">def</span> <span class="nf">cancelled</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cancelled</span>
 
-
 
-    <span class="k">def</span> <span class="nf">running</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="k">return</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cancelled</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_matured</span>
 
-
 
-    <span class="k">def</span> <span class="nf">done</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cancelled</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">_matured</span>
 
-
 
-    <span class="k">def</span> <span class="nf">result</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_block</span><span class="p">(</span><span class="n">timeout</span><span class="p">)</span>
 
-        <span class="k">return</span> <span class="kc">None</span>
 
-
 
-    <span class="k">def</span> <span class="nf">exception</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_block</span><span class="p">(</span><span class="n">timeout</span><span class="p">)</span>
 
-        <span class="k">return</span> <span class="kc">None</span>
 
-
 
-    <span class="k">def</span> <span class="nf">traceback</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_block</span><span class="p">(</span><span class="n">timeout</span><span class="p">)</span>
 
-        <span class="k">return</span> <span class="kc">None</span>
 
-
 
-    <span class="k">def</span> <span class="nf">add_done_callback</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">fn</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cancelled</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_matured</span><span class="p">:</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_done_callbacks</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">fn</span><span class="p">)</span>
 
-                <span class="k">return</span>
 
-
 
-        <span class="n">fn</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
 
-
 
-    <span class="k">def</span> <span class="nf">start</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="bp">self</span><span class="o">.</span><span class="n">_channel</span><span class="o">.</span><span class="n">subscribe</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_update</span><span class="p">,</span> <span class="n">try_to_connect</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__del__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cancelled</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_matured</span><span class="p">:</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_channel</span><span class="o">.</span><span class="n">unsubscribe</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_update</span><span class="p">)</span>
 
-
 
-
 
-<div class="viewcode-block" id="channel_ready_future"><a class="viewcode-back" href="../../../grpc.beta.html#grpc.beta.utilities.channel_ready_future">[docs]</a><span class="k">def</span> <span class="nf">channel_ready_future</span><span class="p">(</span><span class="n">channel</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates a future.Future tracking when an implementations.Channel is ready.</span>
 
-
 
-<span class="sd">  Cancelling the returned future.Future does not tell the given</span>
 
-<span class="sd">  implementations.Channel to abandon attempts it may have been making to</span>
 
-<span class="sd">  connect; cancelling merely deactivates the return future.Future&#39;s</span>
 
-<span class="sd">  subscription to the given implementations.Channel&#39;s connectivity.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    channel: An implementations.Channel.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    A future.Future that matures when the given Channel has connectivity</span>
 
-<span class="sd">      interfaces.ChannelConnectivity.READY.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="n">ready_future</span> <span class="o">=</span> <span class="n">_ChannelReadyFuture</span><span class="p">(</span><span class="n">channel</span><span class="p">)</span>
 
-    <span class="n">ready_future</span><span class="o">.</span><span class="n">start</span><span class="p">()</span>
 
-    <span class="k">return</span> <span class="n">ready_future</span></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 252
python/_modules/grpc/framework/common/cardinality.html
查看文件 

@@ -1,252 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.common.cardinality &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../../grpc.html"/> 
-
 
-  
-  <script src="../../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.framework.common.cardinality</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.framework.common.cardinality</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;Defines an enum for classifying RPC methods by streaming semantics.&quot;&quot;&quot;</span>
 
-
 
-<span class="kn">import</span> <span class="nn">enum</span>
 
-
 
-
 
-<div class="viewcode-block" id="Cardinality"><a class="viewcode-back" href="../../../../grpc.framework.common.html#grpc.framework.common.cardinality.Cardinality">[docs]</a><span class="nd">@enum</span><span class="o">.</span><span class="n">unique</span>
 
-<span class="k">class</span> <span class="nc">Cardinality</span><span class="p">(</span><span class="n">enum</span><span class="o">.</span><span class="n">Enum</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Describes the streaming semantics of an RPC method.&quot;&quot;&quot;</span>
 
-
 
-    <span class="n">UNARY_UNARY</span> <span class="o">=</span> <span class="s1">&#39;request-unary/response-unary&#39;</span>
 
-    <span class="n">UNARY_STREAM</span> <span class="o">=</span> <span class="s1">&#39;request-unary/response-streaming&#39;</span>
 
-    <span class="n">STREAM_UNARY</span> <span class="o">=</span> <span class="s1">&#39;request-streaming/response-unary&#39;</span>
 
-    <span class="n">STREAM_STREAM</span> <span class="o">=</span> <span class="s1">&#39;request-streaming/response-streaming&#39;</span></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 250
python/_modules/grpc/framework/common/style.html
查看文件 

@@ -1,250 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.common.style &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../../grpc.html"/> 
-
 
-  
-  <script src="../../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.framework.common.style</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.framework.common.style</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;Defines an enum for classifying RPC methods by control flow semantics.&quot;&quot;&quot;</span>
 
-
 
-<span class="kn">import</span> <span class="nn">enum</span>
 
-
 
-
 
-<div class="viewcode-block" id="Service"><a class="viewcode-back" href="../../../../grpc.framework.common.html#grpc.framework.common.style.Service">[docs]</a><span class="nd">@enum</span><span class="o">.</span><span class="n">unique</span>
 
-<span class="k">class</span> <span class="nc">Service</span><span class="p">(</span><span class="n">enum</span><span class="o">.</span><span class="n">Enum</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Describes the control flow style of RPC method implementation.&quot;&quot;&quot;</span>
 
-
 
-    <span class="n">INLINE</span> <span class="o">=</span> <span class="s1">&#39;inline&#39;</span>
 
-    <span class="n">EVENT</span> <span class="o">=</span> <span class="s1">&#39;event&#39;</span></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 248
python/_modules/grpc/framework/foundation/abandonment.html
查看文件 

@@ -1,248 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.foundation.abandonment &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../../grpc.html"/> 
-
 
-  
-  <script src="../../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.framework.foundation.abandonment</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.framework.foundation.abandonment</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;Utilities for indicating abandonment of computation.&quot;&quot;&quot;</span>
 
-
 
-
 
-<div class="viewcode-block" id="Abandoned"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.abandonment.Abandoned">[docs]</a><span class="k">class</span> <span class="nc">Abandoned</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Indicates that some computation is being abandoned.</span>
 
-
 
-<span class="sd">  Abandoning a computation is different than returning a value or raising</span>
 
-<span class="sd">  an exception indicating some operational or programming defect.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 320
python/_modules/grpc/framework/foundation/callable_util.html
查看文件 

@@ -1,320 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.foundation.callable_util &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../../grpc.html"/> 
-
 
-  
-  <script src="../../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.framework.foundation.callable_util</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.framework.foundation.callable_util</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;Utilities for working with callables.&quot;&quot;&quot;</span>
 
-
 
-<span class="kn">import</span> <span class="nn">abc</span>
 
-<span class="kn">import</span> <span class="nn">collections</span>
 
-<span class="kn">import</span> <span class="nn">enum</span>
 
-<span class="kn">import</span> <span class="nn">functools</span>
 
-<span class="kn">import</span> <span class="nn">logging</span>
 
-
 
-<span class="kn">import</span> <span class="nn">six</span>
 
-
 
-
 
-<div class="viewcode-block" id="Outcome"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.callable_util.Outcome">[docs]</a><span class="k">class</span> <span class="nc">Outcome</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;A sum type describing the outcome of some call.</span>
 
-
 
-<span class="sd">  Attributes:</span>
 
-<span class="sd">    kind: One of Kind.RETURNED or Kind.RAISED respectively indicating that the</span>
 
-<span class="sd">      call returned a value or raised an exception.</span>
 
-<span class="sd">    return_value: The value returned by the call. Must be present if kind is</span>
 
-<span class="sd">      Kind.RETURNED.</span>
 
-<span class="sd">    exception: The exception raised by the call. Must be present if kind is</span>
 
-<span class="sd">      Kind.RAISED.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="Outcome.Kind"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.callable_util.Outcome.Kind">[docs]</a>    <span class="nd">@enum</span><span class="o">.</span><span class="n">unique</span>
 
-    <span class="k">class</span> <span class="nc">Kind</span><span class="p">(</span><span class="n">enum</span><span class="o">.</span><span class="n">Enum</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Identifies the general kind of the outcome of some call.&quot;&quot;&quot;</span>
 
-
 
-        <span class="n">RETURNED</span> <span class="o">=</span> <span class="nb">object</span><span class="p">()</span>
 
-        <span class="n">RAISED</span> <span class="o">=</span> <span class="nb">object</span><span class="p">()</span></div></div>
 
-
 
-
 
-<span class="k">class</span> <span class="nc">_EasyOutcome</span><span class="p">(</span>
 
-        <span class="n">collections</span><span class="o">.</span><span class="n">namedtuple</span><span class="p">(</span><span class="s1">&#39;_EasyOutcome&#39;</span><span class="p">,</span>
 
-                               <span class="p">[</span><span class="s1">&#39;kind&#39;</span><span class="p">,</span> <span class="s1">&#39;return_value&#39;</span><span class="p">,</span> <span class="s1">&#39;exception&#39;</span><span class="p">]),</span> <span class="n">Outcome</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;A trivial implementation of Outcome.&quot;&quot;&quot;</span>
 
-
 
-
 
-<span class="k">def</span> <span class="nf">_call_logging_exceptions</span><span class="p">(</span><span class="n">behavior</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
 
-    <span class="k">try</span><span class="p">:</span>
 
-        <span class="k">return</span> <span class="n">_EasyOutcome</span><span class="p">(</span><span class="n">Outcome</span><span class="o">.</span><span class="n">Kind</span><span class="o">.</span><span class="n">RETURNED</span><span class="p">,</span>
 
-                            <span class="n">behavior</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">),</span> <span class="kc">None</span><span class="p">)</span>
 
-    <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>  <span class="c1"># pylint: disable=broad-except</span>
 
-        <span class="n">logging</span><span class="o">.</span><span class="n">exception</span><span class="p">(</span><span class="n">message</span><span class="p">)</span>
 
-        <span class="k">return</span> <span class="n">_EasyOutcome</span><span class="p">(</span><span class="n">Outcome</span><span class="o">.</span><span class="n">Kind</span><span class="o">.</span><span class="n">RAISED</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n">e</span><span class="p">)</span>
 
-
 
-
 
-<div class="viewcode-block" id="with_exceptions_logged"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.callable_util.with_exceptions_logged">[docs]</a><span class="k">def</span> <span class="nf">with_exceptions_logged</span><span class="p">(</span><span class="n">behavior</span><span class="p">,</span> <span class="n">message</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Wraps a callable in a try-except that logs any exceptions it raises.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    behavior: Any callable.</span>
 
-<span class="sd">    message: A string to log if the behavior raises an exception.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    A callable that when executed invokes the given behavior. The returned</span>
 
-<span class="sd">      callable takes the same arguments as the given behavior but returns a</span>
 
-<span class="sd">      future.Outcome describing whether the given behavior returned a value or</span>
 
-<span class="sd">      raised an exception.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-
 
-    <span class="nd">@functools</span><span class="o">.</span><span class="n">wraps</span><span class="p">(</span><span class="n">behavior</span><span class="p">)</span>
 
-    <span class="k">def</span> <span class="nf">wrapped_behavior</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
 
-        <span class="k">return</span> <span class="n">_call_logging_exceptions</span><span class="p">(</span><span class="n">behavior</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
 
-
 
-    <span class="k">return</span> <span class="n">wrapped_behavior</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="call_logging_exceptions"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.callable_util.call_logging_exceptions">[docs]</a><span class="k">def</span> <span class="nf">call_logging_exceptions</span><span class="p">(</span><span class="n">behavior</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Calls a behavior in a try-except that logs any exceptions it raises.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    behavior: Any callable.</span>
 
-<span class="sd">    message: A string to log if the behavior raises an exception.</span>
 
-<span class="sd">    *args: Positional arguments to pass to the given behavior.</span>
 
-<span class="sd">    **kwargs: Keyword arguments to pass to the given behavior.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    An Outcome describing whether the given behavior returned a value or raised</span>
 
-<span class="sd">      an exception.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">_call_logging_exceptions</span><span class="p">(</span><span class="n">behavior</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 447
python/_modules/grpc/framework/foundation/future.html
查看文件 

@@ -1,447 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.foundation.future &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../../grpc.html"/> 
-
 
-  
-  <script src="../../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.framework.foundation.future</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.framework.foundation.future</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;A Future interface.</span>
 
-
 
-<span class="sd">Python doesn&#39;t have a Future interface in its standard library. In the absence</span>
 
-<span class="sd">of such a standard, three separate, incompatible implementations</span>
 
-<span class="sd">(concurrent.futures.Future, ndb.Future, and asyncio.Future) have appeared. This</span>
 
-<span class="sd">interface attempts to be as compatible as possible with</span>
 
-<span class="sd">concurrent.futures.Future. From ndb.Future it adopts a traceback-object accessor</span>
 
-<span class="sd">method.</span>
 
-
 
-<span class="sd">Unlike the concrete and implemented Future classes listed above, the Future</span>
 
-<span class="sd">class defined in this module is an entirely abstract interface that anyone may</span>
 
-<span class="sd">implement and use.</span>
 
-
 
-<span class="sd">The one known incompatibility between this interface and the interface of</span>
 
-<span class="sd">concurrent.futures.Future is that this interface defines its own CancelledError</span>
 
-<span class="sd">and TimeoutError exceptions rather than raising the implementation-private</span>
 
-<span class="sd">concurrent.futures._base.CancelledError and the</span>
 
-<span class="sd">built-in-but-only-in-3.3-and-later TimeoutError.</span>
 
-<span class="sd">&quot;&quot;&quot;</span>
 
-
 
-<span class="kn">import</span> <span class="nn">abc</span>
 
-
 
-<span class="kn">import</span> <span class="nn">six</span>
 
-
 
-
 
-<div class="viewcode-block" id="TimeoutError"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.future.TimeoutError">[docs]</a><span class="k">class</span> <span class="nc">TimeoutError</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Indicates that a particular call timed out.&quot;&quot;&quot;</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="CancelledError"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.future.CancelledError">[docs]</a><span class="k">class</span> <span class="nc">CancelledError</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Indicates that the computation underlying a Future was cancelled.&quot;&quot;&quot;</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="Future"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.future.Future">[docs]</a><span class="k">class</span> <span class="nc">Future</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;A representation of a computation in another control flow.</span>
 
-
 
-<span class="sd">  Computations represented by a Future may be yet to be begun, may be ongoing,</span>
 
-<span class="sd">  or may have already completed.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-
 
-    <span class="c1"># NOTE(nathaniel): This isn&#39;t the return type that I would want to have if it</span>
 
-    <span class="c1"># were up to me. Were this interface being written from scratch, the return</span>
 
-    <span class="c1"># type of this method would probably be a sum type like:</span>
 
-    <span class="c1">#</span>
 
-    <span class="c1"># NOT_COMMENCED</span>
 
-    <span class="c1"># COMMENCED_AND_NOT_COMPLETED</span>
 
-    <span class="c1"># PARTIAL_RESULT&lt;Partial_Result_Type&gt;</span>
 
-    <span class="c1"># COMPLETED&lt;Result_Type&gt;</span>
 
-    <span class="c1"># UNCANCELLABLE</span>
 
-    <span class="c1"># NOT_IMMEDIATELY_DETERMINABLE</span>
 
-<div class="viewcode-block" id="Future.cancel"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.future.Future.cancel">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">cancel</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Attempts to cancel the computation.</span>
 
-
 
-<span class="sd">    This method does not block.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      True if the computation has not yet begun, will not be allowed to take</span>
 
-<span class="sd">        place, and determination of both was possible without blocking. False</span>
 
-<span class="sd">        under all other circumstances including but not limited to the</span>
 
-<span class="sd">        computation&#39;s already having begun, the computation&#39;s already having</span>
 
-<span class="sd">        finished, and the computation&#39;s having been scheduled for execution on a</span>
 
-<span class="sd">        remote system for which a determination of whether or not it commenced</span>
 
-<span class="sd">        before being cancelled cannot be made without blocking.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
-
 
-    <span class="c1"># NOTE(nathaniel): Here too this isn&#39;t the return type that I&#39;d want this</span>
 
-    <span class="c1"># method to have if it were up to me. I think I&#39;d go with another sum type</span>
 
-    <span class="c1"># like:</span>
 
-    <span class="c1">#</span>
 
-    <span class="c1"># NOT_CANCELLED (this object&#39;s cancel method hasn&#39;t been called)</span>
 
-    <span class="c1"># NOT_COMMENCED</span>
 
-    <span class="c1"># COMMENCED_AND_NOT_COMPLETED</span>
 
-    <span class="c1"># PARTIAL_RESULT&lt;Partial_Result_Type&gt;</span>
 
-    <span class="c1"># COMPLETED&lt;Result_Type&gt;</span>
 
-    <span class="c1"># UNCANCELLABLE</span>
 
-    <span class="c1"># NOT_IMMEDIATELY_DETERMINABLE</span>
 
-    <span class="c1">#</span>
 
-    <span class="c1"># Notice how giving the cancel method the right semantics obviates most</span>
 
-    <span class="c1"># reasons for this method to exist.</span>
 
-<div class="viewcode-block" id="Future.cancelled"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.future.Future.cancelled">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">cancelled</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Describes whether the computation was cancelled.</span>
 
-
 
-<span class="sd">    This method does not block.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      True if the computation was cancelled any time before its result became</span>
 
-<span class="sd">        immediately available. False under all other circumstances including but</span>
 
-<span class="sd">        not limited to this object&#39;s cancel method not having been called and</span>
 
-<span class="sd">        the computation&#39;s result having become immediately available.</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="Future.running"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.future.Future.running">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">running</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Describes whether the computation is taking place.</span>
 
-
 
-<span class="sd">    This method does not block.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      True if the computation is scheduled to take place in the future or is</span>
 
-<span class="sd">        taking place now, or False if the computation took place in the past or</span>
 
-<span class="sd">        was cancelled.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
-
 
-    <span class="c1"># NOTE(nathaniel): These aren&#39;t quite the semantics I&#39;d like here either. I</span>
 
-    <span class="c1"># would rather this only returned True in cases in which the underlying</span>
 
-    <span class="c1"># computation completed successfully. A computation&#39;s having been cancelled</span>
 
-    <span class="c1"># conflicts with considering that computation &quot;done&quot;.</span>
 
-<div class="viewcode-block" id="Future.done"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.future.Future.done">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">done</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Describes whether the computation has taken place.</span>
 
-
 
-<span class="sd">    This method does not block.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      True if the computation is known to have either completed or have been</span>
 
-<span class="sd">        unscheduled or interrupted. False if the computation may possibly be</span>
 
-<span class="sd">        executing or scheduled to execute later.</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="Future.result"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.future.Future.result">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">result</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Accesses the outcome of the computation or raises its exception.</span>
 
-
 
-<span class="sd">    This method may return immediately or may block.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      timeout: The length of time in seconds to wait for the computation to</span>
 
-<span class="sd">        finish or be cancelled, or None if this method should block until the</span>
 
-<span class="sd">        computation has finished or is cancelled no matter how long that takes.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      The return value of the computation.</span>
 
-
 
-<span class="sd">    Raises:</span>
 
-<span class="sd">      TimeoutError: If a timeout value is passed and the computation does not</span>
 
-<span class="sd">        terminate within the allotted time.</span>
 
-<span class="sd">      CancelledError: If the computation was cancelled.</span>
 
-<span class="sd">      Exception: If the computation raised an exception, this call will raise</span>
 
-<span class="sd">        the same exception.</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="Future.exception"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.future.Future.exception">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">exception</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Return the exception raised by the computation.</span>
 
-
 
-<span class="sd">    This method may return immediately or may block.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      timeout: The length of time in seconds to wait for the computation to</span>
 
-<span class="sd">        terminate or be cancelled, or None if this method should block until</span>
 
-<span class="sd">        the computation is terminated or is cancelled no matter how long that</span>
 
-<span class="sd">        takes.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      The exception raised by the computation, or None if the computation did</span>
 
-<span class="sd">        not raise an exception.</span>
 
-
 
-<span class="sd">    Raises:</span>
 
-<span class="sd">      TimeoutError: If a timeout value is passed and the computation does not</span>
 
-<span class="sd">        terminate within the allotted time.</span>
 
-<span class="sd">      CancelledError: If the computation was cancelled.</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="Future.traceback"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.future.Future.traceback">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">traceback</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Access the traceback of the exception raised by the computation.</span>
 
-
 
-<span class="sd">    This method may return immediately or may block.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      timeout: The length of time in seconds to wait for the computation to</span>
 
-<span class="sd">        terminate or be cancelled, or None if this method should block until</span>
 
-<span class="sd">        the computation is terminated or is cancelled no matter how long that</span>
 
-<span class="sd">        takes.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      The traceback of the exception raised by the computation, or None if the</span>
 
-<span class="sd">        computation did not raise an exception.</span>
 
-
 
-<span class="sd">    Raises:</span>
 
-<span class="sd">      TimeoutError: If a timeout value is passed and the computation does not</span>
 
-<span class="sd">        terminate within the allotted time.</span>
 
-<span class="sd">      CancelledError: If the computation was cancelled.</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="Future.add_done_callback"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.future.Future.add_done_callback">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">add_done_callback</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">fn</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Adds a function to be called at completion of the computation.</span>
 
-
 
-<span class="sd">    The callback will be passed this Future object describing the outcome of</span>
 
-<span class="sd">    the computation.</span>
 
-
 
-<span class="sd">    If the computation has already completed, the callback will be called</span>
 
-<span class="sd">    immediately.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      fn: A callable taking this Future object as its single parameter.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 295
python/_modules/grpc/framework/foundation/logging_pool.html
查看文件 

@@ -1,295 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.foundation.logging_pool &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../../grpc.html"/> 
-
 
-  
-  <script src="../../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.framework.foundation.logging_pool</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.framework.foundation.logging_pool</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;A thread pool that logs exceptions raised by tasks executed within it.&quot;&quot;&quot;</span>
 
-
 
-<span class="kn">import</span> <span class="nn">logging</span>
 
-
 
-<span class="kn">from</span> <span class="nn">concurrent</span> <span class="k">import</span> <span class="n">futures</span>
 
-
 
-
 
-<span class="k">def</span> <span class="nf">_wrap</span><span class="p">(</span><span class="n">behavior</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Wraps an arbitrary callable behavior in exception-logging.&quot;&quot;&quot;</span>
 
-
 
-    <span class="k">def</span> <span class="nf">_wrapping</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
 
-        <span class="k">try</span><span class="p">:</span>
 
-            <span class="k">return</span> <span class="n">behavior</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
 
-        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
 
-            <span class="n">logging</span><span class="o">.</span><span class="n">exception</span><span class="p">(</span>
 
-                <span class="s1">&#39;Unexpected exception from </span><span class="si">%s</span><span class="s1"> executed in logging pool!&#39;</span><span class="p">,</span>
 
-                <span class="n">behavior</span><span class="p">)</span>
 
-            <span class="k">raise</span>
 
-
 
-    <span class="k">return</span> <span class="n">_wrapping</span>
 
-
 
-
 
-<span class="k">class</span> <span class="nc">_LoggingPool</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;An exception-logging futures.ThreadPoolExecutor-compatible thread pool.&quot;&quot;&quot;</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">backing_pool</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_backing_pool</span> <span class="o">=</span> <span class="n">backing_pool</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">return</span> <span class="bp">self</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_val</span><span class="p">,</span> <span class="n">exc_tb</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_backing_pool</span><span class="o">.</span><span class="n">shutdown</span><span class="p">(</span><span class="n">wait</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
 
-
 
-    <span class="k">def</span> <span class="nf">submit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">fn</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
 
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_backing_pool</span><span class="o">.</span><span class="n">submit</span><span class="p">(</span><span class="n">_wrap</span><span class="p">(</span><span class="n">fn</span><span class="p">),</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
 
-
 
-    <span class="k">def</span> <span class="nf">map</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">func</span><span class="p">,</span> <span class="o">*</span><span class="n">iterables</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
 
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_backing_pool</span><span class="o">.</span><span class="n">map</span><span class="p">(</span>
 
-            <span class="n">_wrap</span><span class="p">(</span><span class="n">func</span><span class="p">),</span> <span class="o">*</span><span class="n">iterables</span><span class="p">,</span> <span class="n">timeout</span><span class="o">=</span><span class="n">kwargs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;timeout&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">))</span>
 
-
 
-    <span class="k">def</span> <span class="nf">shutdown</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">wait</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_backing_pool</span><span class="o">.</span><span class="n">shutdown</span><span class="p">(</span><span class="n">wait</span><span class="o">=</span><span class="n">wait</span><span class="p">)</span>
 
-
 
-
 
-<div class="viewcode-block" id="pool"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.logging_pool.pool">[docs]</a><span class="k">def</span> <span class="nf">pool</span><span class="p">(</span><span class="n">max_workers</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates a thread pool that logs exceptions raised by the tasks within it.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    max_workers: The maximum number of worker threads to allow the pool.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    A futures.ThreadPoolExecutor-compatible thread pool that logs exceptions</span>
 
-<span class="sd">      raised by the tasks executed within it.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">_LoggingPool</span><span class="p">(</span><span class="n">futures</span><span class="o">.</span><span class="n">ThreadPoolExecutor</span><span class="p">(</span><span class="n">max_workers</span><span class="p">))</span></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 271
python/_modules/grpc/framework/foundation/stream.html
查看文件 

@@ -1,271 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.foundation.stream &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../../grpc.html"/> 
-
 
-  
-  <script src="../../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.framework.foundation.stream</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.framework.foundation.stream</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;Interfaces related to streams of values or objects.&quot;&quot;&quot;</span>
 
-
 
-<span class="kn">import</span> <span class="nn">abc</span>
 
-
 
-<span class="kn">import</span> <span class="nn">six</span>
 
-
 
-
 
-<div class="viewcode-block" id="Consumer"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream.Consumer">[docs]</a><span class="k">class</span> <span class="nc">Consumer</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Interface for consumers of finite streams of values or objects.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="Consumer.consume"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream.Consumer.consume">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">consume</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Accepts a value.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      value: Any value accepted by this Consumer.</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="Consumer.terminate"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream.Consumer.terminate">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">terminate</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Indicates to this Consumer that no more values will be supplied.&quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
-
 
-<div class="viewcode-block" id="Consumer.consume_and_terminate"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream.Consumer.consume_and_terminate">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">consume_and_terminate</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Supplies a value and signals that no more values will be supplied.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      value: Any value accepted by this Consumer.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 373
python/_modules/grpc/framework/foundation/stream_util.html
查看文件 

@@ -1,373 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.foundation.stream_util &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../../grpc.html"/> 
-
 
-  
-  <script src="../../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.framework.foundation.stream_util</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.framework.foundation.stream_util</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;Helpful utilities related to the stream module.&quot;&quot;&quot;</span>
 
-
 
-<span class="kn">import</span> <span class="nn">logging</span>
 
-<span class="kn">import</span> <span class="nn">threading</span>
 
-
 
-<span class="kn">from</span> <span class="nn">grpc.framework.foundation</span> <span class="k">import</span> <span class="n">stream</span>
 
-
 
-<span class="n">_NO_VALUE</span> <span class="o">=</span> <span class="nb">object</span><span class="p">()</span>
 
-
 
-
 
-<div class="viewcode-block" id="TransformingConsumer"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.TransformingConsumer">[docs]</a><span class="k">class</span> <span class="nc">TransformingConsumer</span><span class="p">(</span><span class="n">stream</span><span class="o">.</span><span class="n">Consumer</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;A stream.Consumer that passes a transformation of its input to another.&quot;&quot;&quot;</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">transformation</span><span class="p">,</span> <span class="n">downstream</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_transformation</span> <span class="o">=</span> <span class="n">transformation</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_downstream</span> <span class="o">=</span> <span class="n">downstream</span>
 
-
 
-<div class="viewcode-block" id="TransformingConsumer.consume"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.TransformingConsumer.consume">[docs]</a>    <span class="k">def</span> <span class="nf">consume</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_downstream</span><span class="o">.</span><span class="n">consume</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_transformation</span><span class="p">(</span><span class="n">value</span><span class="p">))</span></div>
 
-
 
-<div class="viewcode-block" id="TransformingConsumer.terminate"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.TransformingConsumer.terminate">[docs]</a>    <span class="k">def</span> <span class="nf">terminate</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_downstream</span><span class="o">.</span><span class="n">terminate</span><span class="p">()</span></div>
 
-
 
-<div class="viewcode-block" id="TransformingConsumer.consume_and_terminate"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.TransformingConsumer.consume_and_terminate">[docs]</a>    <span class="k">def</span> <span class="nf">consume_and_terminate</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_downstream</span><span class="o">.</span><span class="n">consume_and_terminate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_transformation</span><span class="p">(</span><span class="n">value</span><span class="p">))</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="IterableConsumer"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.IterableConsumer">[docs]</a><span class="k">class</span> <span class="nc">IterableConsumer</span><span class="p">(</span><span class="n">stream</span><span class="o">.</span><span class="n">Consumer</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;A Consumer that when iterated over emits the values it has consumed.&quot;&quot;&quot;</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Condition</span><span class="p">()</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_values</span> <span class="o">=</span> <span class="p">[]</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_active</span> <span class="o">=</span> <span class="kc">True</span>
 
-
 
-<div class="viewcode-block" id="IterableConsumer.consume"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.IterableConsumer.consume">[docs]</a>    <span class="k">def</span> <span class="nf">consume</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">stock_reply</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_active</span><span class="p">:</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_values</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">stock_reply</span><span class="p">)</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="o">.</span><span class="n">notify</span><span class="p">()</span></div>
 
-
 
-<div class="viewcode-block" id="IterableConsumer.terminate"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.IterableConsumer.terminate">[docs]</a>    <span class="k">def</span> <span class="nf">terminate</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="bp">self</span><span class="o">.</span><span class="n">_active</span> <span class="o">=</span> <span class="kc">False</span>
 
-            <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="o">.</span><span class="n">notify</span><span class="p">()</span></div>
 
-
 
-<div class="viewcode-block" id="IterableConsumer.consume_and_terminate"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.IterableConsumer.consume_and_terminate">[docs]</a>    <span class="k">def</span> <span class="nf">consume_and_terminate</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">stock_reply</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_active</span><span class="p">:</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_values</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">stock_reply</span><span class="p">)</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_active</span> <span class="o">=</span> <span class="kc">False</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="o">.</span><span class="n">notify</span><span class="p">()</span></div>
 
-
 
-    <span class="k">def</span> <span class="nf">__iter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">return</span> <span class="bp">self</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__next__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">next</span><span class="p">()</span>
 
-
 
-<div class="viewcode-block" id="IterableConsumer.next"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.IterableConsumer.next">[docs]</a>    <span class="k">def</span> <span class="nf">next</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="p">:</span>
 
-            <span class="k">while</span> <span class="bp">self</span><span class="o">.</span><span class="n">_active</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_values</span><span class="p">:</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_condition</span><span class="o">.</span><span class="n">wait</span><span class="p">()</span>
 
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_values</span><span class="p">:</span>
 
-                <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_values</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
 
-            <span class="k">else</span><span class="p">:</span>
 
-                <span class="k">raise</span> <span class="ne">StopIteration</span><span class="p">()</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="ThreadSwitchingConsumer"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.ThreadSwitchingConsumer">[docs]</a><span class="k">class</span> <span class="nc">ThreadSwitchingConsumer</span><span class="p">(</span><span class="n">stream</span><span class="o">.</span><span class="n">Consumer</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;A Consumer decorator that affords serialization and asynchrony.&quot;&quot;&quot;</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sink</span><span class="p">,</span> <span class="n">pool</span><span class="p">):</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_lock</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Lock</span><span class="p">()</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_sink</span> <span class="o">=</span> <span class="n">sink</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span> <span class="o">=</span> <span class="n">pool</span>
 
-        <span class="c1"># True if self._spin has been submitted to the pool to be called once and</span>
 
-        <span class="c1"># that call has not yet returned, False otherwise.</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_spinning</span> <span class="o">=</span> <span class="kc">False</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_values</span> <span class="o">=</span> <span class="p">[]</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">_active</span> <span class="o">=</span> <span class="kc">True</span>
 
-
 
-    <span class="k">def</span> <span class="nf">_spin</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sink</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">terminate</span><span class="p">):</span>
 
-        <span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
 
-            <span class="k">try</span><span class="p">:</span>
 
-                <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="n">_NO_VALUE</span><span class="p">:</span>
 
-                    <span class="n">sink</span><span class="o">.</span><span class="n">terminate</span><span class="p">()</span>
 
-                <span class="k">elif</span> <span class="n">terminate</span><span class="p">:</span>
 
-                    <span class="n">sink</span><span class="o">.</span><span class="n">consume_and_terminate</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
 
-                <span class="k">else</span><span class="p">:</span>
 
-                    <span class="n">sink</span><span class="o">.</span><span class="n">consume</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
 
-            <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>  <span class="c1"># pylint:disable=broad-except</span>
 
-                <span class="n">logging</span><span class="o">.</span><span class="n">exception</span><span class="p">(</span><span class="n">e</span><span class="p">)</span>
 
-
 
-            <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_lock</span><span class="p">:</span>
 
-                <span class="k">if</span> <span class="n">terminate</span><span class="p">:</span>
 
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_spinning</span> <span class="o">=</span> <span class="kc">False</span>
 
-                    <span class="k">return</span>
 
-                <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">_values</span><span class="p">:</span>
 
-                    <span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_values</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
 
-                    <span class="n">terminate</span> <span class="o">=</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_values</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_active</span>
 
-                <span class="k">elif</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_active</span><span class="p">:</span>
 
-                    <span class="n">value</span> <span class="o">=</span> <span class="n">_NO_VALUE</span>
 
-                    <span class="n">terminate</span> <span class="o">=</span> <span class="kc">True</span>
 
-                <span class="k">else</span><span class="p">:</span>
 
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_spinning</span> <span class="o">=</span> <span class="kc">False</span>
 
-                    <span class="k">return</span>
 
-
 
-<div class="viewcode-block" id="ThreadSwitchingConsumer.consume"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.ThreadSwitchingConsumer.consume">[docs]</a>    <span class="k">def</span> <span class="nf">consume</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_lock</span><span class="p">:</span>
 
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_active</span><span class="p">:</span>
 
-                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_spinning</span><span class="p">:</span>
 
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_values</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
 
-                <span class="k">else</span><span class="p">:</span>
 
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span><span class="o">.</span><span class="n">submit</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_spin</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_sink</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="kc">False</span><span class="p">)</span>
 
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_spinning</span> <span class="o">=</span> <span class="kc">True</span></div>
 
-
 
-<div class="viewcode-block" id="ThreadSwitchingConsumer.terminate"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.ThreadSwitchingConsumer.terminate">[docs]</a>    <span class="k">def</span> <span class="nf">terminate</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_lock</span><span class="p">:</span>
 
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_active</span><span class="p">:</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_active</span> <span class="o">=</span> <span class="kc">False</span>
 
-                <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_spinning</span><span class="p">:</span>
 
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span><span class="o">.</span><span class="n">submit</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_spin</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_sink</span><span class="p">,</span> <span class="n">_NO_VALUE</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
 
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_spinning</span> <span class="o">=</span> <span class="kc">True</span></div>
 
-
 
-<div class="viewcode-block" id="ThreadSwitchingConsumer.consume_and_terminate"><a class="viewcode-back" href="../../../../grpc.framework.foundation.html#grpc.framework.foundation.stream_util.ThreadSwitchingConsumer.consume_and_terminate">[docs]</a>    <span class="k">def</span> <span class="nf">consume_and_terminate</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
 
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_lock</span><span class="p">:</span>
 
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_active</span><span class="p">:</span>
 
-                <span class="bp">self</span><span class="o">.</span><span class="n">_active</span> <span class="o">=</span> <span class="kc">False</span>
 
-                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_spinning</span><span class="p">:</span>
 
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_values</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
 
-                <span class="k">else</span><span class="p">:</span>
 
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span><span class="o">.</span><span class="n">submit</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_spin</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_sink</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
 
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_spinning</span> <span class="o">=</span> <span class="kc">True</span></div></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 556
python/_modules/grpc/framework/interfaces/base/base.html
查看文件 

@@ -1,556 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.interfaces.base.base &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../../../grpc.html"/> 
-
 
-  
-  <script src="../../../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.framework.interfaces.base.base</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.framework.interfaces.base.base</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;The base interface of RPC Framework.</span>
 
-
 
-<span class="sd">Implementations of this interface support the conduct of &quot;operations&quot;:</span>
 
-<span class="sd">exchanges between two distinct ends of an arbitrary number of data payloads</span>
 
-<span class="sd">and metadata such as a name for the operation, initial and terminal metadata</span>
 
-<span class="sd">in each direction, and flow control. These operations may be used for transfers</span>
 
-<span class="sd">of data, remote procedure calls, status indication, or anything else</span>
 
-<span class="sd">applications choose.</span>
 
-<span class="sd">&quot;&quot;&quot;</span>
 
-
 
-<span class="c1"># threading is referenced from specification in this module.</span>
 
-<span class="kn">import</span> <span class="nn">abc</span>
 
-<span class="kn">import</span> <span class="nn">enum</span>
 
-<span class="kn">import</span> <span class="nn">threading</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-
 
-<span class="kn">import</span> <span class="nn">six</span>
 
-
 
-<span class="c1"># abandonment is referenced from specification in this module.</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.foundation</span> <span class="k">import</span> <span class="n">abandonment</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-
 
-<span class="c1"># pylint: disable=too-many-arguments</span>
 
-
 
-
 
-<div class="viewcode-block" id="NoSuchMethodError"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.NoSuchMethodError">[docs]</a><span class="k">class</span> <span class="nc">NoSuchMethodError</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Indicates that an unrecognized operation has been called.</span>
 
-
 
-<span class="sd">    Attributes:</span>
 
-<span class="sd">      code: A code value to communicate to the other side of the operation</span>
 
-<span class="sd">        along with indication of operation termination. May be None.</span>
 
-<span class="sd">      details: A details value to communicate to the other side of the</span>
 
-<span class="sd">        operation along with indication of operation termination. May be None.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">code</span><span class="p">,</span> <span class="n">details</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Constructor.</span>
 
-
 
-<span class="sd">        Args:</span>
 
-<span class="sd">          code: A code value to communicate to the other side of the operation</span>
 
-<span class="sd">            along with indication of operation termination. May be None.</span>
 
-<span class="sd">          details: A details value to communicate to the other side of the</span>
 
-<span class="sd">            operation along with indication of operation termination. May be None.</span>
 
-<span class="sd">        &quot;&quot;&quot;</span>
 
-        <span class="nb">super</span><span class="p">(</span><span class="n">NoSuchMethodError</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">code</span> <span class="o">=</span> <span class="n">code</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">details</span> <span class="o">=</span> <span class="n">details</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="Outcome"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.Outcome">[docs]</a><span class="k">class</span> <span class="nc">Outcome</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;The outcome of an operation.</span>
 
-
 
-<span class="sd">  Attributes:</span>
 
-<span class="sd">    kind: A Kind value coarsely identifying how the operation terminated.</span>
 
-<span class="sd">    code: An application-specific code value or None if no such value was</span>
 
-<span class="sd">      provided.</span>
 
-<span class="sd">    details: An application-specific details value or None if no such value was</span>
 
-<span class="sd">      provided.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="Outcome.Kind"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.Outcome.Kind">[docs]</a>    <span class="nd">@enum</span><span class="o">.</span><span class="n">unique</span>
 
-    <span class="k">class</span> <span class="nc">Kind</span><span class="p">(</span><span class="n">enum</span><span class="o">.</span><span class="n">Enum</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Ways in which an operation can terminate.&quot;&quot;&quot;</span>
 
-
 
-        <span class="n">COMPLETED</span> <span class="o">=</span> <span class="s1">&#39;completed&#39;</span>
 
-        <span class="n">CANCELLED</span> <span class="o">=</span> <span class="s1">&#39;cancelled&#39;</span>
 
-        <span class="n">EXPIRED</span> <span class="o">=</span> <span class="s1">&#39;expired&#39;</span>
 
-        <span class="n">LOCAL_SHUTDOWN</span> <span class="o">=</span> <span class="s1">&#39;local shutdown&#39;</span>
 
-        <span class="n">REMOTE_SHUTDOWN</span> <span class="o">=</span> <span class="s1">&#39;remote shutdown&#39;</span>
 
-        <span class="n">RECEPTION_FAILURE</span> <span class="o">=</span> <span class="s1">&#39;reception failure&#39;</span>
 
-        <span class="n">TRANSMISSION_FAILURE</span> <span class="o">=</span> <span class="s1">&#39;transmission failure&#39;</span>
 
-        <span class="n">LOCAL_FAILURE</span> <span class="o">=</span> <span class="s1">&#39;local failure&#39;</span>
 
-        <span class="n">REMOTE_FAILURE</span> <span class="o">=</span> <span class="s1">&#39;remote failure&#39;</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="Completion"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.Completion">[docs]</a><span class="k">class</span> <span class="nc">Completion</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;An aggregate of the values exchanged upon operation completion.</span>
 
-
 
-<span class="sd">  Attributes:</span>
 
-<span class="sd">    terminal_metadata: A terminal metadata value for the operaton.</span>
 
-<span class="sd">    code: A code value for the operation.</span>
 
-<span class="sd">    message: A message value for the operation.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="OperationContext"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.OperationContext">[docs]</a><span class="k">class</span> <span class="nc">OperationContext</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Provides operation-related information and action.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="OperationContext.outcome"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.OperationContext.outcome">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">outcome</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Indicates the operation&#39;s outcome (or that the operation is ongoing).</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      None if the operation is still active or the Outcome value for the</span>
 
-<span class="sd">        operation if it has terminated.</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="OperationContext.add_termination_callback"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.OperationContext.add_termination_callback">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">add_termination_callback</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">callback</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Adds a function to be called upon operation termination.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      callback: A callable to be passed an Outcome value on operation</span>
 
-<span class="sd">        termination.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      None if the operation has not yet terminated and the passed callback will</span>
 
-<span class="sd">        later be called when it does terminate, or if the operation has already</span>
 
-<span class="sd">        terminated an Outcome value describing the operation termination and the</span>
 
-<span class="sd">        passed callback will not be called as a result of this method 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 class="viewcode-block" id="OperationContext.time_remaining"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.OperationContext.time_remaining">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">time_remaining</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Describes the length of allowed time remaining for the operation.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A nonnegative float indicating the length of allowed time in seconds</span>
 
-<span class="sd">      remaining for the operation to complete before it is considered to have</span>
 
-<span class="sd">      timed out. Zero is returned if the operation has terminated.</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="OperationContext.cancel"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.OperationContext.cancel">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">cancel</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Cancels the operation if the operation has not yet terminated.&quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
-
 
-<div class="viewcode-block" id="OperationContext.fail"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.OperationContext.fail">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">fail</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exception</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Indicates that the operation has failed.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      exception: An exception germane to the operation failure. May be None.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="Operator"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.Operator">[docs]</a><span class="k">class</span> <span class="nc">Operator</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;An interface through which to participate in an operation.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="Operator.advance"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.Operator.advance">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">advance</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                <span class="n">initial_metadata</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                <span class="n">payload</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                <span class="n">completion</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                <span class="n">allowance</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Progresses the operation.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      initial_metadata: An initial metadata value. Only one may ever be</span>
 
-<span class="sd">        communicated in each direction for an operation, and they must be</span>
 
-<span class="sd">        communicated no later than either the first payload or the completion.</span>
 
-<span class="sd">      payload: A payload value.</span>
 
-<span class="sd">      completion: A Completion value. May only ever be non-None once in either</span>
 
-<span class="sd">        direction, and no payloads may be passed after it has been communicated.</span>
 
-<span class="sd">      allowance: A positive integer communicating the number of additional</span>
 
-<span class="sd">        payloads allowed to be passed by the remote side of the operation.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="ProtocolReceiver"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.ProtocolReceiver">[docs]</a><span class="k">class</span> <span class="nc">ProtocolReceiver</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;A means of receiving protocol values during an operation.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="ProtocolReceiver.context"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.ProtocolReceiver.context">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">context</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">protocol_context</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Accepts the protocol context object for the operation.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      protocol_context: The protocol context object for the operation.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="Subscription"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.Subscription">[docs]</a><span class="k">class</span> <span class="nc">Subscription</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Describes customer code&#39;s interest in values from the other side.</span>
 
-
 
-<span class="sd">  Attributes:</span>
 
-<span class="sd">    kind: A Kind value describing the overall kind of this value.</span>
 
-<span class="sd">    termination_callback: A callable to be passed the Outcome associated with</span>
 
-<span class="sd">      the operation after it has terminated. Must be non-None if kind is</span>
 
-<span class="sd">      Kind.TERMINATION_ONLY. Must be None otherwise.</span>
 
-<span class="sd">    allowance: A callable behavior that accepts positive integers representing</span>
 
-<span class="sd">      the number of additional payloads allowed to be passed to the other side</span>
 
-<span class="sd">      of the operation. Must be None if kind is Kind.FULL. Must not be None</span>
 
-<span class="sd">      otherwise.</span>
 
-<span class="sd">    operator: An Operator to be passed values from the other side of the</span>
 
-<span class="sd">      operation. Must be non-None if kind is Kind.FULL. Must be None otherwise.</span>
 
-<span class="sd">    protocol_receiver: A ProtocolReceiver to be passed protocol objects as they</span>
 
-<span class="sd">      become available during the operation. Must be non-None if kind is</span>
 
-<span class="sd">      Kind.FULL.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="Subscription.Kind"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.Subscription.Kind">[docs]</a>    <span class="nd">@enum</span><span class="o">.</span><span class="n">unique</span>
 
-    <span class="k">class</span> <span class="nc">Kind</span><span class="p">(</span><span class="n">enum</span><span class="o">.</span><span class="n">Enum</span><span class="p">):</span>
 
-
 
-        <span class="n">NONE</span> <span class="o">=</span> <span class="s1">&#39;none&#39;</span>
 
-        <span class="n">TERMINATION_ONLY</span> <span class="o">=</span> <span class="s1">&#39;termination only&#39;</span>
 
-        <span class="n">FULL</span> <span class="o">=</span> <span class="s1">&#39;full&#39;</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="Servicer"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.Servicer">[docs]</a><span class="k">class</span> <span class="nc">Servicer</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Interface for service implementations.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="Servicer.service"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.Servicer.service">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">service</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">group</span><span class="p">,</span> <span class="n">method</span><span class="p">,</span> <span class="n">context</span><span class="p">,</span> <span class="n">output_operator</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Services an operation.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the operation to be serviced.</span>
 
-<span class="sd">      method: The method identifier of the operation to be serviced.</span>
 
-<span class="sd">      context: An OperationContext object affording contextual information and</span>
 
-<span class="sd">        actions.</span>
 
-<span class="sd">      output_operator: An Operator that will accept output values of the</span>
 
-<span class="sd">        operation.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A Subscription via which this object may or may not accept more values of</span>
 
-<span class="sd">        the operation.</span>
 
-
 
-<span class="sd">    Raises:</span>
 
-<span class="sd">      NoSuchMethodError: If this Servicer does not handle operations with the</span>
 
-<span class="sd">        given group and method.</span>
 
-<span class="sd">      abandonment.Abandoned: If the operation has been aborted and there no</span>
 
-<span class="sd">        longer is any reason to service the operation.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="End"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.End">[docs]</a><span class="k">class</span> <span class="nc">End</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Common type for entry-point objects on both sides of an operation.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="End.start"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.End.start">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">start</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Starts this object&#39;s service of operations.&quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
-
 
-<div class="viewcode-block" id="End.stop"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.End.stop">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">stop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">grace</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Stops this object&#39;s service of operations.</span>
 
-
 
-<span class="sd">    This object will refuse service of new operations as soon as this method is</span>
 
-<span class="sd">    called but operations under way at the time of the call may be given a</span>
 
-<span class="sd">    grace period during which they are allowed to finish.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      grace: A duration of time in seconds to allow ongoing operations to</span>
 
-<span class="sd">        terminate before being forcefully terminated by the stopping of this</span>
 
-<span class="sd">        End. May be zero to terminate all ongoing operations and immediately</span>
 
-<span class="sd">        stop.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A threading.Event that will be set to indicate all operations having</span>
 
-<span class="sd">        terminated and this End having completely stopped. The returned event</span>
 
-<span class="sd">        may not be set until after the full grace period (if some ongoing</span>
 
-<span class="sd">        operation continues for the full length of the period) or it may be set</span>
 
-<span class="sd">        much sooner (if for example this End had no operations in progress at</span>
 
-<span class="sd">        the time its stop method was called).</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="End.operate"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.End.operate">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">operate</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                <span class="n">group</span><span class="p">,</span>
 
-                <span class="n">method</span><span class="p">,</span>
 
-                <span class="n">subscription</span><span class="p">,</span>
 
-                <span class="n">timeout</span><span class="p">,</span>
 
-                <span class="n">initial_metadata</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                <span class="n">payload</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                <span class="n">completion</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 
-                <span class="n">protocol_options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Commences an operation.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the invoked operation.</span>
 
-<span class="sd">      method: The method identifier of the invoked operation.</span>
 
-<span class="sd">      subscription: A Subscription to which the results of the operation will be</span>
 
-<span class="sd">        passed.</span>
 
-<span class="sd">      timeout: A length of time in seconds to allow for the operation.</span>
 
-<span class="sd">      initial_metadata: An initial metadata value to be sent to the other side</span>
 
-<span class="sd">        of the operation. May be None if the initial metadata will be later</span>
 
-<span class="sd">        passed via the returned operator or if there will be no initial metadata</span>
 
-<span class="sd">        passed at all.</span>
 
-<span class="sd">      payload: An initial payload for the operation.</span>
 
-<span class="sd">      completion: A Completion value indicating the end of transmission to the</span>
 
-<span class="sd">        other side of the operation.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Base interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A pair of objects affording information about the operation and action</span>
 
-<span class="sd">        continuing the operation. The first element of the returned pair is an</span>
 
-<span class="sd">        OperationContext for the operation and the second element of the</span>
 
-<span class="sd">        returned pair is an Operator to which operation values not passed in</span>
 
-<span class="sd">        this call should later be passed.</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="End.operation_stats"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.End.operation_stats">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">operation_stats</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Reports the number of terminated operations broken down by outcome.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A dictionary from Outcome.Kind value to an integer identifying the number</span>
 
-<span class="sd">        of operations that terminated with that outcome kind.</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="End.add_idle_action"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.base.End.add_idle_action">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">add_idle_action</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">action</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Adds an action to be called when this End has no ongoing operations.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      action: A callable that accepts no arguments.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 290
python/_modules/grpc/framework/interfaces/base/utilities.html
查看文件 

@@ -1,290 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.interfaces.base.utilities &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../../../grpc.html"/> 
-
 
-  
-  <script src="../../../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.framework.interfaces.base.utilities</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.framework.interfaces.base.utilities</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;Utilities for use with the base interface of RPC Framework.&quot;&quot;&quot;</span>
 
-
 
-<span class="kn">import</span> <span class="nn">collections</span>
 
-
 
-<span class="kn">from</span> <span class="nn">grpc.framework.interfaces.base</span> <span class="k">import</span> <span class="n">base</span>
 
-
 
-
 
-<span class="k">class</span> <span class="nc">_Completion</span><span class="p">(</span><span class="n">base</span><span class="o">.</span><span class="n">Completion</span><span class="p">,</span>
 
-                  <span class="n">collections</span><span class="o">.</span><span class="n">namedtuple</span><span class="p">(</span><span class="s1">&#39;_Completion&#39;</span><span class="p">,</span> <span class="p">(</span><span class="s1">&#39;terminal_metadata&#39;</span><span class="p">,</span>
 
-                                                         <span class="s1">&#39;code&#39;</span><span class="p">,</span> <span class="s1">&#39;message&#39;</span><span class="p">,))):</span>
 
-    <span class="sd">&quot;&quot;&quot;A trivial implementation of base.Completion.&quot;&quot;&quot;</span>
 
-
 
-
 
-<span class="k">class</span> <span class="nc">_Subscription</span><span class="p">(</span><span class="n">base</span><span class="o">.</span><span class="n">Subscription</span><span class="p">,</span>
 
-                    <span class="n">collections</span><span class="o">.</span><span class="n">namedtuple</span><span class="p">(</span><span class="s1">&#39;_Subscription&#39;</span><span class="p">,</span> <span class="p">(</span>
 
-                        <span class="s1">&#39;kind&#39;</span><span class="p">,</span> <span class="s1">&#39;termination_callback&#39;</span><span class="p">,</span> <span class="s1">&#39;allowance&#39;</span><span class="p">,</span> <span class="s1">&#39;operator&#39;</span><span class="p">,</span>
 
-                        <span class="s1">&#39;protocol_receiver&#39;</span><span class="p">,))):</span>
 
-    <span class="sd">&quot;&quot;&quot;A trivial implementation of base.Subscription.&quot;&quot;&quot;</span>
 
-
 
-
 
-<span class="n">_NONE_SUBSCRIPTION</span> <span class="o">=</span> <span class="n">_Subscription</span><span class="p">(</span><span class="n">base</span><span class="o">.</span><span class="n">Subscription</span><span class="o">.</span><span class="n">Kind</span><span class="o">.</span><span class="n">NONE</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span>
 
-                                   <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
 
-
 
-
 
-<div class="viewcode-block" id="completion"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.utilities.completion">[docs]</a><span class="k">def</span> <span class="nf">completion</span><span class="p">(</span><span class="n">terminal_metadata</span><span class="p">,</span> <span class="n">code</span><span class="p">,</span> <span class="n">message</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates a base.Completion aggregating the given operation values.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    terminal_metadata: A terminal metadata value for an operaton.</span>
 
-<span class="sd">    code: A code value for an operation.</span>
 
-<span class="sd">    message: A message value for an operation.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    A base.Completion aggregating the given operation values.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">_Completion</span><span class="p">(</span><span class="n">terminal_metadata</span><span class="p">,</span> <span class="n">code</span><span class="p">,</span> <span class="n">message</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="full_subscription"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.base.html#grpc.framework.interfaces.base.utilities.full_subscription">[docs]</a><span class="k">def</span> <span class="nf">full_subscription</span><span class="p">(</span><span class="n">operator</span><span class="p">,</span> <span class="n">protocol_receiver</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates a &quot;full&quot; base.Subscription for the given base.Operator.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    operator: A base.Operator to be used in an operation.</span>
 
-<span class="sd">    protocol_receiver: A base.ProtocolReceiver to be used in an operation.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    A base.Subscription of kind base.Subscription.Kind.FULL wrapping the given</span>
 
-<span class="sd">      base.Operator and base.ProtocolReceiver.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">_Subscription</span><span class="p">(</span><span class="n">base</span><span class="o">.</span><span class="n">Subscription</span><span class="o">.</span><span class="n">Kind</span><span class="o">.</span><span class="n">FULL</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n">operator</span><span class="p">,</span>
 
-                         <span class="n">protocol_receiver</span><span class="p">)</span></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 1271
python/_modules/grpc/framework/interfaces/face/face.html
查看文件 

@@ -1,1271 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.interfaces.face.face &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../../../grpc.html"/> 
-
 
-  
-  <script src="../../../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.framework.interfaces.face.face</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.framework.interfaces.face.face</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;Interfaces defining the Face layer of RPC Framework.&quot;&quot;&quot;</span>
 
-
 
-<span class="kn">import</span> <span class="nn">abc</span>
 
-<span class="kn">import</span> <span class="nn">collections</span>
 
-<span class="kn">import</span> <span class="nn">enum</span>
 
-
 
-<span class="kn">import</span> <span class="nn">six</span>
 
-
 
-<span class="c1"># cardinality, style, abandonment, future, and stream are</span>
 
-<span class="c1"># referenced from specification in this module.</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.common</span> <span class="k">import</span> <span class="n">cardinality</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.common</span> <span class="k">import</span> <span class="n">style</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.foundation</span> <span class="k">import</span> <span class="n">abandonment</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.foundation</span> <span class="k">import</span> <span class="n">future</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.foundation</span> <span class="k">import</span> <span class="n">stream</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-
 
-<span class="c1"># pylint: disable=too-many-arguments</span>
 
-
 
-
 
-<div class="viewcode-block" id="NoSuchMethodError"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.NoSuchMethodError">[docs]</a><span class="k">class</span> <span class="nc">NoSuchMethodError</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Raised by customer code to indicate an unrecognized method.</span>
 
-
 
-<span class="sd">  Attributes:</span>
 
-<span class="sd">    group: The group of the unrecognized method.</span>
 
-<span class="sd">    name: The name of the unrecognized method.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">group</span><span class="p">,</span> <span class="n">method</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Constructor.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the unrecognized RPC name.</span>
 
-<span class="sd">      method: The method identifier of the unrecognized RPC name.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="nb">super</span><span class="p">(</span><span class="n">NoSuchMethodError</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">group</span> <span class="o">=</span> <span class="n">group</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">method</span> <span class="o">=</span> <span class="n">method</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">return</span> <span class="s1">&#39;face.NoSuchMethodError(</span><span class="si">%s</span><span class="s1">, </span><span class="si">%s</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">group</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">method</span><span class="p">,)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="Abortion"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.Abortion">[docs]</a><span class="k">class</span> <span class="nc">Abortion</span><span class="p">(</span>
 
-        <span class="n">collections</span><span class="o">.</span><span class="n">namedtuple</span><span class="p">(</span><span class="s1">&#39;Abortion&#39;</span><span class="p">,</span>
 
-                               <span class="p">(</span><span class="s1">&#39;kind&#39;</span><span class="p">,</span> <span class="s1">&#39;initial_metadata&#39;</span><span class="p">,</span> <span class="s1">&#39;terminal_metadata&#39;</span><span class="p">,</span>
 
-                                <span class="s1">&#39;code&#39;</span><span class="p">,</span> <span class="s1">&#39;details&#39;</span><span class="p">,))):</span>
 
-    <span class="sd">&quot;&quot;&quot;A value describing RPC abortion.</span>
 
-
 
-<span class="sd">  Attributes:</span>
 
-<span class="sd">    kind: A Kind value identifying how the RPC failed.</span>
 
-<span class="sd">    initial_metadata: The initial metadata from the other side of the RPC or</span>
 
-<span class="sd">      None if no initial metadata value was received.</span>
 
-<span class="sd">    terminal_metadata: The terminal metadata from the other side of the RPC or</span>
 
-<span class="sd">      None if no terminal metadata value was received.</span>
 
-<span class="sd">    code: The code value from the other side of the RPC or None if no code value</span>
 
-<span class="sd">      was received.</span>
 
-<span class="sd">    details: The details value from the other side of the RPC or None if no</span>
 
-<span class="sd">      details value was received.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="Abortion.Kind"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.Abortion.Kind">[docs]</a>    <span class="nd">@enum</span><span class="o">.</span><span class="n">unique</span>
 
-    <span class="k">class</span> <span class="nc">Kind</span><span class="p">(</span><span class="n">enum</span><span class="o">.</span><span class="n">Enum</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Types of RPC abortion.&quot;&quot;&quot;</span>
 
-
 
-        <span class="n">CANCELLED</span> <span class="o">=</span> <span class="s1">&#39;cancelled&#39;</span>
 
-        <span class="n">EXPIRED</span> <span class="o">=</span> <span class="s1">&#39;expired&#39;</span>
 
-        <span class="n">LOCAL_SHUTDOWN</span> <span class="o">=</span> <span class="s1">&#39;local shutdown&#39;</span>
 
-        <span class="n">REMOTE_SHUTDOWN</span> <span class="o">=</span> <span class="s1">&#39;remote shutdown&#39;</span>
 
-        <span class="n">NETWORK_FAILURE</span> <span class="o">=</span> <span class="s1">&#39;network failure&#39;</span>
 
-        <span class="n">LOCAL_FAILURE</span> <span class="o">=</span> <span class="s1">&#39;local failure&#39;</span>
 
-        <span class="n">REMOTE_FAILURE</span> <span class="o">=</span> <span class="s1">&#39;remote failure&#39;</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="AbortionError"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.AbortionError">[docs]</a><span class="k">class</span> <span class="nc">AbortionError</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">,</span> <span class="ne">Exception</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Common super type for exceptions indicating RPC abortion.</span>
 
-
 
-<span class="sd">    initial_metadata: The initial metadata from the other side of the RPC or</span>
 
-<span class="sd">      None if no initial metadata value was received.</span>
 
-<span class="sd">    terminal_metadata: The terminal metadata from the other side of the RPC or</span>
 
-<span class="sd">      None if no terminal metadata value was received.</span>
 
-<span class="sd">    code: The code value from the other side of the RPC or None if no code value</span>
 
-<span class="sd">      was received.</span>
 
-<span class="sd">    details: The details value from the other side of the RPC or None if no</span>
 
-<span class="sd">      details value was received.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__init__</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="n">terminal_metadata</span><span class="p">,</span> <span class="n">code</span><span class="p">,</span> <span class="n">details</span><span class="p">):</span>
 
-        <span class="nb">super</span><span class="p">(</span><span class="n">AbortionError</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">initial_metadata</span> <span class="o">=</span> <span class="n">initial_metadata</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">terminal_metadata</span> <span class="o">=</span> <span class="n">terminal_metadata</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">code</span> <span class="o">=</span> <span class="n">code</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">details</span> <span class="o">=</span> <span class="n">details</span>
 
-
 
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">(code=</span><span class="si">%s</span><span class="s1">, details=&quot;</span><span class="si">%s</span><span class="s1">&quot;)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span>
 
-                                              <span class="bp">self</span><span class="o">.</span><span class="n">code</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">details</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="CancellationError"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.CancellationError">[docs]</a><span class="k">class</span> <span class="nc">CancellationError</span><span class="p">(</span><span class="n">AbortionError</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Indicates that an RPC has been cancelled.&quot;&quot;&quot;</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="ExpirationError"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.ExpirationError">[docs]</a><span class="k">class</span> <span class="nc">ExpirationError</span><span class="p">(</span><span class="n">AbortionError</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Indicates that an RPC has expired (&quot;timed out&quot;).&quot;&quot;&quot;</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="LocalShutdownError"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.LocalShutdownError">[docs]</a><span class="k">class</span> <span class="nc">LocalShutdownError</span><span class="p">(</span><span class="n">AbortionError</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Indicates that an RPC has terminated due to local shutdown of RPCs.&quot;&quot;&quot;</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="RemoteShutdownError"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.RemoteShutdownError">[docs]</a><span class="k">class</span> <span class="nc">RemoteShutdownError</span><span class="p">(</span><span class="n">AbortionError</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Indicates that an RPC has terminated due to remote shutdown of RPCs.&quot;&quot;&quot;</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="NetworkError"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.NetworkError">[docs]</a><span class="k">class</span> <span class="nc">NetworkError</span><span class="p">(</span><span class="n">AbortionError</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Indicates that some error occurred on the network.&quot;&quot;&quot;</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="LocalError"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.LocalError">[docs]</a><span class="k">class</span> <span class="nc">LocalError</span><span class="p">(</span><span class="n">AbortionError</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Indicates that an RPC has terminated due to a local defect.&quot;&quot;&quot;</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="RemoteError"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.RemoteError">[docs]</a><span class="k">class</span> <span class="nc">RemoteError</span><span class="p">(</span><span class="n">AbortionError</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Indicates that an RPC has terminated due to a remote defect.&quot;&quot;&quot;</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="RpcContext"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.RpcContext">[docs]</a><span class="k">class</span> <span class="nc">RpcContext</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Provides RPC-related information and action.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="RpcContext.is_active"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.RpcContext.is_active">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">is_active</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Describes whether the RPC is active or has terminated.&quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
-
 
-<div class="viewcode-block" id="RpcContext.time_remaining"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.RpcContext.time_remaining">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">time_remaining</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Describes the length of allowed time remaining for the RPC.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A nonnegative float indicating the length of allowed time in seconds</span>
 
-<span class="sd">      remaining for the RPC to complete before it is considered to have timed</span>
 
-<span class="sd">      out.</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="RpcContext.add_abortion_callback"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.RpcContext.add_abortion_callback">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">add_abortion_callback</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">abortion_callback</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Registers a callback to be called if the RPC is aborted.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      abortion_callback: A callable to be called and passed an Abortion value</span>
 
-<span class="sd">        in the event of RPC abortion.</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="RpcContext.cancel"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.RpcContext.cancel">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">cancel</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Cancels the RPC.</span>
 
-
 
-<span class="sd">    Idempotent and has no effect if the RPC has already terminated.</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="RpcContext.protocol_context"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.RpcContext.protocol_context">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">protocol_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Accesses a custom object specified by an implementation provider.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A value specified by the provider of a Face interface implementation</span>
 
-<span class="sd">        affording custom state and behavior.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="Call"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.Call">[docs]</a><span class="k">class</span> <span class="nc">Call</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">,</span> <span class="n">RpcContext</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Invocation-side utility object for an RPC.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="Call.initial_metadata"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.Call.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">initial_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Accesses the initial metadata from the service-side of the RPC.</span>
 
-
 
-<span class="sd">    This method blocks until the value is available or is known not to have been</span>
 
-<span class="sd">    emitted from the service-side of the RPC.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      The initial metadata object emitted by the service-side of the RPC, or</span>
 
-<span class="sd">        None if there was no such value.</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="Call.terminal_metadata"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.Call.terminal_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">terminal_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Accesses the terminal metadata from the service-side of the RPC.</span>
 
-
 
-<span class="sd">    This method blocks until the value is available or is known not to have been</span>
 
-<span class="sd">    emitted from the service-side of the RPC.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      The terminal metadata object emitted by the service-side of the RPC, or</span>
 
-<span class="sd">        None if there was no such value.</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="Call.code"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.Call.code">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">code</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Accesses the code emitted by the service-side of the RPC.</span>
 
-
 
-<span class="sd">    This method blocks until the value is available or is known not to have been</span>
 
-<span class="sd">    emitted from the service-side of the RPC.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      The code object emitted by the service-side of the RPC, or None if there</span>
 
-<span class="sd">        was no such value.</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="Call.details"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.Call.details">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">details</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Accesses the details value emitted by the service-side of the RPC.</span>
 
-
 
-<span class="sd">    This method blocks until the value is available or is known not to have been</span>
 
-<span class="sd">    emitted from the service-side of the RPC.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      The details value emitted by the service-side of the RPC, or None if there</span>
 
-<span class="sd">        was no such value.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="ServicerContext"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.ServicerContext">[docs]</a><span class="k">class</span> <span class="nc">ServicerContext</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">,</span> <span class="n">RpcContext</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;A context object passed to method implementations.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="ServicerContext.invocation_metadata"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.ServicerContext.invocation_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">invocation_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Accesses the metadata from the invocation-side of the RPC.</span>
 
-
 
-<span class="sd">    This method blocks until the value is available or is known not to have been</span>
 
-<span class="sd">    emitted from the invocation-side of the RPC.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      The metadata object emitted by the invocation-side of the RPC, or None if</span>
 
-<span class="sd">        there was no such value.</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.initial_metadata"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.ServicerContext.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">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;Accepts the service-side initial metadata value of the RPC.</span>
 
-
 
-<span class="sd">    This method need not be called by method implementations if they have no</span>
 
-<span class="sd">    service-side initial metadata to transmit.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      initial_metadata: The service-side initial metadata value of the RPC to</span>
 
-<span class="sd">        be transmitted to the invocation side 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.terminal_metadata"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.ServicerContext.terminal_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">terminal_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">terminal_metadata</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Accepts the service-side terminal metadata value of the RPC.</span>
 
-
 
-<span class="sd">    This method need not be called by method implementations if they have no</span>
 
-<span class="sd">    service-side terminal metadata to transmit.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      terminal_metadata: The service-side terminal metadata value of the RPC to</span>
 
-<span class="sd">        be transmitted to the invocation side 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.code"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.ServicerContext.code">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">code</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">code</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Accepts the service-side code of the RPC.</span>
 
-
 
-<span class="sd">    This method need not be called by method implementations if they have no</span>
 
-<span class="sd">    code to transmit.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      code: The code of the RPC to be transmitted to the invocation side of the</span>
 
-<span class="sd">        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.details"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.ServicerContext.details">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">details</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">details</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Accepts the service-side details of the RPC.</span>
 
-
 
-<span class="sd">    This method need not be called by method implementations if they have no</span>
 
-<span class="sd">    service-side details to transmit.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      details: The service-side details value of the RPC to be transmitted to</span>
 
-<span class="sd">        the invocation side 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>
 
-
 
-
 
-<div class="viewcode-block" id="ResponseReceiver"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.ResponseReceiver">[docs]</a><span class="k">class</span> <span class="nc">ResponseReceiver</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Invocation-side object used to accept the output of an RPC.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="ResponseReceiver.initial_metadata"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.ResponseReceiver.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">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;Receives the initial metadata from the service-side of the RPC.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      initial_metadata: The initial metadata object emitted from the</span>
 
-<span class="sd">        service-side 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="ResponseReceiver.response"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.ResponseReceiver.response">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">response</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">response</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Receives a response from the service-side of the RPC.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      response: A response object emitted from the service-side 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="ResponseReceiver.complete"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.ResponseReceiver.complete">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">complete</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">terminal_metadata</span><span class="p">,</span> <span class="n">code</span><span class="p">,</span> <span class="n">details</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Receives the completion values emitted from the service-side of the RPC.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      terminal_metadata: The terminal metadata object emitted from the</span>
 
-<span class="sd">        service-side of the RPC.</span>
 
-<span class="sd">      code: The code object emitted from the service-side of the RPC.</span>
 
-<span class="sd">      details: The details object emitted from the service-side 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>
 
-
 
-
 
-<div class="viewcode-block" id="UnaryUnaryMultiCallable"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.UnaryUnaryMultiCallable">[docs]</a><span class="k">class</span> <span class="nc">UnaryUnaryMultiCallable</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Affords invoking a unary-unary RPC in any call style.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="UnaryUnaryMultiCallable.__call__"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.UnaryUnaryMultiCallable.__call__">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">__call__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                 <span class="n">request</span><span class="p">,</span>
 
-                 <span class="n">timeout</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">with_call</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
 
-                 <span class="n">protocol_options</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>
 
-<span class="sd">      request: The request value for the RPC.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of</span>
 
-<span class="sd">        the RPC.</span>
 
-<span class="sd">      with_call: Whether or not to include return a Call for the RPC in addition</span>
 
-<span class="sd">        to the response.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      The response value for the RPC, and a Call for the RPC if with_call was</span>
 
-<span class="sd">        set to True at invocation.</span>
 
-
 
-<span class="sd">    Raises:</span>
 
-<span class="sd">      AbortionError: Indicating that the RPC was aborted.</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="UnaryUnaryMultiCallable.future"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.UnaryUnaryMultiCallable.future">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">future</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">,</span> <span class="n">timeout</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">protocol_options</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>
 
-<span class="sd">      request: The request value for the RPC.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of</span>
 
-<span class="sd">        the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      An object that is both a Call for the RPC and a future.Future. In the</span>
 
-<span class="sd">        event of RPC completion, the return Future&#39;s result value will be the</span>
 
-<span class="sd">        response value of the RPC. In the event of RPC abortion, the returned</span>
 
-<span class="sd">        Future&#39;s exception value will be an AbortionError.</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="UnaryUnaryMultiCallable.event"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.UnaryUnaryMultiCallable.event">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-              <span class="n">request</span><span class="p">,</span>
 
-              <span class="n">receiver</span><span class="p">,</span>
 
-              <span class="n">abortion_callback</span><span class="p">,</span>
 
-              <span class="n">timeout</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">protocol_options</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>
 
-<span class="sd">      request: The request value for the RPC.</span>
 
-<span class="sd">      receiver: A ResponseReceiver to be passed the response data of the RPC.</span>
 
-<span class="sd">      abortion_callback: A callback to be called and passed an Abortion value</span>
 
-<span class="sd">        in the event of RPC abortion.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of</span>
 
-<span class="sd">        the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A Call for 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>
 
-
 
-
 
-<div class="viewcode-block" id="UnaryStreamMultiCallable"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.UnaryStreamMultiCallable">[docs]</a><span class="k">class</span> <span class="nc">UnaryStreamMultiCallable</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Affords invoking a unary-stream RPC in any call style.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="UnaryStreamMultiCallable.__call__"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.UnaryStreamMultiCallable.__call__">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">__call__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">,</span> <span class="n">timeout</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">protocol_options</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>
 
-<span class="sd">      request: The request value for the RPC.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of</span>
 
-<span class="sd">        the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      An object that is both a Call for the RPC and an iterator of response</span>
 
-<span class="sd">        values. Drawing response values from the returned iterator may raise</span>
 
-<span class="sd">        AbortionError indicating abortion 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="UnaryStreamMultiCallable.event"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.UnaryStreamMultiCallable.event">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-              <span class="n">request</span><span class="p">,</span>
 
-              <span class="n">receiver</span><span class="p">,</span>
 
-              <span class="n">abortion_callback</span><span class="p">,</span>
 
-              <span class="n">timeout</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">protocol_options</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>
 
-<span class="sd">      request: The request value for the RPC.</span>
 
-<span class="sd">      receiver: A ResponseReceiver to be passed the response data of the RPC.</span>
 
-<span class="sd">      abortion_callback: A callback to be called and passed an Abortion value</span>
 
-<span class="sd">        in the event of RPC abortion.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of</span>
 
-<span class="sd">        the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A Call object for 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>
 
-
 
-
 
-<div class="viewcode-block" id="StreamUnaryMultiCallable"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.StreamUnaryMultiCallable">[docs]</a><span class="k">class</span> <span class="nc">StreamUnaryMultiCallable</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Affords invoking a stream-unary RPC in any call style.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="StreamUnaryMultiCallable.__call__"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.StreamUnaryMultiCallable.__call__">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">__call__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                 <span class="n">request_iterator</span><span class="p">,</span>
 
-                 <span class="n">timeout</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">with_call</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
 
-                 <span class="n">protocol_options</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>
 
-<span class="sd">      request_iterator: An iterator that yields request values for the RPC.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of</span>
 
-<span class="sd">        the RPC.</span>
 
-<span class="sd">      with_call: Whether or not to include return a Call for the RPC in addition</span>
 
-<span class="sd">        to the response.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      The response value for the RPC, and a Call for the RPC if with_call was</span>
 
-<span class="sd">        set to True at invocation.</span>
 
-
 
-<span class="sd">    Raises:</span>
 
-<span class="sd">      AbortionError: Indicating that the RPC was aborted.</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="StreamUnaryMultiCallable.future"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.StreamUnaryMultiCallable.future">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">future</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-               <span class="n">request_iterator</span><span class="p">,</span>
 
-               <span class="n">timeout</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">protocol_options</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>
 
-<span class="sd">      request_iterator: An iterator that yields request values for the RPC.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of</span>
 
-<span class="sd">        the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      An object that is both a Call for the RPC and a future.Future. In the</span>
 
-<span class="sd">        event of RPC completion, the return Future&#39;s result value will be the</span>
 
-<span class="sd">        response value of the RPC. In the event of RPC abortion, the returned</span>
 
-<span class="sd">        Future&#39;s exception value will be an AbortionError.</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="StreamUnaryMultiCallable.event"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.StreamUnaryMultiCallable.event">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-              <span class="n">receiver</span><span class="p">,</span>
 
-              <span class="n">abortion_callback</span><span class="p">,</span>
 
-              <span class="n">timeout</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">protocol_options</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>
 
-<span class="sd">      receiver: A ResponseReceiver to be passed the response data of the RPC.</span>
 
-<span class="sd">      abortion_callback: A callback to be called and passed an Abortion value</span>
 
-<span class="sd">        in the event of RPC abortion.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of</span>
 
-<span class="sd">        the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A single object that is both a Call object for the RPC and a</span>
 
-<span class="sd">        stream.Consumer to which the request values of the RPC should be passed.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="StreamStreamMultiCallable"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.StreamStreamMultiCallable">[docs]</a><span class="k">class</span> <span class="nc">StreamStreamMultiCallable</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Affords invoking a stream-stream RPC in any call style.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="StreamStreamMultiCallable.__call__"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.StreamStreamMultiCallable.__call__">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">__call__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                 <span class="n">request_iterator</span><span class="p">,</span>
 
-                 <span class="n">timeout</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">protocol_options</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>
 
-<span class="sd">      request_iterator: An iterator that yields request values for the RPC.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of</span>
 
-<span class="sd">        the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      An object that is both a Call for the RPC and an iterator of response</span>
 
-<span class="sd">        values. Drawing response values from the returned iterator may raise</span>
 
-<span class="sd">        AbortionError indicating abortion 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="StreamStreamMultiCallable.event"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.StreamStreamMultiCallable.event">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-              <span class="n">receiver</span><span class="p">,</span>
 
-              <span class="n">abortion_callback</span><span class="p">,</span>
 
-              <span class="n">timeout</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">protocol_options</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>
 
-<span class="sd">      receiver: A ResponseReceiver to be passed the response data of the RPC.</span>
 
-<span class="sd">      abortion_callback: A callback to be called and passed an Abortion value</span>
 
-<span class="sd">        in the event of RPC abortion.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of</span>
 
-<span class="sd">        the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A single object that is both a Call object for the RPC and a</span>
 
-<span class="sd">        stream.Consumer to which the request values of the RPC should be passed.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="MethodImplementation"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.MethodImplementation">[docs]</a><span class="k">class</span> <span class="nc">MethodImplementation</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;A sum type that describes a method implementation.</span>
 
-
 
-<span class="sd">  Attributes:</span>
 
-<span class="sd">    cardinality: A cardinality.Cardinality value.</span>
 
-<span class="sd">    style: A style.Service value.</span>
 
-<span class="sd">    unary_unary_inline: The implementation of the method as a callable value</span>
 
-<span class="sd">      that takes a request value and a ServicerContext object and returns a</span>
 
-<span class="sd">      response value. Only non-None if cardinality is</span>
 
-<span class="sd">      cardinality.Cardinality.UNARY_UNARY and style is style.Service.INLINE.</span>
 
-<span class="sd">    unary_stream_inline: The implementation of the method as a callable value</span>
 
-<span class="sd">      that takes a request value and a ServicerContext object and returns an</span>
 
-<span class="sd">      iterator of response values. Only non-None if cardinality is</span>
 
-<span class="sd">      cardinality.Cardinality.UNARY_STREAM and style is style.Service.INLINE.</span>
 
-<span class="sd">    stream_unary_inline: The implementation of the method as a callable value</span>
 
-<span class="sd">      that takes an iterator of request values and a ServicerContext object and</span>
 
-<span class="sd">      returns a response value. Only non-None if cardinality is</span>
 
-<span class="sd">      cardinality.Cardinality.STREAM_UNARY and style is style.Service.INLINE.</span>
 
-<span class="sd">    stream_stream_inline: The implementation of the method as a callable value</span>
 
-<span class="sd">      that takes an iterator of request values and a ServicerContext object and</span>
 
-<span class="sd">      returns an iterator of response values. Only non-None if cardinality is</span>
 
-<span class="sd">      cardinality.Cardinality.STREAM_STREAM and style is style.Service.INLINE.</span>
 
-<span class="sd">    unary_unary_event: The implementation of the method as a callable value that</span>
 
-<span class="sd">      takes a request value, a response callback to which to pass the response</span>
 
-<span class="sd">      value of the RPC, and a ServicerContext. Only non-None if cardinality is</span>
 
-<span class="sd">      cardinality.Cardinality.UNARY_UNARY and style is style.Service.EVENT.</span>
 
-<span class="sd">    unary_stream_event: The implementation of the method as a callable value</span>
 
-<span class="sd">      that takes a request value, a stream.Consumer to which to pass the</span>
 
-<span class="sd">      response values of the RPC, and a ServicerContext. Only non-None if</span>
 
-<span class="sd">      cardinality is cardinality.Cardinality.UNARY_STREAM and style is</span>
 
-<span class="sd">      style.Service.EVENT.</span>
 
-<span class="sd">    stream_unary_event: The implementation of the method as a callable value</span>
 
-<span class="sd">      that takes a response callback to which to pass the response value of the</span>
 
-<span class="sd">      RPC and a ServicerContext and returns a stream.Consumer to which the</span>
 
-<span class="sd">      request values of the RPC should be passed. Only non-None if cardinality</span>
 
-<span class="sd">      is cardinality.Cardinality.STREAM_UNARY and style is style.Service.EVENT.</span>
 
-<span class="sd">    stream_stream_event: The implementation of the method as a callable value</span>
 
-<span class="sd">      that takes a stream.Consumer to which to pass the response values of the</span>
 
-<span class="sd">      RPC and a ServicerContext and returns a stream.Consumer to which the</span>
 
-<span class="sd">      request values of the RPC should be passed. Only non-None if cardinality</span>
 
-<span class="sd">      is cardinality.Cardinality.STREAM_STREAM and style is</span>
 
-<span class="sd">      style.Service.EVENT.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="MultiMethodImplementation"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.MultiMethodImplementation">[docs]</a><span class="k">class</span> <span class="nc">MultiMethodImplementation</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;A general type able to service many methods.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="MultiMethodImplementation.service"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.MultiMethodImplementation.service">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">service</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">group</span><span class="p">,</span> <span class="n">method</span><span class="p">,</span> <span class="n">response_consumer</span><span class="p">,</span> <span class="n">context</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Services an RPC.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-<span class="sd">      response_consumer: A stream.Consumer to be called to accept the response</span>
 
-<span class="sd">        values of the RPC.</span>
 
-<span class="sd">      context: a ServicerContext object.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A stream.Consumer with which to accept the request values of the RPC. The</span>
 
-<span class="sd">        consumer returned from this method may or may not be invoked to</span>
 
-<span class="sd">        completion: in the case of RPC abortion, RPC Framework will simply stop</span>
 
-<span class="sd">        passing values to this object. Implementations must not assume that this</span>
 
-<span class="sd">        object will be called to completion of the request stream or even called</span>
 
-<span class="sd">        at all.</span>
 
-
 
-<span class="sd">    Raises:</span>
 
-<span class="sd">      abandonment.Abandoned: May or may not be raised when the RPC has been</span>
 
-<span class="sd">        aborted.</span>
 
-<span class="sd">      NoSuchMethodError: If this MultiMethod does not recognize the given group</span>
 
-<span class="sd">        and name for the RPC and is not able to service 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>
 
-
 
-
 
-<div class="viewcode-block" id="GenericStub"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub">[docs]</a><span class="k">class</span> <span class="nc">GenericStub</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Affords RPC invocation via generic methods.&quot;&quot;&quot;</span>
 
-
 
-<div class="viewcode-block" id="GenericStub.blocking_unary_unary"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.blocking_unary_unary">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">blocking_unary_unary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                             <span class="n">group</span><span class="p">,</span>
 
-                             <span class="n">method</span><span class="p">,</span>
 
-                             <span class="n">request</span><span class="p">,</span>
 
-                             <span class="n">timeout</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">with_call</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
 
-                             <span class="n">protocol_options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Invokes a unary-request-unary-response method.</span>
 
-
 
-<span class="sd">    This method blocks until either returning the response value of the RPC</span>
 
-<span class="sd">    (in the event of RPC completion) or raising an exception (in the event of</span>
 
-<span class="sd">    RPC abortion).</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-<span class="sd">      request: The request value for the RPC.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of the RPC.</span>
 
-<span class="sd">      with_call: Whether or not to include return a Call for the RPC in addition</span>
 
-<span class="sd">        to the response.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      The response value for the RPC, and a Call for the RPC if with_call was</span>
 
-<span class="sd">        set to True at invocation.</span>
 
-
 
-<span class="sd">    Raises:</span>
 
-<span class="sd">      AbortionError: Indicating that the RPC was aborted.</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="GenericStub.future_unary_unary"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.future_unary_unary">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">future_unary_unary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                           <span class="n">group</span><span class="p">,</span>
 
-                           <span class="n">method</span><span class="p">,</span>
 
-                           <span class="n">request</span><span class="p">,</span>
 
-                           <span class="n">timeout</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">protocol_options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Invokes a unary-request-unary-response method.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-<span class="sd">      request: The request value for the RPC.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      An object that is both a Call for the RPC and a future.Future. In the</span>
 
-<span class="sd">        event of RPC completion, the return Future&#39;s result value will be the</span>
 
-<span class="sd">        response value of the RPC. In the event of RPC abortion, the returned</span>
 
-<span class="sd">        Future&#39;s exception value will be an AbortionError.</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="GenericStub.inline_unary_stream"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.inline_unary_stream">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">inline_unary_stream</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                            <span class="n">group</span><span class="p">,</span>
 
-                            <span class="n">method</span><span class="p">,</span>
 
-                            <span class="n">request</span><span class="p">,</span>
 
-                            <span class="n">timeout</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">protocol_options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Invokes a unary-request-stream-response method.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-<span class="sd">      request: The request value for the RPC.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      An object that is both a Call for the RPC and an iterator of response</span>
 
-<span class="sd">        values. Drawing response values from the returned iterator may raise</span>
 
-<span class="sd">        AbortionError indicating abortion 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="GenericStub.blocking_stream_unary"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.blocking_stream_unary">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">blocking_stream_unary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                              <span class="n">group</span><span class="p">,</span>
 
-                              <span class="n">method</span><span class="p">,</span>
 
-                              <span class="n">request_iterator</span><span class="p">,</span>
 
-                              <span class="n">timeout</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">with_call</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
 
-                              <span class="n">protocol_options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Invokes a stream-request-unary-response method.</span>
 
-
 
-<span class="sd">    This method blocks until either returning the response value of the RPC</span>
 
-<span class="sd">    (in the event of RPC completion) or raising an exception (in the event of</span>
 
-<span class="sd">    RPC abortion).</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-<span class="sd">      request_iterator: An iterator that yields request values for the RPC.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of the RPC.</span>
 
-<span class="sd">      with_call: Whether or not to include return a Call for the RPC in addition</span>
 
-<span class="sd">        to the response.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      The response value for the RPC, and a Call for the RPC if with_call was</span>
 
-<span class="sd">        set to True at invocation.</span>
 
-
 
-<span class="sd">    Raises:</span>
 
-<span class="sd">      AbortionError: Indicating that the RPC was aborted.</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="GenericStub.future_stream_unary"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.future_stream_unary">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">future_stream_unary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                            <span class="n">group</span><span class="p">,</span>
 
-                            <span class="n">method</span><span class="p">,</span>
 
-                            <span class="n">request_iterator</span><span class="p">,</span>
 
-                            <span class="n">timeout</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">protocol_options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Invokes a stream-request-unary-response method.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-<span class="sd">      request_iterator: An iterator that yields request values for the RPC.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      An object that is both a Call for the RPC and a future.Future. In the</span>
 
-<span class="sd">        event of RPC completion, the return Future&#39;s result value will be the</span>
 
-<span class="sd">        response value of the RPC. In the event of RPC abortion, the returned</span>
 
-<span class="sd">        Future&#39;s exception value will be an AbortionError.</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="GenericStub.inline_stream_stream"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.inline_stream_stream">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">inline_stream_stream</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                             <span class="n">group</span><span class="p">,</span>
 
-                             <span class="n">method</span><span class="p">,</span>
 
-                             <span class="n">request_iterator</span><span class="p">,</span>
 
-                             <span class="n">timeout</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">protocol_options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Invokes a stream-request-stream-response method.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-<span class="sd">      request_iterator: An iterator that yields request values for the RPC.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      An object that is both a Call for the RPC and an iterator of response</span>
 
-<span class="sd">        values. Drawing response values from the returned iterator may raise</span>
 
-<span class="sd">        AbortionError indicating abortion 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="GenericStub.event_unary_unary"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.event_unary_unary">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">event_unary_unary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                          <span class="n">group</span><span class="p">,</span>
 
-                          <span class="n">method</span><span class="p">,</span>
 
-                          <span class="n">request</span><span class="p">,</span>
 
-                          <span class="n">receiver</span><span class="p">,</span>
 
-                          <span class="n">abortion_callback</span><span class="p">,</span>
 
-                          <span class="n">timeout</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">protocol_options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Event-driven invocation of a unary-request-unary-response method.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-<span class="sd">      request: The request value for the RPC.</span>
 
-<span class="sd">      receiver: A ResponseReceiver to be passed the response data of the RPC.</span>
 
-<span class="sd">      abortion_callback: A callback to be called and passed an Abortion value</span>
 
-<span class="sd">        in the event of RPC abortion.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A Call for 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="GenericStub.event_unary_stream"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.event_unary_stream">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">event_unary_stream</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                           <span class="n">group</span><span class="p">,</span>
 
-                           <span class="n">method</span><span class="p">,</span>
 
-                           <span class="n">request</span><span class="p">,</span>
 
-                           <span class="n">receiver</span><span class="p">,</span>
 
-                           <span class="n">abortion_callback</span><span class="p">,</span>
 
-                           <span class="n">timeout</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">protocol_options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Event-driven invocation of a unary-request-stream-response method.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-<span class="sd">      request: The request value for the RPC.</span>
 
-<span class="sd">      receiver: A ResponseReceiver to be passed the response data of the RPC.</span>
 
-<span class="sd">      abortion_callback: A callback to be called and passed an Abortion value</span>
 
-<span class="sd">        in the event of RPC abortion.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A Call for 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="GenericStub.event_stream_unary"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.event_stream_unary">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">event_stream_unary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                           <span class="n">group</span><span class="p">,</span>
 
-                           <span class="n">method</span><span class="p">,</span>
 
-                           <span class="n">receiver</span><span class="p">,</span>
 
-                           <span class="n">abortion_callback</span><span class="p">,</span>
 
-                           <span class="n">timeout</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">protocol_options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Event-driven invocation of a unary-request-unary-response method.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-<span class="sd">      receiver: A ResponseReceiver to be passed the response data of the RPC.</span>
 
-<span class="sd">      abortion_callback: A callback to be called and passed an Abortion value</span>
 
-<span class="sd">        in the event of RPC abortion.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A pair of a Call object for the RPC and a stream.Consumer to which the</span>
 
-<span class="sd">        request values of the RPC should be passed.</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="GenericStub.event_stream_stream"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.event_stream_stream">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">event_stream_stream</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
 
-                            <span class="n">group</span><span class="p">,</span>
 
-                            <span class="n">method</span><span class="p">,</span>
 
-                            <span class="n">receiver</span><span class="p">,</span>
 
-                            <span class="n">abortion_callback</span><span class="p">,</span>
 
-                            <span class="n">timeout</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">protocol_options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Event-driven invocation of a unary-request-stream-response method.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-<span class="sd">      receiver: A ResponseReceiver to be passed the response data of the RPC.</span>
 
-<span class="sd">      abortion_callback: A callback to be called and passed an Abortion value</span>
 
-<span class="sd">        in the event of RPC abortion.</span>
 
-<span class="sd">      timeout: A duration of time in seconds to allow for the RPC.</span>
 
-<span class="sd">      metadata: A metadata value to be passed to the service-side of the RPC.</span>
 
-<span class="sd">      protocol_options: A value specified by the provider of a Face interface</span>
 
-<span class="sd">        implementation affording custom state and behavior.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A pair of a Call object for the RPC and a stream.Consumer to which the</span>
 
-<span class="sd">        request values of the RPC should be passed.</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="GenericStub.unary_unary"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.unary_unary">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">unary_unary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">group</span><span class="p">,</span> <span class="n">method</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Creates a UnaryUnaryMultiCallable for a unary-unary method.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A UnaryUnaryMultiCallable value for the named unary-unary method.</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="GenericStub.unary_stream"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.unary_stream">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">unary_stream</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">group</span><span class="p">,</span> <span class="n">method</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Creates a UnaryStreamMultiCallable for a unary-stream method.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A UnaryStreamMultiCallable value for the name unary-stream method.</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="GenericStub.stream_unary"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.stream_unary">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">stream_unary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">group</span><span class="p">,</span> <span class="n">method</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Creates a StreamUnaryMultiCallable for a stream-unary method.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A StreamUnaryMultiCallable value for the named stream-unary method.</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="GenericStub.stream_stream"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.GenericStub.stream_stream">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
-    <span class="k">def</span> <span class="nf">stream_stream</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">group</span><span class="p">,</span> <span class="n">method</span><span class="p">):</span>
 
-        <span class="sd">&quot;&quot;&quot;Creates a StreamStreamMultiCallable for a stream-stream method.</span>
 
-
 
-<span class="sd">    Args:</span>
 
-<span class="sd">      group: The group identifier of the RPC.</span>
 
-<span class="sd">      method: The method identifier of the RPC.</span>
 
-
 
-<span class="sd">    Returns:</span>
 
-<span class="sd">      A StreamStreamMultiCallable value for the named stream-stream method.</span>
 
-<span class="sd">    &quot;&quot;&quot;</span>
 
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
-
 
-
 
-<div class="viewcode-block" id="DynamicStub"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.face.DynamicStub">[docs]</a><span class="k">class</span> <span class="nc">DynamicStub</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
-    <span class="sd">&quot;&quot;&quot;Affords RPC invocation via attributes corresponding to afforded methods.</span>
 
-
 
-<span class="sd">  Instances of this type may be scoped to a single group so that attribute</span>
 
-<span class="sd">  access is unambiguous.</span>
 
-
 
-<span class="sd">  Instances of this type respond to attribute access as follows: if the</span>
 
-<span class="sd">  requested attribute is the name of a unary-unary method, the value of the</span>
 
-<span class="sd">  attribute will be a UnaryUnaryMultiCallable with which to invoke an RPC; if</span>
 
-<span class="sd">  the requested attribute is the name of a unary-stream method, the value of the</span>
 
-<span class="sd">  attribute will be a UnaryStreamMultiCallable with which to invoke an RPC; if</span>
 
-<span class="sd">  the requested attribute is the name of a stream-unary method, the value of the</span>
 
-<span class="sd">  attribute will be a StreamUnaryMultiCallable with which to invoke an RPC; and</span>
 
-<span class="sd">  if the requested attribute is the name of a stream-stream method, the value of</span>
 
-<span class="sd">  the attribute will be a StreamStreamMultiCallable with which to invoke an RPC.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 394
python/_modules/grpc/framework/interfaces/face/utilities.html
查看文件 

@@ -1,394 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.interfaces.face.utilities &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="../../../../../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="../../../../../genindex.html"/>
 
-        <link rel="search" title="Search" href="../../../../../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../../../../../index.html"/>
 
-        <link rel="up" title="grpc" href="../../../../grpc.html"/> 
-
 
-  
-  <script src="../../../../../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="../../../../../index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../../../../../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../../../../../grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../../../../../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../../../../../index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="../../../../index.html">Module code</a> &raquo;</li>
 
-        
-          <li><a href="../../../../grpc.html">grpc</a> &raquo;</li>
 
-        
-      <li>grpc.framework.interfaces.face.utilities</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <h1>Source code for grpc.framework.interfaces.face.utilities</h1><div class="highlight"><pre>
 
-<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
-<span class="c1"># you may not use this file except in compliance with the License.</span>
 
-<span class="c1"># You may obtain a copy of the License at</span>
 
-<span class="c1">#</span>
 
-<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
-<span class="c1">#</span>
 
-<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
-<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
-<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
-<span class="c1"># See the License for the specific language governing permissions and</span>
 
-<span class="c1"># limitations under the License.</span>
 
-<span class="sd">&quot;&quot;&quot;Utilities for RPC Framework&#39;s Face interface.&quot;&quot;&quot;</span>
 
-
 
-<span class="kn">import</span> <span class="nn">collections</span>
 
-
 
-<span class="c1"># stream is referenced from specification in this module.</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.common</span> <span class="k">import</span> <span class="n">cardinality</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.common</span> <span class="k">import</span> <span class="n">style</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.foundation</span> <span class="k">import</span> <span class="n">stream</span>  <span class="c1"># pylint: disable=unused-import</span>
 
-<span class="kn">from</span> <span class="nn">grpc.framework.interfaces.face</span> <span class="k">import</span> <span class="n">face</span>
 
-
 
-
 
-<span class="k">class</span> <span class="nc">_MethodImplementation</span><span class="p">(</span><span class="n">face</span><span class="o">.</span><span class="n">MethodImplementation</span><span class="p">,</span>
 
-                            <span class="n">collections</span><span class="o">.</span><span class="n">namedtuple</span><span class="p">(</span><span class="s1">&#39;_MethodImplementation&#39;</span><span class="p">,</span> <span class="p">[</span>
 
-                                <span class="s1">&#39;cardinality&#39;</span><span class="p">,</span>
 
-                                <span class="s1">&#39;style&#39;</span><span class="p">,</span>
 
-                                <span class="s1">&#39;unary_unary_inline&#39;</span><span class="p">,</span>
 
-                                <span class="s1">&#39;unary_stream_inline&#39;</span><span class="p">,</span>
 
-                                <span class="s1">&#39;stream_unary_inline&#39;</span><span class="p">,</span>
 
-                                <span class="s1">&#39;stream_stream_inline&#39;</span><span class="p">,</span>
 
-                                <span class="s1">&#39;unary_unary_event&#39;</span><span class="p">,</span>
 
-                                <span class="s1">&#39;unary_stream_event&#39;</span><span class="p">,</span>
 
-                                <span class="s1">&#39;stream_unary_event&#39;</span><span class="p">,</span>
 
-                                <span class="s1">&#39;stream_stream_event&#39;</span><span class="p">,</span>
 
-                            <span class="p">])):</span>
 
-    <span class="k">pass</span>
 
-
 
-
 
-<div class="viewcode-block" id="unary_unary_inline"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.utilities.unary_unary_inline">[docs]</a><span class="k">def</span> <span class="nf">unary_unary_inline</span><span class="p">(</span><span class="n">behavior</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates an face.MethodImplementation for the given behavior.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    behavior: The implementation of a unary-unary RPC method as a callable value</span>
 
-<span class="sd">      that takes a request value and an face.ServicerContext object and</span>
 
-<span class="sd">      returns a response value.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    An face.MethodImplementation derived from the given behavior.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">_MethodImplementation</span><span class="p">(</span><span class="n">cardinality</span><span class="o">.</span><span class="n">Cardinality</span><span class="o">.</span><span class="n">UNARY_UNARY</span><span class="p">,</span>
 
-                                 <span class="n">style</span><span class="o">.</span><span class="n">Service</span><span class="o">.</span><span class="n">INLINE</span><span class="p">,</span> <span class="n">behavior</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span>
 
-                                 <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="unary_stream_inline"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.utilities.unary_stream_inline">[docs]</a><span class="k">def</span> <span class="nf">unary_stream_inline</span><span class="p">(</span><span class="n">behavior</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates an face.MethodImplementation for the given behavior.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    behavior: The implementation of a unary-stream RPC method as a callable</span>
 
-<span class="sd">      value that takes a request value and an face.ServicerContext object and</span>
 
-<span class="sd">      returns an iterator of response values.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    An face.MethodImplementation derived from the given behavior.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">_MethodImplementation</span><span class="p">(</span><span class="n">cardinality</span><span class="o">.</span><span class="n">Cardinality</span><span class="o">.</span><span class="n">UNARY_STREAM</span><span class="p">,</span>
 
-                                 <span class="n">style</span><span class="o">.</span><span class="n">Service</span><span class="o">.</span><span class="n">INLINE</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n">behavior</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span>
 
-                                 <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="stream_unary_inline"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.utilities.stream_unary_inline">[docs]</a><span class="k">def</span> <span class="nf">stream_unary_inline</span><span class="p">(</span><span class="n">behavior</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates an face.MethodImplementation for the given behavior.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    behavior: The implementation of a stream-unary RPC method as a callable</span>
 
-<span class="sd">      value that takes an iterator of request values and an</span>
 
-<span class="sd">      face.ServicerContext object and returns a response value.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    An face.MethodImplementation derived from the given behavior.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">_MethodImplementation</span><span class="p">(</span><span class="n">cardinality</span><span class="o">.</span><span class="n">Cardinality</span><span class="o">.</span><span class="n">STREAM_UNARY</span><span class="p">,</span>
 
-                                 <span class="n">style</span><span class="o">.</span><span class="n">Service</span><span class="o">.</span><span class="n">INLINE</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n">behavior</span><span class="p">,</span>
 
-                                 <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="stream_stream_inline"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.utilities.stream_stream_inline">[docs]</a><span class="k">def</span> <span class="nf">stream_stream_inline</span><span class="p">(</span><span class="n">behavior</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates an face.MethodImplementation for the given behavior.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    behavior: The implementation of a stream-stream RPC method as a callable</span>
 
-<span class="sd">      value that takes an iterator of request values and an</span>
 
-<span class="sd">      face.ServicerContext object and returns an iterator of response values.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    An face.MethodImplementation derived from the given behavior.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">_MethodImplementation</span><span class="p">(</span><span class="n">cardinality</span><span class="o">.</span><span class="n">Cardinality</span><span class="o">.</span><span class="n">STREAM_STREAM</span><span class="p">,</span>
 
-                                 <span class="n">style</span><span class="o">.</span><span class="n">Service</span><span class="o">.</span><span class="n">INLINE</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span>
 
-                                 <span class="n">behavior</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="unary_unary_event"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.utilities.unary_unary_event">[docs]</a><span class="k">def</span> <span class="nf">unary_unary_event</span><span class="p">(</span><span class="n">behavior</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates an face.MethodImplementation for the given behavior.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    behavior: The implementation of a unary-unary RPC method as a callable</span>
 
-<span class="sd">      value that takes a request value, a response callback to which to pass</span>
 
-<span class="sd">      the response value of the RPC, and an face.ServicerContext.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    An face.MethodImplementation derived from the given behavior.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">_MethodImplementation</span><span class="p">(</span><span class="n">cardinality</span><span class="o">.</span><span class="n">Cardinality</span><span class="o">.</span><span class="n">UNARY_UNARY</span><span class="p">,</span>
 
-                                 <span class="n">style</span><span class="o">.</span><span class="n">Service</span><span class="o">.</span><span class="n">EVENT</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span>
 
-                                 <span class="n">behavior</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="unary_stream_event"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.utilities.unary_stream_event">[docs]</a><span class="k">def</span> <span class="nf">unary_stream_event</span><span class="p">(</span><span class="n">behavior</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates an face.MethodImplementation for the given behavior.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    behavior: The implementation of a unary-stream RPC method as a callable</span>
 
-<span class="sd">      value that takes a request value, a stream.Consumer to which to pass the</span>
 
-<span class="sd">      the response values of the RPC, and an face.ServicerContext.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    An face.MethodImplementation derived from the given behavior.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">_MethodImplementation</span><span class="p">(</span><span class="n">cardinality</span><span class="o">.</span><span class="n">Cardinality</span><span class="o">.</span><span class="n">UNARY_STREAM</span><span class="p">,</span>
 
-                                 <span class="n">style</span><span class="o">.</span><span class="n">Service</span><span class="o">.</span><span class="n">EVENT</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span>
 
-                                 <span class="kc">None</span><span class="p">,</span> <span class="n">behavior</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="stream_unary_event"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.utilities.stream_unary_event">[docs]</a><span class="k">def</span> <span class="nf">stream_unary_event</span><span class="p">(</span><span class="n">behavior</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates an face.MethodImplementation for the given behavior.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    behavior: The implementation of a stream-unary RPC method as a callable</span>
 
-<span class="sd">      value that takes a response callback to which to pass the response value</span>
 
-<span class="sd">      of the RPC and an face.ServicerContext and returns a stream.Consumer to</span>
 
-<span class="sd">      which the request values of the RPC should be passed.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    An face.MethodImplementation derived from the given behavior.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">_MethodImplementation</span><span class="p">(</span><span class="n">cardinality</span><span class="o">.</span><span class="n">Cardinality</span><span class="o">.</span><span class="n">STREAM_UNARY</span><span class="p">,</span>
 
-                                 <span class="n">style</span><span class="o">.</span><span class="n">Service</span><span class="o">.</span><span class="n">EVENT</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span>
 
-                                 <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n">behavior</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
 
-
 
-
 
-<div class="viewcode-block" id="stream_stream_event"><a class="viewcode-back" href="../../../../../grpc.framework.interfaces.face.html#grpc.framework.interfaces.face.utilities.stream_stream_event">[docs]</a><span class="k">def</span> <span class="nf">stream_stream_event</span><span class="p">(</span><span class="n">behavior</span><span class="p">):</span>
 
-    <span class="sd">&quot;&quot;&quot;Creates an face.MethodImplementation for the given behavior.</span>
 
-
 
-<span class="sd">  Args:</span>
 
-<span class="sd">    behavior: The implementation of a stream-stream RPC method as a callable</span>
 
-<span class="sd">      value that takes a stream.Consumer to which to pass the response values</span>
 
-<span class="sd">      of the RPC and an face.ServicerContext and returns a stream.Consumer to</span>
 
-<span class="sd">      which the request values of the RPC should be passed.</span>
 
-
 
-<span class="sd">  Returns:</span>
 
-<span class="sd">    An face.MethodImplementation derived from the given behavior.</span>
 
-<span class="sd">  &quot;&quot;&quot;</span>
 
-    <span class="k">return</span> <span class="n">_MethodImplementation</span><span class="p">(</span><span class="n">cardinality</span><span class="o">.</span><span class="n">Cardinality</span><span class="o">.</span><span class="n">STREAM_STREAM</span><span class="p">,</span>
 
-                                 <span class="n">style</span><span class="o">.</span><span class="n">Service</span><span class="o">.</span><span class="n">EVENT</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span>
 
-                                 <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n">behavior</span><span class="p">)</span></div>
 
-</pre></div>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../../../../../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../../../../../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../../../../../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../../../../../_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="../../../../../_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 174 - 0
python/_modules/grpc_health/v1/health.html
查看文件 

@@ -0,0 +1,174 @@
 
+
 
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
+
 
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
 
+  <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.16.0 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>
 
+    <script type="text/javascript" src="../../../_static/jquery.js"></script>
 
+    <script type="text/javascript" src="../../../_static/underscore.js"></script>
 
+    <script type="text/javascript" src="../../../_static/doctools.js"></script>
 
+    <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
 
+    <link rel="index" title="Index" href="../../../genindex.html" />
 
+    <link rel="search" title="Search" href="../../../search.html" />
 
+   
+  <link rel="stylesheet" href="../../../_static/custom.css" type="text/css" />
 
+  
+  
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
 
+
 
+  </head><body>
 
+  <div class="document">
 
+    
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 
+        <div class="sphinxsidebarwrapper">
 
+<h1 class="logo"><a href="../../../index.html">gRPC Python</a></h1>
 
+
 
+
 
+
 
+<p class="blurb">1.16.0</p>
 
+
 
+
 
+
 
+
 
+
 
+
 
+<h3>Navigation</h3>
 
+<p class="caption"><span class="caption-text">Contents:</span></p>
 
+<ul>
 
+<li class="toctree-l1"><a class="reference internal" href="../../../grpc.html">gRPC</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../../../grpc_health_checking.html">gRPC Health Checking</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../../../grpc_reflection.html">gRPC Reflection</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../../../grpc_testing.html">gRPC Testing</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../../../glossary.html">Glossary</a></li>
 
+</ul>
 
+
 
+<div class="relations">
 
+<h3>Related Topics</h3>
 
+<ul>
 
+  <li><a href="../../../index.html">Documentation overview</a><ul>
 
+  <li><a href="../../index.html">Module code</a><ul>
 
+  </ul></li>
 
+  </ul></li>
 
+</ul>
 
+</div>
 
+<div id="searchbox" style="display: none" role="search">
 
+  <h3>Quick search</h3>
 
+    <div class="searchformwrapper">
 
+    <form class="search" action="../../../search.html" method="get">
 
+      <input type="text" name="q" />
 
+      <input type="submit" value="Go" />
 
+      <input type="hidden" name="check_keywords" value="yes" />
 
+      <input type="hidden" name="area" value="default" />
 
+    </form>
 
+    </div>
 
+</div>
 
+<script type="text/javascript">$('#searchbox').show(0);</script>
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+        </div>
 
+      </div>
 
+      <div class="documentwrapper">
 
+        <div class="bodywrapper">
 
+          
+
 
+          <div class="body" role="main">
 
+            
+  <h1>Source code for grpc_health.v1.health</h1><div class="highlight"><pre>
 
+<span></span><span class="c1"># Copyright 2015 gRPC authors.</span>
 
+<span class="c1">#</span>
 
+<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
+<span class="c1"># you may not use this file except in compliance with the License.</span>
 
+<span class="c1"># You may obtain a copy of the License at</span>
 
+<span class="c1">#</span>
 
+<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
+<span class="c1">#</span>
 
+<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
+<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
+<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
+<span class="c1"># See the License for the specific language governing permissions and</span>
 
+<span class="c1"># limitations under the License.</span>
 
+<span class="sd">&quot;&quot;&quot;Reference implementation for health checking in gRPC Python.&quot;&quot;&quot;</span>
 
+
 
+<span class="kn">import</span> <span class="nn">threading</span>
 
+
 
+<span class="kn">import</span> <span class="nn">grpc</span>
 
+
 
+<span class="kn">from</span> <span class="nn">grpc_health.v1</span> <span class="k">import</span> <span class="n">health_pb2</span> <span class="k">as</span> <span class="n">_health_pb2</span>
 
+<span class="kn">from</span> <span class="nn">grpc_health.v1</span> <span class="k">import</span> <span class="n">health_pb2_grpc</span> <span class="k">as</span> <span class="n">_health_pb2_grpc</span>
 
+
 
+<span class="n">SERVICE_NAME</span> <span class="o">=</span> <span class="n">_health_pb2</span><span class="o">.</span><span class="n">DESCRIPTOR</span><span class="o">.</span><span class="n">services_by_name</span><span class="p">[</span><span class="s1">&#39;Health&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">full_name</span>
 
+
 
+
 
+<div class="viewcode-block" id="HealthServicer"><a class="viewcode-back" href="../../../grpc_health_checking.html#grpc_health.v1.health.HealthServicer">[docs]</a><span class="k">class</span> <span class="nc">HealthServicer</span><span class="p">(</span><span class="n">_health_pb2_grpc</span><span class="o">.</span><span class="n">HealthServicer</span><span class="p">):</span>
 
+    <span class="sd">&quot;&quot;&quot;Servicer handling RPCs for service statuses.&quot;&quot;&quot;</span>
 
+
 
+    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="bp">self</span><span class="o">.</span><span class="n">_server_status_lock</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Lock</span><span class="p">()</span>
 
+        <span class="bp">self</span><span class="o">.</span><span class="n">_server_status</span> <span class="o">=</span> <span class="p">{}</span>
 
+
 
+    <span class="k">def</span> <span class="nf">Check</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">,</span> <span class="n">context</span><span class="p">):</span>
 
+        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_server_status_lock</span><span class="p">:</span>
 
+            <span class="n">status</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_server_status</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">request</span><span class="o">.</span><span class="n">service</span><span class="p">)</span>
 
+            <span class="k">if</span> <span class="n">status</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
 
+                <span class="n">context</span><span class="o">.</span><span class="n">set_code</span><span class="p">(</span><span class="n">grpc</span><span class="o">.</span><span class="n">StatusCode</span><span class="o">.</span><span class="n">NOT_FOUND</span><span class="p">)</span>
 
+                <span class="k">return</span> <span class="n">_health_pb2</span><span class="o">.</span><span class="n">HealthCheckResponse</span><span class="p">()</span>
 
+            <span class="k">else</span><span class="p">:</span>
 
+                <span class="k">return</span> <span class="n">_health_pb2</span><span class="o">.</span><span class="n">HealthCheckResponse</span><span class="p">(</span><span class="n">status</span><span class="o">=</span><span class="n">status</span><span class="p">)</span>
 
+
 
+<div class="viewcode-block" id="HealthServicer.set"><a class="viewcode-back" href="../../../grpc_health_checking.html#grpc_health.v1.health.HealthServicer.set">[docs]</a>    <span class="k">def</span> <span class="nf">set</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">service</span><span class="p">,</span> <span class="n">status</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Sets the status of a service.</span>
 
+
 
+<span class="sd">    Args:</span>
 
+<span class="sd">        service: string, the name of the service.</span>
 
+<span class="sd">            NOTE, &#39;&#39; must be set.</span>
 
+<span class="sd">        status: HealthCheckResponse.status enum value indicating</span>
 
+<span class="sd">            the status of the service</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_server_status_lock</span><span class="p">:</span>
 
+            <span class="bp">self</span><span class="o">.</span><span class="n">_server_status</span><span class="p">[</span><span class="n">service</span><span class="p">]</span> <span class="o">=</span> <span class="n">status</span></div></div>
 
+</pre></div>
 
+
 
+          </div>
 
+          
+        </div>
 
+      </div>
 
+    <div class="clearer"></div>
 
+  </div>
 
+    <div class="footer">
 
+      &copy;2018, The gRPC Authors.
 
+      
+    </div>
 
+
 
+    
+
 
+    
+    <script type="text/javascript">
 
+
 
+      var _gaq = _gaq || [];
 
+      _gaq.push(['_setAccount', 'UA-60127042-1']);
 
+      _gaq.push(['_setDomainName', 'none']);
 
+      _gaq.push(['_setAllowLinker', true]);
 
+      _gaq.push(['_trackPageview']);
 
+
 
+      (function() {
 
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 
+      })();
 
+
 
+    </script>
 
+    
+  </body>
 
+</html>

+ 270 - 0
python/_modules/grpc_reflection/v1alpha/reflection.html
查看文件 

@@ -0,0 +1,270 @@
 
+
 
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
+
 
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
 
+  <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.16.0 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>
 
+    <script type="text/javascript" src="../../../_static/jquery.js"></script>
 
+    <script type="text/javascript" src="../../../_static/underscore.js"></script>
 
+    <script type="text/javascript" src="../../../_static/doctools.js"></script>
 
+    <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
 
+    <link rel="index" title="Index" href="../../../genindex.html" />
 
+    <link rel="search" title="Search" href="../../../search.html" />
 
+   
+  <link rel="stylesheet" href="../../../_static/custom.css" type="text/css" />
 
+  
+  
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
 
+
 
+  </head><body>
 
+  <div class="document">
 
+    
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 
+        <div class="sphinxsidebarwrapper">
 
+<h1 class="logo"><a href="../../../index.html">gRPC Python</a></h1>
 
+
 
+
 
+
 
+<p class="blurb">1.16.0</p>
 
+
 
+
 
+
 
+
 
+
 
+
 
+<h3>Navigation</h3>
 
+<p class="caption"><span class="caption-text">Contents:</span></p>
 
+<ul>
 
+<li class="toctree-l1"><a class="reference internal" href="../../../grpc.html">gRPC</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../../../grpc_health_checking.html">gRPC Health Checking</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../../../grpc_reflection.html">gRPC Reflection</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../../../grpc_testing.html">gRPC Testing</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../../../glossary.html">Glossary</a></li>
 
+</ul>
 
+
 
+<div class="relations">
 
+<h3>Related Topics</h3>
 
+<ul>
 
+  <li><a href="../../../index.html">Documentation overview</a><ul>
 
+  <li><a href="../../index.html">Module code</a><ul>
 
+  </ul></li>
 
+  </ul></li>
 
+</ul>
 
+</div>
 
+<div id="searchbox" style="display: none" role="search">
 
+  <h3>Quick search</h3>
 
+    <div class="searchformwrapper">
 
+    <form class="search" action="../../../search.html" method="get">
 
+      <input type="text" name="q" />
 
+      <input type="submit" value="Go" />
 
+      <input type="hidden" name="check_keywords" value="yes" />
 
+      <input type="hidden" name="area" value="default" />
 
+    </form>
 
+    </div>
 
+</div>
 
+<script type="text/javascript">$('#searchbox').show(0);</script>
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+        </div>
 
+      </div>
 
+      <div class="documentwrapper">
 
+        <div class="bodywrapper">
 
+          
+
 
+          <div class="body" role="main">
 
+            
+  <h1>Source code for grpc_reflection.v1alpha.reflection</h1><div class="highlight"><pre>
 
+<span></span><span class="c1"># Copyright 2016 gRPC authors.</span>
 
+<span class="c1">#</span>
 
+<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
+<span class="c1"># you may not use this file except in compliance with the License.</span>
 
+<span class="c1"># You may obtain a copy of the License at</span>
 
+<span class="c1">#</span>
 
+<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
+<span class="c1">#</span>
 
+<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
+<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
+<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
+<span class="c1"># See the License for the specific language governing permissions and</span>
 
+<span class="c1"># limitations under the License.</span>
 
+<span class="sd">&quot;&quot;&quot;Reference implementation for reflection in gRPC Python.&quot;&quot;&quot;</span>
 
+
 
+<span class="kn">import</span> <span class="nn">grpc</span>
 
+<span class="kn">from</span> <span class="nn">google.protobuf</span> <span class="k">import</span> <span class="n">descriptor_pb2</span>
 
+<span class="kn">from</span> <span class="nn">google.protobuf</span> <span class="k">import</span> <span class="n">descriptor_pool</span>
 
+
 
+<span class="kn">from</span> <span class="nn">grpc_reflection.v1alpha</span> <span class="k">import</span> <span class="n">reflection_pb2</span> <span class="k">as</span> <span class="n">_reflection_pb2</span>
 
+<span class="kn">from</span> <span class="nn">grpc_reflection.v1alpha</span> <span class="k">import</span> <span class="n">reflection_pb2_grpc</span> <span class="k">as</span> <span class="n">_reflection_pb2_grpc</span>
 
+
 
+<span class="n">_POOL</span> <span class="o">=</span> <span class="n">descriptor_pool</span><span class="o">.</span><span class="n">Default</span><span class="p">()</span>
 
+<span class="n">SERVICE_NAME</span> <span class="o">=</span> <span class="n">_reflection_pb2</span><span class="o">.</span><span class="n">DESCRIPTOR</span><span class="o">.</span><span class="n">services_by_name</span><span class="p">[</span>
 
+    <span class="s1">&#39;ServerReflection&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">full_name</span>
 
+
 
+
 
+<span class="k">def</span> <span class="nf">_not_found_error</span><span class="p">():</span>
 
+    <span class="k">return</span> <span class="n">_reflection_pb2</span><span class="o">.</span><span class="n">ServerReflectionResponse</span><span class="p">(</span>
 
+        <span class="n">error_response</span><span class="o">=</span><span class="n">_reflection_pb2</span><span class="o">.</span><span class="n">ErrorResponse</span><span class="p">(</span>
 
+            <span class="n">error_code</span><span class="o">=</span><span class="n">grpc</span><span class="o">.</span><span class="n">StatusCode</span><span class="o">.</span><span class="n">NOT_FOUND</span><span class="o">.</span><span class="n">value</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span>
 
+            <span class="n">error_message</span><span class="o">=</span><span class="n">grpc</span><span class="o">.</span><span class="n">StatusCode</span><span class="o">.</span><span class="n">NOT_FOUND</span><span class="o">.</span><span class="n">value</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">encode</span><span class="p">(),</span>
 
+        <span class="p">))</span>
 
+
 
+
 
+<span class="k">def</span> <span class="nf">_file_descriptor_response</span><span class="p">(</span><span class="n">descriptor</span><span class="p">):</span>
 
+    <span class="n">proto</span> <span class="o">=</span> <span class="n">descriptor_pb2</span><span class="o">.</span><span class="n">FileDescriptorProto</span><span class="p">()</span>
 
+    <span class="n">descriptor</span><span class="o">.</span><span class="n">CopyToProto</span><span class="p">(</span><span class="n">proto</span><span class="p">)</span>
 
+    <span class="n">serialized_proto</span> <span class="o">=</span> <span class="n">proto</span><span class="o">.</span><span class="n">SerializeToString</span><span class="p">()</span>
 
+    <span class="k">return</span> <span class="n">_reflection_pb2</span><span class="o">.</span><span class="n">ServerReflectionResponse</span><span class="p">(</span>
 
+        <span class="n">file_descriptor_response</span><span class="o">=</span><span class="n">_reflection_pb2</span><span class="o">.</span><span class="n">FileDescriptorResponse</span><span class="p">(</span>
 
+            <span class="n">file_descriptor_proto</span><span class="o">=</span><span class="p">(</span><span class="n">serialized_proto</span><span class="p">,)),)</span>
 
+
 
+
 
+<div class="viewcode-block" id="ReflectionServicer"><a class="viewcode-back" href="../../../grpc_reflection.html#grpc_reflection.v1alpha.reflection.ReflectionServicer">[docs]</a><span class="k">class</span> <span class="nc">ReflectionServicer</span><span class="p">(</span><span class="n">_reflection_pb2_grpc</span><span class="o">.</span><span class="n">ServerReflectionServicer</span><span class="p">):</span>
 
+    <span class="sd">&quot;&quot;&quot;Servicer handling RPCs for service statuses.&quot;&quot;&quot;</span>
 
+
 
+    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">service_names</span><span class="p">,</span> <span class="n">pool</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Constructor.</span>
 
+
 
+<span class="sd">    Args:</span>
 
+<span class="sd">      service_names: Iterable of fully-qualified service names available.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+        <span class="bp">self</span><span class="o">.</span><span class="n">_service_names</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span><span class="nb">sorted</span><span class="p">(</span><span class="n">service_names</span><span class="p">))</span>
 
+        <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span> <span class="o">=</span> <span class="n">_POOL</span> <span class="k">if</span> <span class="n">pool</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">pool</span>
 
+
 
+    <span class="k">def</span> <span class="nf">_file_by_filename</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">filename</span><span class="p">):</span>
 
+        <span class="k">try</span><span class="p">:</span>
 
+            <span class="n">descriptor</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span><span class="o">.</span><span class="n">FindFileByName</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
 
+        <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
 
+            <span class="k">return</span> <span class="n">_not_found_error</span><span class="p">()</span>
 
+        <span class="k">else</span><span class="p">:</span>
 
+            <span class="k">return</span> <span class="n">_file_descriptor_response</span><span class="p">(</span><span class="n">descriptor</span><span class="p">)</span>
 
+
 
+    <span class="k">def</span> <span class="nf">_file_containing_symbol</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">fully_qualified_name</span><span class="p">):</span>
 
+        <span class="k">try</span><span class="p">:</span>
 
+            <span class="n">descriptor</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span><span class="o">.</span><span class="n">FindFileContainingSymbol</span><span class="p">(</span>
 
+                <span class="n">fully_qualified_name</span><span class="p">)</span>
 
+        <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
 
+            <span class="k">return</span> <span class="n">_not_found_error</span><span class="p">()</span>
 
+        <span class="k">else</span><span class="p">:</span>
 
+            <span class="k">return</span> <span class="n">_file_descriptor_response</span><span class="p">(</span><span class="n">descriptor</span><span class="p">)</span>
 
+
 
+    <span class="k">def</span> <span class="nf">_file_containing_extension</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">containing_type</span><span class="p">,</span> <span class="n">extension_number</span><span class="p">):</span>
 
+        <span class="k">try</span><span class="p">:</span>
 
+            <span class="n">message_descriptor</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span><span class="o">.</span><span class="n">FindMessageTypeByName</span><span class="p">(</span>
 
+                <span class="n">containing_type</span><span class="p">)</span>
 
+            <span class="n">extension_descriptor</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span><span class="o">.</span><span class="n">FindExtensionByNumber</span><span class="p">(</span>
 
+                <span class="n">message_descriptor</span><span class="p">,</span> <span class="n">extension_number</span><span class="p">)</span>
 
+            <span class="n">descriptor</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span><span class="o">.</span><span class="n">FindFileContainingSymbol</span><span class="p">(</span>
 
+                <span class="n">extension_descriptor</span><span class="o">.</span><span class="n">full_name</span><span class="p">)</span>
 
+        <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
 
+            <span class="k">return</span> <span class="n">_not_found_error</span><span class="p">()</span>
 
+        <span class="k">else</span><span class="p">:</span>
 
+            <span class="k">return</span> <span class="n">_file_descriptor_response</span><span class="p">(</span><span class="n">descriptor</span><span class="p">)</span>
 
+
 
+    <span class="k">def</span> <span class="nf">_all_extension_numbers_of_type</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">containing_type</span><span class="p">):</span>
 
+        <span class="k">try</span><span class="p">:</span>
 
+            <span class="n">message_descriptor</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span><span class="o">.</span><span class="n">FindMessageTypeByName</span><span class="p">(</span>
 
+                <span class="n">containing_type</span><span class="p">)</span>
 
+            <span class="n">extension_numbers</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span>
 
+                <span class="nb">sorted</span><span class="p">(</span>
 
+                    <span class="n">extension</span><span class="o">.</span><span class="n">number</span>
 
+                    <span class="k">for</span> <span class="n">extension</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span><span class="o">.</span><span class="n">FindAllExtensions</span><span class="p">(</span>
 
+                        <span class="n">message_descriptor</span><span class="p">)))</span>
 
+        <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
 
+            <span class="k">return</span> <span class="n">_not_found_error</span><span class="p">()</span>
 
+        <span class="k">else</span><span class="p">:</span>
 
+            <span class="k">return</span> <span class="n">_reflection_pb2</span><span class="o">.</span><span class="n">ServerReflectionResponse</span><span class="p">(</span>
 
+                <span class="n">all_extension_numbers_response</span><span class="o">=</span><span class="n">_reflection_pb2</span><span class="o">.</span>
 
+                <span class="n">ExtensionNumberResponse</span><span class="p">(</span>
 
+                    <span class="n">base_type_name</span><span class="o">=</span><span class="n">message_descriptor</span><span class="o">.</span><span class="n">full_name</span><span class="p">,</span>
 
+                    <span class="n">extension_number</span><span class="o">=</span><span class="n">extension_numbers</span><span class="p">))</span>
 
+
 
+    <span class="k">def</span> <span class="nf">_list_services</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="k">return</span> <span class="n">_reflection_pb2</span><span class="o">.</span><span class="n">ServerReflectionResponse</span><span class="p">(</span>
 
+            <span class="n">list_services_response</span><span class="o">=</span><span class="n">_reflection_pb2</span><span class="o">.</span><span class="n">ListServiceResponse</span><span class="p">(</span>
 
+                <span class="n">service</span><span class="o">=</span><span class="p">[</span>
 
+                    <span class="n">_reflection_pb2</span><span class="o">.</span><span class="n">ServiceResponse</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="n">service_name</span><span class="p">)</span>
 
+                    <span class="k">for</span> <span class="n">service_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_service_names</span>
 
+                <span class="p">]))</span>
 
+
 
+    <span class="k">def</span> <span class="nf">ServerReflectionInfo</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request_iterator</span><span class="p">,</span> <span class="n">context</span><span class="p">):</span>
 
+        <span class="c1"># pylint: disable=unused-argument</span>
 
+        <span class="k">for</span> <span class="n">request</span> <span class="ow">in</span> <span class="n">request_iterator</span><span class="p">:</span>
 
+            <span class="k">if</span> <span class="n">request</span><span class="o">.</span><span class="n">HasField</span><span class="p">(</span><span class="s1">&#39;file_by_filename&#39;</span><span class="p">):</span>
 
+                <span class="k">yield</span> <span class="bp">self</span><span class="o">.</span><span class="n">_file_by_filename</span><span class="p">(</span><span class="n">request</span><span class="o">.</span><span class="n">file_by_filename</span><span class="p">)</span>
 
+            <span class="k">elif</span> <span class="n">request</span><span class="o">.</span><span class="n">HasField</span><span class="p">(</span><span class="s1">&#39;file_containing_symbol&#39;</span><span class="p">):</span>
 
+                <span class="k">yield</span> <span class="bp">self</span><span class="o">.</span><span class="n">_file_containing_symbol</span><span class="p">(</span>
 
+                    <span class="n">request</span><span class="o">.</span><span class="n">file_containing_symbol</span><span class="p">)</span>
 
+            <span class="k">elif</span> <span class="n">request</span><span class="o">.</span><span class="n">HasField</span><span class="p">(</span><span class="s1">&#39;file_containing_extension&#39;</span><span class="p">):</span>
 
+                <span class="k">yield</span> <span class="bp">self</span><span class="o">.</span><span class="n">_file_containing_extension</span><span class="p">(</span>
 
+                    <span class="n">request</span><span class="o">.</span><span class="n">file_containing_extension</span><span class="o">.</span><span class="n">containing_type</span><span class="p">,</span>
 
+                    <span class="n">request</span><span class="o">.</span><span class="n">file_containing_extension</span><span class="o">.</span><span class="n">extension_number</span><span class="p">)</span>
 
+            <span class="k">elif</span> <span class="n">request</span><span class="o">.</span><span class="n">HasField</span><span class="p">(</span><span class="s1">&#39;all_extension_numbers_of_type&#39;</span><span class="p">):</span>
 
+                <span class="k">yield</span> <span class="bp">self</span><span class="o">.</span><span class="n">_all_extension_numbers_of_type</span><span class="p">(</span>
 
+                    <span class="n">request</span><span class="o">.</span><span class="n">all_extension_numbers_of_type</span><span class="p">)</span>
 
+            <span class="k">elif</span> <span class="n">request</span><span class="o">.</span><span class="n">HasField</span><span class="p">(</span><span class="s1">&#39;list_services&#39;</span><span class="p">):</span>
 
+                <span class="k">yield</span> <span class="bp">self</span><span class="o">.</span><span class="n">_list_services</span><span class="p">()</span>
 
+            <span class="k">else</span><span class="p">:</span>
 
+                <span class="k">yield</span> <span class="n">_reflection_pb2</span><span class="o">.</span><span class="n">ServerReflectionResponse</span><span class="p">(</span>
 
+                    <span class="n">error_response</span><span class="o">=</span><span class="n">_reflection_pb2</span><span class="o">.</span><span class="n">ErrorResponse</span><span class="p">(</span>
 
+                        <span class="n">error_code</span><span class="o">=</span><span class="n">grpc</span><span class="o">.</span><span class="n">StatusCode</span><span class="o">.</span><span class="n">INVALID_ARGUMENT</span><span class="o">.</span><span class="n">value</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span>
 
+                        <span class="n">error_message</span><span class="o">=</span><span class="n">grpc</span><span class="o">.</span><span class="n">StatusCode</span><span class="o">.</span><span class="n">INVALID_ARGUMENT</span><span class="o">.</span><span class="n">value</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
 
+                        <span class="o">.</span><span class="n">encode</span><span class="p">(),</span>
 
+                    <span class="p">))</span></div>
 
+
 
+
 
+<div class="viewcode-block" id="enable_server_reflection"><a class="viewcode-back" href="../../../grpc_reflection.html#grpc_reflection.v1alpha.reflection.enable_server_reflection">[docs]</a><span class="k">def</span> <span class="nf">enable_server_reflection</span><span class="p">(</span><span class="n">service_names</span><span class="p">,</span> <span class="n">server</span><span class="p">,</span> <span class="n">pool</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
+    <span class="sd">&quot;&quot;&quot;Enables server reflection on a server.</span>
 
+
 
+<span class="sd">    Args:</span>
 
+<span class="sd">      service_names: Iterable of fully-qualified service names available.</span>
 
+<span class="sd">      server: grpc.Server to which reflection service will be added.</span>
 
+<span class="sd">      pool: DescriptorPool object to use (descriptor_pool.Default() if None).</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+    <span class="n">_reflection_pb2_grpc</span><span class="o">.</span><span class="n">add_ServerReflectionServicer_to_server</span><span class="p">(</span>
 
+        <span class="n">ReflectionServicer</span><span class="p">(</span><span class="n">service_names</span><span class="p">,</span> <span class="n">pool</span><span class="o">=</span><span class="n">pool</span><span class="p">),</span> <span class="n">server</span><span class="p">)</span></div>
 
+</pre></div>
 
+
 
+          </div>
 
+          
+        </div>
 
+      </div>
 
+    <div class="clearer"></div>
 
+  </div>
 
+    <div class="footer">
 
+      &copy;2018, The gRPC Authors.
 
+      
+    </div>
 
+
 
+    
+
 
+    
+    <script type="text/javascript">
 
+
 
+      var _gaq = _gaq || [];
 
+      _gaq.push(['_setAccount', 'UA-60127042-1']);
 
+      _gaq.push(['_setDomainName', 'none']);
 
+      _gaq.push(['_setAllowLinker', true]);
 
+      _gaq.push(['_trackPageview']);
 
+
 
+      (function() {
 
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 
+      })();
 
+
 
+    </script>
 
+    
+  </body>
 
+</html>

+ 819 - 0
python/_modules/grpc_testing.html
查看文件 

@@ -0,0 +1,819 @@
 
+
 
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
+
 
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
 
+  <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.16.0 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>
 
+    <script type="text/javascript" src="../_static/jquery.js"></script>
 
+    <script type="text/javascript" src="../_static/underscore.js"></script>
 
+    <script type="text/javascript" src="../_static/doctools.js"></script>
 
+    <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
 
+    <link rel="index" title="Index" href="../genindex.html" />
 
+    <link rel="search" title="Search" href="../search.html" />
 
+   
+  <link rel="stylesheet" href="../_static/custom.css" type="text/css" />
 
+  
+  
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
 
+
 
+  </head><body>
 
+  <div class="document">
 
+    
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 
+        <div class="sphinxsidebarwrapper">
 
+<h1 class="logo"><a href="../index.html">gRPC Python</a></h1>
 
+
 
+
 
+
 
+<p class="blurb">1.16.0</p>
 
+
 
+
 
+
 
+
 
+
 
+
 
+<h3>Navigation</h3>
 
+<p class="caption"><span class="caption-text">Contents:</span></p>
 
+<ul>
 
+<li class="toctree-l1"><a class="reference internal" href="../grpc.html">gRPC</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../grpc_health_checking.html">gRPC Health Checking</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../grpc_reflection.html">gRPC Reflection</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../grpc_testing.html">gRPC Testing</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../glossary.html">Glossary</a></li>
 
+</ul>
 
+
 
+<div class="relations">
 
+<h3>Related Topics</h3>
 
+<ul>
 
+  <li><a href="../index.html">Documentation overview</a><ul>
 
+  <li><a href="index.html">Module code</a><ul>
 
+  </ul></li>
 
+  </ul></li>
 
+</ul>
 
+</div>
 
+<div id="searchbox" style="display: none" role="search">
 
+  <h3>Quick search</h3>
 
+    <div class="searchformwrapper">
 
+    <form class="search" action="../search.html" method="get">
 
+      <input type="text" name="q" />
 
+      <input type="submit" value="Go" />
 
+      <input type="hidden" name="check_keywords" value="yes" />
 
+      <input type="hidden" name="area" value="default" />
 
+    </form>
 
+    </div>
 
+</div>
 
+<script type="text/javascript">$('#searchbox').show(0);</script>
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+        </div>
 
+      </div>
 
+      <div class="documentwrapper">
 
+        <div class="bodywrapper">
 
+          
+
 
+          <div class="body" role="main">
 
+            
+  <h1>Source code for grpc_testing</h1><div class="highlight"><pre>
 
+<span></span><span class="c1"># Copyright 2017 gRPC authors.</span>
 
+<span class="c1">#</span>
 
+<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
+<span class="c1"># you may not use this file except in compliance with the License.</span>
 
+<span class="c1"># You may obtain a copy of the License at</span>
 
+<span class="c1">#</span>
 
+<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
 
+<span class="c1">#</span>
 
+<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
 
+<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
+<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
+<span class="c1"># See the License for the specific language governing permissions and</span>
 
+<span class="c1"># limitations under the License.</span>
 
+<span class="sd">&quot;&quot;&quot;Objects for use in testing gRPC Python-using application code.&quot;&quot;&quot;</span>
 
+
 
+<span class="kn">import</span> <span class="nn">abc</span>
 
+<span class="kn">import</span> <span class="nn">six</span>
 
+
 
+<span class="kn">from</span> <span class="nn">google.protobuf</span> <span class="k">import</span> <span class="n">descriptor</span>
 
+
 
+<span class="kn">import</span> <span class="nn">grpc</span>
 
+
 
+
 
+<div class="viewcode-block" id="UnaryUnaryChannelRpc"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryUnaryChannelRpc">[docs]</a><span class="k">class</span> <span class="nc">UnaryUnaryChannelRpc</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
+    <span class="sd">&quot;&quot;&quot;Fixture for a unary-unary RPC invoked by a system under test.</span>
 
+
 
+<span class="sd">    Enables users to &quot;play server&quot; for the RPC.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+
 
+<div class="viewcode-block" id="UnaryUnaryChannelRpc.send_initial_metadata"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryUnaryChannelRpc.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 RPC&#39;s initial metadata to the system under test.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          initial_metadata: The RPC&#39;s initial metadata to be &quot;sent&quot; to</span>
 
+<span class="sd">            the system under test.</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="UnaryUnaryChannelRpc.cancelled"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryUnaryChannelRpc.cancelled">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">cancelled</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Blocks until the system under test has cancelled the RPC.&quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+
 
+<div class="viewcode-block" id="UnaryUnaryChannelRpc.terminate"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryUnaryChannelRpc.terminate">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">terminate</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">response</span><span class="p">,</span> <span class="n">trailing_metadata</span><span class="p">,</span> <span class="n">code</span><span class="p">,</span> <span class="n">details</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Terminates the RPC.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          response: The response for the RPC.</span>
 
+<span class="sd">          trailing_metadata: The RPC&#39;s trailing metadata.</span>
 
+<span class="sd">          code: The RPC&#39;s status code.</span>
 
+<span class="sd">          details: The RPC&#39;s status details.</span>
 
+<span class="sd">        &quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
+
 
+
 
+<div class="viewcode-block" id="UnaryStreamChannelRpc"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryStreamChannelRpc">[docs]</a><span class="k">class</span> <span class="nc">UnaryStreamChannelRpc</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
+    <span class="sd">&quot;&quot;&quot;Fixture for a unary-stream RPC invoked by a system under test.</span>
 
+
 
+<span class="sd">    Enables users to &quot;play server&quot; for the RPC.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+
 
+<div class="viewcode-block" id="UnaryStreamChannelRpc.send_initial_metadata"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryStreamChannelRpc.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 RPC&#39;s initial metadata to the system under test.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          initial_metadata: The RPC&#39;s initial metadata to be &quot;sent&quot; to</span>
 
+<span class="sd">            the system under test.</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="UnaryStreamChannelRpc.send_response"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryStreamChannelRpc.send_response">[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_response</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">response</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Sends a response to the system under test.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          response: A response message to be &quot;sent&quot; to the system under test.</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="UnaryStreamChannelRpc.cancelled"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryStreamChannelRpc.cancelled">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">cancelled</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Blocks until the system under test has cancelled the RPC.&quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+
 
+<div class="viewcode-block" id="UnaryStreamChannelRpc.terminate"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryStreamChannelRpc.terminate">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">terminate</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">trailing_metadata</span><span class="p">,</span> <span class="n">code</span><span class="p">,</span> <span class="n">details</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Terminates the RPC.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          trailing_metadata: The RPC&#39;s trailing metadata.</span>
 
+<span class="sd">          code: The RPC&#39;s status code.</span>
 
+<span class="sd">          details: The RPC&#39;s status details.</span>
 
+<span class="sd">        &quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
+
 
+
 
+<div class="viewcode-block" id="StreamUnaryChannelRpc"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamUnaryChannelRpc">[docs]</a><span class="k">class</span> <span class="nc">StreamUnaryChannelRpc</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
+    <span class="sd">&quot;&quot;&quot;Fixture for a stream-unary RPC invoked by a system under test.</span>
 
+
 
+<span class="sd">    Enables users to &quot;play server&quot; for the RPC.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+
 
+<div class="viewcode-block" id="StreamUnaryChannelRpc.send_initial_metadata"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamUnaryChannelRpc.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 RPC&#39;s initial metadata to the system under test.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          initial_metadata: The RPC&#39;s initial metadata to be &quot;sent&quot; to</span>
 
+<span class="sd">            the system under test.</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="StreamUnaryChannelRpc.take_request"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamUnaryChannelRpc.take_request">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">take_request</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Draws one of the requests added to the RPC by the system under test.</span>
 
+
 
+<span class="sd">        This method blocks until the system under test has added to the RPC</span>
 
+<span class="sd">        the request to be returned.</span>
 
+
 
+<span class="sd">        Successive calls to this method return requests in the same order in</span>
 
+<span class="sd">        which the system under test added them to the RPC.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A request message added to the RPC by the system under test.</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="StreamUnaryChannelRpc.requests_closed"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamUnaryChannelRpc.requests_closed">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">requests_closed</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Blocks until the system under test has closed the request stream.&quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+
 
+<div class="viewcode-block" id="StreamUnaryChannelRpc.cancelled"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamUnaryChannelRpc.cancelled">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">cancelled</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Blocks until the system under test has cancelled the RPC.&quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+
 
+<div class="viewcode-block" id="StreamUnaryChannelRpc.terminate"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamUnaryChannelRpc.terminate">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">terminate</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">response</span><span class="p">,</span> <span class="n">trailing_metadata</span><span class="p">,</span> <span class="n">code</span><span class="p">,</span> <span class="n">details</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Terminates the RPC.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          response: The response for the RPC.</span>
 
+<span class="sd">          trailing_metadata: The RPC&#39;s trailing metadata.</span>
 
+<span class="sd">          code: The RPC&#39;s status code.</span>
 
+<span class="sd">          details: The RPC&#39;s status details.</span>
 
+<span class="sd">        &quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
+
 
+
 
+<div class="viewcode-block" id="StreamStreamChannelRpc"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamChannelRpc">[docs]</a><span class="k">class</span> <span class="nc">StreamStreamChannelRpc</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
+    <span class="sd">&quot;&quot;&quot;Fixture for a stream-stream RPC invoked by a system under test.</span>
 
+
 
+<span class="sd">    Enables users to &quot;play server&quot; for the RPC.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+
 
+<div class="viewcode-block" id="StreamStreamChannelRpc.send_initial_metadata"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamChannelRpc.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 RPC&#39;s initial metadata to the system under test.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          initial_metadata: The RPC&#39;s initial metadata to be &quot;sent&quot; to the</span>
 
+<span class="sd">            system under test.</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="StreamStreamChannelRpc.take_request"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamChannelRpc.take_request">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">take_request</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Draws one of the requests added to the RPC by the system under test.</span>
 
+
 
+<span class="sd">        This method blocks until the system under test has added to the RPC</span>
 
+<span class="sd">        the request to be returned.</span>
 
+
 
+<span class="sd">        Successive calls to this method return requests in the same order in</span>
 
+<span class="sd">        which the system under test added them to the RPC.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A request message added to the RPC by the system under test.</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="StreamStreamChannelRpc.send_response"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamChannelRpc.send_response">[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_response</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">response</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Sends a response to the system under test.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          response: A response messages to be &quot;sent&quot; to the system under test.</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="StreamStreamChannelRpc.requests_closed"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamChannelRpc.requests_closed">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">requests_closed</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Blocks until the system under test has closed the request stream.&quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+
 
+<div class="viewcode-block" id="StreamStreamChannelRpc.cancelled"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamChannelRpc.cancelled">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">cancelled</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Blocks until the system under test has cancelled the RPC.&quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+
 
+<div class="viewcode-block" id="StreamStreamChannelRpc.terminate"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamChannelRpc.terminate">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">terminate</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">trailing_metadata</span><span class="p">,</span> <span class="n">code</span><span class="p">,</span> <span class="n">details</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Terminates the RPC.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          trailing_metadata: The RPC&#39;s trailing metadata.</span>
 
+<span class="sd">          code: The RPC&#39;s status code.</span>
 
+<span class="sd">          details: The RPC&#39;s status details.</span>
 
+<span class="sd">        &quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
+
 
+
 
+<div class="viewcode-block" id="Channel"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Channel">[docs]</a><span class="k">class</span> <span class="nc">Channel</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">,</span> <span class="n">grpc</span><span class="o">.</span><span class="n">Channel</span><span class="p">)):</span>
 
+    <span class="sd">&quot;&quot;&quot;A grpc.Channel double with which to test a system that invokes RPCs.&quot;&quot;&quot;</span>
 
+
 
+<div class="viewcode-block" id="Channel.take_unary_unary"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Channel.take_unary_unary">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">take_unary_unary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method_descriptor</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Draws an RPC currently being made by the system under test.</span>
 
+
 
+<span class="sd">        If the given descriptor does not identify any RPC currently being made</span>
 
+<span class="sd">        by the system under test, this method blocks until the system under</span>
 
+<span class="sd">        test invokes such an RPC.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          method_descriptor: A descriptor.MethodDescriptor describing a</span>
 
+<span class="sd">            unary-unary RPC method.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A (invocation_metadata, request, unary_unary_channel_rpc) tuple of</span>
 
+<span class="sd">            the RPC&#39;s invocation metadata, its request, and a</span>
 
+<span class="sd">            UnaryUnaryChannelRpc with which to &quot;play server&quot; for 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="Channel.take_unary_stream"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Channel.take_unary_stream">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">take_unary_stream</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method_descriptor</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Draws an RPC currently being made by the system under test.</span>
 
+
 
+<span class="sd">        If the given descriptor does not identify any RPC currently being made</span>
 
+<span class="sd">        by the system under test, this method blocks until the system under</span>
 
+<span class="sd">        test invokes such an RPC.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          method_descriptor: A descriptor.MethodDescriptor describing a</span>
 
+<span class="sd">            unary-stream RPC method.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A (invocation_metadata, request, unary_stream_channel_rpc) tuple of</span>
 
+<span class="sd">            the RPC&#39;s invocation metadata, its request, and a</span>
 
+<span class="sd">            UnaryStreamChannelRpc with which to &quot;play server&quot; for 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="Channel.take_stream_unary"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Channel.take_stream_unary">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">take_stream_unary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method_descriptor</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Draws an RPC currently being made by the system under test.</span>
 
+
 
+<span class="sd">        If the given descriptor does not identify any RPC currently being made</span>
 
+<span class="sd">        by the system under test, this method blocks until the system under</span>
 
+<span class="sd">        test invokes such an RPC.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          method_descriptor: A descriptor.MethodDescriptor describing a</span>
 
+<span class="sd">            stream-unary RPC method.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A (invocation_metadata, stream_unary_channel_rpc) tuple of the RPC&#39;s</span>
 
+<span class="sd">            invocation metadata and a StreamUnaryChannelRpc with which to &quot;play</span>
 
+<span class="sd">            server&quot; for 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="Channel.take_stream_stream"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Channel.take_stream_stream">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">take_stream_stream</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method_descriptor</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Draws an RPC currently being made by the system under test.</span>
 
+
 
+<span class="sd">        If the given descriptor does not identify any RPC currently being made</span>
 
+<span class="sd">        by the system under test, this method blocks until the system under</span>
 
+<span class="sd">        test invokes such an RPC.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          method_descriptor: A descriptor.MethodDescriptor describing a</span>
 
+<span class="sd">            stream-stream RPC method.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A (invocation_metadata, stream_stream_channel_rpc) tuple of the RPC&#39;s</span>
 
+<span class="sd">            invocation metadata and a StreamStreamChannelRpc with which to</span>
 
+<span class="sd">            &quot;play server&quot; for 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>
 
+
 
+
 
+<div class="viewcode-block" id="UnaryUnaryServerRpc"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryUnaryServerRpc">[docs]</a><span class="k">class</span> <span class="nc">UnaryUnaryServerRpc</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
+    <span class="sd">&quot;&quot;&quot;Fixture for a unary-unary RPC serviced by a system under test.</span>
 
+
 
+<span class="sd">    Enables users to &quot;play client&quot; for the RPC.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+
 
+<div class="viewcode-block" id="UnaryUnaryServerRpc.initial_metadata"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryUnaryServerRpc.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">initial_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Accesses the initial metadata emitted by the system under test.</span>
 
+
 
+<span class="sd">        This method blocks until the system under test has added initial</span>
 
+<span class="sd">        metadata to the RPC (or has provided one or more response messages or</span>
 
+<span class="sd">        has terminated the RPC, either of which will cause gRPC Python to</span>
 
+<span class="sd">        synthesize initial metadata for the RPC).</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          The initial metadata for 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="UnaryUnaryServerRpc.cancel"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryUnaryServerRpc.cancel">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">cancel</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Cancels the RPC.&quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+
 
+<div class="viewcode-block" id="UnaryUnaryServerRpc.termination"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryUnaryServerRpc.termination">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">termination</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Blocks until the system under test has terminated the RPC.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A (response, trailing_metadata, code, details) sequence with the RPC&#39;s</span>
 
+<span class="sd">            response, trailing metadata, code, and details.</span>
 
+<span class="sd">        &quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
+
 
+
 
+<div class="viewcode-block" id="UnaryStreamServerRpc"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryStreamServerRpc">[docs]</a><span class="k">class</span> <span class="nc">UnaryStreamServerRpc</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
+    <span class="sd">&quot;&quot;&quot;Fixture for a unary-stream RPC serviced by a system under test.</span>
 
+
 
+<span class="sd">    Enables users to &quot;play client&quot; for the RPC.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+
 
+<div class="viewcode-block" id="UnaryStreamServerRpc.initial_metadata"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryStreamServerRpc.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">initial_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Accesses the initial metadata emitted by the system under test.</span>
 
+
 
+<span class="sd">        This method blocks until the system under test has added initial</span>
 
+<span class="sd">        metadata to the RPC (or has provided one or more response messages or</span>
 
+<span class="sd">        has terminated the RPC, either of which will cause gRPC Python to</span>
 
+<span class="sd">        synthesize initial metadata for the RPC).</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          The initial metadata for 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="UnaryStreamServerRpc.take_response"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryStreamServerRpc.take_response">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">take_response</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Draws one of the responses added to the RPC by the system under test.</span>
 
+
 
+<span class="sd">        Successive calls to this method return responses in the same order in</span>
 
+<span class="sd">        which the system under test added them to the RPC.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A response message added to the RPC by the system under test.</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="UnaryStreamServerRpc.cancel"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryStreamServerRpc.cancel">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">cancel</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Cancels the RPC.&quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+
 
+<div class="viewcode-block" id="UnaryStreamServerRpc.termination"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.UnaryStreamServerRpc.termination">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">termination</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Blocks until the system under test has terminated the RPC.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A (trailing_metadata, code, details) sequence with the RPC&#39;s trailing</span>
 
+<span class="sd">            metadata, code, and details.</span>
 
+<span class="sd">        &quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
+
 
+
 
+<div class="viewcode-block" id="StreamUnaryServerRpc"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamUnaryServerRpc">[docs]</a><span class="k">class</span> <span class="nc">StreamUnaryServerRpc</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
+    <span class="sd">&quot;&quot;&quot;Fixture for a stream-unary RPC serviced by a system under test.</span>
 
+
 
+<span class="sd">    Enables users to &quot;play client&quot; for the RPC.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+
 
+<div class="viewcode-block" id="StreamUnaryServerRpc.initial_metadata"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamUnaryServerRpc.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">initial_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Accesses the initial metadata emitted by the system under test.</span>
 
+
 
+<span class="sd">        This method blocks until the system under test has added initial</span>
 
+<span class="sd">        metadata to the RPC (or has provided one or more response messages or</span>
 
+<span class="sd">        has terminated the RPC, either of which will cause gRPC Python to</span>
 
+<span class="sd">        synthesize initial metadata for the RPC).</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          The initial metadata for 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="StreamUnaryServerRpc.send_request"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamUnaryServerRpc.send_request">[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_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Sends a request to the system under test.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          request: A request message for the RPC to be &quot;sent&quot; to the system</span>
 
+<span class="sd">            under test.</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="StreamUnaryServerRpc.requests_closed"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamUnaryServerRpc.requests_closed">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">requests_closed</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Indicates the end of the RPC&#39;s request stream.&quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+
 
+<div class="viewcode-block" id="StreamUnaryServerRpc.cancel"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamUnaryServerRpc.cancel">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">cancel</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Cancels the RPC.&quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+
 
+<div class="viewcode-block" id="StreamUnaryServerRpc.termination"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamUnaryServerRpc.termination">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">termination</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Blocks until the system under test has terminated the RPC.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A (response, trailing_metadata, code, details) sequence with the RPC&#39;s</span>
 
+<span class="sd">            response, trailing metadata, code, and details.</span>
 
+<span class="sd">        &quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
+
 
+
 
+<div class="viewcode-block" id="StreamStreamServerRpc"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamServerRpc">[docs]</a><span class="k">class</span> <span class="nc">StreamStreamServerRpc</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
+    <span class="sd">&quot;&quot;&quot;Fixture for a stream-stream RPC serviced by a system under test.</span>
 
+
 
+<span class="sd">    Enables users to &quot;play client&quot; for the RPC.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+
 
+<div class="viewcode-block" id="StreamStreamServerRpc.initial_metadata"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamServerRpc.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">initial_metadata</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Accesses the initial metadata emitted by the system under test.</span>
 
+
 
+<span class="sd">        This method blocks until the system under test has added initial</span>
 
+<span class="sd">        metadata to the RPC (or has provided one or more response messages or</span>
 
+<span class="sd">        has terminated the RPC, either of which will cause gRPC Python to</span>
 
+<span class="sd">        synthesize initial metadata for the RPC).</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          The initial metadata for 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="StreamStreamServerRpc.send_request"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamServerRpc.send_request">[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_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Sends a request to the system under test.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          request: A request message for the RPC to be &quot;sent&quot; to the system</span>
 
+<span class="sd">            under test.</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="StreamStreamServerRpc.requests_closed"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamServerRpc.requests_closed">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">requests_closed</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Indicates the end of the RPC&#39;s request stream.&quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+
 
+<div class="viewcode-block" id="StreamStreamServerRpc.take_response"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamServerRpc.take_response">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">take_response</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Draws one of the responses added to the RPC by the system under test.</span>
 
+
 
+<span class="sd">        Successive calls to this method return responses in the same order in</span>
 
+<span class="sd">        which the system under test added them to the RPC.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A response message added to the RPC by the system under test.</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="StreamStreamServerRpc.cancel"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamServerRpc.cancel">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">cancel</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Cancels the RPC.&quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
 
+
 
+<div class="viewcode-block" id="StreamStreamServerRpc.termination"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.StreamStreamServerRpc.termination">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">termination</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Blocks until the system under test has terminated the RPC.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A (trailing_metadata, code, details) sequence with the RPC&#39;s trailing</span>
 
+<span class="sd">            metadata, code, and details.</span>
 
+<span class="sd">        &quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
+
 
+
 
+<div class="viewcode-block" id="Server"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Server">[docs]</a><span class="k">class</span> <span class="nc">Server</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
+    <span class="sd">&quot;&quot;&quot;A server with which to test a system that services RPCs.&quot;&quot;&quot;</span>
 
+
 
+<div class="viewcode-block" id="Server.invoke_unary_unary"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Server.invoke_unary_unary">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">invoke_unary_unary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method_descriptor</span><span class="p">,</span> <span class="n">invocation_metadata</span><span class="p">,</span>
 
+                           <span class="n">request</span><span class="p">,</span> <span class="n">timeout</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Invokes an RPC to be serviced by the system under test.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          method_descriptor: A descriptor.MethodDescriptor describing a unary-unary</span>
 
+<span class="sd">            RPC method.</span>
 
+<span class="sd">          invocation_metadata: The RPC&#39;s invocation metadata.</span>
 
+<span class="sd">          request: The RPC&#39;s request.</span>
 
+<span class="sd">          timeout: A duration of time in seconds for the RPC or None to</span>
 
+<span class="sd">            indicate that the RPC has no time limit.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A UnaryUnaryServerRpc with which to &quot;play client&quot; for 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="Server.invoke_unary_stream"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Server.invoke_unary_stream">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">invoke_unary_stream</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method_descriptor</span><span class="p">,</span> <span class="n">invocation_metadata</span><span class="p">,</span>
 
+                            <span class="n">request</span><span class="p">,</span> <span class="n">timeout</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Invokes an RPC to be serviced by the system under test.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          method_descriptor: A descriptor.MethodDescriptor describing a unary-stream</span>
 
+<span class="sd">            RPC method.</span>
 
+<span class="sd">          invocation_metadata: The RPC&#39;s invocation metadata.</span>
 
+<span class="sd">          request: The RPC&#39;s request.</span>
 
+<span class="sd">          timeout: A duration of time in seconds for the RPC or None to</span>
 
+<span class="sd">            indicate that the RPC has no time limit.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A UnaryStreamServerRpc with which to &quot;play client&quot; for 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="Server.invoke_stream_unary"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Server.invoke_stream_unary">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">invoke_stream_unary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method_descriptor</span><span class="p">,</span> <span class="n">invocation_metadata</span><span class="p">,</span>
 
+                            <span class="n">timeout</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Invokes an RPC to be serviced by the system under test.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          method_descriptor: A descriptor.MethodDescriptor describing a stream-unary</span>
 
+<span class="sd">            RPC method.</span>
 
+<span class="sd">          invocation_metadata: The RPC&#39;s invocation metadata.</span>
 
+<span class="sd">          timeout: A duration of time in seconds for the RPC or None to</span>
 
+<span class="sd">            indicate that the RPC has no time limit.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A StreamUnaryServerRpc with which to &quot;play client&quot; for 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="Server.invoke_stream_stream"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Server.invoke_stream_stream">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">invoke_stream_stream</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method_descriptor</span><span class="p">,</span> <span class="n">invocation_metadata</span><span class="p">,</span>
 
+                             <span class="n">timeout</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Invokes an RPC to be serviced by the system under test.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          method_descriptor: A descriptor.MethodDescriptor describing a stream-stream</span>
 
+<span class="sd">            RPC method.</span>
 
+<span class="sd">          invocation_metadata: The RPC&#39;s invocation metadata.</span>
 
+<span class="sd">          timeout: A duration of time in seconds for the RPC or None to</span>
 
+<span class="sd">            indicate that the RPC has no time limit.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A StreamStreamServerRpc with which to &quot;play client&quot; for 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>
 
+
 
+
 
+<div class="viewcode-block" id="Time"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Time">[docs]</a><span class="k">class</span> <span class="nc">Time</span><span class="p">(</span><span class="n">six</span><span class="o">.</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABCMeta</span><span class="p">)):</span>
 
+    <span class="sd">&quot;&quot;&quot;A simulation of time.</span>
 
+
 
+<span class="sd">    Implementations needn&#39;t be connected with real time as provided by the</span>
 
+<span class="sd">    Python interpreter, but as long as systems under test use</span>
 
+<span class="sd">    RpcContext.is_active and RpcContext.time_remaining for querying RPC liveness</span>
 
+<span class="sd">    implementations may be used to change passage of time in tests.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+
 
+<div class="viewcode-block" id="Time.time"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Time.time">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">time</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Accesses the current test time.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          The current test time (over which this object has authority).</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="Time.call_in"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Time.call_in">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">call_in</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">behavior</span><span class="p">,</span> <span class="n">delay</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Adds a behavior to be called after some time.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          behavior: A behavior to be called with no arguments.</span>
 
+<span class="sd">          delay: A duration of time in seconds after which to call the behavior.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A grpc.Future with which the call of the behavior may be cancelled</span>
 
+<span class="sd">            before it is executed.</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="Time.call_at"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Time.call_at">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">call_at</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">behavior</span><span class="p">,</span> <span class="n">time</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Adds a behavior to be called at a specific time.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          behavior: A behavior to be called with no arguments.</span>
 
+<span class="sd">          time: The test time at which to call the behavior.</span>
 
+
 
+<span class="sd">        Returns:</span>
 
+<span class="sd">          A grpc.Future with which the call of the behavior may be cancelled</span>
 
+<span class="sd">            before it is executed.</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="Time.sleep_for"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Time.sleep_for">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">sleep_for</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">duration</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Blocks for some length of test time.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          duration: A duration of test time in seconds for which to block.</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="Time.sleep_until"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.Time.sleep_until">[docs]</a>    <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span>
 
+    <span class="k">def</span> <span class="nf">sleep_until</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">time</span><span class="p">):</span>
 
+        <span class="sd">&quot;&quot;&quot;Blocks until some test time.</span>
 
+
 
+<span class="sd">        Args:</span>
 
+<span class="sd">          time: The test time until which to block.</span>
 
+<span class="sd">        &quot;&quot;&quot;</span>
 
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
 
+
 
+
 
+<div class="viewcode-block" id="strict_real_time"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.strict_real_time">[docs]</a><span class="k">def</span> <span class="nf">strict_real_time</span><span class="p">():</span>
 
+    <span class="sd">&quot;&quot;&quot;Creates a Time backed by the Python interpreter&#39;s time.</span>
 
+
 
+<span class="sd">    The returned instance will be &quot;strict&quot; with respect to callbacks</span>
 
+<span class="sd">    submitted to it: it will ensure that all callbacks registered to</span>
 
+<span class="sd">    be called at time t have been called before it describes the time</span>
 
+<span class="sd">    as having advanced beyond t.</span>
 
+
 
+<span class="sd">    Returns:</span>
 
+<span class="sd">      A Time backed by the &quot;system&quot; (Python interpreter&#39;s) time.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+    <span class="kn">from</span> <span class="nn">grpc_testing</span> <span class="k">import</span> <span class="n">_time</span>
 
+    <span class="k">return</span> <span class="n">_time</span><span class="o">.</span><span class="n">StrictRealTime</span><span class="p">()</span></div>
 
+
 
+
 
+<div class="viewcode-block" id="strict_fake_time"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.strict_fake_time">[docs]</a><span class="k">def</span> <span class="nf">strict_fake_time</span><span class="p">(</span><span class="n">now</span><span class="p">):</span>
 
+    <span class="sd">&quot;&quot;&quot;Creates a Time that can be manipulated by test code.</span>
 
+
 
+<span class="sd">    The returned instance maintains an internal representation of time</span>
 
+<span class="sd">    independent of real time. This internal representation only advances</span>
 
+<span class="sd">    when user code calls the instance&#39;s sleep_for and sleep_until methods.</span>
 
+
 
+<span class="sd">    The returned instance will be &quot;strict&quot; with respect to callbacks</span>
 
+<span class="sd">    submitted to it: it will ensure that all callbacks registered to</span>
 
+<span class="sd">    be called at time t have been called before it describes the time</span>
 
+<span class="sd">    as having advanced beyond t.</span>
 
+
 
+<span class="sd">    Returns:</span>
 
+<span class="sd">      A Time that simulates the passage of time.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+    <span class="kn">from</span> <span class="nn">grpc_testing</span> <span class="k">import</span> <span class="n">_time</span>
 
+    <span class="k">return</span> <span class="n">_time</span><span class="o">.</span><span class="n">StrictFakeTime</span><span class="p">(</span><span class="n">now</span><span class="p">)</span></div>
 
+
 
+
 
+<div class="viewcode-block" id="channel"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.channel">[docs]</a><span class="k">def</span> <span class="nf">channel</span><span class="p">(</span><span class="n">service_descriptors</span><span class="p">,</span> <span class="n">time</span><span class="p">):</span>
 
+    <span class="sd">&quot;&quot;&quot;Creates a Channel for use in tests of a gRPC Python-using system.</span>
 
+
 
+<span class="sd">    Args:</span>
 
+<span class="sd">      service_descriptors: An iterable of descriptor.ServiceDescriptors</span>
 
+<span class="sd">        describing the RPCs that will be made on the returned Channel by the</span>
 
+<span class="sd">        system under test.</span>
 
+<span class="sd">      time: A Time to be used for tests.</span>
 
+
 
+<span class="sd">    Returns:</span>
 
+<span class="sd">      A Channel for use in tests.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+    <span class="kn">from</span> <span class="nn">grpc_testing</span> <span class="k">import</span> <span class="n">_channel</span>
 
+    <span class="k">return</span> <span class="n">_channel</span><span class="o">.</span><span class="n">testing_channel</span><span class="p">(</span><span class="n">service_descriptors</span><span class="p">,</span> <span class="n">time</span><span class="p">)</span></div>
 
+
 
+
 
+<div class="viewcode-block" id="server_from_dictionary"><a class="viewcode-back" href="../grpc_testing.html#grpc_testing.server_from_dictionary">[docs]</a><span class="k">def</span> <span class="nf">server_from_dictionary</span><span class="p">(</span><span class="n">descriptors_to_servicers</span><span class="p">,</span> <span class="n">time</span><span class="p">):</span>
 
+    <span class="sd">&quot;&quot;&quot;Creates a Server for use in tests of a gRPC Python-using system.</span>
 
+
 
+<span class="sd">    Args:</span>
 
+<span class="sd">      descriptors_to_servicers: A dictionary from descriptor.ServiceDescriptors</span>
 
+<span class="sd">        defining RPC services to servicer objects (usually instances of classes</span>
 
+<span class="sd">        that implement &quot;Servicer&quot; interfaces defined in generated &quot;_pb2_grpc&quot;</span>
 
+<span class="sd">        modules) implementing those services.</span>
 
+<span class="sd">      time: A Time to be used for tests.</span>
 
+
 
+<span class="sd">    Returns:</span>
 
+<span class="sd">      A Server for use in tests.</span>
 
+<span class="sd">    &quot;&quot;&quot;</span>
 
+    <span class="kn">from</span> <span class="nn">grpc_testing</span> <span class="k">import</span> <span class="n">_server</span>
 
+    <span class="k">return</span> <span class="n">_server</span><span class="o">.</span><span class="n">server_from_dictionary</span><span class="p">(</span><span class="n">descriptors_to_servicers</span><span class="p">,</span> <span class="n">time</span><span class="p">)</span></div>
 
+</pre></div>
 
+
 
+          </div>
 
+          
+        </div>
 
+      </div>
 
+    <div class="clearer"></div>
 
+  </div>
 
+    <div class="footer">
 
+      &copy;2018, The gRPC Authors.
 
+      
+    </div>
 
+
 
+    
+
 
+    
+    <script type="text/javascript">
 
+
 
+      var _gaq = _gaq || [];
 
+      _gaq.push(['_setAccount', 'UA-60127042-1']);
 
+      _gaq.push(['_setDomainName', 'none']);
 
+      _gaq.push(['_setAllowLinker', true]);
 
+      _gaq.push(['_trackPageview']);
 
+
 
+      (function() {
 
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 
+      })();
 
+
 
+    </script>
 
+    
+  </body>
 
+</html>

+ 84 - 197
python/_modules/index.html
查看文件 

@@ -1,128 +1,72 @@
 
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>Overview: module code &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
+
 
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
 
+  <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.16.0 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>
 
+    <script type="text/javascript" src="../_static/jquery.js"></script>
 
+    <script type="text/javascript" src="../_static/underscore.js"></script>
 
+    <script type="text/javascript" src="../_static/doctools.js"></script>
 
+    <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
 
+    <link rel="index" title="Index" href="../genindex.html" />
 
+    <link rel="search" title="Search" href="../search.html" />
 
+   
+  <link rel="stylesheet" href="../_static/custom.css" type="text/css" />
 
   
-
 
   
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
 
 
-  
-  
+  </head><body>
 
+  <div class="document">
 
     
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 
+        <div class="sphinxsidebarwrapper">
 
+<h1 class="logo"><a href="../index.html">gRPC Python</a></h1>
 
 
-  
 
-  
-  
-    <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
 
-  
-        <link rel="index" title="Index"
 
-              href="../genindex.html"/>
 
-        <link rel="search" title="Search" href="../search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="../index.html"/> 
-
 
-  
-  <script src="../_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
+<p class="blurb">1.16.0</p>
 
 
-          
-            <a href="../index.html" class="icon icon-home"> grpcio
 
-          
 
-          
-          </a>
 
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
 
-          
-        </div>
 
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
+<h3>Navigation</h3>
 
+<p class="caption"><span class="caption-text">Contents:</span></p>
 
 <ul>
 
-<li class="toctree-l1"><a class="reference internal" href="../grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="../grpc.html#glossary">Glossary</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../grpc.html">gRPC</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../grpc_health_checking.html">gRPC Health Checking</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../grpc_reflection.html">gRPC Reflection</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../grpc_testing.html">gRPC Testing</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="../glossary.html">Glossary</a></li>
 
 </ul>
 
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="../index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
+<div class="relations">
 
+<h3>Related Topics</h3>
 
+<ul>
 
+  <li><a href="../index.html">Documentation overview</a><ul>
 
+  </ul></li>
 
+</ul>
 
+</div>
 
+<div id="searchbox" style="display: none" role="search">
 
+  <h3>Quick search</h3>
 
+    <div class="searchformwrapper">
 
+    <form class="search" action="../search.html" method="get">
 
+      <input type="text" name="q" />
 
+      <input type="submit" value="Go" />
 
+      <input type="hidden" name="check_keywords" value="yes" />
 
+      <input type="hidden" name="area" value="default" />
 
+    </form>
 
+    </div>
 
+</div>
 
+<script type="text/javascript">$('#searchbox').show(0);</script>
 
 
 
 
@@ -130,108 +74,51 @@
 
 
 
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="../index.html">Docs</a> &raquo;</li>
 
-        
-      <li>Overview: module code</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
+        </div>
 
+      </div>
 
+      <div class="documentwrapper">
 
+        <div class="bodywrapper">
 
+          
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
+          <div class="body" role="main">
 
             
   <h1>All modules for which code is available</h1>
 
 <ul><li><a href="grpc.html">grpc</a></li>
 
-<ul><li><a href="grpc/beta/implementations.html">grpc.beta.implementations</a></li>
 
-<li><a href="grpc/beta/interfaces.html">grpc.beta.interfaces</a></li>
 
-<li><a href="grpc/beta/utilities.html">grpc.beta.utilities</a></li>
 
-<li><a href="grpc/framework/common/cardinality.html">grpc.framework.common.cardinality</a></li>
 
-<li><a href="grpc/framework/common/style.html">grpc.framework.common.style</a></li>
 
-<li><a href="grpc/framework/foundation/abandonment.html">grpc.framework.foundation.abandonment</a></li>
 
-<li><a href="grpc/framework/foundation/callable_util.html">grpc.framework.foundation.callable_util</a></li>
 
-<li><a href="grpc/framework/foundation/future.html">grpc.framework.foundation.future</a></li>
 
-<li><a href="grpc/framework/foundation/logging_pool.html">grpc.framework.foundation.logging_pool</a></li>
 
-<li><a href="grpc/framework/foundation/stream.html">grpc.framework.foundation.stream</a></li>
 
-<li><a href="grpc/framework/foundation/stream_util.html">grpc.framework.foundation.stream_util</a></li>
 
-<li><a href="grpc/framework/interfaces/base/base.html">grpc.framework.interfaces.base.base</a></li>
 
-<li><a href="grpc/framework/interfaces/base/utilities.html">grpc.framework.interfaces.base.utilities</a></li>
 
-<li><a href="grpc/framework/interfaces/face/face.html">grpc.framework.interfaces.face.face</a></li>
 
-<li><a href="grpc/framework/interfaces/face/utilities.html">grpc.framework.interfaces.face.utilities</a></li>
 
-</ul></ul>
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
+<li><a href="grpc_health/v1/health.html">grpc_health.v1.health</a></li>
 
+<li><a href="grpc_reflection/v1alpha/reflection.html">grpc_reflection.v1alpha.reflection</a></li>
 
+<li><a href="grpc_testing.html">grpc_testing</a></li>
 
+</ul>
 
 
+          </div>
 
+          
         </div>
 
       </div>
 
-
 
-    </section>
 
-
 
+    <div class="clearer"></div>
 
   </div>
 
-  
-
 
+    <div class="footer">
 
+      &copy;2018, The gRPC Authors.
 
+      
+    </div>
 
 
-  
+    
 
+    
     <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'../',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="../_static/jquery.js"></script>
 
-      <script type="text/javascript" src="../_static/underscore.js"></script>
 
-      <script type="text/javascript" src="../_static/doctools.js"></script>
 
 
-  
+      var _gaq = _gaq || [];
 
+      _gaq.push(['_setAccount', 'UA-60127042-1']);
 
+      _gaq.push(['_setDomainName', 'none']);
 
+      _gaq.push(['_setAllowLinker', true]);
 
+      _gaq.push(['_trackPageview']);
 
 
-  
-  
-    <script type="text/javascript" src="../_static/js/theme.js"></script>
 
-  
+      (function() {
 
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 
+      })();
 
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
+    </script>
 
+    
+  </body>
 
 </html>

+ 153 - 0
python/_sources/api.rst.txt
查看文件 

@@ -0,0 +1,153 @@
 
+API Reference
 
+=============
 
+
 
+.. module:: grpc
 
+
 
+Create Client
 
+-------------
 
+
 
+.. autofunction:: insecure_channel
 
+.. autofunction:: secure_channel
 
+.. autofunction:: intercept_channel
 
+
 
+
 
+Create Client Credentials
 
+-------------------------
 
+
 
+.. autofunction:: ssl_channel_credentials
 
+.. autofunction:: metadata_call_credentials
 
+.. autofunction:: access_token_call_credentials
 
+.. autofunction:: composite_call_credentials
 
+.. autofunction:: composite_channel_credentials
 
+
 
+
 
+Create Server
 
+-------------
 
+
 
+.. autofunction:: server
 
+
 
+
 
+Create Server Credentials
 
+-------------------------
 
+
 
+.. autofunction:: ssl_server_credentials
 
+.. autofunction:: ssl_server_certificate_configuration
 
+.. autofunction:: dynamic_ssl_server_credentials
 
+
 
+
 
+RPC Method Handlers
 
+--------------------------
 
+
 
+.. autofunction:: unary_unary_rpc_method_handler
 
+.. autofunction:: unary_stream_rpc_method_handler
 
+.. autofunction:: stream_unary_rpc_method_handler
 
+.. autofunction:: stream_stream_rpc_method_handler
 
+.. autofunction:: method_handlers_generic_handler
 
+
 
+
 
+Channel Ready Future
 
+--------------------------
 
+
 
+.. autofunction:: channel_ready_future
 
+
 
+
 
+Channel Connectivity
 
+--------------------------
 
+
 
+.. autoclass:: ChannelConnectivity
 
+
 
+
 
+gRPC Status Code
 
+--------------------------
 
+
 
+.. autoclass:: StatusCode
 
+
 
+
 
+Channel Object
 
+--------------
 
+
 
+.. autoclass:: Channel
 
+
 
+
 
+Server Object
 
+-------------
 
+
 
+.. autoclass:: Server
 
+
 
+
 
+Authentication & Authorization Objects
 
+--------------------------------------
 
+
 
+.. autoclass:: ChannelCredentials
 
+.. autoclass:: CallCredentials
 
+.. autoclass:: AuthMetadataContext
 
+.. autoclass:: AuthMetadataPluginCallback
 
+.. autoclass:: AuthMetadataPlugin
 
+.. autoclass:: ServerCredentials
 
+.. autoclass:: ServerCertificateConfiguration
 
+
 
+
 
+gRPC Exceptions
 
+---------------
 
+
 
+.. autoexception:: RpcError
 
+
 
+
 
+Shared Context
 
+--------------
 
+
 
+.. autoclass:: RpcContext
 
+
 
+
 
+Client-Side Context
 
+-----------------------
 
+
 
+.. autoclass:: Call
 
+
 
+
 
+Client-Side Interceptor
 
+------------------------------------------------
 
+
 
+.. autoclass:: ClientCallDetails
 
+.. autoclass:: UnaryUnaryClientInterceptor
 
+.. autoclass:: UnaryStreamClientInterceptor
 
+.. autoclass:: StreamUnaryClientInterceptor
 
+.. autoclass:: StreamStreamClientInterceptor
 
+
 
+
 
+Service-Side Context
 
+--------------------
 
+
 
+.. autoclass:: ServicerContext
 
+
 
+
 
+Service-Side Handler
 
+-------------------------------
 
+
 
+.. autoclass:: RpcMethodHandler
 
+.. autoclass:: HandlerCallDetails
 
+.. autoclass:: GenericRpcHandler
 
+.. autoclass:: ServiceRpcHandler
 
+
 
+
 
+Service-Side Interceptor
 
+------------------------
 
+
 
+.. autoclass:: ServerInterceptor
 
+
 
+
 
+Multi-Callable
 
+-------------------------
 
+
 
+.. autoclass:: UnaryUnaryMultiCallable
 
+.. autoclass:: UnaryStreamMultiCallable
 
+.. autoclass:: StreamUnaryMultiCallable
 
+.. autoclass:: StreamStreamMultiCallable
 
+
 
+
 
+Future
 
+----------------
 
+
 
+.. autoexception:: FutureTimeoutError
 
+.. autoexception:: FutureCancelledError
 
+.. autoclass:: Future

+ 16 - 0
python/_sources/glossary.rst.txt
查看文件 

@@ -0,0 +1,16 @@
 
+Glossary
 
+================
 
+
 
+.. glossary::
 
+
 
+  metadatum
 
+    A key-value pair included in the HTTP header.  It is a
 
+    2-tuple where the first entry is the key and the
 
+    second is the value, i.e. (key, value).  The metadata key is an ASCII str,
 
+    and must be a valid HTTP header name.  The metadata value can be
 
+    either a valid HTTP ASCII str, or bytes.  If bytes are provided,
 
+    the key must end with '-bin', i.e.
 
+    ``('binary-metadata-bin', b'\\x00\\xFF')``
 
+
 
+  metadata
 
+    A sequence of metadatum.

+ 0 - 38
python/_sources/grpc.beta.rst.txt
查看文件 

@@ -1,38 +0,0 @@
 
-grpc\.beta package
 
-==================
 
-
 
-Submodules
 
-----------
 
-
 
-grpc\.beta\.implementations module
 
-----------------------------------
 
-
 
-.. automodule:: grpc.beta.implementations
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-grpc\.beta\.interfaces module
 
------------------------------
 
-
 
-.. automodule:: grpc.beta.interfaces
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-grpc\.beta\.utilities module
 
-----------------------------
 
-
 
-.. automodule:: grpc.beta.utilities
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-
 
-Module contents
 
----------------
 
-
 
-.. automodule:: grpc.beta
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:

+ 0 - 30
python/_sources/grpc.framework.common.rst.txt
查看文件 

@@ -1,30 +0,0 @@
 
-grpc\.framework\.common package
 
-===============================
 
-
 
-Submodules
 
-----------
 
-
 
-grpc\.framework\.common\.cardinality module
 
--------------------------------------------
 
-
 
-.. automodule:: grpc.framework.common.cardinality
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-grpc\.framework\.common\.style module
 
--------------------------------------
 
-
 
-.. automodule:: grpc.framework.common.style
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-
 
-Module contents
 
----------------
 
-
 
-.. automodule:: grpc.framework.common
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:

+ 0 - 62
python/_sources/grpc.framework.foundation.rst.txt
查看文件 

@@ -1,62 +0,0 @@
 
-grpc\.framework\.foundation package
 
-===================================
 
-
 
-Submodules
 
-----------
 
-
 
-grpc\.framework\.foundation\.abandonment module
 
------------------------------------------------
 
-
 
-.. automodule:: grpc.framework.foundation.abandonment
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-grpc\.framework\.foundation\.callable\_util module
 
---------------------------------------------------
 
-
 
-.. automodule:: grpc.framework.foundation.callable_util
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-grpc\.framework\.foundation\.future module
 
-------------------------------------------
 
-
 
-.. automodule:: grpc.framework.foundation.future
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-grpc\.framework\.foundation\.logging\_pool module
 
--------------------------------------------------
 
-
 
-.. automodule:: grpc.framework.foundation.logging_pool
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-grpc\.framework\.foundation\.stream module
 
-------------------------------------------
 
-
 
-.. automodule:: grpc.framework.foundation.stream
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-grpc\.framework\.foundation\.stream\_util module
 
-------------------------------------------------
 
-
 
-.. automodule:: grpc.framework.foundation.stream_util
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-
 
-Module contents
 
----------------
 
-
 
-.. automodule:: grpc.framework.foundation
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:

+ 0 - 30
python/_sources/grpc.framework.interfaces.base.rst.txt
查看文件 

@@ -1,30 +0,0 @@
 
-grpc\.framework\.interfaces\.base package
 
-=========================================
 
-
 
-Submodules
 
-----------
 
-
 
-grpc\.framework\.interfaces\.base\.base module
 
-----------------------------------------------
 
-
 
-.. automodule:: grpc.framework.interfaces.base.base
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-grpc\.framework\.interfaces\.base\.utilities module
 
----------------------------------------------------
 
-
 
-.. automodule:: grpc.framework.interfaces.base.utilities
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-
 
-Module contents
 
----------------
 
-
 
-.. automodule:: grpc.framework.interfaces.base
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:

+ 0 - 30
python/_sources/grpc.framework.interfaces.face.rst.txt
查看文件 

@@ -1,30 +0,0 @@
 
-grpc\.framework\.interfaces\.face package
 
-=========================================
 
-
 
-Submodules
 
-----------
 
-
 
-grpc\.framework\.interfaces\.face\.face module
 
-----------------------------------------------
 
-
 
-.. automodule:: grpc.framework.interfaces.face.face
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-grpc\.framework\.interfaces\.face\.utilities module
 
----------------------------------------------------
 
-
 
-.. automodule:: grpc.framework.interfaces.face.utilities
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
-
 
-
 
-Module contents
 
----------------
 
-
 
-.. automodule:: grpc.framework.interfaces.face
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:

+ 0 - 18
python/_sources/grpc.framework.interfaces.rst.txt
查看文件 

@@ -1,18 +0,0 @@
 
-grpc\.framework\.interfaces package
 
-===================================
 
-
 
-Subpackages
 
------------
 
-
 
-.. toctree::
 
-
 
-    grpc.framework.interfaces.base
 
-    grpc.framework.interfaces.face
 
-
 
-Module contents
 
----------------
 
-
 
-.. automodule:: grpc.framework.interfaces
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:

+ 0 - 19
python/_sources/grpc.framework.rst.txt
查看文件 

@@ -1,19 +0,0 @@
 
-grpc\.framework package
 
-=======================
 
-
 
-Subpackages
 
------------
 
-
 
-.. toctree::
 
-
 
-    grpc.framework.common
 
-    grpc.framework.foundation
 
-    grpc.framework.interfaces
 
-
 
-Module contents
 
----------------
 
-
 
-.. automodule:: grpc.framework
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:

+ 158 - 25
python/_sources/grpc.rst.txt
查看文件 

@@ -1,36 +1,169 @@
 
-grpc package
 
-============
 
+gRPC
 
+=============
 
 
-Subpackages
 
------------
 
+.. module:: grpc
 
 
-.. toctree::
 
+Tutorial
 
+--------
 
 
-    grpc.beta
 
-    grpc.framework
 
+If you want to see gRPC in action first, visit the `Python Quickstart <https://grpc.io/docs/quickstart/python.html>`_.
 
+Or, if you would like dive in with more extensive usage of gRPC Python, check `gRPC Basics - Python <https://grpc.io/docs/tutorials/basic/python.html>`_ out.
 
 
-Module contents
 
+
 
+Example
 
+-------
 
+
 
+Go to `gRPC Python Examples <https://github.com/grpc/grpc/tree/master/examples/python>`_
 
+
 
+
 
+Module Contents
 
 ---------------
 
 
-.. automodule:: grpc
 
-    :members:
 
-    :undoc-members:
 
-    :show-inheritance:
 
+Create Client
 
+^^^^^^^^^^^^^
 
+
 
+.. autofunction:: insecure_channel
 
+.. autofunction:: secure_channel
 
+.. autofunction:: intercept_channel
 
+
 
+
 
+Create Client Credentials
 
+^^^^^^^^^^^^^^^^^^^^^^^^^
 
+
 
+.. autofunction:: ssl_channel_credentials
 
+.. autofunction:: metadata_call_credentials
 
+.. autofunction:: access_token_call_credentials
 
+.. autofunction:: composite_call_credentials
 
+.. autofunction:: composite_channel_credentials
 
+
 
+
 
+Create Server
 
+^^^^^^^^^^^^^
 
+
 
+.. autofunction:: server
 
+
 
+
 
+Create Server Credentials
 
+^^^^^^^^^^^^^^^^^^^^^^^^^
 
+
 
+.. autofunction:: ssl_server_credentials
 
+.. autofunction:: ssl_server_certificate_configuration
 
+.. autofunction:: dynamic_ssl_server_credentials
 
+
 
+
 
+RPC Method Handlers
 
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+
 
+.. autofunction:: unary_unary_rpc_method_handler
 
+.. autofunction:: unary_stream_rpc_method_handler
 
+.. autofunction:: stream_unary_rpc_method_handler
 
+.. autofunction:: stream_stream_rpc_method_handler
 
+.. autofunction:: method_handlers_generic_handler
 
+
 
+
 
+Channel Ready Future
 
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+
 
+.. autofunction:: channel_ready_future
 
+
 
+
 
+Channel Connectivity
 
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+
 
+.. autoclass:: ChannelConnectivity
 
+
 
+
 
+gRPC Status Code
 
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+
 
+.. autoclass:: StatusCode
 
+
 
+
 
+Channel Object
 
+^^^^^^^^^^^^^^
 
+
 
+.. autoclass:: Channel
 
+
 
+
 
+Server Object
 
+^^^^^^^^^^^^^
 
+
 
+.. autoclass:: Server
 
+
 
+
 
+Authentication & Authorization Objects
 
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+
 
+.. autoclass:: ChannelCredentials
 
+.. autoclass:: CallCredentials
 
+.. autoclass:: AuthMetadataContext
 
+.. autoclass:: AuthMetadataPluginCallback
 
+.. autoclass:: AuthMetadataPlugin
 
+.. autoclass:: ServerCredentials
 
+.. autoclass:: ServerCertificateConfiguration
 
+
 
+
 
+gRPC Exceptions
 
+^^^^^^^^^^^^^^^
 
+
 
+.. autoexception:: RpcError
 
+
 
+
 
+Shared Context
 
+^^^^^^^^^^^^^^
 
+
 
+.. autoclass:: RpcContext
 
+
 
+
 
+Client-Side Context
 
+^^^^^^^^^^^^^^^^^^^^^^^
 
+
 
+.. autoclass:: Call
 
+
 
+
 
+Client-Side Interceptor
 
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+
 
+.. autoclass:: ClientCallDetails
 
+.. autoclass:: UnaryUnaryClientInterceptor
 
+.. autoclass:: UnaryStreamClientInterceptor
 
+.. autoclass:: StreamUnaryClientInterceptor
 
+.. autoclass:: StreamStreamClientInterceptor
 
+
 
+
 
+Service-Side Context
 
+^^^^^^^^^^^^^^^^^^^^
 
+
 
+.. autoclass:: ServicerContext
 
+
 
+
 
+Service-Side Handler
 
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+
 
+.. autoclass:: RpcMethodHandler
 
+.. autoclass:: HandlerCallDetails
 
+.. autoclass:: GenericRpcHandler
 
+.. autoclass:: ServiceRpcHandler
 
+
 
+
 
+Service-Side Interceptor
 
+^^^^^^^^^^^^^^^^^^^^^^^^
 
+
 
+.. autoclass:: ServerInterceptor
 
+
 
 
+Multi-Callable Interfaces
 
+^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
-Glossary
 
-================
 
+.. autoclass:: UnaryUnaryMultiCallable
 
+.. autoclass:: UnaryStreamMultiCallable
 
+.. autoclass:: StreamUnaryMultiCallable
 
+.. autoclass:: StreamStreamMultiCallable
 
 
-.. glossary::
 
 
-  metadatum
 
-    A key-value pair included in the HTTP header.  It is a 
-    2-tuple where the first entry is the key and the
 
-    second is the value, i.e. (key, value).  The metadata key is an ASCII str,
 
-    and must be a valid HTTP header name.  The metadata value can be
 
-    either a valid HTTP ASCII str, or bytes.  If bytes are provided,
 
-    the key must end with '-bin', i.e.
 
-    ``('binary-metadata-bin', b'\x00\xFF')``
 
+Future Interfaces
 
+^^^^^^^^^^^^^^^^^
 
 
-  metadata
 
-    A sequence of metadatum.
 
+.. autoexception:: FutureTimeoutError
 
+.. autoexception:: FutureCancelledError
 
+.. autoclass:: Future

+ 7 - 0
python/_sources/grpc_health_checking.rst.txt
查看文件 

@@ -0,0 +1,7 @@
 
+gRPC Health Checking
 
+====================
 
+
 
+Module Contents
 
+---------------
 
+
 
+.. autoclass:: grpc_health.v1.health.HealthServicer

+ 19 - 0
python/_sources/grpc_reflection.rst.txt
查看文件 

@@ -0,0 +1,19 @@
 
+gRPC Reflection
 
+====================
 
+
 
+What is gRPC reflection?
 
+---------------------------------------------
 
+
 
+Check this out `gRPC Python Server Reflection <https://github.com/grpc/grpc/blob/master/doc/python/server_reflection.md>`_
 
+
 
+
 
+Example
 
+-------
 
+
 
+Refer to the GitHub `reflection example <https://github.com/grpc/grpc/blob/master/examples/python/helloworld/greeter_server_with_reflection.py>`_
 
+
 
+
 
+Module Contents
 
+---------------
 
+
 
+.. automodule:: grpc_reflection.v1alpha.reflection

+ 7 - 0
python/_sources/grpc_testing.rst.txt
查看文件 

@@ -0,0 +1,7 @@
 
+gRPC Testing
 
+====================
 
+
 
+Module Contents
 
+---------------
 
+
 
+.. automodule:: grpc_testing

+ 10 - 7
python/_sources/index.rst.txt
查看文件 

@@ -1,16 +1,19 @@
 
-.. grpcio documentation master file, created by
 
-   sphinx-quickstart on Tue Dec 12 18:55:33 2017.
 
-   You can adapt this file completely to your liking, but it should at least
 
-   contain the root `toctree` directive.
 
+Welcome to gRPC Python's documentation!
 
+=======================================
 
 
-Welcome to grpcio's documentation!
 
-==================================
 
+Version: |version| Release: |release|
 
+
 
+API Reference
 
+=============
 
 
 .. toctree::
 
-   :maxdepth: 4
 
    :caption: Contents:
 
 
    grpc
 
+   grpc_health_checking
 
+   grpc_reflection
 
+   grpc_testing
 
+   glossary
 
 
 
 Indices and tables

+ 703 - 0
python/_static/alabaster.css
查看文件 

@@ -0,0 +1,703 @@
 
+@import url("basic.css");
 
+
 
+/* -- page layout ----------------------------------------------------------- */
 
+
 
+body {
 
+    font-family: Georgia, serif;
 
+    font-size: 17px;
 
+    background-color: #fff;
 
+    color: #000;
 
+    margin: 0;
 
+    padding: 0;
 
+}
 
+
 
+
 
+div.document {
 
+    width: 1140px;
 
+    margin: 30px auto 0 auto;
 
+}
 
+
 
+div.documentwrapper {
 
+    float: left;
 
+    width: 100%;
 
+}
 
+
 
+div.bodywrapper {
 
+    margin: 0 0 0 220px;
 
+}
 
+
 
+div.sphinxsidebar {
 
+    width: 220px;
 
+    font-size: 14px;
 
+    line-height: 1.5;
 
+}
 
+
 
+hr {
 
+    border: 1px solid #B1B4B6;
 
+}
 
+
 
+div.body {
 
+    background-color: #fff;
 
+    color: #3E4349;
 
+    padding: 0 30px 0 30px;
 
+}
 
+
 
+div.body > .section {
 
+    text-align: left;
 
+}
 
+
 
+div.footer {
 
+    width: 1140px;
 
+    margin: 20px auto 30px auto;
 
+    font-size: 14px;
 
+    color: #888;
 
+    text-align: right;
 
+}
 
+
 
+div.footer a {
 
+    color: #888;
 
+}
 
+
 
+p.caption {
 
+    font-family: inherit;
 
+    font-size: inherit;
 
+}
 
+
 
+
 
+
 
+div.sphinxsidebar a {
 
+    color: #444;
 
+    text-decoration: none;
 
+    border-bottom: 1px dotted #999;
 
+}
 
+
 
+div.sphinxsidebar a:hover {
 
+    border-bottom: 1px solid #999;
 
+}
 
+
 
+div.sphinxsidebarwrapper {
 
+    padding: 18px 10px;
 
+}
 
+
 
+div.sphinxsidebarwrapper p.logo {
 
+    padding: 0;
 
+    margin: -10px 0 0 0px;
 
+    text-align: center;
 
+}
 
+
 
+div.sphinxsidebarwrapper h1.logo {
 
+    margin-top: -10px;
 
+    text-align: center;
 
+    margin-bottom: 5px;
 
+    text-align: left;
 
+}
 
+
 
+div.sphinxsidebarwrapper h1.logo-name {
 
+    margin-top: 0px;
 
+}
 
+
 
+div.sphinxsidebarwrapper p.blurb {
 
+    margin-top: 0;
 
+    font-style: normal;
 
+}
 
+
 
+div.sphinxsidebar h3,
 
+div.sphinxsidebar h4 {
 
+    font-family: Georgia, serif;
 
+    color: #444;
 
+    font-size: 24px;
 
+    font-weight: normal;
 
+    margin: 0 0 5px 0;
 
+    padding: 0;
 
+}
 
+
 
+div.sphinxsidebar h4 {
 
+    font-size: 20px;
 
+}
 
+
 
+div.sphinxsidebar h3 a {
 
+    color: #444;
 
+}
 
+
 
+div.sphinxsidebar p.logo a,
 
+div.sphinxsidebar h3 a,
 
+div.sphinxsidebar p.logo a:hover,
 
+div.sphinxsidebar h3 a:hover {
 
+    border: none;
 
+}
 
+
 
+div.sphinxsidebar p {
 
+    color: #555;
 
+    margin: 10px 0;
 
+}
 
+
 
+div.sphinxsidebar ul {
 
+    margin: 10px 0;
 
+    padding: 0;
 
+    color: #000;
 
+}
 
+
 
+div.sphinxsidebar ul li.toctree-l1 > a {
 
+    font-size: 120%;
 
+}
 
+
 
+div.sphinxsidebar ul li.toctree-l2 > a {
 
+    font-size: 110%;
 
+}
 
+
 
+div.sphinxsidebar input {
 
+    border: 1px solid #CCC;
 
+    font-family: Georgia, serif;
 
+    font-size: 1em;
 
+}
 
+
 
+div.sphinxsidebar hr {
 
+    border: none;
 
+    height: 1px;
 
+    color: #AAA;
 
+    background: #AAA;
 
+
 
+    text-align: left;
 
+    margin-left: 0;
 
+    width: 50%;
 
+}
 
+
 
+div.sphinxsidebar .badge {
 
+    border-bottom: none;
 
+}
 
+
 
+div.sphinxsidebar .badge:hover {
 
+    border-bottom: none;
 
+}
 
+
 
+/* To address an issue with donation coming after search */
 
+div.sphinxsidebar h3.donation {
 
+    margin-top: 10px;
 
+}
 
+
 
+/* -- body styles ----------------------------------------------------------- */
 
+
 
+a {
 
+    color: #004B6B;
 
+    text-decoration: underline;
 
+}
 
+
 
+a:hover {
 
+    color: #6D4100;
 
+    text-decoration: underline;
 
+}
 
+
 
+div.body h1,
 
+div.body h2,
 
+div.body h3,
 
+div.body h4,
 
+div.body h5,
 
+div.body h6 {
 
+    font-family: Georgia, serif;
 
+    font-weight: normal;
 
+    margin: 30px 0px 10px 0px;
 
+    padding: 0;
 
+}
 
+
 
+div.body h1 { margin-top: 0; padding-top: 0; font-size: 240%; }
 
+div.body h2 { font-size: 180%; }
 
+div.body h3 { font-size: 150%; }
 
+div.body h4 { font-size: 130%; }
 
+div.body h5 { font-size: 100%; }
 
+div.body h6 { font-size: 100%; }
 
+
 
+a.headerlink {
 
+    color: #DDD;
 
+    padding: 0 4px;
 
+    text-decoration: none;
 
+}
 
+
 
+a.headerlink:hover {
 
+    color: #444;
 
+    background: #EAEAEA;
 
+}
 
+
 
+div.body p, div.body dd, div.body li {
 
+    line-height: 1.4em;
 
+}
 
+
 
+div.admonition {
 
+    margin: 20px 0px;
 
+    padding: 10px 30px;
 
+    background-color: #EEE;
 
+    border: 1px solid #CCC;
 
+}
 
+
 
+div.admonition tt.xref, div.admonition code.xref, div.admonition a tt {
 
+    background-color: #FBFBFB;
 
+    border-bottom: 1px solid #fafafa;
 
+}
 
+
 
+div.admonition p.admonition-title {
 
+    font-family: Georgia, serif;
 
+    font-weight: normal;
 
+    font-size: 24px;
 
+    margin: 0 0 10px 0;
 
+    padding: 0;
 
+    line-height: 1;
 
+}
 
+
 
+div.admonition p.last {
 
+    margin-bottom: 0;
 
+}
 
+
 
+div.highlight {
 
+    background-color: #fff;
 
+}
 
+
 
+dt:target, .highlight {
 
+    background: #FAF3E8;
 
+}
 
+
 
+div.warning {
 
+    background-color: #FCC;
 
+    border: 1px solid #FAA;
 
+}
 
+
 
+div.danger {
 
+    background-color: #FCC;
 
+    border: 1px solid #FAA;
 
+    -moz-box-shadow: 2px 2px 4px #D52C2C;
 
+    -webkit-box-shadow: 2px 2px 4px #D52C2C;
 
+    box-shadow: 2px 2px 4px #D52C2C;
 
+}
 
+
 
+div.error {
 
+    background-color: #FCC;
 
+    border: 1px solid #FAA;
 
+    -moz-box-shadow: 2px 2px 4px #D52C2C;
 
+    -webkit-box-shadow: 2px 2px 4px #D52C2C;
 
+    box-shadow: 2px 2px 4px #D52C2C;
 
+}
 
+
 
+div.caution {
 
+    background-color: #FCC;
 
+    border: 1px solid #FAA;
 
+}
 
+
 
+div.attention {
 
+    background-color: #FCC;
 
+    border: 1px solid #FAA;
 
+}
 
+
 
+div.important {
 
+    background-color: #EEE;
 
+    border: 1px solid #CCC;
 
+}
 
+
 
+div.note {
 
+    background-color: #EEE;
 
+    border: 1px solid #CCC;
 
+}
 
+
 
+div.tip {
 
+    background-color: #EEE;
 
+    border: 1px solid #CCC;
 
+}
 
+
 
+div.hint {
 
+    background-color: #EEE;
 
+    border: 1px solid #CCC;
 
+}
 
+
 
+div.seealso {
 
+    background-color: #EEE;
 
+    border: 1px solid #CCC;
 
+}
 
+
 
+div.topic {
 
+    background-color: #EEE;
 
+}
 
+
 
+p.admonition-title {
 
+    display: inline;
 
+}
 
+
 
+p.admonition-title:after {
 
+    content: ":";
 
+}
 
+
 
+pre, tt, code {
 
+    font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace;
 
+    font-size: 0.9em;
 
+}
 
+
 
+.hll {
 
+    background-color: #FFC;
 
+    margin: 0 -12px;
 
+    padding: 0 12px;
 
+    display: block;
 
+}
 
+
 
+img.screenshot {
 
+}
 
+
 
+tt.descname, tt.descclassname, code.descname, code.descclassname {
 
+    font-size: 0.95em;
 
+}
 
+
 
+tt.descname, code.descname {
 
+    padding-right: 0.08em;
 
+}
 
+
 
+img.screenshot {
 
+    -moz-box-shadow: 2px 2px 4px #EEE;
 
+    -webkit-box-shadow: 2px 2px 4px #EEE;
 
+    box-shadow: 2px 2px 4px #EEE;
 
+}
 
+
 
+table.docutils {
 
+    border: 1px solid #888;
 
+    -moz-box-shadow: 2px 2px 4px #EEE;
 
+    -webkit-box-shadow: 2px 2px 4px #EEE;
 
+    box-shadow: 2px 2px 4px #EEE;
 
+}
 
+
 
+table.docutils td, table.docutils th {
 
+    border: 1px solid #888;
 
+    padding: 0.25em 0.7em;
 
+}
 
+
 
+table.field-list, table.footnote {
 
+    border: none;
 
+    -moz-box-shadow: none;
 
+    -webkit-box-shadow: none;
 
+    box-shadow: none;
 
+}
 
+
 
+table.footnote {
 
+    margin: 15px 0;
 
+    width: 100%;
 
+    border: 1px solid #EEE;
 
+    background: #FDFDFD;
 
+    font-size: 0.9em;
 
+}
 
+
 
+table.footnote + table.footnote {
 
+    margin-top: -15px;
 
+    border-top: none;
 
+}
 
+
 
+table.field-list th {
 
+    padding: 0 0.8em 0 0;
 
+}
 
+
 
+table.field-list td {
 
+    padding: 0;
 
+}
 
+
 
+table.field-list p {
 
+    margin-bottom: 0.8em;
 
+}
 
+
 
+/* Cloned from
 
+ * https://github.com/sphinx-doc/sphinx/commit/ef60dbfce09286b20b7385333d63a60321784e68
 
+ */
 
+.field-name {
 
+    -moz-hyphens: manual;
 
+    -ms-hyphens: manual;
 
+    -webkit-hyphens: manual;
 
+    hyphens: manual;
 
+}
 
+
 
+table.footnote td.label {
 
+    width: .1px;
 
+    padding: 0.3em 0 0.3em 0.5em;
 
+}
 
+
 
+table.footnote td {
 
+    padding: 0.3em 0.5em;
 
+}
 
+
 
+dl {
 
+    margin: 0;
 
+    padding: 0;
 
+}
 
+
 
+dl dd {
 
+    margin-left: 30px;
 
+}
 
+
 
+blockquote {
 
+    margin: 0 0 0 30px;
 
+    padding: 0;
 
+}
 
+
 
+ul, ol {
 
+    /* Matches the 30px from the narrow-screen "li > ul" selector below */
 
+    margin: 10px 0 10px 30px;
 
+    padding: 0;
 
+}
 
+
 
+pre {
 
+    background: #EEE;
 
+    padding: 7px 30px;
 
+    margin: 15px 0px;
 
+    line-height: 1.3em;
 
+}
 
+
 
+div.viewcode-block:target {
 
+    background: #ffd;
 
+}
 
+
 
+dl pre, blockquote pre, li pre {
 
+    margin-left: 0;
 
+    padding-left: 30px;
 
+}
 
+
 
+tt, code {
 
+    background-color: #ecf0f3;
 
+    color: #222;
 
+    /* padding: 1px 2px; */
 
+}
 
+
 
+tt.xref, code.xref, a tt {
 
+    background-color: #FBFBFB;
 
+    border-bottom: 1px solid #fff;
 
+}
 
+
 
+a.reference {
 
+    text-decoration: none;
 
+    border-bottom: 1px dotted #004B6B;
 
+}
 
+
 
+/* Don't put an underline on images */
 
+a.image-reference, a.image-reference:hover {
 
+    border-bottom: none;
 
+}
 
+
 
+a.reference:hover {
 
+    border-bottom: 1px solid #6D4100;
 
+}
 
+
 
+a.footnote-reference {
 
+    text-decoration: none;
 
+    font-size: 0.7em;
 
+    vertical-align: top;
 
+    border-bottom: 1px dotted #004B6B;
 
+}
 
+
 
+a.footnote-reference:hover {
 
+    border-bottom: 1px solid #6D4100;
 
+}
 
+
 
+a:hover tt, a:hover code {
 
+    background: #EEE;
 
+}
 
+
 
+
 
+@media screen and (max-width: 870px) {
 
+
 
+    div.sphinxsidebar {
 
+    	display: none;
 
+    }
 
+
 
+    div.document {
 
+       width: 100%;
 
+
 
+    }
 
+
 
+    div.documentwrapper {
 
+    	margin-left: 0;
 
+    	margin-top: 0;
 
+    	margin-right: 0;
 
+    	margin-bottom: 0;
 
+    }
 
+
 
+    div.bodywrapper {
 
+    	margin-top: 0;
 
+    	margin-right: 0;
 
+    	margin-bottom: 0;
 
+    	margin-left: 0;
 
+    }
 
+
 
+    ul {
 
+    	margin-left: 0;
 
+    }
 
+
 
+	li > ul {
 
+        /* Matches the 30px from the "ul, ol" selector above */
 
+		margin-left: 30px;
 
+	}
 
+
 
+    .document {
 
+    	width: auto;
 
+    }
 
+
 
+    .footer {
 
+    	width: auto;
 
+    }
 
+
 
+    .bodywrapper {
 
+    	margin: 0;
 
+    }
 
+
 
+    .footer {
 
+    	width: auto;
 
+    }
 
+
 
+    .github {
 
+        display: none;
 
+    }
 
+
 
+
 
+
 
+}
 
+
 
+
 
+
 
+@media screen and (max-width: 875px) {
 
+
 
+    body {
 
+        margin: 0;
 
+        padding: 20px 30px;
 
+    }
 
+
 
+    div.documentwrapper {
 
+        float: none;
 
+        background: #fff;
 
+    }
 
+
 
+    div.sphinxsidebar {
 
+        display: block;
 
+        float: none;
 
+        width: 102.5%;
 
+        margin: -20px -30px 20px -30px;
 
+        padding: 10px 20px;
 
+        background: #333;
 
+        color: #FFF;
 
+    }
 
+
 
+    div.sphinxsidebar h3, div.sphinxsidebar h4, div.sphinxsidebar p,
 
+    div.sphinxsidebar h3 a {
 
+        color: #fff;
 
+    }
 
+
 
+    div.sphinxsidebar a {
 
+        color: #AAA;
 
+    }
 
+
 
+    div.sphinxsidebar p.logo {
 
+        display: none;
 
+    }
 
+
 
+    div.document {
 
+        width: 100%;
 
+        margin: 0;
 
+    }
 
+
 
+    div.footer {
 
+        display: none;
 
+    }
 
+
 
+    div.bodywrapper {
 
+        margin: 0;
 
+    }
 
+
 
+    div.body {
 
+        min-height: 0;
 
+        padding: 0;
 
+    }
 
+
 
+    .rtd_doc_footer {
 
+        display: none;
 
+    }
 
+
 
+    .document {
 
+        width: auto;
 
+    }
 
+
 
+    .footer {
 
+        width: auto;
 
+    }
 
+
 
+    .footer {
 
+        width: auto;
 
+    }
 
+
 
+    .github {
 
+        display: none;
 
+    }
 
+}
 
+@media screen and (min-width: 876px) {
 
+    div.sphinxsidebar {
 
+        position: fixed;
 
+        margin-left: 0;
 
+    }
 
+}
 
+
 
+
 
+/* misc. */
 
+
 
+.revsys-inline {
 
+    display: none!important;
 
+}
 
+
 
+/* Make nested-list/multi-paragraph items look better in Releases changelog
 
+ * pages. Without this, docutils' magical list fuckery causes inconsistent
 
+ * formatting between different release sub-lists.
 
+ */
 
+div#changelog > div.section > ul > li > p:only-child {
 
+    margin-bottom: 0;
 
+}
 
+
 
+/* Hide fugly table cell borders in ..bibliography:: directive output */
 
+table.docutils.citation, table.docutils.citation td, table.docutils.citation th {
 
+  border: none;
 
+  /* Below needed in some edge cases; if not applied, bottom shadows appear */
 
+  -moz-box-shadow: none;
 
+  -webkit-box-shadow: none;
 
+  box-shadow: none;
 
+}
 
+
 
+
 
+/* relbar */
 
+
 
+.related {
 
+    line-height: 30px;
 
+    width: 100%;
 
+    font-size: 0.9rem;
 
+}
 
+
 
+.related.top {
 
+    border-bottom: 1px solid #EEE;
 
+    margin-bottom: 20px;
 
+}
 
+
 
+.related.bottom {
 
+    border-top: 1px solid #EEE;
 
+}
 
+
 
+.related ul {
 
+    padding: 0;
 
+    margin: 0;
 
+    list-style: none;
 
+}
 
+
 
+.related li {
 
+    display: inline;
 
+}
 
+
 
+nav#rellinks {
 
+    float: right;
 
+}
 
+
 
+nav#rellinks li+li:before {
 
+    content: "|";
 
+}
 
+
 
+nav#breadcrumbs li+li:before {
 
+    content: "\00BB";
 
+}
 
+
 
+/* Hide certain items when printing */
 
+@media print {
 
+    div.related {
 
+        display: none;
 
+    }
 
+}

+ 35 - 2
python/_static/basic.css
查看文件 

@@ -4,7 +4,7 @@
 
  *
 
  * Sphinx stylesheet -- basic theme.
 
  *
 
- * :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS.
 
+ * :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS.
 
  * :license: BSD, see LICENSE for details.
 
  *
 
  */
 
@@ -81,10 +81,26 @@ div.sphinxsidebar input {
 
     font-size: 1em;
 
 }
 
 
+div.sphinxsidebar #searchbox form.search {
 
+    overflow: hidden;
 
+}
 
+
 
 div.sphinxsidebar #searchbox input[type="text"] {
 
-    width: 170px;
 
+    float: left;
 
+    width: 80%;
 
+    padding: 0.25em;
 
+    box-sizing: border-box;
 
 }
 
 
+div.sphinxsidebar #searchbox input[type="submit"] {
 
+    float: left;
 
+    width: 20%;
 
+    border-left: none;
 
+    padding: 0.25em;
 
+    box-sizing: border-box;
 
+}
 
+
 
+
 
 img {
 
     border: 0;
 
     max-width: 100%;
 
@@ -199,6 +215,11 @@ table.modindextable td {
 
 
 /* -- general body styles --------------------------------------------------- */
 
 
+div.body {
 
+    min-width: 450px;
 
+    max-width: 800px;
 
+}
 
+
 
 div.body p, div.body dd, div.body li, div.body blockquote {
 
     -moz-hyphens: auto;
 
     -ms-hyphens: auto;
 
@@ -332,6 +353,11 @@ table.docutils {
 
     border-collapse: collapse;
 
 }
 
 
+table.align-center {
 
+    margin-left: auto;
 
+    margin-right: auto;
 
+}
 
+
 
 table caption span.caption-number {
 
     font-style: italic;
 
 }
 
@@ -405,6 +431,13 @@ table.field-list td, table.field-list th {
 
     hyphens: manual;
 
 }
 
 
+/* -- hlist styles ---------------------------------------------------------- */
 
+
 
+table.hlist td {
 
+    vertical-align: top;
 
+}
 
+
 
+
 
 /* -- other body styles ----------------------------------------------------- */
 
 
 ol.arabic {

File diff suppressed because it is too large
+ 0 - 0
python/_static/css/badge_only.css


File diff suppressed because it is too large
+ 0 - 0
python/_static/css/theme.css


+ 1 - 0
python/_static/custom.css
查看文件 

@@ -0,0 +1 @@
 
+/* This file intentionally left blank. */

+ 9 - 5
python/_static/doctools.js
查看文件 

@@ -4,7 +4,7 @@
 
  *
 
  * Sphinx JavaScript utilities for all documentation.
 
  *
 
- * :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS.
 
+ * :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS.
 
  * :license: BSD, see LICENSE for details.
 
  *
 
  */
 
@@ -70,7 +70,9 @@ jQuery.fn.highlightText = function(text, className) {
 
     if (node.nodeType === 3) {
 
       var val = node.nodeValue;
 
       var pos = val.toLowerCase().indexOf(text);
 
-      if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) {
 
+      if (pos >= 0 &&
 
+          !jQuery(node.parentNode).hasClass(className) &&
 
+          !jQuery(node.parentNode).hasClass("nohighlight")) {
 
         var span;
 
         var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg");
 
         if (isInSVG) {
 
@@ -148,7 +150,9 @@ var Documentation = {
 
     this.fixFirefoxAnchorBug();
 
     this.highlightSearchWords();
 
     this.initIndexTable();
 
-    
+    if (DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) {
 
+      this.initOnKeyListeners();
 
+    }
 
   },
 
 
   /**
 
@@ -204,7 +208,7 @@ var Documentation = {
 
    * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075
 
    */
 
   fixFirefoxAnchorBug : function() {
 
-    if (document.location.hash)
 
+    if (document.location.hash && $.browser.mozilla)
 
       window.setTimeout(function() {
 
         document.location.href += '';
 
       }, 10);
 
@@ -308,4 +312,4 @@ _ = Documentation.gettext;
 
 
 $(document).ready(function() {
 
   Documentation.init();
 
-});
 
+});

+ 296 - 0
python/_static/documentation_options.js
查看文件 

@@ -0,0 +1,296 @@
 
+var DOCUMENTATION_OPTIONS = {
 
+    URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
 
+    VERSION: '1.16.0',
 
+    LANGUAGE: 'en',
 
+    COLLAPSE_INDEX: false,
 
+    FILE_SUFFIX: '.html',
 
+    HAS_SOURCE: true,
 
+    SOURCELINK_SUFFIX: '.txt',
 
+    NAVIGATION_WITH_KEYS: false,
 
+    SEARCH_LANGUAGE_STOP_WORDS: ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"]
 
+};
 
+
 
+
 
+
 
+/* Non-minified version JS is _stemmer.js if file is provided */ 
+/**
 
+ * Porter Stemmer
 
+ */
 
+var Stemmer = function() {
 
+
 
+  var step2list = {
 
+    ational: 'ate',
 
+    tional: 'tion',
 
+    enci: 'ence',
 
+    anci: 'ance',
 
+    izer: 'ize',
 
+    bli: 'ble',
 
+    alli: 'al',
 
+    entli: 'ent',
 
+    eli: 'e',
 
+    ousli: 'ous',
 
+    ization: 'ize',
 
+    ation: 'ate',
 
+    ator: 'ate',
 
+    alism: 'al',
 
+    iveness: 'ive',
 
+    fulness: 'ful',
 
+    ousness: 'ous',
 
+    aliti: 'al',
 
+    iviti: 'ive',
 
+    biliti: 'ble',
 
+    logi: 'log'
 
+  };
 
+
 
+  var step3list = {
 
+    icate: 'ic',
 
+    ative: '',
 
+    alize: 'al',
 
+    iciti: 'ic',
 
+    ical: 'ic',
 
+    ful: '',
 
+    ness: ''
 
+  };
 
+
 
+  var c = "[^aeiou]";          // consonant
 
+  var v = "[aeiouy]";          // vowel
 
+  var C = c + "[^aeiouy]*";    // consonant sequence
 
+  var V = v + "[aeiou]*";      // vowel sequence
 
+
 
+  var mgr0 = "^(" + C + ")?" + V + C;                      // [C]VC... is m>0
 
+  var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$";    // [C]VC[V] is m=1
 
+  var mgr1 = "^(" + C + ")?" + V + C + V + C;              // [C]VCVC... is m>1
 
+  var s_v   = "^(" + C + ")?" + v;                         // vowel in stem
 
+
 
+  this.stemWord = function (w) {
 
+    var stem;
 
+    var suffix;
 
+    var firstch;
 
+    var origword = w;
 
+
 
+    if (w.length < 3)
 
+      return w;
 
+
 
+    var re;
 
+    var re2;
 
+    var re3;
 
+    var re4;
 
+
 
+    firstch = w.substr(0,1);
 
+    if (firstch == "y")
 
+      w = firstch.toUpperCase() + w.substr(1);
 
+
 
+    // Step 1a
 
+    re = /^(.+?)(ss|i)es$/;
 
+    re2 = /^(.+?)([^s])s$/;
 
+
 
+    if (re.test(w))
 
+      w = w.replace(re,"$1$2");
 
+    else if (re2.test(w))
 
+      w = w.replace(re2,"$1$2");
 
+
 
+    // Step 1b
 
+    re = /^(.+?)eed$/;
 
+    re2 = /^(.+?)(ed|ing)$/;
 
+    if (re.test(w)) {
 
+      var fp = re.exec(w);
 
+      re = new RegExp(mgr0);
 
+      if (re.test(fp[1])) {
 
+        re = /.$/;
 
+        w = w.replace(re,"");
 
+      }
 
+    }
 
+    else if (re2.test(w)) {
 
+      var fp = re2.exec(w);
 
+      stem = fp[1];
 
+      re2 = new RegExp(s_v);
 
+      if (re2.test(stem)) {
 
+        w = stem;
 
+        re2 = /(at|bl|iz)$/;
 
+        re3 = new RegExp("([^aeiouylsz])\\1$");
 
+        re4 = new RegExp("^" + C + v + "[^aeiouwxy]$");
 
+        if (re2.test(w))
 
+          w = w + "e";
 
+        else if (re3.test(w)) {
 
+          re = /.$/;
 
+          w = w.replace(re,"");
 
+        }
 
+        else if (re4.test(w))
 
+          w = w + "e";
 
+      }
 
+    }
 
+
 
+    // Step 1c
 
+    re = /^(.+?)y$/;
 
+    if (re.test(w)) {
 
+      var fp = re.exec(w);
 
+      stem = fp[1];
 
+      re = new RegExp(s_v);
 
+      if (re.test(stem))
 
+        w = stem + "i";
 
+    }
 
+
 
+    // Step 2
 
+    re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
 
+    if (re.test(w)) {
 
+      var fp = re.exec(w);
 
+      stem = fp[1];
 
+      suffix = fp[2];
 
+      re = new RegExp(mgr0);
 
+      if (re.test(stem))
 
+        w = stem + step2list[suffix];
 
+    }
 
+
 
+    // Step 3
 
+    re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
 
+    if (re.test(w)) {
 
+      var fp = re.exec(w);
 
+      stem = fp[1];
 
+      suffix = fp[2];
 
+      re = new RegExp(mgr0);
 
+      if (re.test(stem))
 
+        w = stem + step3list[suffix];
 
+    }
 
+
 
+    // Step 4
 
+    re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;
 
+    re2 = /^(.+?)(s|t)(ion)$/;
 
+    if (re.test(w)) {
 
+      var fp = re.exec(w);
 
+      stem = fp[1];
 
+      re = new RegExp(mgr1);
 
+      if (re.test(stem))
 
+        w = stem;
 
+    }
 
+    else if (re2.test(w)) {
 
+      var fp = re2.exec(w);
 
+      stem = fp[1] + fp[2];
 
+      re2 = new RegExp(mgr1);
 
+      if (re2.test(stem))
 
+        w = stem;
 
+    }
 
+
 
+    // Step 5
 
+    re = /^(.+?)e$/;
 
+    if (re.test(w)) {
 
+      var fp = re.exec(w);
 
+      stem = fp[1];
 
+      re = new RegExp(mgr1);
 
+      re2 = new RegExp(meq1);
 
+      re3 = new RegExp("^" + C + v + "[^aeiouwxy]$");
 
+      if (re.test(stem) || (re2.test(stem) && !(re3.test(stem))))
 
+        w = stem;
 
+    }
 
+    re = /ll$/;
 
+    re2 = new RegExp(mgr1);
 
+    if (re.test(w) && re2.test(w)) {
 
+      re = /.$/;
 
+      w = w.replace(re,"");
 
+    }
 
+
 
+    // and turn initial Y back to y
 
+    if (firstch == "y")
 
+      w = firstch.toLowerCase() + w.substr(1);
 
+    return w;
 
+  }
 
+}
 
+
 
+
 
+
 
+
 
+
 
+var splitChars = (function() {
 
+    var result = {};
 
+    var singles = [96, 180, 187, 191, 215, 247, 749, 885, 903, 907, 909, 930, 1014, 1648,
 
+         1748, 1809, 2416, 2473, 2481, 2526, 2601, 2609, 2612, 2615, 2653, 2702,
 
+         2706, 2729, 2737, 2740, 2857, 2865, 2868, 2910, 2928, 2948, 2961, 2971,
 
+         2973, 3085, 3089, 3113, 3124, 3213, 3217, 3241, 3252, 3295, 3341, 3345,
 
+         3369, 3506, 3516, 3633, 3715, 3721, 3736, 3744, 3748, 3750, 3756, 3761,
 
+         3781, 3912, 4239, 4347, 4681, 4695, 4697, 4745, 4785, 4799, 4801, 4823,
 
+         4881, 5760, 5901, 5997, 6313, 7405, 8024, 8026, 8028, 8030, 8117, 8125,
 
+         8133, 8181, 8468, 8485, 8487, 8489, 8494, 8527, 11311, 11359, 11687, 11695,
 
+         11703, 11711, 11719, 11727, 11735, 12448, 12539, 43010, 43014, 43019, 43587,
 
+         43696, 43713, 64286, 64297, 64311, 64317, 64319, 64322, 64325, 65141];
 
+    var i, j, start, end;
 
+    for (i = 0; i < singles.length; i++) {
 
+        result[singles[i]] = true;
 
+    }
 
+    var ranges = [[0, 47], [58, 64], [91, 94], [123, 169], [171, 177], [182, 184], [706, 709],
 
+         [722, 735], [741, 747], [751, 879], [888, 889], [894, 901], [1154, 1161],
 
+         [1318, 1328], [1367, 1368], [1370, 1376], [1416, 1487], [1515, 1519], [1523, 1568],
 
+         [1611, 1631], [1642, 1645], [1750, 1764], [1767, 1773], [1789, 1790], [1792, 1807],
 
+         [1840, 1868], [1958, 1968], [1970, 1983], [2027, 2035], [2038, 2041], [2043, 2047],
 
+         [2070, 2073], [2075, 2083], [2085, 2087], [2089, 2307], [2362, 2364], [2366, 2383],
 
+         [2385, 2391], [2402, 2405], [2419, 2424], [2432, 2436], [2445, 2446], [2449, 2450],
 
+         [2483, 2485], [2490, 2492], [2494, 2509], [2511, 2523], [2530, 2533], [2546, 2547],
 
+         [2554, 2564], [2571, 2574], [2577, 2578], [2618, 2648], [2655, 2661], [2672, 2673],
 
+         [2677, 2692], [2746, 2748], [2750, 2767], [2769, 2783], [2786, 2789], [2800, 2820],
 
+         [2829, 2830], [2833, 2834], [2874, 2876], [2878, 2907], [2914, 2917], [2930, 2946],
 
+         [2955, 2957], [2966, 2968], [2976, 2978], [2981, 2983], [2987, 2989], [3002, 3023],
 
+         [3025, 3045], [3059, 3076], [3130, 3132], [3134, 3159], [3162, 3167], [3170, 3173],
 
+         [3184, 3191], [3199, 3204], [3258, 3260], [3262, 3293], [3298, 3301], [3312, 3332],
 
+         [3386, 3388], [3390, 3423], [3426, 3429], [3446, 3449], [3456, 3460], [3479, 3481],
 
+         [3518, 3519], [3527, 3584], [3636, 3647], [3655, 3663], [3674, 3712], [3717, 3718],
 
+         [3723, 3724], [3726, 3731], [3752, 3753], [3764, 3772], [3774, 3775], [3783, 3791],
 
+         [3802, 3803], [3806, 3839], [3841, 3871], [3892, 3903], [3949, 3975], [3980, 4095],
 
+         [4139, 4158], [4170, 4175], [4182, 4185], [4190, 4192], [4194, 4196], [4199, 4205],
 
+         [4209, 4212], [4226, 4237], [4250, 4255], [4294, 4303], [4349, 4351], [4686, 4687],
 
+         [4702, 4703], [4750, 4751], [4790, 4791], [4806, 4807], [4886, 4887], [4955, 4968],
 
+         [4989, 4991], [5008, 5023], [5109, 5120], [5741, 5742], [5787, 5791], [5867, 5869],
 
+         [5873, 5887], [5906, 5919], [5938, 5951], [5970, 5983], [6001, 6015], [6068, 6102],
 
+         [6104, 6107], [6109, 6111], [6122, 6127], [6138, 6159], [6170, 6175], [6264, 6271],
 
+         [6315, 6319], [6390, 6399], [6429, 6469], [6510, 6511], [6517, 6527], [6572, 6592],
 
+         [6600, 6607], [6619, 6655], [6679, 6687], [6741, 6783], [6794, 6799], [6810, 6822],
 
+         [6824, 6916], [6964, 6980], [6988, 6991], [7002, 7042], [7073, 7085], [7098, 7167],
 
+         [7204, 7231], [7242, 7244], [7294, 7400], [7410, 7423], [7616, 7679], [7958, 7959],
 
+         [7966, 7967], [8006, 8007], [8014, 8015], [8062, 8063], [8127, 8129], [8141, 8143],
 
+         [8148, 8149], [8156, 8159], [8173, 8177], [8189, 8303], [8306, 8307], [8314, 8318],
 
+         [8330, 8335], [8341, 8449], [8451, 8454], [8456, 8457], [8470, 8472], [8478, 8483],
 
+         [8506, 8507], [8512, 8516], [8522, 8525], [8586, 9311], [9372, 9449], [9472, 10101],
 
+         [10132, 11263], [11493, 11498], [11503, 11516], [11518, 11519], [11558, 11567],
 
+         [11622, 11630], [11632, 11647], [11671, 11679], [11743, 11822], [11824, 12292],
 
+         [12296, 12320], [12330, 12336], [12342, 12343], [12349, 12352], [12439, 12444],
 
+         [12544, 12548], [12590, 12592], [12687, 12689], [12694, 12703], [12728, 12783],
 
+         [12800, 12831], [12842, 12880], [12896, 12927], [12938, 12976], [12992, 13311],
 
+         [19894, 19967], [40908, 40959], [42125, 42191], [42238, 42239], [42509, 42511],
 
+         [42540, 42559], [42592, 42593], [42607, 42622], [42648, 42655], [42736, 42774],
 
+         [42784, 42785], [42889, 42890], [42893, 43002], [43043, 43055], [43062, 43071],
 
+         [43124, 43137], [43188, 43215], [43226, 43249], [43256, 43258], [43260, 43263],
 
+         [43302, 43311], [43335, 43359], [43389, 43395], [43443, 43470], [43482, 43519],
 
+         [43561, 43583], [43596, 43599], [43610, 43615], [43639, 43641], [43643, 43647],
 
+         [43698, 43700], [43703, 43704], [43710, 43711], [43715, 43738], [43742, 43967],
 
+         [44003, 44015], [44026, 44031], [55204, 55215], [55239, 55242], [55292, 55295],
 
+         [57344, 63743], [64046, 64047], [64110, 64111], [64218, 64255], [64263, 64274],
 
+         [64280, 64284], [64434, 64466], [64830, 64847], [64912, 64913], [64968, 65007],
 
+         [65020, 65135], [65277, 65295], [65306, 65312], [65339, 65344], [65371, 65381],
 
+         [65471, 65473], [65480, 65481], [65488, 65489], [65496, 65497]];
 
+    for (i = 0; i < ranges.length; i++) {
 
+        start = ranges[i][0];
 
+        end = ranges[i][1];
 
+        for (j = start; j <= end; j++) {
 
+            result[j] = true;
 
+        }
 
+    }
 
+    return result;
 
+})();
 
+
 
+function splitQuery(query) {
 
+    var result = [];
 
+    var start = -1;
 
+    for (var i = 0; i < query.length; i++) {
 
+        if (splitChars[query.charCodeAt(i)]) {
 
+            if (start !== -1) {
 
+                result.push(query.slice(start, i));
 
+                start = -1;
 
+            }
 
+        } else if (start === -1) {
 
+            start = i;
 
+        }
 
+    }
 
+    if (start !== -1) {
 
+        result.push(query.slice(start));
 
+    }
 
+    return result;
 
+}
 
+
 
+

二進制
python/_static/fonts/Inconsolata-Bold.ttf
查看文件


二進制
python/_static/fonts/Inconsolata-Regular.ttf
查看文件


二進制
python/_static/fonts/Lato-Bold.ttf
查看文件


二進制
python/_static/fonts/Lato-Regular.ttf
查看文件


二進制
python/_static/fonts/RobotoSlab-Bold.ttf
查看文件


二進制
python/_static/fonts/RobotoSlab-Regular.ttf
查看文件


二進制
python/_static/fonts/fontawesome-webfont.eot
查看文件


File diff suppressed because it is too large
+ 0 - 196
python/_static/fonts/fontawesome-webfont.svg


二進制
python/_static/fonts/fontawesome-webfont.ttf
查看文件


二進制
python/_static/fonts/fontawesome-webfont.woff
查看文件


File diff suppressed because it is too large
+ 338 - 190
python/_static/jquery-3.2.1.js


File diff suppressed because it is too large
+ 0 - 1
python/_static/jquery.js


File diff suppressed because it is too large
+ 0 - 3
python/_static/js/modernizr.min.js


+ 0 - 169
python/_static/js/theme.js
查看文件 

@@ -1,169 +0,0 @@
 
-require=(function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({"sphinx-rtd-theme":[function(require,module,exports){
 
-var jQuery = (typeof(window) != 'undefined') ? window.jQuery : require('jquery');
 
-
 
-// Sphinx theme nav state
 
-function ThemeNav () {
 
-
 
-    var nav = {
 
-        navBar: null,
 
-        win: null,
 
-        winScroll: false,
 
-        winResize: false,
 
-        linkScroll: false,
 
-        winPosition: 0,
 
-        winHeight: null,
 
-        docHeight: null,
 
-        isRunning: false
 
-    };
 
-
 
-    nav.enable = function () {
 
-        var self = this;
 
-
 
-        if (!self.isRunning) {
 
-            self.isRunning = true;
 
-            jQuery(function ($) {
 
-                self.init($);
 
-
 
-                self.reset();
 
-                self.win.on('hashchange', self.reset);
 
-
 
-                // Set scroll monitor
 
-                self.win.on('scroll', function () {
 
-                    if (!self.linkScroll) {
 
-                        self.winScroll = true;
 
-                    }
 
-                });
 
-                setInterval(function () { if (self.winScroll) self.onScroll(); }, 25);
 
-
 
-                // Set resize monitor
 
-                self.win.on('resize', function () {
 
-                    self.winResize = true;
 
-                });
 
-                setInterval(function () { if (self.winResize) self.onResize(); }, 25);
 
-                self.onResize();
 
-            });
 
-        };
 
-    };
 
-
 
-    nav.init = function ($) {
 
-        var doc = $(document),
 
-            self = this;
 
-
 
-        this.navBar = $('div.wy-side-scroll:first');
 
-        this.win = $(window);
 
-
 
-        // Set up javascript UX bits
 
-        $(document)
 
-            // Shift nav in mobile when clicking the menu.
 
-            .on('click', "[data-toggle='wy-nav-top']", function() {
 
-                $("[data-toggle='wy-nav-shift']").toggleClass("shift");
 
-                $("[data-toggle='rst-versions']").toggleClass("shift");
 
-            })
 
-
 
-            // Nav menu link click operations
 
-            .on('click', ".wy-menu-vertical .current ul li a", function() {
 
-                var target = $(this);
 
-                // Close menu when you click a link.
 
-                $("[data-toggle='wy-nav-shift']").removeClass("shift");
 
-                $("[data-toggle='rst-versions']").toggleClass("shift");
 
-                // Handle dynamic display of l3 and l4 nav lists
 
-                self.toggleCurrent(target);
 
-                self.hashChange();
 
-            })
 
-            .on('click', "[data-toggle='rst-current-version']", function() {
 
-                $("[data-toggle='rst-versions']").toggleClass("shift-up");
 
-            })
 
-
 
-        // Make tables responsive
 
-        $("table.docutils:not(.field-list)")
 
-            .wrap("<div class='wy-table-responsive'></div>");
 
-
 
-        // Add expand links to all parents of nested ul
 
-        $('.wy-menu-vertical ul').not('.simple').siblings('a').each(function () {
 
-            var link = $(this);
 
-                expand = $('<span class="toctree-expand"></span>');
 
-            expand.on('click', function (ev) {
 
-                self.toggleCurrent(link);
 
-                ev.stopPropagation();
 
-                return false;
 
-            });
 
-            link.prepend(expand);
 
-        });
 
-    };
 
-
 
-    nav.reset = function () {
 
-        // Get anchor from URL and open up nested nav
 
-        var anchor = encodeURI(window.location.hash);
 
-        if (anchor) {
 
-            try {
 
-                var link = $('.wy-menu-vertical')
 
-                    .find('[href="' + anchor + '"]');
 
-                // If we didn't find a link, it may be because we clicked on
 
-                // something that is not in the sidebar (eg: when using
 
-                // sphinxcontrib.httpdomain it generates headerlinks but those
 
-                // aren't picked up and placed in the toctree). So let's find
 
-                // the closest header in the document and try with that one.
 
-                if (link.length === 0) {
 
-                  var doc_link = $('.document a[href="' + anchor + '"]');
 
-                  var closest_section = doc_link.closest('div.section');
 
-                  // Try again with the closest section entry.
 
-                  link = $('.wy-menu-vertical')
 
-                    .find('[href="#' + closest_section.attr("id") + '"]');
 
-
 
-                }
 
-                $('.wy-menu-vertical li.toctree-l1 li.current')
 
-                    .removeClass('current');
 
-                link.closest('li.toctree-l2').addClass('current');
 
-                link.closest('li.toctree-l3').addClass('current');
 
-                link.closest('li.toctree-l4').addClass('current');
 
-            }
 
-            catch (err) {
 
-                console.log("Error expanding nav for anchor", err);
 
-            }
 
-        }
 
-    };
 
-
 
-    nav.onScroll = function () {
 
-        this.winScroll = false;
 
-        var newWinPosition = this.win.scrollTop(),
 
-            winBottom = newWinPosition + this.winHeight,
 
-            navPosition = this.navBar.scrollTop(),
 
-            newNavPosition = navPosition + (newWinPosition - this.winPosition);
 
-        if (newWinPosition < 0 || winBottom > this.docHeight) {
 
-            return;
 
-        }
 
-        this.navBar.scrollTop(newNavPosition);
 
-        this.winPosition = newWinPosition;
 
-    };
 
-
 
-    nav.onResize = function () {
 
-        this.winResize = false;
 
-        this.winHeight = this.win.height();
 
-        this.docHeight = $(document).height();
 
-    };
 
-
 
-    nav.hashChange = function () {
 
-        this.linkScroll = true;
 
-        this.win.one('hashchange', function () {
 
-            this.linkScroll = false;
 
-        });
 
-    };
 
-
 
-    nav.toggleCurrent = function (elem) {
 
-        var parent_li = elem.closest('li');
 
-        parent_li.siblings('li.current').removeClass('current');
 
-        parent_li.siblings().find('li.current').removeClass('current');
 
-        parent_li.find('> ul li.current').removeClass('current');
 
-        parent_li.toggleClass('current');
 
-    }
 
-
 
-    return nav;
 
-};
 
-
 
-module.exports.ThemeNav = ThemeNav();
 
-
 
-if (typeof(window) != 'undefined') {
 
-    window.SphinxRtdTheme = { StickyNav: module.exports.ThemeNav };
 
-}
 
-
 
-},{"jquery":"jquery"}]},{},["sphinx-rtd-theme"]);

+ 73 - 65
python/_static/pygments.css
查看文件 

@@ -1,69 +1,77 @@
 
 .highlight .hll { background-color: #ffffcc }
 
-.highlight  { background: #eeffcc; }
 
-.highlight .c { color: #408090; font-style: italic } /* Comment */
 
-.highlight .err { border: 1px solid #FF0000 } /* Error */
 
-.highlight .k { color: #007020; font-weight: bold } /* Keyword */
 
-.highlight .o { color: #666666 } /* Operator */
 
-.highlight .ch { color: #408090; font-style: italic } /* Comment.Hashbang */
 
-.highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */
 
-.highlight .cp { color: #007020 } /* Comment.Preproc */
 
-.highlight .cpf { color: #408090; font-style: italic } /* Comment.PreprocFile */
 
-.highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */
 
-.highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */
 
-.highlight .gd { color: #A00000 } /* Generic.Deleted */
 
-.highlight .ge { font-style: italic } /* Generic.Emph */
 
-.highlight .gr { color: #FF0000 } /* Generic.Error */
 
+.highlight  { background: #f8f8f8; }
 
+.highlight .c { color: #8f5902; font-style: italic } /* Comment */
 
+.highlight .err { color: #a40000; border: 1px solid #ef2929 } /* Error */
 
+.highlight .g { color: #000000 } /* Generic */
 
+.highlight .k { color: #004461; font-weight: bold } /* Keyword */
 
+.highlight .l { color: #000000 } /* Literal */
 
+.highlight .n { color: #000000 } /* Name */
 
+.highlight .o { color: #582800 } /* Operator */
 
+.highlight .x { color: #000000 } /* Other */
 
+.highlight .p { color: #000000; font-weight: bold } /* Punctuation */
 
+.highlight .ch { color: #8f5902; font-style: italic } /* Comment.Hashbang */
 
+.highlight .cm { color: #8f5902; font-style: italic } /* Comment.Multiline */
 
+.highlight .cp { color: #8f5902 } /* Comment.Preproc */
 
+.highlight .cpf { color: #8f5902; font-style: italic } /* Comment.PreprocFile */
 
+.highlight .c1 { color: #8f5902; font-style: italic } /* Comment.Single */
 
+.highlight .cs { color: #8f5902; font-style: italic } /* Comment.Special */
 
+.highlight .gd { color: #a40000 } /* Generic.Deleted */
 
+.highlight .ge { color: #000000; font-style: italic } /* Generic.Emph */
 
+.highlight .gr { color: #ef2929 } /* Generic.Error */
 
 .highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
 
 .highlight .gi { color: #00A000 } /* Generic.Inserted */
 
-.highlight .go { color: #333333 } /* Generic.Output */
 
-.highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */
 
-.highlight .gs { font-weight: bold } /* Generic.Strong */
 
+.highlight .go { color: #888888 } /* Generic.Output */
 
+.highlight .gp { color: #745334 } /* Generic.Prompt */
 
+.highlight .gs { color: #000000; font-weight: bold } /* Generic.Strong */
 
 .highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
 
-.highlight .gt { color: #0044DD } /* Generic.Traceback */
 
-.highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */
 
-.highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */
 
-.highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */
 
-.highlight .kp { color: #007020 } /* Keyword.Pseudo */
 
-.highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */
 
-.highlight .kt { color: #902000 } /* Keyword.Type */
 
-.highlight .m { color: #208050 } /* Literal.Number */
 
-.highlight .s { color: #4070a0 } /* Literal.String */
 
-.highlight .na { color: #4070a0 } /* Name.Attribute */
 
-.highlight .nb { color: #007020 } /* Name.Builtin */
 
-.highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */
 
-.highlight .no { color: #60add5 } /* Name.Constant */
 
-.highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */
 
-.highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */
 
-.highlight .ne { color: #007020 } /* Name.Exception */
 
-.highlight .nf { color: #06287e } /* Name.Function */
 
-.highlight .nl { color: #002070; font-weight: bold } /* Name.Label */
 
-.highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */
 
-.highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */
 
-.highlight .nv { color: #bb60d5 } /* Name.Variable */
 
-.highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */
 
-.highlight .w { color: #bbbbbb } /* Text.Whitespace */
 
-.highlight .mb { color: #208050 } /* Literal.Number.Bin */
 
-.highlight .mf { color: #208050 } /* Literal.Number.Float */
 
-.highlight .mh { color: #208050 } /* Literal.Number.Hex */
 
-.highlight .mi { color: #208050 } /* Literal.Number.Integer */
 
-.highlight .mo { color: #208050 } /* Literal.Number.Oct */
 
-.highlight .sa { color: #4070a0 } /* Literal.String.Affix */
 
-.highlight .sb { color: #4070a0 } /* Literal.String.Backtick */
 
-.highlight .sc { color: #4070a0 } /* Literal.String.Char */
 
-.highlight .dl { color: #4070a0 } /* Literal.String.Delimiter */
 
-.highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */
 
-.highlight .s2 { color: #4070a0 } /* Literal.String.Double */
 
-.highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */
 
-.highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */
 
-.highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */
 
-.highlight .sx { color: #c65d09 } /* Literal.String.Other */
 
-.highlight .sr { color: #235388 } /* Literal.String.Regex */
 
-.highlight .s1 { color: #4070a0 } /* Literal.String.Single */
 
-.highlight .ss { color: #517918 } /* Literal.String.Symbol */
 
-.highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */
 
-.highlight .fm { color: #06287e } /* Name.Function.Magic */
 
-.highlight .vc { color: #bb60d5 } /* Name.Variable.Class */
 
-.highlight .vg { color: #bb60d5 } /* Name.Variable.Global */
 
-.highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */
 
-.highlight .vm { color: #bb60d5 } /* Name.Variable.Magic */
 
-.highlight .il { color: #208050 } /* Literal.Number.Integer.Long */
 
+.highlight .gt { color: #a40000; font-weight: bold } /* Generic.Traceback */
 
+.highlight .kc { color: #004461; font-weight: bold } /* Keyword.Constant */
 
+.highlight .kd { color: #004461; font-weight: bold } /* Keyword.Declaration */
 
+.highlight .kn { color: #004461; font-weight: bold } /* Keyword.Namespace */
 
+.highlight .kp { color: #004461; font-weight: bold } /* Keyword.Pseudo */
 
+.highlight .kr { color: #004461; font-weight: bold } /* Keyword.Reserved */
 
+.highlight .kt { color: #004461; font-weight: bold } /* Keyword.Type */
 
+.highlight .ld { color: #000000 } /* Literal.Date */
 
+.highlight .m { color: #990000 } /* Literal.Number */
 
+.highlight .s { color: #4e9a06 } /* Literal.String */
 
+.highlight .na { color: #c4a000 } /* Name.Attribute */
 
+.highlight .nb { color: #004461 } /* Name.Builtin */
 
+.highlight .nc { color: #000000 } /* Name.Class */
 
+.highlight .no { color: #000000 } /* Name.Constant */
 
+.highlight .nd { color: #888888 } /* Name.Decorator */
 
+.highlight .ni { color: #ce5c00 } /* Name.Entity */
 
+.highlight .ne { color: #cc0000; font-weight: bold } /* Name.Exception */
 
+.highlight .nf { color: #000000 } /* Name.Function */
 
+.highlight .nl { color: #f57900 } /* Name.Label */
 
+.highlight .nn { color: #000000 } /* Name.Namespace */
 
+.highlight .nx { color: #000000 } /* Name.Other */
 
+.highlight .py { color: #000000 } /* Name.Property */
 
+.highlight .nt { color: #004461; font-weight: bold } /* Name.Tag */
 
+.highlight .nv { color: #000000 } /* Name.Variable */
 
+.highlight .ow { color: #004461; font-weight: bold } /* Operator.Word */
 
+.highlight .w { color: #f8f8f8; text-decoration: underline } /* Text.Whitespace */
 
+.highlight .mb { color: #990000 } /* Literal.Number.Bin */
 
+.highlight .mf { color: #990000 } /* Literal.Number.Float */
 
+.highlight .mh { color: #990000 } /* Literal.Number.Hex */
 
+.highlight .mi { color: #990000 } /* Literal.Number.Integer */
 
+.highlight .mo { color: #990000 } /* Literal.Number.Oct */
 
+.highlight .sa { color: #4e9a06 } /* Literal.String.Affix */
 
+.highlight .sb { color: #4e9a06 } /* Literal.String.Backtick */
 
+.highlight .sc { color: #4e9a06 } /* Literal.String.Char */
 
+.highlight .dl { color: #4e9a06 } /* Literal.String.Delimiter */
 
+.highlight .sd { color: #8f5902; font-style: italic } /* Literal.String.Doc */
 
+.highlight .s2 { color: #4e9a06 } /* Literal.String.Double */
 
+.highlight .se { color: #4e9a06 } /* Literal.String.Escape */
 
+.highlight .sh { color: #4e9a06 } /* Literal.String.Heredoc */
 
+.highlight .si { color: #4e9a06 } /* Literal.String.Interpol */
 
+.highlight .sx { color: #4e9a06 } /* Literal.String.Other */
 
+.highlight .sr { color: #4e9a06 } /* Literal.String.Regex */
 
+.highlight .s1 { color: #4e9a06 } /* Literal.String.Single */
 
+.highlight .ss { color: #4e9a06 } /* Literal.String.Symbol */
 
+.highlight .bp { color: #3465a4 } /* Name.Builtin.Pseudo */
 
+.highlight .fm { color: #000000 } /* Name.Function.Magic */
 
+.highlight .vc { color: #000000 } /* Name.Variable.Class */
 
+.highlight .vg { color: #000000 } /* Name.Variable.Global */
 
+.highlight .vi { color: #000000 } /* Name.Variable.Instance */
 
+.highlight .vm { color: #000000 } /* Name.Variable.Magic */
 
+.highlight .il { color: #990000 } /* Literal.Number.Integer.Long */

+ 37 - 316
python/_static/searchtools.js
查看文件 

@@ -1,331 +1,52 @@
 
 /*
 
- * searchtools.js_t
 
+ * searchtools.js
 
  * ~~~~~~~~~~~~~~~~
 
  *
 
  * Sphinx JavaScript utilities for the full-text search.
 
  *
 
- * :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS.
 
+ * :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS.
 
  * :license: BSD, see LICENSE for details.
 
  *
 
  */
 
 
-
 
-/* Non-minified version JS is _stemmer.js if file is provided */ 
-/**
 
- * Porter Stemmer
 
- */
 
-var Stemmer = function() {
 
-
 
-  var step2list = {
 
-    ational: 'ate',
 
-    tional: 'tion',
 
-    enci: 'ence',
 
-    anci: 'ance',
 
-    izer: 'ize',
 
-    bli: 'ble',
 
-    alli: 'al',
 
-    entli: 'ent',
 
-    eli: 'e',
 
-    ousli: 'ous',
 
-    ization: 'ize',
 
-    ation: 'ate',
 
-    ator: 'ate',
 
-    alism: 'al',
 
-    iveness: 'ive',
 
-    fulness: 'ful',
 
-    ousness: 'ous',
 
-    aliti: 'al',
 
-    iviti: 'ive',
 
-    biliti: 'ble',
 
-    logi: 'log'
 
-  };
 
-
 
-  var step3list = {
 
-    icate: 'ic',
 
-    ative: '',
 
-    alize: 'al',
 
-    iciti: 'ic',
 
-    ical: 'ic',
 
-    ful: '',
 
-    ness: ''
 
+if (!Scorer) {
 
+  /**
 
+   * Simple result scoring code.
 
+   */
 
+  var Scorer = {
 
+    // Implement the following function to further tweak the score for each result
 
+    // The function takes a result array [filename, title, anchor, descr, score]
 
+    // and returns the new score.
 
+    /*
 
+    score: function(result) {
 
+      return result[4];
 
+    },
 
+    */
 
+
 
+    // query matches the full name of an object
 
+    objNameMatch: 11,
 
+    // or matches in the last dotted part of the object name
 
+    objPartialMatch: 6,
 
+    // Additive scores depending on the priority of the object
 
+    objPrio: {0:  15,   // used to be importantResults
 
+              1:  5,   // used to be objectResults
 
+              2: -5},  // used to be unimportantResults
 
+    //  Used when the priority is not in the mapping.
 
+    objPrioDefault: 0,
 
+
 
+    // query found in title
 
+    title: 15,
 
+    // query found in terms
 
+    term: 5
 
   };
 
-
 
-  var c = "[^aeiou]";          // consonant
 
-  var v = "[aeiouy]";          // vowel
 
-  var C = c + "[^aeiouy]*";    // consonant sequence
 
-  var V = v + "[aeiou]*";      // vowel sequence
 
-
 
-  var mgr0 = "^(" + C + ")?" + V + C;                      // [C]VC... is m>0
 
-  var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$";    // [C]VC[V] is m=1
 
-  var mgr1 = "^(" + C + ")?" + V + C + V + C;              // [C]VCVC... is m>1
 
-  var s_v   = "^(" + C + ")?" + v;                         // vowel in stem
 
-
 
-  this.stemWord = function (w) {
 
-    var stem;
 
-    var suffix;
 
-    var firstch;
 
-    var origword = w;
 
-
 
-    if (w.length < 3)
 
-      return w;
 
-
 
-    var re;
 
-    var re2;
 
-    var re3;
 
-    var re4;
 
-
 
-    firstch = w.substr(0,1);
 
-    if (firstch == "y")
 
-      w = firstch.toUpperCase() + w.substr(1);
 
-
 
-    // Step 1a
 
-    re = /^(.+?)(ss|i)es$/;
 
-    re2 = /^(.+?)([^s])s$/;
 
-
 
-    if (re.test(w))
 
-      w = w.replace(re,"$1$2");
 
-    else if (re2.test(w))
 
-      w = w.replace(re2,"$1$2");
 
-
 
-    // Step 1b
 
-    re = /^(.+?)eed$/;
 
-    re2 = /^(.+?)(ed|ing)$/;
 
-    if (re.test(w)) {
 
-      var fp = re.exec(w);
 
-      re = new RegExp(mgr0);
 
-      if (re.test(fp[1])) {
 
-        re = /.$/;
 
-        w = w.replace(re,"");
 
-      }
 
-    }
 
-    else if (re2.test(w)) {
 
-      var fp = re2.exec(w);
 
-      stem = fp[1];
 
-      re2 = new RegExp(s_v);
 
-      if (re2.test(stem)) {
 
-        w = stem;
 
-        re2 = /(at|bl|iz)$/;
 
-        re3 = new RegExp("([^aeiouylsz])\\1$");
 
-        re4 = new RegExp("^" + C + v + "[^aeiouwxy]$");
 
-        if (re2.test(w))
 
-          w = w + "e";
 
-        else if (re3.test(w)) {
 
-          re = /.$/;
 
-          w = w.replace(re,"");
 
-        }
 
-        else if (re4.test(w))
 
-          w = w + "e";
 
-      }
 
-    }
 
-
 
-    // Step 1c
 
-    re = /^(.+?)y$/;
 
-    if (re.test(w)) {
 
-      var fp = re.exec(w);
 
-      stem = fp[1];
 
-      re = new RegExp(s_v);
 
-      if (re.test(stem))
 
-        w = stem + "i";
 
-    }
 
-
 
-    // Step 2
 
-    re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
 
-    if (re.test(w)) {
 
-      var fp = re.exec(w);
 
-      stem = fp[1];
 
-      suffix = fp[2];
 
-      re = new RegExp(mgr0);
 
-      if (re.test(stem))
 
-        w = stem + step2list[suffix];
 
-    }
 
-
 
-    // Step 3
 
-    re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
 
-    if (re.test(w)) {
 
-      var fp = re.exec(w);
 
-      stem = fp[1];
 
-      suffix = fp[2];
 
-      re = new RegExp(mgr0);
 
-      if (re.test(stem))
 
-        w = stem + step3list[suffix];
 
-    }
 
-
 
-    // Step 4
 
-    re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;
 
-    re2 = /^(.+?)(s|t)(ion)$/;
 
-    if (re.test(w)) {
 
-      var fp = re.exec(w);
 
-      stem = fp[1];
 
-      re = new RegExp(mgr1);
 
-      if (re.test(stem))
 
-        w = stem;
 
-    }
 
-    else if (re2.test(w)) {
 
-      var fp = re2.exec(w);
 
-      stem = fp[1] + fp[2];
 
-      re2 = new RegExp(mgr1);
 
-      if (re2.test(stem))
 
-        w = stem;
 
-    }
 
-
 
-    // Step 5
 
-    re = /^(.+?)e$/;
 
-    if (re.test(w)) {
 
-      var fp = re.exec(w);
 
-      stem = fp[1];
 
-      re = new RegExp(mgr1);
 
-      re2 = new RegExp(meq1);
 
-      re3 = new RegExp("^" + C + v + "[^aeiouwxy]$");
 
-      if (re.test(stem) || (re2.test(stem) && !(re3.test(stem))))
 
-        w = stem;
 
-    }
 
-    re = /ll$/;
 
-    re2 = new RegExp(mgr1);
 
-    if (re.test(w) && re2.test(w)) {
 
-      re = /.$/;
 
-      w = w.replace(re,"");
 
-    }
 
-
 
-    // and turn initial Y back to y
 
-    if (firstch == "y")
 
-      w = firstch.toLowerCase() + w.substr(1);
 
-    return w;
 
-  }
 
 }
 
 
-
 
-
 
-/**
 
- * Simple result scoring code.
 
- */
 
-var Scorer = {
 
-  // Implement the following function to further tweak the score for each result
 
-  // The function takes a result array [filename, title, anchor, descr, score]
 
-  // and returns the new score.
 
-  /*
 
-  score: function(result) {
 
-    return result[4];
 
-  },
 
-  */
 
-
 
-  // query matches the full name of an object
 
-  objNameMatch: 11,
 
-  // or matches in the last dotted part of the object name
 
-  objPartialMatch: 6,
 
-  // Additive scores depending on the priority of the object
 
-  objPrio: {0:  15,   // used to be importantResults
 
-            1:  5,   // used to be objectResults
 
-            2: -5},  // used to be unimportantResults
 
-  //  Used when the priority is not in the mapping.
 
-  objPrioDefault: 0,
 
-
 
-  // query found in title
 
-  title: 15,
 
-  // query found in terms
 
-  term: 5
 
-};
 
-
 
-
 
-
 
-
 
-
 
-var splitChars = (function() {
 
-    var result = {};
 
-    var singles = [96, 180, 187, 191, 215, 247, 749, 885, 903, 907, 909, 930, 1014, 1648,
 
-         1748, 1809, 2416, 2473, 2481, 2526, 2601, 2609, 2612, 2615, 2653, 2702,
 
-         2706, 2729, 2737, 2740, 2857, 2865, 2868, 2910, 2928, 2948, 2961, 2971,
 
-         2973, 3085, 3089, 3113, 3124, 3213, 3217, 3241, 3252, 3295, 3341, 3345,
 
-         3369, 3506, 3516, 3633, 3715, 3721, 3736, 3744, 3748, 3750, 3756, 3761,
 
-         3781, 3912, 4239, 4347, 4681, 4695, 4697, 4745, 4785, 4799, 4801, 4823,
 
-         4881, 5760, 5901, 5997, 6313, 7405, 8024, 8026, 8028, 8030, 8117, 8125,
 
-         8133, 8181, 8468, 8485, 8487, 8489, 8494, 8527, 11311, 11359, 11687, 11695,
 
-         11703, 11711, 11719, 11727, 11735, 12448, 12539, 43010, 43014, 43019, 43587,
 
-         43696, 43713, 64286, 64297, 64311, 64317, 64319, 64322, 64325, 65141];
 
-    var i, j, start, end;
 
-    for (i = 0; i < singles.length; i++) {
 
-        result[singles[i]] = true;
 
-    }
 
-    var ranges = [[0, 47], [58, 64], [91, 94], [123, 169], [171, 177], [182, 184], [706, 709],
 
-         [722, 735], [741, 747], [751, 879], [888, 889], [894, 901], [1154, 1161],
 
-         [1318, 1328], [1367, 1368], [1370, 1376], [1416, 1487], [1515, 1519], [1523, 1568],
 
-         [1611, 1631], [1642, 1645], [1750, 1764], [1767, 1773], [1789, 1790], [1792, 1807],
 
-         [1840, 1868], [1958, 1968], [1970, 1983], [2027, 2035], [2038, 2041], [2043, 2047],
 
-         [2070, 2073], [2075, 2083], [2085, 2087], [2089, 2307], [2362, 2364], [2366, 2383],
 
-         [2385, 2391], [2402, 2405], [2419, 2424], [2432, 2436], [2445, 2446], [2449, 2450],
 
-         [2483, 2485], [2490, 2492], [2494, 2509], [2511, 2523], [2530, 2533], [2546, 2547],
 
-         [2554, 2564], [2571, 2574], [2577, 2578], [2618, 2648], [2655, 2661], [2672, 2673],
 
-         [2677, 2692], [2746, 2748], [2750, 2767], [2769, 2783], [2786, 2789], [2800, 2820],
 
-         [2829, 2830], [2833, 2834], [2874, 2876], [2878, 2907], [2914, 2917], [2930, 2946],
 
-         [2955, 2957], [2966, 2968], [2976, 2978], [2981, 2983], [2987, 2989], [3002, 3023],
 
-         [3025, 3045], [3059, 3076], [3130, 3132], [3134, 3159], [3162, 3167], [3170, 3173],
 
-         [3184, 3191], [3199, 3204], [3258, 3260], [3262, 3293], [3298, 3301], [3312, 3332],
 
-         [3386, 3388], [3390, 3423], [3426, 3429], [3446, 3449], [3456, 3460], [3479, 3481],
 
-         [3518, 3519], [3527, 3584], [3636, 3647], [3655, 3663], [3674, 3712], [3717, 3718],
 
-         [3723, 3724], [3726, 3731], [3752, 3753], [3764, 3772], [3774, 3775], [3783, 3791],
 
-         [3802, 3803], [3806, 3839], [3841, 3871], [3892, 3903], [3949, 3975], [3980, 4095],
 
-         [4139, 4158], [4170, 4175], [4182, 4185], [4190, 4192], [4194, 4196], [4199, 4205],
 
-         [4209, 4212], [4226, 4237], [4250, 4255], [4294, 4303], [4349, 4351], [4686, 4687],
 
-         [4702, 4703], [4750, 4751], [4790, 4791], [4806, 4807], [4886, 4887], [4955, 4968],
 
-         [4989, 4991], [5008, 5023], [5109, 5120], [5741, 5742], [5787, 5791], [5867, 5869],
 
-         [5873, 5887], [5906, 5919], [5938, 5951], [5970, 5983], [6001, 6015], [6068, 6102],
 
-         [6104, 6107], [6109, 6111], [6122, 6127], [6138, 6159], [6170, 6175], [6264, 6271],
 
-         [6315, 6319], [6390, 6399], [6429, 6469], [6510, 6511], [6517, 6527], [6572, 6592],
 
-         [6600, 6607], [6619, 6655], [6679, 6687], [6741, 6783], [6794, 6799], [6810, 6822],
 
-         [6824, 6916], [6964, 6980], [6988, 6991], [7002, 7042], [7073, 7085], [7098, 7167],
 
-         [7204, 7231], [7242, 7244], [7294, 7400], [7410, 7423], [7616, 7679], [7958, 7959],
 
-         [7966, 7967], [8006, 8007], [8014, 8015], [8062, 8063], [8127, 8129], [8141, 8143],
 
-         [8148, 8149], [8156, 8159], [8173, 8177], [8189, 8303], [8306, 8307], [8314, 8318],
 
-         [8330, 8335], [8341, 8449], [8451, 8454], [8456, 8457], [8470, 8472], [8478, 8483],
 
-         [8506, 8507], [8512, 8516], [8522, 8525], [8586, 9311], [9372, 9449], [9472, 10101],
 
-         [10132, 11263], [11493, 11498], [11503, 11516], [11518, 11519], [11558, 11567],
 
-         [11622, 11630], [11632, 11647], [11671, 11679], [11743, 11822], [11824, 12292],
 
-         [12296, 12320], [12330, 12336], [12342, 12343], [12349, 12352], [12439, 12444],
 
-         [12544, 12548], [12590, 12592], [12687, 12689], [12694, 12703], [12728, 12783],
 
-         [12800, 12831], [12842, 12880], [12896, 12927], [12938, 12976], [12992, 13311],
 
-         [19894, 19967], [40908, 40959], [42125, 42191], [42238, 42239], [42509, 42511],
 
-         [42540, 42559], [42592, 42593], [42607, 42622], [42648, 42655], [42736, 42774],
 
-         [42784, 42785], [42889, 42890], [42893, 43002], [43043, 43055], [43062, 43071],
 
-         [43124, 43137], [43188, 43215], [43226, 43249], [43256, 43258], [43260, 43263],
 
-         [43302, 43311], [43335, 43359], [43389, 43395], [43443, 43470], [43482, 43519],
 
-         [43561, 43583], [43596, 43599], [43610, 43615], [43639, 43641], [43643, 43647],
 
-         [43698, 43700], [43703, 43704], [43710, 43711], [43715, 43738], [43742, 43967],
 
-         [44003, 44015], [44026, 44031], [55204, 55215], [55239, 55242], [55292, 55295],
 
-         [57344, 63743], [64046, 64047], [64110, 64111], [64218, 64255], [64263, 64274],
 
-         [64280, 64284], [64434, 64466], [64830, 64847], [64912, 64913], [64968, 65007],
 
-         [65020, 65135], [65277, 65295], [65306, 65312], [65339, 65344], [65371, 65381],
 
-         [65471, 65473], [65480, 65481], [65488, 65489], [65496, 65497]];
 
-    for (i = 0; i < ranges.length; i++) {
 
-        start = ranges[i][0];
 
-        end = ranges[i][1];
 
-        for (j = start; j <= end; j++) {
 
-            result[j] = true;
 
-        }
 
-    }
 
-    return result;
 
-})();
 
-
 
-function splitQuery(query) {
 
-    var result = [];
 
-    var start = -1;
 
-    for (var i = 0; i < query.length; i++) {
 
-        if (splitChars[query.charCodeAt(i)]) {
 
-            if (start !== -1) {
 
-                result.push(query.slice(start, i));
 
-                start = -1;
 
-            }
 
-        } else if (start === -1) {
 
-            start = i;
 
-        }
 
-    }
 
-    if (start !== -1) {
 
-        result.push(query.slice(start));
 
-    }
 
-    return result;
 
+if (!splitQuery) {
 
+  function splitQuery(query) {
 
+    return query.split(/\s+/);
 
+  }
 
 }
 
 
-
 
-
 
-
 
 /**
 
  * Search Module
 
  */
 
@@ -417,7 +138,7 @@ var Search = {
 
    */
 
   query : function(query) {
 
     var i;
 
-    var stopwords = ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"];
 
+    var stopwords = DOCUMENTATION_OPTIONS.SEARCH_LANGUAGE_STOP_WORDS;
 
 
     // stem the searchterms and add them to the correct list
 
     var stemmer = new Stemmer();
 
@@ -758,4 +479,4 @@ var Search = {
 
 
 $(document).ready(function() {
 
   Search.init();
 
-});
 
+});

+ 2 - 2
python/_static/websupport.js
查看文件 

@@ -4,7 +4,7 @@
 
  *
 
  * sphinx.websupport utilities for all documentation.
 
  *
 
- * :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS.
 
+ * :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS.
 
  * :license: BSD, see LICENSE for details.
 
  *
 
  */
 
@@ -301,7 +301,7 @@
 
     li.hide();
 
 
     // Determine where in the parents children list to insert this comment.
 
-    for(i=0; i < siblings.length; i++) {
 
+    for(var i=0; i < siblings.length; i++) {
 
       if (comp(comment, siblings[i]) <= 0) {
 
         $('#cd' + siblings[i].id)
 
           .parent()

+ 2374 - 0
python/api.html
查看文件 

@@ -0,0 +1,2374 @@
 
+
 
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
+
 
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
 
+  <head>
 
+    <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
 
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 
+    <title>API Reference &#8212; gRPC Python 1.17.0.dev0 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>
 
+    <script type="text/javascript" src="_static/jquery.js"></script>
 
+    <script type="text/javascript" src="_static/underscore.js"></script>
 
+    <script type="text/javascript" src="_static/doctools.js"></script>
 
+    <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
 
+    <link rel="index" title="Index" href="genindex.html" />
 
+    <link rel="search" title="Search" href="search.html" />
 
+    <link rel="next" title="gRPC Health Checking" href="grpc_health_checking.html" />
 
+    <link rel="prev" title="Welcome to gRPC Python’s documentation!" href="index.html" />
 
+   
+  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
 
+  
+  
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
 
+
 
+  </head><body>
 
+  <div class="document">
 
+    
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 
+        <div class="sphinxsidebarwrapper">
 
+<h1 class="logo"><a href="index.html">gRPC Python</a></h1>
 
+
 
+
 
+
 
+<p class="blurb">1.17.0.dev0</p>
 
+
 
+
 
+
 
+
 
+
 
+
 
+<h3>Navigation</h3>
 
+<p class="caption"><span class="caption-text">Contents:</span></p>
 
+<ul class="current">
 
+<li class="toctree-l1 current"><a class="current reference internal" href="#">API Reference</a><ul>
 
+<li class="toctree-l2"><a class="reference internal" href="#create-client">Create Client</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#create-client-credentials">Create Client Credentials</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#create-server">Create Server</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#create-server-credentials">Create Server Credentials</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#rpc-method-handlers">RPC Method Handlers</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#channel-ready-future">Channel Ready Future</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#channel-connectivity">Channel Connectivity</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#grpc-status-code">gRPC Status Code</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#channel-object">Channel Object</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#server-object">Server Object</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#authentication-authorization-objects">Authentication &amp; Authorization Objects</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#grpc-exceptions">gRPC Exceptions</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#shared-context">Shared Context</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#client-side-context">Client-Side Context</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#client-side-interceptor">Client-Side Interceptor</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#service-side-context">Service-Side Context</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#service-side-handler">Service-Side Handler</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#service-side-interceptor">Service-Side Interceptor</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#multi-callable">Multi-Callable</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#future">Future</a></li>
 
+</ul>
 
+</li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_health_checking.html">gRPC Health Checking</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_reflection.html">gRPC Reflection</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_testing.html">gRPC Testing</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary</a></li>
 
+</ul>
 
+
 
+<div class="relations">
 
+<h3>Related Topics</h3>
 
+<ul>
 
+  <li><a href="index.html">Documentation overview</a><ul>
 
+      <li>Previous: <a href="index.html" title="previous chapter">Welcome to gRPC Python’s documentation!</a></li>
 
+      <li>Next: <a href="grpc_health_checking.html" title="next chapter">gRPC Health Checking</a></li>
 
+  </ul></li>
 
+</ul>
 
+</div>
 
+<div id="searchbox" style="display: none" role="search">
 
+  <h3>Quick search</h3>
 
+    <div class="searchformwrapper">
 
+    <form class="search" action="search.html" method="get">
 
+      <input type="text" name="q" />
 
+      <input type="submit" value="Go" />
 
+      <input type="hidden" name="check_keywords" value="yes" />
 
+      <input type="hidden" name="area" value="default" />
 
+    </form>
 
+    </div>
 
+</div>
 
+<script type="text/javascript">$('#searchbox').show(0);</script>
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+        </div>
 
+      </div>
 
+      <div class="documentwrapper">
 
+        <div class="bodywrapper">
 
+          
+
 
+          <div class="body" role="main">
 
+            
+  <div class="section" id="module-grpc">
 
+<span id="api-reference"></span><h1>API Reference<a class="headerlink" href="#module-grpc" title="Permalink to this headline">¶</a></h1>
 
+<div class="section" id="create-client">
 
+<h2>Create Client<a class="headerlink" href="#create-client" title="Permalink to this headline">¶</a></h2>
 
+<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>
 
+<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">
 
+<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"><ul class="first simple">
 
+<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>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A Channel.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<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>
 
+<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">
 
+<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"><ul class="first simple">
 
+<li><strong>target</strong> – The server address.</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>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A Channel.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc.intercept_channel">
 
+<code class="descclassname">grpc.</code><code class="descname">intercept_channel</code><span class="sig-paren">(</span><em>channel</em>, <em>*interceptors</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#intercept_channel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.intercept_channel" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Intercepts a channel through a set of interceptors.</p>
 
+<p>This is an EXPERIMENTAL API.</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"><ul class="first simple">
 
+<li><strong>channel</strong> – A Channel.</li>
 
+<li><strong>interceptors</strong> – Zero or more objects of type
 
+UnaryUnaryClientInterceptor,
 
+UnaryStreamClientInterceptor,
 
+StreamUnaryClientInterceptor, or
 
+StreamStreamClientInterceptor.
 
+Interceptors are given control in the order they are listed.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">A Channel that intercepts each invocation via the provided interceptors.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last"><code class="xref py py-exc docutils literal notranslate"><span class="pre">TypeError</span></code> – If interceptor does not derive from any of
 
+UnaryUnaryClientInterceptor,
 
+UnaryStreamClientInterceptor,
 
+StreamUnaryClientInterceptor, or
 
+StreamStreamClientInterceptor.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="create-client-credentials">
 
+<h2>Create Client Credentials<a class="headerlink" href="#create-client-credentials" title="Permalink to this headline">¶</a></h2>
 
+<dl class="function">
 
+<dt id="grpc.ssl_channel_credentials">
 
+<code class="descclassname">grpc.</code><code class="descname">ssl_channel_credentials</code><span class="sig-paren">(</span><em>root_certificates=None</em>, <em>private_key=None</em>, <em>certificate_chain=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ssl_channel_credentials"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ssl_channel_credentials" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a ChannelCredentials for use with an SSL-enabled Channel.</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"><ul class="first simple">
 
+<li><strong>root_certificates</strong> – The PEM-encoded root certificates as a byte string,
 
+or None to retrieve them from a default location chosen by gRPC
 
+runtime.</li>
 
+<li><strong>private_key</strong> – The PEM-encoded private key as a byte string, or None if no
 
+private key should be used.</li>
 
+<li><strong>certificate_chain</strong> – The PEM-encoded certificate chain as a byte string
 
+to use or or None if no certificate chain should be used.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A ChannelCredentials for use with an SSL-enabled Channel.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc.metadata_call_credentials">
 
+<code class="descclassname">grpc.</code><code class="descname">metadata_call_credentials</code><span class="sig-paren">(</span><em>metadata_plugin</em>, <em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#metadata_call_credentials"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.metadata_call_credentials" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Construct CallCredentials from an AuthMetadataPlugin.</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"><ul class="first simple">
 
+<li><strong>metadata_plugin</strong> – An AuthMetadataPlugin to use for authentication.</li>
 
+<li><strong>name</strong> – An optional name for the plugin.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A CallCredentials.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc.access_token_call_credentials">
 
+<code class="descclassname">grpc.</code><code class="descname">access_token_call_credentials</code><span class="sig-paren">(</span><em>access_token</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#access_token_call_credentials"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.access_token_call_credentials" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Construct CallCredentials from an access token.</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>access_token</strong> – A string to place directly in the http request
 
+authorization header, for example
 
+“authorization: Bearer &lt;access_token&gt;”.</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">A CallCredentials.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc.composite_call_credentials">
 
+<code class="descclassname">grpc.</code><code class="descname">composite_call_credentials</code><span class="sig-paren">(</span><em>*call_credentials</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#composite_call_credentials"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.composite_call_credentials" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Compose multiple CallCredentials to make a new CallCredentials.</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>*call_credentials</strong> – At least two CallCredentials objects.</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">A CallCredentials object composed of the given CallCredentials objects.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc.composite_channel_credentials">
 
+<code class="descclassname">grpc.</code><code class="descname">composite_channel_credentials</code><span class="sig-paren">(</span><em>channel_credentials</em>, <em>*call_credentials</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#composite_channel_credentials"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.composite_channel_credentials" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Compose a ChannelCredentials and one or more CallCredentials objects.</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"><ul class="first simple">
 
+<li><strong>channel_credentials</strong> – A ChannelCredentials object.</li>
 
+<li><strong>*call_credentials</strong> – One or more CallCredentials objects.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
+<dt>A ChannelCredentials composed of the given ChannelCredentials and</dt>
 
+<dd><p class="first last">CallCredentials objects.</p>
 
+</dd>
 
+</dl>
 
+</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="create-server">
 
+<h2>Create Server<a class="headerlink" href="#create-server" title="Permalink to this headline">¶</a></h2>
 
+<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>
 
+<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" />
 
+<col class="field-body" />
 
+<tbody valign="top">
 
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
 
+<li><strong>thread_pool</strong> – A futures.ThreadPoolExecutor to be used by the Server
 
+to execute RPC handlers.</li>
 
+<li><strong>handlers</strong> – An optional list of GenericRpcHandlers used for executing RPCs.
 
+More handlers may be added by calling add_generic_rpc_handlers any time
 
+before the server is started.</li>
 
+<li><strong>interceptors</strong> – An optional list of ServerInterceptor objects that observe
 
+and optionally manipulate the incoming RPCs before handing them over to
 
+handlers. The interceptors are given control in the order they are
 
+specified. This is an EXPERIMENTAL API.</li>
 
+<li><strong>options</strong> – An optional list of key-value pairs (channel args in gRPC runtime)</li>
 
+<li><strong>configure the channel.</strong> (<em>to</em>) – </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>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A Server object.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="create-server-credentials">
 
+<h2>Create Server Credentials<a class="headerlink" href="#create-server-credentials" title="Permalink to this headline">¶</a></h2>
 
+<dl class="function">
 
+<dt id="grpc.ssl_server_credentials">
 
+<code class="descclassname">grpc.</code><code class="descname">ssl_server_credentials</code><span class="sig-paren">(</span><em>private_key_certificate_chain_pairs</em>, <em>root_certificates=None</em>, <em>require_client_auth=False</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ssl_server_credentials"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ssl_server_credentials" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a ServerCredentials for use with an SSL-enabled Server.</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"><ul class="first simple">
 
+<li><strong>private_key_certificate_chain_pairs</strong> – A list of pairs of the form
 
+[PEM-encoded private key, PEM-encoded certificate chain].</li>
 
+<li><strong>root_certificates</strong> – An optional byte string of PEM-encoded client root
 
+certificates that the server will use to verify client authentication.
 
+If omitted, require_client_auth must also be False.</li>
 
+<li><strong>require_client_auth</strong> – A boolean indicating whether or not to require
 
+clients to be authenticated. May only be True if root_certificates
 
+is not None.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A ServerCredentials for use with an SSL-enabled Server. Typically, this
 
+object is an argument to add_secure_port() method during server setup.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc.ssl_server_certificate_configuration">
 
+<code class="descclassname">grpc.</code><code class="descname">ssl_server_certificate_configuration</code><span class="sig-paren">(</span><em>private_key_certificate_chain_pairs</em>, <em>root_certificates=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ssl_server_certificate_configuration"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ssl_server_certificate_configuration" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a ServerCertificateConfiguration for use with a Server.</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"><ul class="first simple">
 
+<li><strong>private_key_certificate_chain_pairs</strong> – A collection of pairs of
 
+the form [PEM-encoded private key, PEM-encoded certificate
 
+chain].</li>
 
+<li><strong>root_certificates</strong> – An optional byte string of PEM-encoded client root
 
+certificates that the server will use to verify client authentication.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
+<dt>A ServerCertificateConfiguration that can be returned in the certificate</dt>
 
+<dd><p class="first last">configuration fetching callback.</p>
 
+</dd>
 
+</dl>
 
+</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc.dynamic_ssl_server_credentials">
 
+<code class="descclassname">grpc.</code><code class="descname">dynamic_ssl_server_credentials</code><span class="sig-paren">(</span><em>initial_certificate_configuration</em>, <em>certificate_configuration_fetcher</em>, <em>require_client_authentication=False</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#dynamic_ssl_server_credentials"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.dynamic_ssl_server_credentials" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a ServerCredentials for use with an SSL-enabled Server.</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"><ul class="first simple">
 
+<li><strong>initial_certificate_configuration</strong> (<a class="reference internal" href="#grpc.ServerCertificateConfiguration" title="grpc.ServerCertificateConfiguration"><em>ServerCertificateConfiguration</em></a>) – The
 
+certificate configuration with which the server will be initialized.</li>
 
+<li><strong>certificate_configuration_fetcher</strong> (<em>callable</em>) – A callable that takes no
 
+arguments and should return a ServerCertificateConfiguration to
 
+replace the server’s current certificate, or None for no change
 
+(i.e., the server will continue its current certificate
 
+config). The library will call this callback on <em>every</em> new
 
+client connection before starting the TLS handshake with the
 
+client, thus allowing the user application to optionally
 
+return a new ServerCertificateConfiguration that the server will then
 
+use for the handshake.</li>
 
+<li><strong>require_client_authentication</strong> – A boolean indicating whether or not to
 
+require clients to be authenticated.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A ServerCredentials.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="rpc-method-handlers">
 
+<h2>RPC Method Handlers<a class="headerlink" href="#rpc-method-handlers" title="Permalink to this headline">¶</a></h2>
 
+<dl class="function">
 
+<dt id="grpc.unary_unary_rpc_method_handler">
 
+<code class="descclassname">grpc.</code><code class="descname">unary_unary_rpc_method_handler</code><span class="sig-paren">(</span><em>behavior</em>, <em>request_deserializer=None</em>, <em>response_serializer=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#unary_unary_rpc_method_handler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.unary_unary_rpc_method_handler" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates an RpcMethodHandler for a unary-unary RPC 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"><ul class="first simple">
 
+<li><strong>behavior</strong> – The implementation of an RPC that accepts one request
 
+and returns one response.</li>
 
+<li><strong>request_deserializer</strong> – An optional behavior for request deserialization.</li>
 
+<li><strong>response_serializer</strong> – An optional behavior for response serialization.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An RpcMethodHandler object that is typically used by grpc.Server.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc.unary_stream_rpc_method_handler">
 
+<code class="descclassname">grpc.</code><code class="descname">unary_stream_rpc_method_handler</code><span class="sig-paren">(</span><em>behavior</em>, <em>request_deserializer=None</em>, <em>response_serializer=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#unary_stream_rpc_method_handler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.unary_stream_rpc_method_handler" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates an RpcMethodHandler for a unary-stream RPC 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"><ul class="first simple">
 
+<li><strong>behavior</strong> – The implementation of an RPC that accepts one request
 
+and returns an iterator of response values.</li>
 
+<li><strong>request_deserializer</strong> – An optional behavior for request deserialization.</li>
 
+<li><strong>response_serializer</strong> – An optional behavior for response serialization.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An RpcMethodHandler object that is typically used by grpc.Server.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc.stream_unary_rpc_method_handler">
 
+<code class="descclassname">grpc.</code><code class="descname">stream_unary_rpc_method_handler</code><span class="sig-paren">(</span><em>behavior</em>, <em>request_deserializer=None</em>, <em>response_serializer=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#stream_unary_rpc_method_handler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.stream_unary_rpc_method_handler" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates an RpcMethodHandler for a stream-unary RPC 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"><ul class="first simple">
 
+<li><strong>behavior</strong> – The implementation of an RPC that accepts an iterator of
 
+request values and returns a single response value.</li>
 
+<li><strong>request_deserializer</strong> – An optional behavior for request deserialization.</li>
 
+<li><strong>response_serializer</strong> – An optional behavior for response serialization.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An RpcMethodHandler object that is typically used by grpc.Server.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc.stream_stream_rpc_method_handler">
 
+<code class="descclassname">grpc.</code><code class="descname">stream_stream_rpc_method_handler</code><span class="sig-paren">(</span><em>behavior</em>, <em>request_deserializer=None</em>, <em>response_serializer=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#stream_stream_rpc_method_handler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.stream_stream_rpc_method_handler" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates an RpcMethodHandler for a stream-stream RPC 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"><ul class="first simple">
 
+<li><strong>behavior</strong> – The implementation of an RPC that accepts an iterator of
 
+request values and returns an iterator of response values.</li>
 
+<li><strong>request_deserializer</strong> – An optional behavior for request deserialization.</li>
 
+<li><strong>response_serializer</strong> – An optional behavior for response serialization.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An RpcMethodHandler object that is typically used by grpc.Server.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc.method_handlers_generic_handler">
 
+<code class="descclassname">grpc.</code><code class="descname">method_handlers_generic_handler</code><span class="sig-paren">(</span><em>service</em>, <em>method_handlers</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#method_handlers_generic_handler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.method_handlers_generic_handler" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a GenericRpcHandler from RpcMethodHandlers.</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"><ul class="first simple">
 
+<li><strong>service</strong> – The name of the service that is implemented by the
 
+method_handlers.</li>
 
+<li><strong>method_handlers</strong> – A dictionary that maps method names to corresponding
 
+RpcMethodHandler.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A GenericRpcHandler. This is typically added to the grpc.Server object
 
+with add_generic_rpc_handlers() before starting the server.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="channel-ready-future">
 
+<h2>Channel Ready Future<a class="headerlink" href="#channel-ready-future" title="Permalink to this headline">¶</a></h2>
 
+<dl class="function">
 
+<dt id="grpc.channel_ready_future">
 
+<code class="descclassname">grpc.</code><code class="descname">channel_ready_future</code><span class="sig-paren">(</span><em>channel</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#channel_ready_future"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.channel_ready_future" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a Future that tracks when a Channel is ready.</p>
 
+<p>Cancelling the Future does not affect the channel’s state machine.
 
+It merely decouples the Future from channel state machine.</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>channel</strong> – A Channel object.</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">A Future object that matures when the channel connectivity is
 
+ChannelConnectivity.READY.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="channel-connectivity">
 
+<h2>Channel Connectivity<a class="headerlink" href="#channel-connectivity" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc.ChannelConnectivity">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">ChannelConnectivity</code><a class="reference internal" href="_modules/grpc.html#ChannelConnectivity"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ChannelConnectivity" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Mirrors grpc_connectivity_state in the gRPC Core.</p>
 
+<dl class="attribute">
 
+<dt id="grpc.ChannelConnectivity.IDLE">
 
+<code class="descname">IDLE</code><a class="headerlink" href="#grpc.ChannelConnectivity.IDLE" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The channel is idle.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.ChannelConnectivity.CONNECTING">
 
+<code class="descname">CONNECTING</code><a class="headerlink" href="#grpc.ChannelConnectivity.CONNECTING" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The channel is connecting.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.ChannelConnectivity.READY">
 
+<code class="descname">READY</code><a class="headerlink" href="#grpc.ChannelConnectivity.READY" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The channel is ready to conduct RPCs.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.ChannelConnectivity.TRANSIENT_FAILURE">
 
+<code class="descname">TRANSIENT_FAILURE</code><a class="headerlink" href="#grpc.ChannelConnectivity.TRANSIENT_FAILURE" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The channel has seen a failure from which it expects
 
+to recover.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.ChannelConnectivity.SHUTDOWN">
 
+<code class="descname">SHUTDOWN</code><a class="headerlink" href="#grpc.ChannelConnectivity.SHUTDOWN" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The channel has seen a failure from which it cannot recover.</p>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="grpc-status-code">
 
+<h2>gRPC Status Code<a class="headerlink" href="#grpc-status-code" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc.StatusCode">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">StatusCode</code><a class="reference internal" href="_modules/grpc.html#StatusCode"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StatusCode" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Mirrors grpc_status_code in the gRPC Core.</p>
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.OK">
 
+<code class="descname">OK</code><a class="headerlink" href="#grpc.StatusCode.OK" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Not an error; returned on success</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.CANCELLED">
 
+<code class="descname">CANCELLED</code><a class="headerlink" href="#grpc.StatusCode.CANCELLED" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The operation was cancelled (typically by the caller).</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.UNKNOWN">
 
+<code class="descname">UNKNOWN</code><a class="headerlink" href="#grpc.StatusCode.UNKNOWN" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Unknown error.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.INVALID_ARGUMENT">
 
+<code class="descname">INVALID_ARGUMENT</code><a class="headerlink" href="#grpc.StatusCode.INVALID_ARGUMENT" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Client specified an invalid argument.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.DEADLINE_EXCEEDED">
 
+<code class="descname">DEADLINE_EXCEEDED</code><a class="headerlink" href="#grpc.StatusCode.DEADLINE_EXCEEDED" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Deadline expired before operation could complete.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.NOT_FOUND">
 
+<code class="descname">NOT_FOUND</code><a class="headerlink" href="#grpc.StatusCode.NOT_FOUND" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Some requested entity (e.g., file or directory) was not found.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.ALREADY_EXISTS">
 
+<code class="descname">ALREADY_EXISTS</code><a class="headerlink" href="#grpc.StatusCode.ALREADY_EXISTS" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Some entity that we attempted to create (e.g., file or directory)
 
+already exists.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.PERMISSION_DENIED">
 
+<code class="descname">PERMISSION_DENIED</code><a class="headerlink" href="#grpc.StatusCode.PERMISSION_DENIED" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The caller does not have permission to execute the specified
 
+operation.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.UNAUTHENTICATED">
 
+<code class="descname">UNAUTHENTICATED</code><a class="headerlink" href="#grpc.StatusCode.UNAUTHENTICATED" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The request does not have valid authentication credentials for the
 
+operation.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.RESOURCE_EXHAUSTED">
 
+<code class="descname">RESOURCE_EXHAUSTED</code><a class="headerlink" href="#grpc.StatusCode.RESOURCE_EXHAUSTED" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Some resource has been exhausted, perhaps a per-user quota, or
 
+perhaps the entire file system is out of space.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.FAILED_PRECONDITION">
 
+<code class="descname">FAILED_PRECONDITION</code><a class="headerlink" href="#grpc.StatusCode.FAILED_PRECONDITION" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Operation was rejected because the system is not in a state
 
+required for the operation’s execution.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.ABORTED">
 
+<code class="descname">ABORTED</code><a class="headerlink" href="#grpc.StatusCode.ABORTED" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The operation was aborted, typically due to a concurrency issue
 
+like sequencer check failures, transaction aborts, etc.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.UNIMPLEMENTED">
 
+<code class="descname">UNIMPLEMENTED</code><a class="headerlink" href="#grpc.StatusCode.UNIMPLEMENTED" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Operation is not implemented or not supported/enabled in this service.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.INTERNAL">
 
+<code class="descname">INTERNAL</code><a class="headerlink" href="#grpc.StatusCode.INTERNAL" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Internal errors.  Means some invariants expected by underlying
 
+system has been broken.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.UNAVAILABLE">
 
+<code class="descname">UNAVAILABLE</code><a class="headerlink" href="#grpc.StatusCode.UNAVAILABLE" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The service is currently unavailable.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.StatusCode.DATA_LOSS">
 
+<code class="descname">DATA_LOSS</code><a class="headerlink" href="#grpc.StatusCode.DATA_LOSS" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Unrecoverable data loss or corruption.</p>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="channel-object">
 
+<h2>Channel Object<a class="headerlink" href="#channel-object" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc.Channel">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">Channel</code><a class="reference internal" href="_modules/grpc.html#Channel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Channel" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Affords RPC invocation via generic methods on client-side.</p>
 
+<p>Channel objects implement the Context Manager type, although they need not
 
+support being entered and exited multiple times.</p>
 
+<dl class="method">
 
+<dt id="grpc.Channel.close">
 
+<code class="descname">close</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Channel.close"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Channel.close" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Closes this Channel and releases all resources held by it.</p>
 
+<p>Closing the Channel will immediately terminate all RPCs active with the
 
+Channel and it is not valid to invoke new RPCs with the Channel.</p>
 
+<p>This method is idempotent.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Channel.stream_stream">
 
+<code class="descname">stream_stream</code><span class="sig-paren">(</span><em>method</em>, <em>request_serializer=None</em>, <em>response_deserializer=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Channel.stream_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Channel.stream_stream" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a StreamStreamMultiCallable for a stream-stream 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"><ul class="first simple">
 
+<li><strong>method</strong> – The name of the RPC method.</li>
 
+<li><strong>request_serializer</strong> – Optional behaviour for serializing the request
 
+message. Request goes unserialized in case None is passed.</li>
 
+<li><strong>response_deserializer</strong> – Optional behaviour for deserializing the
 
+response message. Response goes undeserialized in case None
 
+is passed.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A StreamStreamMultiCallable value for the named stream-stream method.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Channel.stream_unary">
 
+<code class="descname">stream_unary</code><span class="sig-paren">(</span><em>method</em>, <em>request_serializer=None</em>, <em>response_deserializer=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Channel.stream_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Channel.stream_unary" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a StreamUnaryMultiCallable for a stream-unary 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"><ul class="first simple">
 
+<li><strong>method</strong> – The name of the RPC method.</li>
 
+<li><strong>request_serializer</strong> – Optional behaviour for serializing the request
 
+message. Request goes unserialized in case None is passed.</li>
 
+<li><strong>response_deserializer</strong> – Optional behaviour for deserializing the
 
+response message. Response goes undeserialized in case None is
 
+passed.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A StreamUnaryMultiCallable value for the named stream-unary method.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Channel.subscribe">
 
+<code class="descname">subscribe</code><span class="sig-paren">(</span><em>callback</em>, <em>try_to_connect=False</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Channel.subscribe"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Channel.subscribe" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Subscribe to this Channel’s connectivity state machine.</p>
 
+<p>A Channel may be in any of the states described by ChannelConnectivity.
 
+This method allows application to monitor the state transitions.
 
+The typical use case is to debug or gain better visibility into gRPC
 
+runtime’s state.</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"><ul class="first last simple">
 
+<li><strong>callback</strong> – A callable to be invoked with ChannelConnectivity argument.
 
+ChannelConnectivity describes current state of the channel.
 
+The callable will be invoked immediately upon subscription
 
+and again for every change to ChannelConnectivity until it
 
+is unsubscribed or this Channel object goes out of scope.</li>
 
+<li><strong>try_to_connect</strong> – A boolean indicating whether or not this Channel
 
+should attempt to connect immediately. If set to False, gRPC
 
+runtime decides when to connect.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Channel.unary_stream">
 
+<code class="descname">unary_stream</code><span class="sig-paren">(</span><em>method</em>, <em>request_serializer=None</em>, <em>response_deserializer=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Channel.unary_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Channel.unary_stream" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a UnaryStreamMultiCallable for a unary-stream 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"><ul class="first simple">
 
+<li><strong>method</strong> – The name of the RPC method.</li>
 
+<li><strong>request_serializer</strong> – Optional behaviour for serializing the request
 
+message. Request goes unserialized in case None is passed.</li>
 
+<li><strong>response_deserializer</strong> – Optional behaviour for deserializing the
 
+response message. Response goes undeserialized in case None is
 
+passed.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A UnaryStreamMultiCallable value for the name unary-stream method.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Channel.unary_unary">
 
+<code class="descname">unary_unary</code><span class="sig-paren">(</span><em>method</em>, <em>request_serializer=None</em>, <em>response_deserializer=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Channel.unary_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Channel.unary_unary" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a UnaryUnaryMultiCallable for a unary-unary 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"><ul class="first simple">
 
+<li><strong>method</strong> – The name of the RPC method.</li>
 
+<li><strong>request_serializer</strong> – Optional behaviour for serializing the request
 
+message. Request goes unserialized in case None is passed.</li>
 
+<li><strong>response_deserializer</strong> – Optional behaviour for deserializing the
 
+response message. Response goes undeserialized in case None
 
+is passed.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A UnaryUnaryMultiCallable value for the named unary-unary method.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Channel.unsubscribe">
 
+<code class="descname">unsubscribe</code><span class="sig-paren">(</span><em>callback</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Channel.unsubscribe"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Channel.unsubscribe" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Unsubscribes a subscribed callback from this Channel’s connectivity.</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"><ul class="first last simple">
 
+<li><strong>callback</strong> – A callable previously registered with this Channel from</li>
 
+<li><strong>been passed to its &quot;subscribe&quot; method.</strong> (<em>having</em>) – </li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="server-object">
 
+<h2>Server Object<a class="headerlink" href="#server-object" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc.Server">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">Server</code><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>Services RPCs.</p>
 
+<dl class="method">
 
+<dt id="grpc.Server.add_generic_rpc_handlers">
 
+<code class="descname">add_generic_rpc_handlers</code><span class="sig-paren">(</span><em>generic_rpc_handlers</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Server.add_generic_rpc_handlers"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Server.add_generic_rpc_handlers" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Registers GenericRpcHandlers with this Server.</p>
 
+<p>This method is only safe to call before the server is started.</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"><ul class="first last simple">
 
+<li><strong>generic_rpc_handlers</strong> – An iterable of GenericRpcHandlers that will be</li>
 
+<li><strong>to service RPCs.</strong> (<em>used</em>) – </li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Server.add_insecure_port">
 
+<code class="descname">add_insecure_port</code><span class="sig-paren">(</span><em>address</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Server.add_insecure_port"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Server.add_insecure_port" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Opens an insecure port for accepting RPCs.</p>
 
+<p>This method may only be called before starting the server.</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"><ul class="first simple">
 
+<li><strong>address</strong> – The address for which to open a port.</li>
 
+<li><strong>the port is 0</strong><strong>, or </strong><strong>not specified in the address</strong><strong>, </strong><strong>then gRPC runtime</strong> (<em>if</em>) – </li>
 
+<li><strong>choose a port.</strong> (<em>will</em>) – </li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">An integer port on which server will accept RPC requests.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last">integer</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Server.add_secure_port">
 
+<code class="descname">add_secure_port</code><span class="sig-paren">(</span><em>address</em>, <em>server_credentials</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Server.add_secure_port"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Server.add_secure_port" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Opens a secure port for accepting RPCs.</p>
 
+<p>This method may only be called before starting the server.</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"><ul class="first simple">
 
+<li><strong>address</strong> – The address for which to open a port.
 
+if the port is 0, or not specified in the address, then gRPC
 
+runtime will choose a port.</li>
 
+<li><strong>server_credentials</strong> – A ServerCredentials object.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">An integer port on which server will accept RPC requests.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><p class="first last">integer</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Server.start">
 
+<code class="descname">start</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Server.start"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Server.start" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Starts this Server.</p>
 
+<p>This method may only be called once. (i.e. it is not idempotent).</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Server.stop">
 
+<code class="descname">stop</code><span class="sig-paren">(</span><em>grace</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Server.stop"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Server.stop" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Stops this Server.</p>
 
+<p>This method immediately stop service of new RPCs in all cases.</p>
 
+<p>If a grace period is specified, this method returns immediately
 
+and all RPCs active at the end of the grace period are aborted.
 
+If a grace period is not specified (by passing None for <cite>grace</cite>),
 
+all existing RPCs are aborted immediately and this method
 
+blocks until the last RPC handler terminates.</p>
 
+<p>This method is idempotent and may be called at any time.
 
+Passing a smaller grace value in a subsequent call will have
 
+the effect of stopping the Server sooner (passing None will
 
+have the effect of stopping the server immediately). Passing
 
+a larger grace value in a subsequent call <em>will not</em> have the
 
+effect of stopping the server later (i.e. the most restrictive
 
+grace value is used).</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>grace</strong> – A duration of time in seconds or None.</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">A threading.Event that will be set when this Server has completely
 
+stopped, i.e. when running RPCs either complete or are aborted and
 
+all handlers have terminated.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="authentication-authorization-objects">
 
+<h2>Authentication &amp; Authorization Objects<a class="headerlink" href="#authentication-authorization-objects" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc.ChannelCredentials">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">ChannelCredentials</code><span class="sig-paren">(</span><em>credentials</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ChannelCredentials"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ChannelCredentials" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>An encapsulation of the data required to create a secure Channel.</p>
 
+<p>This class has no supported interface - it exists to define the type of its
 
+instances and its instances exist to be passed to other functions. For
 
+example, ssl_channel_credentials returns an instance of this class and
 
+secure_channel requires an instance of this class.</p>
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.CallCredentials">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">CallCredentials</code><span class="sig-paren">(</span><em>credentials</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#CallCredentials"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.CallCredentials" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>An encapsulation of the data required to assert an identity over a call.</p>
 
+<p>A CallCredentials may be composed with ChannelCredentials to always assert
 
+identity for every call over that Channel.</p>
 
+<p>This class has no supported interface - it exists to define the type of its
 
+instances and its instances exist to be passed to other functions.</p>
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.AuthMetadataContext">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">AuthMetadataContext</code><a class="reference internal" href="_modules/grpc.html#AuthMetadataContext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.AuthMetadataContext" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Provides information to call credentials metadata plugins.</p>
 
+<dl class="attribute">
 
+<dt id="grpc.AuthMetadataContext.service_url">
 
+<code class="descname">service_url</code><a class="headerlink" href="#grpc.AuthMetadataContext.service_url" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>A string URL of the service being called into.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.AuthMetadataContext.method_name">
 
+<code class="descname">method_name</code><a class="headerlink" href="#grpc.AuthMetadataContext.method_name" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>A string of the fully qualified method name being called.</p>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.AuthMetadataPluginCallback">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">AuthMetadataPluginCallback</code><a class="reference internal" href="_modules/grpc.html#AuthMetadataPluginCallback"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.AuthMetadataPluginCallback" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Callback object received by a metadata plugin.</p>
 
+<dl class="method">
 
+<dt id="grpc.AuthMetadataPluginCallback.__call__">
 
+<code class="descname">__call__</code><span class="sig-paren">(</span><em>metadata</em>, <em>error</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#AuthMetadataPluginCallback.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.AuthMetadataPluginCallback.__call__" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Passes to the gRPC runtime authentication metadata for an RPC.</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"><ul class="first last simple">
 
+<li><strong>metadata</strong> – The <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a> used to construct the CallCredentials.</li>
 
+<li><strong>error</strong> – An Exception to indicate error or None to indicate success.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.AuthMetadataPlugin">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">AuthMetadataPlugin</code><a class="reference internal" href="_modules/grpc.html#AuthMetadataPlugin"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.AuthMetadataPlugin" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>A specification for custom authentication.</p>
 
+<dl class="method">
 
+<dt id="grpc.AuthMetadataPlugin.__call__">
 
+<code class="descname">__call__</code><span class="sig-paren">(</span><em>context</em>, <em>callback</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#AuthMetadataPlugin.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.AuthMetadataPlugin.__call__" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Implements authentication by passing metadata to a callback.</p>
 
+<p>Implementations of this method must not block.</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"><ul class="first last simple">
 
+<li><strong>context</strong> – An AuthMetadataContext providing information on the RPC that
 
+the plugin is being called to authenticate.</li>
 
+<li><strong>callback</strong> – An AuthMetadataPluginCallback to be invoked either
 
+synchronously or asynchronously.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.ServerCredentials">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">ServerCredentials</code><span class="sig-paren">(</span><em>credentials</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServerCredentials"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServerCredentials" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>An encapsulation of the data required to open a secure port on a Server.</p>
 
+<p>This class has no supported interface - it exists to define the type of its
 
+instances and its instances exist to be passed to other functions.</p>
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.ServerCertificateConfiguration">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">ServerCertificateConfiguration</code><span class="sig-paren">(</span><em>certificate_configuration</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServerCertificateConfiguration"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServerCertificateConfiguration" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>A certificate configuration for use with an SSL-enabled Server.</p>
 
+<p>Instances of this class can be returned in the certificate configuration
 
+fetching callback.</p>
 
+<p>This class has no supported interface – it exists to define the
 
+type of its instances and its instances exist to be passed to
 
+other functions.</p>
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="grpc-exceptions">
 
+<h2>gRPC Exceptions<a class="headerlink" href="#grpc-exceptions" title="Permalink to this headline">¶</a></h2>
 
+<dl class="exception">
 
+<dt id="grpc.RpcError">
 
+<em class="property">exception </em><code class="descclassname">grpc.</code><code class="descname">RpcError</code><a class="reference internal" href="_modules/grpc.html#RpcError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.RpcError" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Raised by the gRPC library to indicate non-OK-status RPC termination.</p>
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="shared-context">
 
+<h2>Shared Context<a class="headerlink" href="#shared-context" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc.RpcContext">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">RpcContext</code><a class="reference internal" href="_modules/grpc.html#RpcContext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.RpcContext" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Provides RPC-related information and action.</p>
 
+<dl class="method">
 
+<dt id="grpc.RpcContext.add_callback">
 
+<code class="descname">add_callback</code><span class="sig-paren">(</span><em>callback</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#RpcContext.add_callback"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.RpcContext.add_callback" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Registers a callback to be called on RPC termination.</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>callback</strong> – A no-parameter callable to be called on RPC termination.</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">True if the callback was added and will be called later; False if
 
+the callback was not added and will not be called (because the RPC
 
+already terminated or some other reason).</td>
 
+</tr>
 
+<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body">bool</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.RpcContext.cancel">
 
+<code class="descname">cancel</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#RpcContext.cancel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.RpcContext.cancel" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Cancels the RPC.</p>
 
+<p>Idempotent and has no effect if the RPC has already terminated.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.RpcContext.is_active">
 
+<code class="descname">is_active</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#RpcContext.is_active"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.RpcContext.is_active" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Describes whether the RPC is active or has terminated.</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">Returns:</th><td class="field-body">True if RPC is active, False otherwise.</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body">bool</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.RpcContext.time_remaining">
 
+<code class="descname">time_remaining</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#RpcContext.time_remaining"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.RpcContext.time_remaining" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Describes the length of allowed time remaining for the RPC.</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">Returns:</th><td class="field-body">A nonnegative float indicating the length of allowed time in seconds
 
+remaining for the RPC to complete before it is considered to have
 
+timed out, or None if no deadline was specified for the RPC.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="client-side-context">
 
+<h2>Client-Side Context<a class="headerlink" href="#client-side-context" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc.Call">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">Call</code><a class="reference internal" href="_modules/grpc.html#Call"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Call" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Invocation-side utility object for an RPC.</p>
 
+<dl class="method">
 
+<dt id="grpc.Call.code">
 
+<code class="descname">code</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Call.code"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Call.code" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Accesses the status code sent by the server.</p>
 
+<p>This method blocks until the value is available.</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">Returns:</th><td class="field-body">The StatusCode value for the RPC.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Call.details">
 
+<code class="descname">details</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Call.details"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Call.details" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Accesses the details sent by the server.</p>
 
+<p>This method blocks until the value is available.</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">Returns:</th><td class="field-body">The details string of the RPC.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Call.initial_metadata">
 
+<code class="descname">initial_metadata</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Call.initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Call.initial_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Accesses the initial metadata sent by the server.</p>
 
+<p>This method blocks until the value is available.</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">Returns:</th><td class="field-body">The initial <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a>.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Call.trailing_metadata">
 
+<code class="descname">trailing_metadata</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Call.trailing_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Call.trailing_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Accesses the trailing metadata sent by the server.</p>
 
+<p>This method blocks until the value is available.</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">Returns:</th><td class="field-body">The trailing <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a>.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="client-side-interceptor">
 
+<h2>Client-Side Interceptor<a class="headerlink" href="#client-side-interceptor" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc.ClientCallDetails">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">ClientCallDetails</code><a class="reference internal" href="_modules/grpc.html#ClientCallDetails"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ClientCallDetails" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Describes an RPC to be invoked.</p>
 
+<p>This is an EXPERIMENTAL API.</p>
 
+<dl class="attribute">
 
+<dt id="grpc.ClientCallDetails.method">
 
+<code class="descname">method</code><a class="headerlink" href="#grpc.ClientCallDetails.method" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The method name of the RPC.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.ClientCallDetails.timeout">
 
+<code class="descname">timeout</code><a class="headerlink" href="#grpc.ClientCallDetails.timeout" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>An optional duration of time in seconds to allow for the RPC.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.ClientCallDetails.metadata">
 
+<code class="descname">metadata</code><a class="headerlink" href="#grpc.ClientCallDetails.metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Optional <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a> to be transmitted to
 
+the service-side of the RPC.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.ClientCallDetails.credentials">
 
+<code class="descname">credentials</code><a class="headerlink" href="#grpc.ClientCallDetails.credentials" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>An optional CallCredentials for the RPC.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.ClientCallDetails.wait_for_ready">
 
+<code class="descname">wait_for_ready</code><a class="headerlink" href="#grpc.ClientCallDetails.wait_for_ready" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>An optional flag to enable wait for ready mechanism.</p>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.UnaryUnaryClientInterceptor">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">UnaryUnaryClientInterceptor</code><a class="reference internal" href="_modules/grpc.html#UnaryUnaryClientInterceptor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryUnaryClientInterceptor" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Affords intercepting unary-unary invocations.</p>
 
+<p>This is an EXPERIMENTAL API.</p>
 
+<dl class="method">
 
+<dt id="grpc.UnaryUnaryClientInterceptor.intercept_unary_unary">
 
+<code class="descname">intercept_unary_unary</code><span class="sig-paren">(</span><em>continuation</em>, <em>client_call_details</em>, <em>request</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#UnaryUnaryClientInterceptor.intercept_unary_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryUnaryClientInterceptor.intercept_unary_unary" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Intercepts a unary-unary invocation asynchronously.</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"><ul class="first simple">
 
+<li><strong>continuation</strong> – A function that proceeds with the invocation by
 
+executing the next interceptor in chain or invoking the
 
+actual RPC on the underlying Channel. It is the interceptor’s
 
+responsibility to call it if it decides to move the RPC forward.
 
+The interceptor can use
 
+<cite>response_future = continuation(client_call_details, request)</cite>
 
+to continue with the RPC. <cite>continuation</cite> returns an object that is
 
+both a Call for the RPC and a Future. In the event of RPC
 
+completion, the return Call-Future’s result value will be
 
+the response message of the RPC. Should the event terminate
 
+with non-OK status, the returned Call-Future’s exception value
 
+will be an RpcError.</li>
 
+<li><strong>client_call_details</strong> – A ClientCallDetails object describing the
 
+outgoing RPC.</li>
 
+<li><strong>request</strong> – The request value for the RPC.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An object that is both a Call for the RPC and a Future.
 
+In the event of RPC completion, the return Call-Future’s
 
+result value will be the response message of the RPC.
 
+Should the event terminate with non-OK status, the returned
 
+Call-Future’s exception value will be an RpcError.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.UnaryStreamClientInterceptor">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">UnaryStreamClientInterceptor</code><a class="reference internal" href="_modules/grpc.html#UnaryStreamClientInterceptor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryStreamClientInterceptor" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Affords intercepting unary-stream invocations.</p>
 
+<p>This is an EXPERIMENTAL API.</p>
 
+<dl class="method">
 
+<dt id="grpc.UnaryStreamClientInterceptor.intercept_unary_stream">
 
+<code class="descname">intercept_unary_stream</code><span class="sig-paren">(</span><em>continuation</em>, <em>client_call_details</em>, <em>request</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#UnaryStreamClientInterceptor.intercept_unary_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryStreamClientInterceptor.intercept_unary_stream" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Intercepts a unary-stream invocation.</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"><ul class="first simple">
 
+<li><strong>continuation</strong> – A function that proceeds with the invocation by
 
+executing the next interceptor in chain or invoking the
 
+actual RPC on the underlying Channel. It is the interceptor’s
 
+responsibility to call it if it decides to move the RPC forward.
 
+The interceptor can use
 
+<cite>response_iterator = continuation(client_call_details, request)</cite>
 
+to continue with the RPC. <cite>continuation</cite> returns an object that is
 
+both a Call for the RPC and an iterator for response values.
 
+Drawing response values from the returned Call-iterator may
 
+raise RpcError indicating termination of the RPC with non-OK
 
+status.</li>
 
+<li><strong>client_call_details</strong> – A ClientCallDetails object describing the
 
+outgoing RPC.</li>
 
+<li><strong>request</strong> – The request value for the RPC.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An object that is both a Call for the RPC and an iterator of
 
+response values. Drawing response values from the returned
 
+Call-iterator may raise RpcError indicating termination of
 
+the RPC with non-OK status.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.StreamUnaryClientInterceptor">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">StreamUnaryClientInterceptor</code><a class="reference internal" href="_modules/grpc.html#StreamUnaryClientInterceptor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamUnaryClientInterceptor" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Affords intercepting stream-unary invocations.</p>
 
+<p>This is an EXPERIMENTAL API.</p>
 
+<dl class="method">
 
+<dt id="grpc.StreamUnaryClientInterceptor.intercept_stream_unary">
 
+<code class="descname">intercept_stream_unary</code><span class="sig-paren">(</span><em>continuation</em>, <em>client_call_details</em>, <em>request_iterator</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#StreamUnaryClientInterceptor.intercept_stream_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamUnaryClientInterceptor.intercept_stream_unary" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Intercepts a stream-unary invocation asynchronously.</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"><ul class="first simple">
 
+<li><strong>continuation</strong> – A function that proceeds with the invocation by
 
+executing the next interceptor in chain or invoking the
 
+actual RPC on the underlying Channel. It is the interceptor’s
 
+responsibility to call it if it decides to move the RPC forward.
 
+The interceptor can use
 
+<cite>response_future = continuation(client_call_details, request_iterator)</cite>
 
+to continue with the RPC. <cite>continuation</cite> returns an object that is
 
+both a Call for the RPC and a Future. In the event of RPC completion,
 
+the return Call-Future’s result value will be the response message
 
+of the RPC. Should the event terminate with non-OK status, the
 
+returned Call-Future’s exception value will be an RpcError.</li>
 
+<li><strong>client_call_details</strong> – A ClientCallDetails object describing the
 
+outgoing RPC.</li>
 
+<li><strong>request_iterator</strong> – An iterator that yields request values for the RPC.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An object that is both a Call for the RPC and a Future.
 
+In the event of RPC completion, the return Call-Future’s
 
+result value will be the response message of the RPC.
 
+Should the event terminate with non-OK status, the returned
 
+Call-Future’s exception value will be an RpcError.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.StreamStreamClientInterceptor">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">StreamStreamClientInterceptor</code><a class="reference internal" href="_modules/grpc.html#StreamStreamClientInterceptor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamStreamClientInterceptor" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Affords intercepting stream-stream invocations.</p>
 
+<p>This is an EXPERIMENTAL API.</p>
 
+<dl class="method">
 
+<dt id="grpc.StreamStreamClientInterceptor.intercept_stream_stream">
 
+<code class="descname">intercept_stream_stream</code><span class="sig-paren">(</span><em>continuation</em>, <em>client_call_details</em>, <em>request_iterator</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#StreamStreamClientInterceptor.intercept_stream_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamStreamClientInterceptor.intercept_stream_stream" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Intercepts a stream-stream invocation.</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"><ul class="first simple">
 
+<li><strong>continuation</strong> – A function that proceeds with the invocation by
 
+executing the next interceptor in chain or invoking the
 
+actual RPC on the underlying Channel. It is the interceptor’s
 
+responsibility to call it if it decides to move the RPC forward.
 
+The interceptor can use
 
+<cite>response_iterator = continuation(client_call_details, request_iterator)</cite>
 
+to continue with the RPC. <cite>continuation</cite> returns an object that is
 
+both a Call for the RPC and an iterator for response values.
 
+Drawing response values from the returned Call-iterator may
 
+raise RpcError indicating termination of the RPC with non-OK
 
+status.</li>
 
+<li><strong>client_call_details</strong> – A ClientCallDetails object describing the
 
+outgoing RPC.</li>
 
+<li><strong>request_iterator</strong> – An iterator that yields request values for the RPC.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An object that is both a Call for the RPC and an iterator of
 
+response values. Drawing response values from the returned
 
+Call-iterator may raise RpcError indicating termination of
 
+the RPC with non-OK status.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="service-side-context">
 
+<h2>Service-Side Context<a class="headerlink" href="#service-side-context" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc.ServicerContext">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">ServicerContext</code><a class="reference internal" href="_modules/grpc.html#ServicerContext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>A context object passed to method implementations.</p>
 
+<dl class="method">
 
+<dt id="grpc.ServicerContext.abort">
 
+<code class="descname">abort</code><span class="sig-paren">(</span><em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServicerContext.abort"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext.abort" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Raises an exception to terminate the RPC with a non-OK status.</p>
 
+<p>The code and details passed as arguments will supercede any existing
 
+ones.</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"><ul class="first simple">
 
+<li><strong>code</strong> – A StatusCode object to be sent to the client.
 
+It must not be StatusCode.OK.</li>
 
+<li><strong>details</strong> – An ASCII-encodable string to be sent to the client upon
 
+termination of the RPC.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last"><code class="xref py py-exc docutils literal notranslate"><span class="pre">Exception</span></code> – An exception is always raised to signal the abortion the
 
+RPC to the gRPC runtime.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.ServicerContext.auth_context">
 
+<code class="descname">auth_context</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServicerContext.auth_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext.auth_context" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Gets the auth context for the call.</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">Returns:</th><td class="field-body">A map of strings to an iterable of bytes for each auth property.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</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>
 
+<dd><p>Accesses the metadata from the sent by the client.</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">Returns:</th><td class="field-body">The invocation <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a>.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.ServicerContext.peer">
 
+<code class="descname">peer</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServicerContext.peer"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext.peer" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Identifies the peer that invoked the RPC being serviced.</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">Returns:</th><td class="field-body">A string identifying the peer that invoked the RPC being serviced.
 
+The string format is determined by gRPC runtime.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.ServicerContext.peer_identities">
 
+<code class="descname">peer_identities</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServicerContext.peer_identities"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext.peer_identities" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Gets one or more peer identity(s).</p>
 
+<p>Equivalent to
 
+servicer_context.auth_context().get(servicer_context.peer_identity_key())</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">Returns:</th><td class="field-body">An iterable of the identities, or None if the call is not
 
+authenticated. Each identity is returned as a raw bytes type.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.ServicerContext.peer_identity_key">
 
+<code class="descname">peer_identity_key</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServicerContext.peer_identity_key"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext.peer_identity_key" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The auth property used to identify the peer.</p>
 
+<p>For example, “x509_common_name” or “x509_subject_alternative_name” are
 
+used to identify an SSL peer.</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">Returns:</th><td class="field-body">The auth property (string) that indicates the
 
+peer identity, or None if the call is not authenticated.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.ServicerContext.send_initial_metadata">
 
+<code class="descname">send_initial_metadata</code><span class="sig-paren">(</span><em>initial_metadata</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServicerContext.send_initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext.send_initial_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Sends the initial metadata value to the client.</p>
 
+<p>This method need not be called by implementations if they have no
 
+metadata to add to what the gRPC runtime will transmit.</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>initial_metadata</strong> – The initial <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a>.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.ServicerContext.set_code">
 
+<code class="descname">set_code</code><span class="sig-paren">(</span><em>code</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServicerContext.set_code"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext.set_code" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Sets the value to be used as status code upon RPC completion.</p>
 
+<p>This method need not be called by method implementations if they wish
 
+the gRPC runtime to determine the status code of the RPC.</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>code</strong> – A StatusCode object to be sent to the client.</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>
 
+<dd><p>Sets the value to be used as detail string upon RPC completion.</p>
 
+<p>This method need not be called by method implementations if they have
 
+no details to transmit.</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>details</strong> – An ASCII-encodable string to be sent to the client upon
 
+termination of the RPC.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.ServicerContext.set_trailing_metadata">
 
+<code class="descname">set_trailing_metadata</code><span class="sig-paren">(</span><em>trailing_metadata</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServicerContext.set_trailing_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServicerContext.set_trailing_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Sends the trailing metadata for the RPC.</p>
 
+<p>This method need not be called by implementations if they have no
 
+metadata to add to what the gRPC runtime will transmit.</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>trailing_metadata</strong> – The trailing <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a>.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="service-side-handler">
 
+<h2>Service-Side Handler<a class="headerlink" href="#service-side-handler" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc.RpcMethodHandler">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">RpcMethodHandler</code><a class="reference internal" href="_modules/grpc.html#RpcMethodHandler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.RpcMethodHandler" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>An implementation of a single RPC method.</p>
 
+<dl class="attribute">
 
+<dt id="grpc.RpcMethodHandler.request_streaming">
 
+<code class="descname">request_streaming</code><a class="headerlink" href="#grpc.RpcMethodHandler.request_streaming" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Whether the RPC supports exactly one request message
 
+or any arbitrary number of request messages.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.RpcMethodHandler.response_streaming">
 
+<code class="descname">response_streaming</code><a class="headerlink" href="#grpc.RpcMethodHandler.response_streaming" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Whether the RPC supports exactly one response message
 
+or any arbitrary number of response messages.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.RpcMethodHandler.request_deserializer">
 
+<code class="descname">request_deserializer</code><a class="headerlink" href="#grpc.RpcMethodHandler.request_deserializer" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>A callable behavior that accepts a byte string and
 
+returns an object suitable to be passed to this object’s business
 
+logic, or None to indicate that this object’s business logic should be
 
+passed the raw request bytes.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.RpcMethodHandler.response_serializer">
 
+<code class="descname">response_serializer</code><a class="headerlink" href="#grpc.RpcMethodHandler.response_serializer" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>A callable behavior that accepts an object produced
 
+by this object’s business logic and returns a byte string, or None to
 
+indicate that the byte strings produced by this object’s business logic
 
+should be transmitted on the wire as they are.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.RpcMethodHandler.unary_unary">
 
+<code class="descname">unary_unary</code><a class="headerlink" href="#grpc.RpcMethodHandler.unary_unary" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>This object’s application-specific business logic as a
 
+callable value that takes a request value and a ServicerContext object
 
+and returns a response value. Only non-None if both request_streaming
 
+and response_streaming are False.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.RpcMethodHandler.unary_stream">
 
+<code class="descname">unary_stream</code><a class="headerlink" href="#grpc.RpcMethodHandler.unary_stream" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>This object’s application-specific business logic as a
 
+callable value that takes a request value and a ServicerContext object
 
+and returns an iterator of response values. Only non-None if
 
+request_streaming is False and response_streaming is True.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.RpcMethodHandler.stream_unary">
 
+<code class="descname">stream_unary</code><a class="headerlink" href="#grpc.RpcMethodHandler.stream_unary" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>This object’s application-specific business logic as a
 
+callable value that takes an iterator of request values and a
 
+ServicerContext object and returns a response value. Only non-None if
 
+request_streaming is True and response_streaming is False.</p>
 
+</dd></dl>
 
+
 
+<dl class="attribute">
 
+<dt id="grpc.RpcMethodHandler.stream_stream">
 
+<code class="descname">stream_stream</code><a class="headerlink" href="#grpc.RpcMethodHandler.stream_stream" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>This object’s application-specific business logic as a
 
+callable value that takes an iterator of request values and a
 
+ServicerContext object and returns an iterator of response values.
 
+Only non-None if request_streaming and response_streaming are both
 
+True.</p>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.HandlerCallDetails">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">HandlerCallDetails</code><a class="reference internal" href="_modules/grpc.html#HandlerCallDetails"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.HandlerCallDetails" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Describes an RPC that has just arrived for service.
 
+.. attribute:: method</p>
 
+<blockquote>
 
+<div>The method name of the RPC.</div></blockquote>
 
+<dl class="attribute">
 
+<dt id="grpc.HandlerCallDetails.invocation_metadata">
 
+<code class="descname">invocation_metadata</code><a class="headerlink" href="#grpc.HandlerCallDetails.invocation_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>The <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a> sent by the client.</p>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.GenericRpcHandler">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">GenericRpcHandler</code><a class="reference internal" href="_modules/grpc.html#GenericRpcHandler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.GenericRpcHandler" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>An implementation of arbitrarily many RPC methods.</p>
 
+<dl class="method">
 
+<dt id="grpc.GenericRpcHandler.service">
 
+<code class="descname">service</code><span class="sig-paren">(</span><em>handler_call_details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#GenericRpcHandler.service"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.GenericRpcHandler.service" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Returns the handler for servicing the RPC.</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>handler_call_details</strong> – A HandlerCallDetails describing the RPC.</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">An RpcMethodHandler with which the RPC may be serviced if the
 
+implementation chooses to service this RPC, or None otherwise.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.ServiceRpcHandler">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">ServiceRpcHandler</code><a class="reference internal" href="_modules/grpc.html#ServiceRpcHandler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServiceRpcHandler" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>An implementation of RPC methods belonging to a service.</p>
 
+<p>A service handles RPC methods with structured names of the form
 
+‘/Service.Name/Service.Method’, where ‘Service.Name’ is the value
 
+returned by service_name(), and ‘Service.Method’ is the method
 
+name.  A service can have multiple method names, but only a single
 
+service name.</p>
 
+<dl class="method">
 
+<dt id="grpc.ServiceRpcHandler.service_name">
 
+<code class="descname">service_name</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServiceRpcHandler.service_name"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServiceRpcHandler.service_name" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Returns this service’s name.</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">Returns:</th><td class="field-body">The service name.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="service-side-interceptor">
 
+<h2>Service-Side Interceptor<a class="headerlink" href="#service-side-interceptor" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc.ServerInterceptor">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">ServerInterceptor</code><a class="reference internal" href="_modules/grpc.html#ServerInterceptor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServerInterceptor" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Affords intercepting incoming RPCs on the service-side.</p>
 
+<p>This is an EXPERIMENTAL API.</p>
 
+<dl class="method">
 
+<dt id="grpc.ServerInterceptor.intercept_service">
 
+<code class="descname">intercept_service</code><span class="sig-paren">(</span><em>continuation</em>, <em>handler_call_details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#ServerInterceptor.intercept_service"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.ServerInterceptor.intercept_service" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Intercepts incoming RPCs before handing them over to a handler.</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"><ul class="first simple">
 
+<li><strong>continuation</strong> – A function that takes a HandlerCallDetails and
 
+proceeds to invoke the next interceptor in the chain, if any,
 
+or the RPC handler lookup logic, with the call details passed
 
+as an argument, and returns an RpcMethodHandler instance if
 
+the RPC is considered serviced, or None otherwise.</li>
 
+<li><strong>handler_call_details</strong> – A HandlerCallDetails describing the RPC.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An RpcMethodHandler with which the RPC may be serviced if the
 
+interceptor chooses to service this RPC, or None otherwise.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="multi-callable">
 
+<h2>Multi-Callable<a class="headerlink" href="#multi-callable" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc.UnaryUnaryMultiCallable">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">UnaryUnaryMultiCallable</code><a class="reference internal" href="_modules/grpc.html#UnaryUnaryMultiCallable"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryUnaryMultiCallable" title="Permalink to this definition">¶</a></dt>
 
+<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>
 
+<dd><p>Synchronously invokes the underlying RPC.</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"><ul class="first simple">
 
+<li><strong>request</strong> – The request value for the RPC.</li>
 
+<li><strong>timeout</strong> – An optional duration of time in seconds to allow
 
+for the RPC.</li>
 
+<li><strong>metadata</strong> – Optional <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a> to be transmitted to the
 
+service-side of the RPC.</li>
 
+<li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 
+<li><strong>wait_for_ready</strong> – An optional flag to enable wait for ready
 
+mechanism</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">The response value for the RPC.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last"><a class="reference internal" href="#grpc.RpcError" title="grpc.RpcError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">RpcError</span></code></a> – Indicating that the RPC terminated with non-OK status. The
 
+raised RpcError will also be a Call for the RPC affording the RPC’s
 
+metadata, status code, and details.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<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>
 
+<dd><p>Asynchronously invokes the underlying RPC.</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"><ul class="first simple">
 
+<li><strong>request</strong> – The request value for the RPC.</li>
 
+<li><strong>timeout</strong> – An optional duration of time in seconds to allow for
 
+the RPC.</li>
 
+<li><strong>metadata</strong> – Optional <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a> to be transmitted to the
 
+service-side of the RPC.</li>
 
+<li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 
+<li><strong>wait_for_ready</strong> – An optional flag to enable wait for ready
 
+mechanism</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An object that is both a Call for the RPC and a Future.
 
+In the event of RPC completion, the return Call-Future’s result
 
+value will be the response message of the RPC.
 
+Should the event terminate with non-OK status,
 
+the returned Call-Future’s exception value will be an RpcError.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<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>
 
+<dd><p>Synchronously invokes the underlying RPC.</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"><ul class="first simple">
 
+<li><strong>request</strong> – The request value for the RPC.</li>
 
+<li><strong>timeout</strong> – An optional durating of time in seconds to allow for
 
+the RPC.</li>
 
+<li><strong>metadata</strong> – Optional <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a> to be transmitted to the
 
+service-side of the RPC.</li>
 
+<li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 
+<li><strong>wait_for_ready</strong> – An optional flag to enable wait for ready
 
+mechanism</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">The response value for the RPC and a Call value for the RPC.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last"><a class="reference internal" href="#grpc.RpcError" title="grpc.RpcError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">RpcError</span></code></a> – Indicating that the RPC terminated with non-OK status. The
 
+raised RpcError will also be a Call for the RPC affording the RPC’s
 
+metadata, status code, and details.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.UnaryStreamMultiCallable">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">UnaryStreamMultiCallable</code><a class="reference internal" href="_modules/grpc.html#UnaryStreamMultiCallable"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.UnaryStreamMultiCallable" title="Permalink to this definition">¶</a></dt>
 
+<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>
 
+<dd><p>Invokes the underlying RPC.</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"><ul class="first simple">
 
+<li><strong>request</strong> – The request value for the RPC.</li>
 
+<li><strong>timeout</strong> – An optional duration of time in seconds to allow for
 
+the RPC. If None, the timeout is considered infinite.</li>
 
+<li><strong>metadata</strong> – An optional <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a> to be transmitted to the
 
+service-side of the RPC.</li>
 
+<li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 
+<li><strong>wait_for_ready</strong> – An optional flag to enable wait for ready
 
+mechanism</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An object that is both a Call for the RPC and an iterator of
 
+response values. Drawing response values from the returned
 
+Call-iterator may raise RpcError indicating termination of the
 
+RPC with non-OK status.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.StreamUnaryMultiCallable">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">StreamUnaryMultiCallable</code><a class="reference internal" href="_modules/grpc.html#StreamUnaryMultiCallable"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamUnaryMultiCallable" title="Permalink to this definition">¶</a></dt>
 
+<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>
 
+<dd><p>Synchronously invokes the underlying RPC.</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"><ul class="first simple">
 
+<li><strong>request_iterator</strong> – An iterator that yields request values for
 
+the RPC.</li>
 
+<li><strong>timeout</strong> – An optional duration of time in seconds to allow for
 
+the RPC. If None, the timeout is considered infinite.</li>
 
+<li><strong>metadata</strong> – Optional <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a> to be transmitted to the
 
+service-side of the RPC.</li>
 
+<li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 
+<li><strong>wait_for_ready</strong> – An optional flag to enable wait for ready
 
+mechanism</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">The response value for the RPC.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last"><a class="reference internal" href="#grpc.RpcError" title="grpc.RpcError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">RpcError</span></code></a> – Indicating that the RPC terminated with non-OK status. The
 
+raised RpcError will also implement grpc.Call, affording methods
 
+such as metadata, code, and details.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<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>
 
+<dd><p>Asynchronously invokes the underlying RPC on the client.</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"><ul class="first simple">
 
+<li><strong>request_iterator</strong> – An iterator that yields request values for the RPC.</li>
 
+<li><strong>timeout</strong> – An optional duration of time in seconds to allow for
 
+the RPC. If None, the timeout is considered infinite.</li>
 
+<li><strong>metadata</strong> – Optional <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a> to be transmitted to the
 
+service-side of the RPC.</li>
 
+<li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 
+<li><strong>wait_for_ready</strong> – An optional flag to enable wait for ready
 
+mechanism</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An object that is both a Call for the RPC and a Future.
 
+In the event of RPC completion, the return Call-Future’s result value
 
+will be the response message of the RPC. Should the event terminate
 
+with non-OK status, the returned Call-Future’s exception value will
 
+be an RpcError.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<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>
 
+<dd><p>Synchronously invokes the underlying RPC on the client.</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"><ul class="first simple">
 
+<li><strong>request_iterator</strong> – An iterator that yields request values for
 
+the RPC.</li>
 
+<li><strong>timeout</strong> – An optional duration of time in seconds to allow for
 
+the RPC. If None, the timeout is considered infinite.</li>
 
+<li><strong>metadata</strong> – Optional <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a> to be transmitted to the
 
+service-side of the RPC.</li>
 
+<li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 
+<li><strong>wait_for_ready</strong> – An optional flag to enable wait for ready
 
+mechanism</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">The response value for the RPC and a Call object for the RPC.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last"><a class="reference internal" href="#grpc.RpcError" title="grpc.RpcError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">RpcError</span></code></a> – Indicating that the RPC terminated with non-OK status. The
 
+raised RpcError will also be a Call for the RPC affording the RPC’s
 
+metadata, status code, and details.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.StreamStreamMultiCallable">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">StreamStreamMultiCallable</code><a class="reference internal" href="_modules/grpc.html#StreamStreamMultiCallable"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.StreamStreamMultiCallable" title="Permalink to this definition">¶</a></dt>
 
+<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>
 
+<dd><p>Invokes the underlying RPC on the client.</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"><ul class="first simple">
 
+<li><strong>request_iterator</strong> – An iterator that yields request values for the RPC.</li>
 
+<li><strong>timeout</strong> – An optional duration of time in seconds to allow for
 
+the RPC. If not specified, the timeout is considered infinite.</li>
 
+<li><strong>metadata</strong> – Optional <a class="reference internal" href="glossary.html#term-metadata"><span class="xref std std-term">metadata</span></a> to be transmitted to the
 
+service-side of the RPC.</li>
 
+<li><strong>credentials</strong> – An optional CallCredentials for the RPC.</li>
 
+<li><strong>wait_for_ready</strong> – An optional flag to enable wait for ready
 
+mechanism</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An object that is both a Call for the RPC and an iterator of
 
+response values. Drawing response values from the returned
 
+Call-iterator may raise RpcError indicating termination of the
 
+RPC with non-OK status.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+<div class="section" id="future">
 
+<h2>Future<a class="headerlink" href="#future" title="Permalink to this headline">¶</a></h2>
 
+<dl class="exception">
 
+<dt id="grpc.FutureTimeoutError">
 
+<em class="property">exception </em><code class="descclassname">grpc.</code><code class="descname">FutureTimeoutError</code><a class="reference internal" href="_modules/grpc.html#FutureTimeoutError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.FutureTimeoutError" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Indicates that a method call on a Future timed out.</p>
 
+</dd></dl>
 
+
 
+<dl class="exception">
 
+<dt id="grpc.FutureCancelledError">
 
+<em class="property">exception </em><code class="descclassname">grpc.</code><code class="descname">FutureCancelledError</code><a class="reference internal" href="_modules/grpc.html#FutureCancelledError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.FutureCancelledError" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Indicates that the computation underlying a Future was cancelled.</p>
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc.Future">
 
+<em class="property">class </em><code class="descclassname">grpc.</code><code class="descname">Future</code><a class="reference internal" href="_modules/grpc.html#Future"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Future" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>A representation of a computation in another control flow.</p>
 
+<p>Computations represented by a Future may be yet to be begun,
 
+may be ongoing, or may have already completed.</p>
 
+<dl class="method">
 
+<dt id="grpc.Future.add_done_callback">
 
+<code class="descname">add_done_callback</code><span class="sig-paren">(</span><em>fn</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Future.add_done_callback"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Future.add_done_callback" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Adds a function to be called at completion of the computation.</p>
 
+<p>The callback will be passed this Future object describing the outcome
 
+of the computation.  Callbacks will be invoked after the future is
 
+terimated, whether successfully or not.</p>
 
+<p>If the computation has already completed, the callback will be called
 
+immediately.</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>fn</strong> – A callable taking this Future object as its single parameter.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Future.cancel">
 
+<code class="descname">cancel</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Future.cancel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Future.cancel" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Attempts to cancel the computation.</p>
 
+<p>This method does not block.</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">Returns:</th><td class="field-body">Returns True if the computation was canceled.<p>Returns False under all other circumstances, for example:</p>
 
+<ol class="arabic simple">
 
+<li>computation has begun and could not be canceled.</li>
 
+<li>computation has finished</li>
 
+<li><dl class="first docutils">
 
+<dt>computation is scheduled for execution and it is impossible</dt>
 
+<dd>to determine its state without blocking.</dd>
 
+</dl>
 
+</li>
 
+</ol>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body">bool</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Future.cancelled">
 
+<code class="descname">cancelled</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Future.cancelled"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Future.cancelled" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Describes whether the computation was cancelled.</p>
 
+<p>This method does not block.</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">Returns:</th><td class="field-body">Returns True if the computation was cancelled before its result became
 
+available.<p>Returns False under all other circumstances, for example:</p>
 
+<ol class="arabic simple">
 
+<li>computation was not cancelled.</li>
 
+<li>computation’s result is available.</li>
 
+</ol>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body">bool</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Future.done">
 
+<code class="descname">done</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Future.done"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Future.done" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Describes whether the computation has taken place.</p>
 
+<p>This method does not block.</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">Returns:</th><td class="field-body">Returns True if the computation already executed or was cancelled.
 
+Returns False if the computation is scheduled for execution or
 
+currently executing.
 
+This is exactly opposite of the running() method’s result.</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body">bool</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Future.exception">
 
+<code class="descname">exception</code><span class="sig-paren">(</span><em>timeout=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Future.exception"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Future.exception" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Return the exception raised by the computation.</p>
 
+<p>This method may return immediately or may block.</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"><p class="first"><strong>timeout</strong> – The length of time in seconds to wait for the computation to
 
+terminate or be cancelled. If None, the call will block until the
 
+computations’s termination.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">The exception raised by the computation, or None if the computation
 
+did not raise an exception.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><ul class="first last simple">
 
+<li><a class="reference internal" href="#grpc.FutureTimeoutError" title="grpc.FutureTimeoutError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">FutureTimeoutError</span></code></a> – If a timeout value is passed and the computation
 
+does not terminate within the allotted time.</li>
 
+<li><a class="reference internal" href="#grpc.FutureCancelledError" title="grpc.FutureCancelledError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">FutureCancelledError</span></code></a> – If the computation was cancelled.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Future.result">
 
+<code class="descname">result</code><span class="sig-paren">(</span><em>timeout=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Future.result"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Future.result" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Returns the result of the computation or raises its exception.</p>
 
+<p>This method may return immediately or may block.</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"><p class="first"><strong>timeout</strong> – The length of time in seconds to wait for the computation to
 
+finish or be cancelled. If None, the call will block until the
 
+computations’s termination.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">The return value of the computation.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><ul class="first last simple">
 
+<li><a class="reference internal" href="#grpc.FutureTimeoutError" title="grpc.FutureTimeoutError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">FutureTimeoutError</span></code></a> – If a timeout value is passed and the computation
 
+does not terminate within the allotted time.</li>
 
+<li><a class="reference internal" href="#grpc.FutureCancelledError" title="grpc.FutureCancelledError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">FutureCancelledError</span></code></a> – If the computation was cancelled.</li>
 
+<li><code class="xref py py-exc docutils literal notranslate"><span class="pre">Exception</span></code> – If the computation raised an exception, this call will
 
+raise the same exception.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Future.running">
 
+<code class="descname">running</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Future.running"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Future.running" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Describes whether the computation is taking place.</p>
 
+<p>This method does not block.</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">Returns:</th><td class="field-body">Returns True if the computation is scheduled for execution or
 
+currently executing.<p>Returns False if the computation already executed or was cancelled.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc.Future.traceback">
 
+<code class="descname">traceback</code><span class="sig-paren">(</span><em>timeout=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc.html#Future.traceback"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.Future.traceback" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Access the traceback of the exception raised by the computation.</p>
 
+<p>This method may return immediately or may block.</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"><p class="first"><strong>timeout</strong> – The length of time in seconds to wait for the computation
 
+to terminate or be cancelled. If None, the call will block until
 
+the computation’s termination.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">The traceback of the exception raised by the computation, or None
 
+if the computation did not raise an exception.</p>
 
+</td>
 
+</tr>
 
+<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><ul class="first last simple">
 
+<li><a class="reference internal" href="#grpc.FutureTimeoutError" title="grpc.FutureTimeoutError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">FutureTimeoutError</span></code></a> – If a timeout value is passed and the computation
 
+does not terminate within the allotted time.</li>
 
+<li><a class="reference internal" href="#grpc.FutureCancelledError" title="grpc.FutureCancelledError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">FutureCancelledError</span></code></a> – If the computation was cancelled.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+</div>
 
+
 
+
 
+          </div>
 
+          
+        </div>
 
+      </div>
 
+    <div class="clearer"></div>
 
+  </div>
 
+    <div class="footer">
 
+      &copy;2018, The gRPC Authors.
 
+      
+      |
 
+      <a href="_sources/api.rst.txt"
 
+          rel="nofollow">Page source</a>
 
+    </div>
 
+
 
+    
+
 
+    
+    <script type="text/javascript">
 
+
 
+      var _gaq = _gaq || [];
 
+      _gaq.push(['_setAccount', 'UA-60127042-1']);
 
+      _gaq.push(['_setDomainName', 'none']);
 
+      _gaq.push(['_setAllowLinker', true]);
 
+      _gaq.push(['_trackPageview']);
 
+
 
+      (function() {
 
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 
+      })();
 
+
 
+    </script>
 
+    
+  </body>
 
+</html>

File diff suppressed because it is too large
+ 127 - 580
python/genindex.html


+ 139 - 0
python/glossary.html
查看文件 

@@ -0,0 +1,139 @@
 
+
 
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
+
 
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
 
+  <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.16.0 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>
 
+    <script type="text/javascript" src="_static/jquery.js"></script>
 
+    <script type="text/javascript" src="_static/underscore.js"></script>
 
+    <script type="text/javascript" src="_static/doctools.js"></script>
 
+    <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
 
+    <link rel="index" title="Index" href="genindex.html" />
 
+    <link rel="search" title="Search" href="search.html" />
 
+    <link rel="prev" title="gRPC Testing" href="grpc_testing.html" />
 
+   
+  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
 
+  
+  
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
 
+
 
+  </head><body>
 
+  <div class="document">
 
+    
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 
+        <div class="sphinxsidebarwrapper">
 
+<h1 class="logo"><a href="index.html">gRPC Python</a></h1>
 
+
 
+
 
+
 
+<p class="blurb">1.16.0</p>
 
+
 
+
 
+
 
+
 
+
 
+
 
+<h3>Navigation</h3>
 
+<p class="caption"><span class="caption-text">Contents:</span></p>
 
+<ul class="current">
 
+<li class="toctree-l1"><a class="reference internal" href="grpc.html">gRPC</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_health_checking.html">gRPC Health Checking</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_reflection.html">gRPC Reflection</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_testing.html">gRPC Testing</a></li>
 
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Glossary</a></li>
 
+</ul>
 
+
 
+<div class="relations">
 
+<h3>Related Topics</h3>
 
+<ul>
 
+  <li><a href="index.html">Documentation overview</a><ul>
 
+      <li>Previous: <a href="grpc_testing.html" title="previous chapter">gRPC Testing</a></li>
 
+  </ul></li>
 
+</ul>
 
+</div>
 
+<div id="searchbox" style="display: none" role="search">
 
+  <h3>Quick search</h3>
 
+    <div class="searchformwrapper">
 
+    <form class="search" action="search.html" method="get">
 
+      <input type="text" name="q" />
 
+      <input type="submit" value="Go" />
 
+      <input type="hidden" name="check_keywords" value="yes" />
 
+      <input type="hidden" name="area" value="default" />
 
+    </form>
 
+    </div>
 
+</div>
 
+<script type="text/javascript">$('#searchbox').show(0);</script>
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+        </div>
 
+      </div>
 
+      <div class="documentwrapper">
 
+        <div class="bodywrapper">
 
+          
+
 
+          <div class="body" role="main">
 
+            
+  <div class="section" id="glossary">
 
+<h1>Glossary<a class="headerlink" href="#glossary" title="Permalink to this headline">¶</a></h1>
 
+<dl class="glossary docutils">
 
+<dt id="term-metadatum">metadatum</dt>
 
+<dd>A key-value pair included in the HTTP header.  It is a
 
+2-tuple where the first entry is the key and the
 
+second is the value, i.e. (key, value).  The metadata key is an ASCII str,
 
+and must be a valid HTTP header name.  The metadata value can be
 
+either a valid HTTP ASCII str, or bytes.  If bytes are provided,
 
+the key must end with ‘-bin’, i.e.
 
+<code class="docutils literal notranslate"><span class="pre">('binary-metadata-bin',</span> <span class="pre">b'\\x00\\xFF')</span></code></dd>
 
+<dt id="term-metadata">metadata</dt>
 
+<dd>A sequence of metadatum.</dd>
 
+</dl>
 
+</div>
 
+
 
+
 
+          </div>
 
+          
+        </div>
 
+      </div>
 
+    <div class="clearer"></div>
 
+  </div>
 
+    <div class="footer">
 
+      &copy;2018, The gRPC Authors.
 
+      
+      |
 
+      <a href="_sources/glossary.rst.txt"
 
+          rel="nofollow">Page source</a>
 
+    </div>
 
+
 
+    
+
 
+    
+    <script type="text/javascript">
 
+
 
+      var _gaq = _gaq || [];
 
+      _gaq.push(['_setAccount', 'UA-60127042-1']);
 
+      _gaq.push(['_setDomainName', 'none']);
 
+      _gaq.push(['_setAllowLinker', true]);
 
+      _gaq.push(['_trackPageview']);
 
+
 
+      (function() {
 
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 
+      })();
 
+
 
+    </script>
 
+    
+  </body>
 
+</html>

+ 0 - 737
python/grpc.beta.html
查看文件 

@@ -1,737 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.beta package &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="genindex.html"/>
 
-        <link rel="search" title="Search" href="search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="index.html"/>
 
-        <link rel="up" title="grpc package" href="grpc.html"/>
 
-        <link rel="next" title="grpc.framework package" href="grpc.framework.html"/>
 
-        <link rel="prev" title="grpc package" href="grpc.html"/> 
-
 
-  
-  <script src="_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul class="current">
 
-<li class="toctree-l1 current"><a class="reference internal" href="grpc.html">grpc package</a><ul class="current">
 
-<li class="toctree-l2 current"><a class="reference internal" href="grpc.html#subpackages">Subpackages</a><ul class="current">
 
-<li class="toctree-l3 current"><a class="current reference internal" href="#">grpc.beta package</a><ul>
 
-<li class="toctree-l4"><a class="reference internal" href="#submodules">Submodules</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="#module-grpc.beta.implementations">grpc.beta.implementations module</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="#module-grpc.beta.interfaces">grpc.beta.interfaces module</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="#module-grpc.beta.utilities">grpc.beta.utilities module</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="#module-grpc.beta">Module contents</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l3"><a class="reference internal" href="grpc.framework.html">grpc.framework package</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.html#module-grpc">Module contents</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="grpc.html">grpc package</a> &raquo;</li>
 
-        
-      <li>grpc.beta package</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-            <a href="_sources/grpc.beta.rst.txt" rel="nofollow"> View page source</a>
 
-          
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <div class="section" id="grpc-beta-package">
 
-<h1>grpc.beta package<a class="headerlink" href="#grpc-beta-package" title="Permalink to this headline">¶</a></h1>
 
-<div class="section" id="submodules">
 
-<h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this headline">¶</a></h2>
 
-</div>
 
-<div class="section" id="module-grpc.beta.implementations">
 
-<span id="grpc-beta-implementations-module"></span><h2>grpc.beta.implementations module<a class="headerlink" href="#module-grpc.beta.implementations" title="Permalink to this headline">¶</a></h2>
 
-<p>Entry points into the Beta API of gRPC Python.</p>
 
-<dl class="class">
 
-<dt id="grpc.beta.implementations.Channel">
 
-<em class="property">class </em><code class="descclassname">grpc.beta.implementations.</code><code class="descname">Channel</code><span class="sig-paren">(</span><em>channel</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#Channel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.Channel" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>A channel to a remote host through which RPCs may be conducted.</p>
 
-<p>Only the “subscribe” and “unsubscribe” methods are supported for application
 
-use. This class’ instance constructor and all other attributes are
 
-unsupported.</p>
 
-<dl class="method">
 
-<dt id="grpc.beta.implementations.Channel.subscribe">
 
-<code class="descname">subscribe</code><span class="sig-paren">(</span><em>callback</em>, <em>try_to_connect=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#Channel.subscribe"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.Channel.subscribe" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Subscribes to this Channel’s connectivity.</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"><ul class="first last simple">
 
-<li><strong>callback</strong> – A callable to be invoked and passed an
 
-interfaces.ChannelConnectivity identifying this Channel’s connectivity.
 
-The callable will be invoked immediately upon subscription and again for
 
-every change to this Channel’s connectivity thereafter until it is
 
-unsubscribed.</li>
 
-<li><strong>try_to_connect</strong> – A boolean indicating whether or not this Channel should
 
-attempt to connect if it is not already connected and ready to conduct
 
-RPCs.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.beta.implementations.Channel.unsubscribe">
 
-<code class="descname">unsubscribe</code><span class="sig-paren">(</span><em>callback</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#Channel.unsubscribe"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.Channel.unsubscribe" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Unsubscribes a callback from this Channel’s connectivity.</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>callback</strong> – A callable previously registered with this Channel from having
 
-been passed to its “subscribe” method.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.beta.implementations.ServerOptions">
 
-<em class="property">class </em><code class="descclassname">grpc.beta.implementations.</code><code class="descname">ServerOptions</code><span class="sig-paren">(</span><em>multi_method_implementation</em>, <em>request_deserializers</em>, <em>response_serializers</em>, <em>thread_pool</em>, <em>thread_pool_size</em>, <em>default_timeout</em>, <em>maximum_timeout</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#ServerOptions"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.ServerOptions" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>A value encapsulating the various options for creation of a Server.</p>
 
-<p>This class and its instances have no supported interface - it exists to define
 
-the type of its instances and its instances exist to be passed to other
 
-functions.</p>
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.beta.implementations.StubOptions">
 
-<em class="property">class </em><code class="descclassname">grpc.beta.implementations.</code><code class="descname">StubOptions</code><span class="sig-paren">(</span><em>host</em>, <em>request_serializers</em>, <em>response_deserializers</em>, <em>metadata_transformer</em>, <em>thread_pool</em>, <em>thread_pool_size</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#StubOptions"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.StubOptions" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>A value encapsulating the various options for creation of a Stub.</p>
 
-<p>This class and its instances have no supported interface - it exists to define
 
-the type of its instances and its instances exist to be passed to other
 
-functions.</p>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.beta.implementations.dynamic_stub">
 
-<code class="descclassname">grpc.beta.implementations.</code><code class="descname">dynamic_stub</code><span class="sig-paren">(</span><em>channel</em>, <em>service</em>, <em>cardinalities</em>, <em>options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#dynamic_stub"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.dynamic_stub" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a face.DynamicStub with which RPCs can be invoked.</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"><ul class="first simple">
 
-<li><strong>channel</strong> – A Channel for the returned face.DynamicStub to use.</li>
 
-<li><strong>service</strong> – The package-qualified full name of the service.</li>
 
-<li><strong>cardinalities</strong> – A dictionary from RPC method name to cardinality.Cardinality
 
-value identifying the cardinality of the RPC method.</li>
 
-<li><strong>options</strong> – An optional StubOptions value further customizing the functionality
 
-of the returned face.DynamicStub.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A face.DynamicStub with which RPCs can be invoked.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.beta.implementations.generic_stub">
 
-<code class="descclassname">grpc.beta.implementations.</code><code class="descname">generic_stub</code><span class="sig-paren">(</span><em>channel</em>, <em>options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#generic_stub"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.generic_stub" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a face.GenericStub on which RPCs can be made.</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"><ul class="first simple">
 
-<li><strong>channel</strong> – A Channel for use by the created stub.</li>
 
-<li><strong>options</strong> – A StubOptions customizing the created stub.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A face.GenericStub on which RPCs can be made.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.beta.implementations.google_call_credentials">
 
-<code class="descclassname">grpc.beta.implementations.</code><code class="descname">google_call_credentials</code><span class="sig-paren">(</span><em>credentials</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#google_call_credentials"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.google_call_credentials" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Construct CallCredentials from GoogleCredentials.</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>credentials</strong> – A GoogleCredentials object from the oauth2client library.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">A CallCredentials object for use in a GRPCCallOptions object.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.beta.implementations.insecure_channel">
 
-<code class="descclassname">grpc.beta.implementations.</code><code class="descname">insecure_channel</code><span class="sig-paren">(</span><em>host</em>, <em>port</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#insecure_channel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.insecure_channel" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates an insecure Channel to a remote host.</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"><ul class="first simple">
 
-<li><strong>host</strong> – The name of the remote host to which to connect.</li>
 
-<li><strong>port</strong> – The port of the remote host to which to connect.
 
-If None only the ‘host’ part will be used.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A Channel to the remote host through which RPCs may be conducted.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.beta.implementations.metadata_call_credentials">
 
-<code class="descclassname">grpc.beta.implementations.</code><code class="descname">metadata_call_credentials</code><span class="sig-paren">(</span><em>metadata_plugin</em>, <em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#metadata_call_credentials"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.metadata_call_credentials" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.beta.implementations.secure_channel">
 
-<code class="descclassname">grpc.beta.implementations.</code><code class="descname">secure_channel</code><span class="sig-paren">(</span><em>host</em>, <em>port</em>, <em>channel_credentials</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#secure_channel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.secure_channel" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a secure Channel to a remote host.</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"><ul class="first simple">
 
-<li><strong>host</strong> – The name of the remote host to which to connect.</li>
 
-<li><strong>port</strong> – The port of the remote host to which to connect.
 
-If None only the ‘host’ part will be used.</li>
 
-<li><strong>channel_credentials</strong> – A ChannelCredentials.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A secure Channel to the remote host through which RPCs may be conducted.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.beta.implementations.server">
 
-<code class="descclassname">grpc.beta.implementations.</code><code class="descname">server</code><span class="sig-paren">(</span><em>service_implementations</em>, <em>options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#server"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.server" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates an interfaces.Server with which RPCs can be serviced.</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"><ul class="first simple">
 
-<li><strong>service_implementations</strong> – A dictionary from service name-method name pair to
 
-face.MethodImplementation.</li>
 
-<li><strong>options</strong> – An optional ServerOptions value further customizing the
 
-functionality of the returned Server.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">An interfaces.Server with which RPCs can be serviced.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.beta.implementations.server_options">
 
-<code class="descclassname">grpc.beta.implementations.</code><code class="descname">server_options</code><span class="sig-paren">(</span><em>multi_method_implementation=None</em>, <em>request_deserializers=None</em>, <em>response_serializers=None</em>, <em>thread_pool=None</em>, <em>thread_pool_size=None</em>, <em>default_timeout=None</em>, <em>maximum_timeout=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#server_options"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.server_options" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a ServerOptions value to be passed at server creation.</p>
 
-<p>All parameters are optional and should always be passed by keyword.</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"><ul class="first simple">
 
-<li><strong>multi_method_implementation</strong> – A face.MultiMethodImplementation to be called
 
-to service an RPC if the server has no specific method implementation for
 
-the name of the RPC for which service was requested.</li>
 
-<li><strong>request_deserializers</strong> – A dictionary from service name-method name pair to
 
-request deserialization behavior.</li>
 
-<li><strong>response_serializers</strong> – A dictionary from service name-method name pair to
 
-response serialization behavior.</li>
 
-<li><strong>thread_pool</strong> – A thread pool to use in stubs.</li>
 
-<li><strong>thread_pool_size</strong> – The size of thread pool to create for use in stubs;
 
-ignored if thread_pool has been passed.</li>
 
-<li><strong>default_timeout</strong> – A duration in seconds to allow for RPC service when
 
-servicing RPCs that did not include a timeout value when invoked.</li>
 
-<li><strong>maximum_timeout</strong> – A duration in seconds to allow for RPC service when
 
-servicing RPCs no matter what timeout value was passed when the RPC was
 
-invoked.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A StubOptions value created from the passed parameters.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.beta.implementations.stub_options">
 
-<code class="descclassname">grpc.beta.implementations.</code><code class="descname">stub_options</code><span class="sig-paren">(</span><em>host=None</em>, <em>request_serializers=None</em>, <em>response_deserializers=None</em>, <em>metadata_transformer=None</em>, <em>thread_pool=None</em>, <em>thread_pool_size=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/implementations.html#stub_options"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.implementations.stub_options" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a StubOptions value to be passed at stub creation.</p>
 
-<p>All parameters are optional and should always be passed by keyword.</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"><ul class="first simple">
 
-<li><strong>host</strong> – A host string to set on RPC calls.</li>
 
-<li><strong>request_serializers</strong> – A dictionary from service name-method name pair to
 
-request serialization behavior.</li>
 
-<li><strong>response_deserializers</strong> – A dictionary from service name-method name pair to
 
-response deserialization behavior.</li>
 
-<li><strong>metadata_transformer</strong> – A callable that given a metadata object produces
 
-another metadata object to be used in the underlying communication on the
 
-wire.</li>
 
-<li><strong>thread_pool</strong> – A thread pool to use in stubs.</li>
 
-<li><strong>thread_pool_size</strong> – The size of thread pool to create for use in stubs;
 
-ignored if thread_pool has been passed.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A StubOptions value created from the passed parameters.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.beta.interfaces">
 
-<span id="grpc-beta-interfaces-module"></span><h2>grpc.beta.interfaces module<a class="headerlink" href="#module-grpc.beta.interfaces" title="Permalink to this headline">¶</a></h2>
 
-<p>Constants and interfaces of the Beta API of gRPC Python.</p>
 
-<dl class="class">
 
-<dt id="grpc.beta.interfaces.GRPCCallOptions">
 
-<em class="property">class </em><code class="descclassname">grpc.beta.interfaces.</code><code class="descname">GRPCCallOptions</code><span class="sig-paren">(</span><em>disable_compression</em>, <em>subcall_of</em>, <em>credentials</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/interfaces.html#GRPCCallOptions"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.interfaces.GRPCCallOptions" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>A value encapsulating gRPC-specific options passed on RPC invocation.</p>
 
-<p>This class and its instances have no supported interface - it exists to
 
-define the type of its instances and its instances exist to be passed to
 
-other functions.</p>
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.beta.interfaces.GRPCInvocationContext">
 
-<em class="property">class </em><code class="descclassname">grpc.beta.interfaces.</code><code class="descname">GRPCInvocationContext</code><a class="reference internal" href="_modules/grpc/beta/interfaces.html#GRPCInvocationContext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.interfaces.GRPCInvocationContext" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Exposes gRPC-specific options and behaviors to code invoking RPCs.</p>
 
-<dl class="method">
 
-<dt id="grpc.beta.interfaces.GRPCInvocationContext.disable_next_request_compression">
 
-<code class="descname">disable_next_request_compression</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/interfaces.html#GRPCInvocationContext.disable_next_request_compression"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.interfaces.GRPCInvocationContext.disable_next_request_compression" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Disables compression of the next request passed by the application.</p>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.beta.interfaces.GRPCServicerContext">
 
-<em class="property">class </em><code class="descclassname">grpc.beta.interfaces.</code><code class="descname">GRPCServicerContext</code><a class="reference internal" href="_modules/grpc/beta/interfaces.html#GRPCServicerContext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.interfaces.GRPCServicerContext" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Exposes gRPC-specific options and behaviors to code servicing RPCs.</p>
 
-<dl class="method">
 
-<dt id="grpc.beta.interfaces.GRPCServicerContext.disable_next_response_compression">
 
-<code class="descname">disable_next_response_compression</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/interfaces.html#GRPCServicerContext.disable_next_response_compression"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.interfaces.GRPCServicerContext.disable_next_response_compression" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Disables compression of the next response passed by the application.</p>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.beta.interfaces.GRPCServicerContext.peer">
 
-<code class="descname">peer</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/interfaces.html#GRPCServicerContext.peer"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.interfaces.GRPCServicerContext.peer" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Identifies the peer that invoked the RPC being serviced.</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">Returns:</th><td class="field-body">A string identifying the peer that invoked the RPC being serviced.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.beta.interfaces.Server">
 
-<em class="property">class </em><code class="descclassname">grpc.beta.interfaces.</code><code class="descname">Server</code><a class="reference internal" href="_modules/grpc/beta/interfaces.html#Server"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.interfaces.Server" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Services RPCs.</p>
 
-<dl class="method">
 
-<dt id="grpc.beta.interfaces.Server.add_insecure_port">
 
-<code class="descname">add_insecure_port</code><span class="sig-paren">(</span><em>address</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/interfaces.html#Server.add_insecure_port"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.interfaces.Server.add_insecure_port" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Reserves a port for insecure RPC service once this Server becomes active.</p>
 
-<p>This method may only be called before calling this Server’s start method is
 
-called.</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>address</strong> – The address for which to open a port.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>An integer port on which RPCs will be serviced after this link has been</dt>
 
-<dd>started. This is typically the same number as the port number contained
 
-in the passed address, but will likely be different if the port number
 
-contained in the passed address was zero.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.beta.interfaces.Server.add_secure_port">
 
-<code class="descname">add_secure_port</code><span class="sig-paren">(</span><em>address</em>, <em>server_credentials</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/interfaces.html#Server.add_secure_port"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.interfaces.Server.add_secure_port" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Reserves a port for secure RPC service after this Server becomes active.</p>
 
-<p>This method may only be called before calling this Server’s start method is
 
-called.</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"><ul class="first simple">
 
-<li><strong>address</strong> – The address for which to open a port.</li>
 
-<li><strong>server_credentials</strong> – A ServerCredentials.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>An integer port on which RPCs will be serviced after this link has been</dt>
 
-<dd><p class="first last">started. This is typically the same number as the port number contained
 
-in the passed address, but will likely be different if the port number
 
-contained in the passed address was zero.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.beta.interfaces.Server.start">
 
-<code class="descname">start</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/interfaces.html#Server.start"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.interfaces.Server.start" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Starts this Server’s service of RPCs.</p>
 
-<p>This method may only be called while the server is not serving RPCs (i.e. it
 
-is not idempotent).</p>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.beta.interfaces.Server.stop">
 
-<code class="descname">stop</code><span class="sig-paren">(</span><em>grace</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/interfaces.html#Server.stop"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.interfaces.Server.stop" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Stops this Server’s service of RPCs.</p>
 
-<p>All calls to this method immediately stop service of new RPCs. When existing
 
-RPCs are aborted is controlled by the grace period parameter passed to this
 
-method.</p>
 
-<p>This method may be called at any time and is idempotent. Passing a smaller
 
-grace value than has been passed in a previous call will have the effect of
 
-stopping the Server sooner. Passing a larger grace value than has been
 
-passed in a previous call will not have the effect of stopping the server
 
-later.</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>grace</strong> – A duration of time in seconds to allow existing RPCs to complete
 
-before being aborted by this Server’s stopping. May be zero for
 
-immediate abortion of all in-progress RPCs.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">A threading.Event that will be set when this Server has completely
 
-stopped. The returned event may not be set until after the full grace
 
-period (if some ongoing RPC continues for the full length of the period)
 
-of it may be set much sooner (such as if this Server had no RPCs underway
 
-at the time it was stopped or if all RPCs that it had underway completed
 
-very early in the grace period).</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.beta.interfaces.grpc_call_options">
 
-<code class="descclassname">grpc.beta.interfaces.</code><code class="descname">grpc_call_options</code><span class="sig-paren">(</span><em>disable_compression=False</em>, <em>credentials=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/interfaces.html#grpc_call_options"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.interfaces.grpc_call_options" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a GRPCCallOptions value to be passed at RPC invocation.</p>
 
-<p>All parameters are optional and should always be passed by keyword.</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"><ul class="first last simple">
 
-<li><strong>disable_compression</strong> – A boolean indicating whether or not compression should
 
-be disabled for the request object of the RPC. Only valid for
 
-request-unary RPCs.</li>
 
-<li><strong>credentials</strong> – A CallCredentials object to use for the invoked RPC.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.beta.utilities">
 
-<span id="grpc-beta-utilities-module"></span><h2>grpc.beta.utilities module<a class="headerlink" href="#module-grpc.beta.utilities" title="Permalink to this headline">¶</a></h2>
 
-<p>Utilities for the gRPC Python Beta API.</p>
 
-<dl class="function">
 
-<dt id="grpc.beta.utilities.channel_ready_future">
 
-<code class="descclassname">grpc.beta.utilities.</code><code class="descname">channel_ready_future</code><span class="sig-paren">(</span><em>channel</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/beta/utilities.html#channel_ready_future"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.beta.utilities.channel_ready_future" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a future.Future tracking when an implementations.Channel is ready.</p>
 
-<p>Cancelling the returned future.Future does not tell the given
 
-implementations.Channel to abandon attempts it may have been making to
 
-connect; cancelling merely deactivates the return future.Future’s
 
-subscription to the given implementations.Channel’s connectivity.</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>channel</strong> – An implementations.Channel.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>A future.Future that matures when the given Channel has connectivity</dt>
 
-<dd>interfaces.ChannelConnectivity.READY.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.beta">
 
-<span id="module-contents"></span><h2>Module contents<a class="headerlink" href="#module-grpc.beta" title="Permalink to this headline">¶</a></h2>
 
-</div>
 
-</div>
 
-
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 
-      
-        <a href="grpc.framework.html" class="btn btn-neutral float-right" title="grpc.framework package" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
 
-      
-      
-        <a href="grpc.html" class="btn btn-neutral" title="grpc package" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
 
-      
-    </div>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'./',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="_static/jquery.js"></script>
 
-      <script type="text/javascript" src="_static/underscore.js"></script>
 
-      <script type="text/javascript" src="_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 311
python/grpc.framework.common.html
查看文件 

@@ -1,311 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.common package &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="genindex.html"/>
 
-        <link rel="search" title="Search" href="search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="index.html"/>
 
-        <link rel="up" title="grpc.framework package" href="grpc.framework.html"/>
 
-        <link rel="next" title="grpc.framework.foundation package" href="grpc.framework.foundation.html"/>
 
-        <link rel="prev" title="grpc.framework package" href="grpc.framework.html"/> 
-
 
-  
-  <script src="_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul class="current">
 
-<li class="toctree-l1 current"><a class="reference internal" href="grpc.html">grpc package</a><ul class="current">
 
-<li class="toctree-l2 current"><a class="reference internal" href="grpc.html#subpackages">Subpackages</a><ul class="current">
 
-<li class="toctree-l3"><a class="reference internal" href="grpc.beta.html">grpc.beta package</a></li>
 
-<li class="toctree-l3 current"><a class="reference internal" href="grpc.framework.html">grpc.framework package</a><ul class="current">
 
-<li class="toctree-l4 current"><a class="reference internal" href="grpc.framework.html#subpackages">Subpackages</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.html#module-grpc.framework">Module contents</a></li>
 
-</ul>
 
-</li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.html#module-grpc">Module contents</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="grpc.html">grpc package</a> &raquo;</li>
 
-        
-          <li><a href="grpc.framework.html">grpc.framework package</a> &raquo;</li>
 
-        
-      <li>grpc.framework.common package</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-            <a href="_sources/grpc.framework.common.rst.txt" rel="nofollow"> View page source</a>
 
-          
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <div class="section" id="grpc-framework-common-package">
 
-<h1>grpc.framework.common package<a class="headerlink" href="#grpc-framework-common-package" title="Permalink to this headline">¶</a></h1>
 
-<div class="section" id="submodules">
 
-<h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this headline">¶</a></h2>
 
-</div>
 
-<div class="section" id="module-grpc.framework.common.cardinality">
 
-<span id="grpc-framework-common-cardinality-module"></span><h2>grpc.framework.common.cardinality module<a class="headerlink" href="#module-grpc.framework.common.cardinality" title="Permalink to this headline">¶</a></h2>
 
-<p>Defines an enum for classifying RPC methods by streaming semantics.</p>
 
-<dl class="class">
 
-<dt id="grpc.framework.common.cardinality.Cardinality">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.common.cardinality.</code><code class="descname">Cardinality</code><a class="reference internal" href="_modules/grpc/framework/common/cardinality.html#Cardinality"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.common.cardinality.Cardinality" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">enum.Enum</span></code></p>
 
-<p>Describes the streaming semantics of an RPC method.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.common.cardinality.Cardinality.STREAM_STREAM">
 
-<code class="descname">STREAM_STREAM</code><em class="property"> = 'request-streaming/response-streaming'</em><a class="headerlink" href="#grpc.framework.common.cardinality.Cardinality.STREAM_STREAM" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.common.cardinality.Cardinality.STREAM_UNARY">
 
-<code class="descname">STREAM_UNARY</code><em class="property"> = 'request-streaming/response-unary'</em><a class="headerlink" href="#grpc.framework.common.cardinality.Cardinality.STREAM_UNARY" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.common.cardinality.Cardinality.UNARY_STREAM">
 
-<code class="descname">UNARY_STREAM</code><em class="property"> = 'request-unary/response-streaming'</em><a class="headerlink" href="#grpc.framework.common.cardinality.Cardinality.UNARY_STREAM" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.common.cardinality.Cardinality.UNARY_UNARY">
 
-<code class="descname">UNARY_UNARY</code><em class="property"> = 'request-unary/response-unary'</em><a class="headerlink" href="#grpc.framework.common.cardinality.Cardinality.UNARY_UNARY" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.framework.common.style">
 
-<span id="grpc-framework-common-style-module"></span><h2>grpc.framework.common.style module<a class="headerlink" href="#module-grpc.framework.common.style" title="Permalink to this headline">¶</a></h2>
 
-<p>Defines an enum for classifying RPC methods by control flow semantics.</p>
 
-<dl class="class">
 
-<dt id="grpc.framework.common.style.Service">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.common.style.</code><code class="descname">Service</code><a class="reference internal" href="_modules/grpc/framework/common/style.html#Service"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.common.style.Service" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">enum.Enum</span></code></p>
 
-<p>Describes the control flow style of RPC method implementation.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.common.style.Service.EVENT">
 
-<code class="descname">EVENT</code><em class="property"> = 'event'</em><a class="headerlink" href="#grpc.framework.common.style.Service.EVENT" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.common.style.Service.INLINE">
 
-<code class="descname">INLINE</code><em class="property"> = 'inline'</em><a class="headerlink" href="#grpc.framework.common.style.Service.INLINE" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.framework.common">
 
-<span id="module-contents"></span><h2>Module contents<a class="headerlink" href="#module-grpc.framework.common" title="Permalink to this headline">¶</a></h2>
 
-</div>
 
-</div>
 
-
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 
-      
-        <a href="grpc.framework.foundation.html" class="btn btn-neutral float-right" title="grpc.framework.foundation package" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
 
-      
-      
-        <a href="grpc.framework.html" class="btn btn-neutral" title="grpc.framework package" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
 
-      
-    </div>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'./',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="_static/jquery.js"></script>
 
-      <script type="text/javascript" src="_static/underscore.js"></script>
 
-      <script type="text/javascript" src="_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 763
python/grpc.framework.foundation.html
查看文件 

@@ -1,763 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.foundation package &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="genindex.html"/>
 
-        <link rel="search" title="Search" href="search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="index.html"/>
 
-        <link rel="up" title="grpc.framework package" href="grpc.framework.html"/>
 
-        <link rel="next" title="grpc.framework.interfaces package" href="grpc.framework.interfaces.html"/>
 
-        <link rel="prev" title="grpc.framework.common package" href="grpc.framework.common.html"/> 
-
 
-  
-  <script src="_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul class="current">
 
-<li class="toctree-l1 current"><a class="reference internal" href="grpc.html">grpc package</a><ul class="current">
 
-<li class="toctree-l2 current"><a class="reference internal" href="grpc.html#subpackages">Subpackages</a><ul class="current">
 
-<li class="toctree-l3"><a class="reference internal" href="grpc.beta.html">grpc.beta package</a></li>
 
-<li class="toctree-l3 current"><a class="reference internal" href="grpc.framework.html">grpc.framework package</a><ul class="current">
 
-<li class="toctree-l4 current"><a class="reference internal" href="grpc.framework.html#subpackages">Subpackages</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.html#module-grpc.framework">Module contents</a></li>
 
-</ul>
 
-</li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.html#module-grpc">Module contents</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="grpc.html">grpc package</a> &raquo;</li>
 
-        
-          <li><a href="grpc.framework.html">grpc.framework package</a> &raquo;</li>
 
-        
-      <li>grpc.framework.foundation package</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-            <a href="_sources/grpc.framework.foundation.rst.txt" rel="nofollow"> View page source</a>
 
-          
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <div class="section" id="grpc-framework-foundation-package">
 
-<h1>grpc.framework.foundation package<a class="headerlink" href="#grpc-framework-foundation-package" title="Permalink to this headline">¶</a></h1>
 
-<div class="section" id="submodules">
 
-<h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this headline">¶</a></h2>
 
-</div>
 
-<div class="section" id="module-grpc.framework.foundation.abandonment">
 
-<span id="grpc-framework-foundation-abandonment-module"></span><h2>grpc.framework.foundation.abandonment module<a class="headerlink" href="#module-grpc.framework.foundation.abandonment" title="Permalink to this headline">¶</a></h2>
 
-<p>Utilities for indicating abandonment of computation.</p>
 
-<dl class="exception">
 
-<dt id="grpc.framework.foundation.abandonment.Abandoned">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.foundation.abandonment.</code><code class="descname">Abandoned</code><a class="reference internal" href="_modules/grpc/framework/foundation/abandonment.html#Abandoned"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.abandonment.Abandoned" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">exceptions.Exception</span></code></p>
 
-<p>Indicates that some computation is being abandoned.</p>
 
-<p>Abandoning a computation is different than returning a value or raising
 
-an exception indicating some operational or programming defect.</p>
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.framework.foundation.callable_util">
 
-<span id="grpc-framework-foundation-callable-util-module"></span><h2>grpc.framework.foundation.callable_util module<a class="headerlink" href="#module-grpc.framework.foundation.callable_util" title="Permalink to this headline">¶</a></h2>
 
-<p>Utilities for working with callables.</p>
 
-<dl class="class">
 
-<dt id="grpc.framework.foundation.callable_util.Outcome">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.foundation.callable_util.</code><code class="descname">Outcome</code><a class="reference internal" href="_modules/grpc/framework/foundation/callable_util.html#Outcome"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.callable_util.Outcome" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>A sum type describing the outcome of some call.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.foundation.callable_util.Outcome.kind">
 
-<code class="descname">kind</code><a class="headerlink" href="#grpc.framework.foundation.callable_util.Outcome.kind" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>One of Kind.RETURNED or Kind.RAISED respectively indicating that the
 
-call returned a value or raised an exception.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.foundation.callable_util.Outcome.return_value">
 
-<code class="descname">return_value</code><a class="headerlink" href="#grpc.framework.foundation.callable_util.Outcome.return_value" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The value returned by the call. Must be present if kind is
 
-Kind.RETURNED.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.foundation.callable_util.Outcome.exception">
 
-<code class="descname">exception</code><a class="headerlink" href="#grpc.framework.foundation.callable_util.Outcome.exception" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The exception raised by the call. Must be present if kind is
 
-Kind.RAISED.</p>
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.foundation.callable_util.Outcome.Kind">
 
-<em class="property">class </em><code class="descname">Kind</code><a class="reference internal" href="_modules/grpc/framework/foundation/callable_util.html#Outcome.Kind"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.callable_util.Outcome.Kind" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">enum.Enum</span></code></p>
 
-<p>Identifies the general kind of the outcome of some call.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.foundation.callable_util.Outcome.Kind.RAISED">
 
-<code class="descname">RAISED</code><em class="property"> = &lt;object object&gt;</em><a class="headerlink" href="#grpc.framework.foundation.callable_util.Outcome.Kind.RAISED" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.foundation.callable_util.Outcome.Kind.RETURNED">
 
-<code class="descname">RETURNED</code><em class="property"> = &lt;object object&gt;</em><a class="headerlink" href="#grpc.framework.foundation.callable_util.Outcome.Kind.RETURNED" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.framework.foundation.callable_util.call_logging_exceptions">
 
-<code class="descclassname">grpc.framework.foundation.callable_util.</code><code class="descname">call_logging_exceptions</code><span class="sig-paren">(</span><em>behavior</em>, <em>message</em>, <em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/callable_util.html#call_logging_exceptions"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.callable_util.call_logging_exceptions" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Calls a behavior in a try-except that logs any exceptions it raises.</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"><ul class="first simple">
 
-<li><strong>behavior</strong> – Any callable.</li>
 
-<li><strong>message</strong> – A string to log if the behavior raises an exception.</li>
 
-<li><strong>*args</strong> – Positional arguments to pass to the given behavior.</li>
 
-<li><strong>**kwargs</strong> – Keyword arguments to pass to the given behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>An Outcome describing whether the given behavior returned a value or raised</dt>
 
-<dd><p class="first last">an exception.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.framework.foundation.callable_util.with_exceptions_logged">
 
-<code class="descclassname">grpc.framework.foundation.callable_util.</code><code class="descname">with_exceptions_logged</code><span class="sig-paren">(</span><em>behavior</em>, <em>message</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/callable_util.html#with_exceptions_logged"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.callable_util.with_exceptions_logged" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Wraps a callable in a try-except that logs any exceptions it raises.</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"><ul class="first simple">
 
-<li><strong>behavior</strong> – Any callable.</li>
 
-<li><strong>message</strong> – A string to log if the behavior raises an exception.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>A callable that when executed invokes the given behavior. The returned</dt>
 
-<dd><p class="first last">callable takes the same arguments as the given behavior but returns a
 
-future.Outcome describing whether the given behavior returned a value or
 
-raised an exception.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.framework.foundation.future">
 
-<span id="grpc-framework-foundation-future-module"></span><h2>grpc.framework.foundation.future module<a class="headerlink" href="#module-grpc.framework.foundation.future" title="Permalink to this headline">¶</a></h2>
 
-<p>A Future interface.</p>
 
-<p>Python doesn’t have a Future interface in its standard library. In the absence
 
-of such a standard, three separate, incompatible implementations
 
-(concurrent.futures.Future, ndb.Future, and asyncio.Future) have appeared. This
 
-interface attempts to be as compatible as possible with
 
-concurrent.futures.Future. From ndb.Future it adopts a traceback-object accessor
 
-method.</p>
 
-<p>Unlike the concrete and implemented Future classes listed above, the Future
 
-class defined in this module is an entirely abstract interface that anyone may
 
-implement and use.</p>
 
-<p>The one known incompatibility between this interface and the interface of
 
-concurrent.futures.Future is that this interface defines its own CancelledError
 
-and TimeoutError exceptions rather than raising the implementation-private
 
-concurrent.futures._base.CancelledError and the
 
-built-in-but-only-in-3.3-and-later TimeoutError.</p>
 
-<dl class="exception">
 
-<dt id="grpc.framework.foundation.future.CancelledError">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.foundation.future.</code><code class="descname">CancelledError</code><a class="reference internal" href="_modules/grpc/framework/foundation/future.html#CancelledError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.future.CancelledError" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">exceptions.Exception</span></code></p>
 
-<p>Indicates that the computation underlying a Future was cancelled.</p>
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.foundation.future.Future">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.foundation.future.</code><code class="descname">Future</code><a class="reference internal" href="_modules/grpc/framework/foundation/future.html#Future"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.future.Future" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>A representation of a computation in another control flow.</p>
 
-<p>Computations represented by a Future may be yet to be begun, may be ongoing,
 
-or may have already completed.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.future.Future.add_done_callback">
 
-<code class="descname">add_done_callback</code><span class="sig-paren">(</span><em>fn</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/future.html#Future.add_done_callback"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.future.Future.add_done_callback" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Adds a function to be called at completion of the computation.</p>
 
-<p>The callback will be passed this Future object describing the outcome of
 
-the computation.</p>
 
-<p>If the computation has already completed, the callback will be called
 
-immediately.</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>fn</strong> – A callable taking this Future object as its single parameter.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.future.Future.cancel">
 
-<code class="descname">cancel</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/future.html#Future.cancel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.future.Future.cancel" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Attempts to cancel the computation.</p>
 
-<p>This method does not block.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>True if the computation has not yet begun, will not be allowed to take</dt>
 
-<dd>place, and determination of both was possible without blocking. False
 
-under all other circumstances including but not limited to the
 
-computation’s already having begun, the computation’s already having
 
-finished, and the computation’s having been scheduled for execution on a
 
-remote system for which a determination of whether or not it commenced
 
-before being cancelled cannot be made without blocking.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.future.Future.cancelled">
 
-<code class="descname">cancelled</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/future.html#Future.cancelled"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.future.Future.cancelled" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Describes whether the computation was cancelled.</p>
 
-<p>This method does not block.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>True if the computation was cancelled any time before its result became</dt>
 
-<dd>immediately available. False under all other circumstances including but
 
-not limited to this object’s cancel method not having been called and
 
-the computation’s result having become immediately available.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.future.Future.done">
 
-<code class="descname">done</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/future.html#Future.done"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.future.Future.done" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Describes whether the computation has taken place.</p>
 
-<p>This method does not block.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>True if the computation is known to have either completed or have been</dt>
 
-<dd>unscheduled or interrupted. False if the computation may possibly be
 
-executing or scheduled to execute later.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.future.Future.exception">
 
-<code class="descname">exception</code><span class="sig-paren">(</span><em>timeout=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/future.html#Future.exception"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.future.Future.exception" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Return the exception raised by the computation.</p>
 
-<p>This method may return immediately or may block.</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"><p class="first"><strong>timeout</strong> – The length of time in seconds to wait for the computation to
 
-terminate or be cancelled, or None if this method should block until
 
-the computation is terminated or is cancelled no matter how long that
 
-takes.</p>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first"><dl class="docutils">
 
-<dt>The exception raised by the computation, or None if the computation did</dt>
 
-<dd><p class="first last">not raise an exception.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><ul class="first last simple">
 
-<li><a class="reference internal" href="#grpc.framework.foundation.future.TimeoutError" title="grpc.framework.foundation.future.TimeoutError"><code class="xref py py-exc docutils literal"><span class="pre">TimeoutError</span></code></a> – If a timeout value is passed and the computation does not
 
-terminate within the allotted time.</li>
 
-<li><a class="reference internal" href="#grpc.framework.foundation.future.CancelledError" title="grpc.framework.foundation.future.CancelledError"><code class="xref py py-exc docutils literal"><span class="pre">CancelledError</span></code></a> – If the computation was cancelled.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.future.Future.result">
 
-<code class="descname">result</code><span class="sig-paren">(</span><em>timeout=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/future.html#Future.result"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.future.Future.result" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accesses the outcome of the computation or raises its exception.</p>
 
-<p>This method may return immediately or may block.</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"><p class="first"><strong>timeout</strong> – The length of time in seconds to wait for the computation to
 
-finish or be cancelled, or None if this method should block until the
 
-computation has finished or is cancelled no matter how long that takes.</p>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">The return value of the computation.</p>
 
-</td>
 
-</tr>
 
-<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><ul class="first last simple">
 
-<li><a class="reference internal" href="#grpc.framework.foundation.future.TimeoutError" title="grpc.framework.foundation.future.TimeoutError"><code class="xref py py-exc docutils literal"><span class="pre">TimeoutError</span></code></a> – If a timeout value is passed and the computation does not
 
-terminate within the allotted time.</li>
 
-<li><a class="reference internal" href="#grpc.framework.foundation.future.CancelledError" title="grpc.framework.foundation.future.CancelledError"><code class="xref py py-exc docutils literal"><span class="pre">CancelledError</span></code></a> – If the computation was cancelled.</li>
 
-<li><code class="xref py py-exc docutils literal"><span class="pre">Exception</span></code> – If the computation raised an exception, this call will raise
 
-the same exception.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.future.Future.running">
 
-<code class="descname">running</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/future.html#Future.running"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.future.Future.running" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Describes whether the computation is taking place.</p>
 
-<p>This method does not block.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>True if the computation is scheduled to take place in the future or is</dt>
 
-<dd>taking place now, or False if the computation took place in the past or
 
-was cancelled.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.future.Future.traceback">
 
-<code class="descname">traceback</code><span class="sig-paren">(</span><em>timeout=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/future.html#Future.traceback"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.future.Future.traceback" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Access the traceback of the exception raised by the computation.</p>
 
-<p>This method may return immediately or may block.</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"><p class="first"><strong>timeout</strong> – The length of time in seconds to wait for the computation to
 
-terminate or be cancelled, or None if this method should block until
 
-the computation is terminated or is cancelled no matter how long that
 
-takes.</p>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first"><dl class="docutils">
 
-<dt>The traceback of the exception raised by the computation, or None if the</dt>
 
-<dd><p class="first last">computation did not raise an exception.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><ul class="first last simple">
 
-<li><a class="reference internal" href="#grpc.framework.foundation.future.TimeoutError" title="grpc.framework.foundation.future.TimeoutError"><code class="xref py py-exc docutils literal"><span class="pre">TimeoutError</span></code></a> – If a timeout value is passed and the computation does not
 
-terminate within the allotted time.</li>
 
-<li><a class="reference internal" href="#grpc.framework.foundation.future.CancelledError" title="grpc.framework.foundation.future.CancelledError"><code class="xref py py-exc docutils literal"><span class="pre">CancelledError</span></code></a> – If the computation was cancelled.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="exception">
 
-<dt id="grpc.framework.foundation.future.TimeoutError">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.foundation.future.</code><code class="descname">TimeoutError</code><a class="reference internal" href="_modules/grpc/framework/foundation/future.html#TimeoutError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.future.TimeoutError" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">exceptions.Exception</span></code></p>
 
-<p>Indicates that a particular call timed out.</p>
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.framework.foundation.logging_pool">
 
-<span id="grpc-framework-foundation-logging-pool-module"></span><h2>grpc.framework.foundation.logging_pool module<a class="headerlink" href="#module-grpc.framework.foundation.logging_pool" title="Permalink to this headline">¶</a></h2>
 
-<p>A thread pool that logs exceptions raised by tasks executed within it.</p>
 
-<dl class="function">
 
-<dt id="grpc.framework.foundation.logging_pool.pool">
 
-<code class="descclassname">grpc.framework.foundation.logging_pool.</code><code class="descname">pool</code><span class="sig-paren">(</span><em>max_workers</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/logging_pool.html#pool"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.logging_pool.pool" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a thread pool that logs exceptions raised by the tasks within it.</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>max_workers</strong> – The maximum number of worker threads to allow the pool.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>A futures.ThreadPoolExecutor-compatible thread pool that logs exceptions</dt>
 
-<dd>raised by the tasks executed within it.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.framework.foundation.stream">
 
-<span id="grpc-framework-foundation-stream-module"></span><h2>grpc.framework.foundation.stream module<a class="headerlink" href="#module-grpc.framework.foundation.stream" title="Permalink to this headline">¶</a></h2>
 
-<p>Interfaces related to streams of values or objects.</p>
 
-<dl class="class">
 
-<dt id="grpc.framework.foundation.stream.Consumer">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.foundation.stream.</code><code class="descname">Consumer</code><a class="reference internal" href="_modules/grpc/framework/foundation/stream.html#Consumer"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream.Consumer" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Interface for consumers of finite streams of values or objects.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream.Consumer.consume">
 
-<code class="descname">consume</code><span class="sig-paren">(</span><em>value</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream.html#Consumer.consume"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream.Consumer.consume" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accepts a value.</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>value</strong> – Any value accepted by this Consumer.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream.Consumer.consume_and_terminate">
 
-<code class="descname">consume_and_terminate</code><span class="sig-paren">(</span><em>value</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream.html#Consumer.consume_and_terminate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream.Consumer.consume_and_terminate" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Supplies a value and signals that no more values will be supplied.</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>value</strong> – Any value accepted by this Consumer.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream.Consumer.terminate">
 
-<code class="descname">terminate</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream.html#Consumer.terminate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream.Consumer.terminate" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Indicates to this Consumer that no more values will be supplied.</p>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.framework.foundation.stream_util">
 
-<span id="grpc-framework-foundation-stream-util-module"></span><h2>grpc.framework.foundation.stream_util module<a class="headerlink" href="#module-grpc.framework.foundation.stream_util" title="Permalink to this headline">¶</a></h2>
 
-<p>Helpful utilities related to the stream module.</p>
 
-<dl class="class">
 
-<dt id="grpc.framework.foundation.stream_util.IterableConsumer">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.foundation.stream_util.</code><code class="descname">IterableConsumer</code><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#IterableConsumer"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.IterableConsumer" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.foundation.stream.Consumer" title="grpc.framework.foundation.stream.Consumer"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.foundation.stream.Consumer</span></code></a></p>
 
-<p>A Consumer that when iterated over emits the values it has consumed.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream_util.IterableConsumer.consume">
 
-<code class="descname">consume</code><span class="sig-paren">(</span><em>stock_reply</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#IterableConsumer.consume"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.IterableConsumer.consume" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream_util.IterableConsumer.consume_and_terminate">
 
-<code class="descname">consume_and_terminate</code><span class="sig-paren">(</span><em>stock_reply</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#IterableConsumer.consume_and_terminate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.IterableConsumer.consume_and_terminate" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream_util.IterableConsumer.next">
 
-<code class="descname">next</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#IterableConsumer.next"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.IterableConsumer.next" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream_util.IterableConsumer.terminate">
 
-<code class="descname">terminate</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#IterableConsumer.terminate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.IterableConsumer.terminate" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.foundation.stream_util.ThreadSwitchingConsumer">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.foundation.stream_util.</code><code class="descname">ThreadSwitchingConsumer</code><span class="sig-paren">(</span><em>sink</em>, <em>pool</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#ThreadSwitchingConsumer"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.ThreadSwitchingConsumer" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.foundation.stream.Consumer" title="grpc.framework.foundation.stream.Consumer"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.foundation.stream.Consumer</span></code></a></p>
 
-<p>A Consumer decorator that affords serialization and asynchrony.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream_util.ThreadSwitchingConsumer.consume">
 
-<code class="descname">consume</code><span class="sig-paren">(</span><em>value</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#ThreadSwitchingConsumer.consume"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.ThreadSwitchingConsumer.consume" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream_util.ThreadSwitchingConsumer.consume_and_terminate">
 
-<code class="descname">consume_and_terminate</code><span class="sig-paren">(</span><em>value</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#ThreadSwitchingConsumer.consume_and_terminate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.ThreadSwitchingConsumer.consume_and_terminate" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream_util.ThreadSwitchingConsumer.terminate">
 
-<code class="descname">terminate</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#ThreadSwitchingConsumer.terminate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.ThreadSwitchingConsumer.terminate" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.foundation.stream_util.TransformingConsumer">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.foundation.stream_util.</code><code class="descname">TransformingConsumer</code><span class="sig-paren">(</span><em>transformation</em>, <em>downstream</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#TransformingConsumer"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.TransformingConsumer" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.foundation.stream.Consumer" title="grpc.framework.foundation.stream.Consumer"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.foundation.stream.Consumer</span></code></a></p>
 
-<p>A stream.Consumer that passes a transformation of its input to another.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream_util.TransformingConsumer.consume">
 
-<code class="descname">consume</code><span class="sig-paren">(</span><em>value</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#TransformingConsumer.consume"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.TransformingConsumer.consume" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream_util.TransformingConsumer.consume_and_terminate">
 
-<code class="descname">consume_and_terminate</code><span class="sig-paren">(</span><em>value</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#TransformingConsumer.consume_and_terminate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.TransformingConsumer.consume_and_terminate" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.foundation.stream_util.TransformingConsumer.terminate">
 
-<code class="descname">terminate</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/foundation/stream_util.html#TransformingConsumer.terminate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.foundation.stream_util.TransformingConsumer.terminate" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.framework.foundation">
 
-<span id="module-contents"></span><h2>Module contents<a class="headerlink" href="#module-grpc.framework.foundation" title="Permalink to this headline">¶</a></h2>
 
-</div>
 
-</div>
 
-
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 
-      
-        <a href="grpc.framework.interfaces.html" class="btn btn-neutral float-right" title="grpc.framework.interfaces package" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
 
-      
-      
-        <a href="grpc.framework.common.html" class="btn btn-neutral" title="grpc.framework.common package" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
 
-      
-    </div>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'./',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="_static/jquery.js"></script>
 
-      <script type="text/javascript" src="_static/underscore.js"></script>
 
-      <script type="text/javascript" src="_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 300
python/grpc.framework.html
查看文件 

@@ -1,300 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework package &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="genindex.html"/>
 
-        <link rel="search" title="Search" href="search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="index.html"/>
 
-        <link rel="up" title="grpc package" href="grpc.html"/>
 
-        <link rel="next" title="grpc.framework.common package" href="grpc.framework.common.html"/>
 
-        <link rel="prev" title="grpc.beta package" href="grpc.beta.html"/> 
-
 
-  
-  <script src="_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul class="current">
 
-<li class="toctree-l1 current"><a class="reference internal" href="grpc.html">grpc package</a><ul class="current">
 
-<li class="toctree-l2 current"><a class="reference internal" href="grpc.html#subpackages">Subpackages</a><ul class="current">
 
-<li class="toctree-l3"><a class="reference internal" href="grpc.beta.html">grpc.beta package</a></li>
 
-<li class="toctree-l3 current"><a class="current reference internal" href="#">grpc.framework package</a><ul>
 
-<li class="toctree-l4"><a class="reference internal" href="#subpackages">Subpackages</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="#module-grpc.framework">Module contents</a></li>
 
-</ul>
 
-</li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.html#module-grpc">Module contents</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="grpc.html">grpc package</a> &raquo;</li>
 
-        
-      <li>grpc.framework package</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-            <a href="_sources/grpc.framework.rst.txt" rel="nofollow"> View page source</a>
 
-          
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <div class="section" id="grpc-framework-package">
 
-<h1>grpc.framework package<a class="headerlink" href="#grpc-framework-package" title="Permalink to this headline">¶</a></h1>
 
-<div class="section" id="subpackages">
 
-<h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to this headline">¶</a></h2>
 
-<div class="toctree-wrapper compound">
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.framework.common.html">grpc.framework.common package</a><ul>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.common.html#submodules">Submodules</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.common.html#module-grpc.framework.common.cardinality">grpc.framework.common.cardinality module</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.common.html#module-grpc.framework.common.style">grpc.framework.common.style module</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.common.html#module-grpc.framework.common">Module contents</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.framework.foundation.html">grpc.framework.foundation package</a><ul>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.foundation.html#submodules">Submodules</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.foundation.html#module-grpc.framework.foundation.abandonment">grpc.framework.foundation.abandonment module</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.foundation.html#module-grpc.framework.foundation.callable_util">grpc.framework.foundation.callable_util module</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.foundation.html#module-grpc.framework.foundation.future">grpc.framework.foundation.future module</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.foundation.html#module-grpc.framework.foundation.logging_pool">grpc.framework.foundation.logging_pool module</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.foundation.html#module-grpc.framework.foundation.stream">grpc.framework.foundation.stream module</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.foundation.html#module-grpc.framework.foundation.stream_util">grpc.framework.foundation.stream_util module</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.foundation.html#module-grpc.framework.foundation">Module contents</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.framework.interfaces.html">grpc.framework.interfaces package</a><ul>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.interfaces.html#subpackages">Subpackages</a><ul>
 
-<li class="toctree-l3"><a class="reference internal" href="grpc.framework.interfaces.base.html">grpc.framework.interfaces.base package</a><ul>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.interfaces.base.html#submodules">Submodules</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.interfaces.base.html#module-grpc.framework.interfaces.base.base">grpc.framework.interfaces.base.base module</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.interfaces.base.html#module-grpc.framework.interfaces.base.utilities">grpc.framework.interfaces.base.utilities module</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.interfaces.base.html#module-grpc.framework.interfaces.base">Module contents</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l3"><a class="reference internal" href="grpc.framework.interfaces.face.html">grpc.framework.interfaces.face package</a><ul>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.interfaces.face.html#submodules">Submodules</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.interfaces.face.html#module-grpc.framework.interfaces.face.face">grpc.framework.interfaces.face.face module</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.interfaces.face.html#module-grpc.framework.interfaces.face.utilities">grpc.framework.interfaces.face.utilities module</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.interfaces.face.html#module-grpc.framework.interfaces.face">Module contents</a></li>
 
-</ul>
 
-</li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.interfaces.html#module-grpc.framework.interfaces">Module contents</a></li>
 
-</ul>
 
-</li>
 
-</ul>
 
-</div>
 
-</div>
 
-<div class="section" id="module-grpc.framework">
 
-<span id="module-contents"></span><h2>Module contents<a class="headerlink" href="#module-grpc.framework" title="Permalink to this headline">¶</a></h2>
 
-</div>
 
-</div>
 
-
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 
-      
-        <a href="grpc.framework.common.html" class="btn btn-neutral float-right" title="grpc.framework.common package" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
 
-      
-      
-        <a href="grpc.beta.html" class="btn btn-neutral" title="grpc.beta package" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
 
-      
-    </div>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'./',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="_static/jquery.js"></script>
 
-      <script type="text/javascript" src="_static/underscore.js"></script>
 
-      <script type="text/javascript" src="_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 811
python/grpc.framework.interfaces.base.html
查看文件 

@@ -1,811 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.interfaces.base package &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="genindex.html"/>
 
-        <link rel="search" title="Search" href="search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="index.html"/>
 
-        <link rel="up" title="grpc.framework.interfaces package" href="grpc.framework.interfaces.html"/>
 
-        <link rel="next" title="grpc.framework.interfaces.face package" href="grpc.framework.interfaces.face.html"/>
 
-        <link rel="prev" title="grpc.framework.interfaces package" href="grpc.framework.interfaces.html"/> 
-
 
-  
-  <script src="_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul class="current">
 
-<li class="toctree-l1 current"><a class="reference internal" href="grpc.html">grpc package</a><ul class="current">
 
-<li class="toctree-l2 current"><a class="reference internal" href="grpc.html#subpackages">Subpackages</a><ul class="current">
 
-<li class="toctree-l3"><a class="reference internal" href="grpc.beta.html">grpc.beta package</a></li>
 
-<li class="toctree-l3 current"><a class="reference internal" href="grpc.framework.html">grpc.framework package</a><ul class="current">
 
-<li class="toctree-l4 current"><a class="reference internal" href="grpc.framework.html#subpackages">Subpackages</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.html#module-grpc.framework">Module contents</a></li>
 
-</ul>
 
-</li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.html#module-grpc">Module contents</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="grpc.html">grpc package</a> &raquo;</li>
 
-        
-          <li><a href="grpc.framework.html">grpc.framework package</a> &raquo;</li>
 
-        
-          <li><a href="grpc.framework.interfaces.html">grpc.framework.interfaces package</a> &raquo;</li>
 
-        
-      <li>grpc.framework.interfaces.base package</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-            <a href="_sources/grpc.framework.interfaces.base.rst.txt" rel="nofollow"> View page source</a>
 
-          
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <div class="section" id="grpc-framework-interfaces-base-package">
 
-<h1>grpc.framework.interfaces.base package<a class="headerlink" href="#grpc-framework-interfaces-base-package" title="Permalink to this headline">¶</a></h1>
 
-<div class="section" id="submodules">
 
-<h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this headline">¶</a></h2>
 
-</div>
 
-<div class="section" id="module-grpc.framework.interfaces.base.base">
 
-<span id="grpc-framework-interfaces-base-base-module"></span><h2>grpc.framework.interfaces.base.base module<a class="headerlink" href="#module-grpc.framework.interfaces.base.base" title="Permalink to this headline">¶</a></h2>
 
-<p>The base interface of RPC Framework.</p>
 
-<p>Implementations of this interface support the conduct of “operations”:
 
-exchanges between two distinct ends of an arbitrary number of data payloads
 
-and metadata such as a name for the operation, initial and terminal metadata
 
-in each direction, and flow control. These operations may be used for transfers
 
-of data, remote procedure calls, status indication, or anything else
 
-applications choose.</p>
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.base.base.Completion">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.base.base.</code><code class="descname">Completion</code><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#Completion"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.Completion" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>An aggregate of the values exchanged upon operation completion.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Completion.terminal_metadata">
 
-<code class="descname">terminal_metadata</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.Completion.terminal_metadata" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A terminal metadata value for the operaton.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Completion.code">
 
-<code class="descname">code</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.Completion.code" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A code value for the operation.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Completion.message">
 
-<code class="descname">message</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.Completion.message" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A message value for the operation.</p>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.base.base.End">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.base.base.</code><code class="descname">End</code><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#End"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.End" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Common type for entry-point objects on both sides of an operation.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.End.add_idle_action">
 
-<code class="descname">add_idle_action</code><span class="sig-paren">(</span><em>action</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#End.add_idle_action"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.End.add_idle_action" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Adds an action to be called when this End has no ongoing operations.</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>action</strong> – A callable that accepts no arguments.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.End.operate">
 
-<code class="descname">operate</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>subscription</em>, <em>timeout</em>, <em>initial_metadata=None</em>, <em>payload=None</em>, <em>completion=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#End.operate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.End.operate" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Commences an operation.</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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the invoked operation.</li>
 
-<li><strong>method</strong> – The method identifier of the invoked operation.</li>
 
-<li><strong>subscription</strong> – A Subscription to which the results of the operation will be
 
-passed.</li>
 
-<li><strong>timeout</strong> – A length of time in seconds to allow for the operation.</li>
 
-<li><strong>initial_metadata</strong> – An initial metadata value to be sent to the other side
 
-of the operation. May be None if the initial metadata will be later
 
-passed via the returned operator or if there will be no initial metadata
 
-passed at all.</li>
 
-<li><strong>payload</strong> – An initial payload for the operation.</li>
 
-<li><strong>completion</strong> – A Completion value indicating the end of transmission to the
 
-other side of the operation.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Base interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>A pair of objects affording information about the operation and action</dt>
 
-<dd><p class="first last">continuing the operation. The first element of the returned pair is an
 
-OperationContext for the operation and the second element of the
 
-returned pair is an Operator to which operation values not passed in
 
-this call should later be passed.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.End.operation_stats">
 
-<code class="descname">operation_stats</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#End.operation_stats"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.End.operation_stats" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Reports the number of terminated operations broken down by outcome.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>A dictionary from Outcome.Kind value to an integer identifying the number</dt>
 
-<dd>of operations that terminated with that outcome kind.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.End.start">
 
-<code class="descname">start</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#End.start"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.End.start" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Starts this object’s service of operations.</p>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.End.stop">
 
-<code class="descname">stop</code><span class="sig-paren">(</span><em>grace</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#End.stop"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.End.stop" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Stops this object’s service of operations.</p>
 
-<p>This object will refuse service of new operations as soon as this method is
 
-called but operations under way at the time of the call may be given a
 
-grace period during which they are allowed to finish.</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>grace</strong> – A duration of time in seconds to allow ongoing operations to
 
-terminate before being forcefully terminated by the stopping of this
 
-End. May be zero to terminate all ongoing operations and immediately
 
-stop.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>A threading.Event that will be set to indicate all operations having</dt>
 
-<dd>terminated and this End having completely stopped. The returned event
 
-may not be set until after the full grace period (if some ongoing
 
-operation continues for the full length of the period) or it may be set
 
-much sooner (if for example this End had no operations in progress at
 
-the time its stop method was called).</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="exception">
 
-<dt id="grpc.framework.interfaces.base.base.NoSuchMethodError">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.interfaces.base.base.</code><code class="descname">NoSuchMethodError</code><span class="sig-paren">(</span><em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#NoSuchMethodError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.NoSuchMethodError" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">exceptions.Exception</span></code></p>
 
-<p>Indicates that an unrecognized operation has been called.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.NoSuchMethodError.code">
 
-<code class="descname">code</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.NoSuchMethodError.code" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A code value to communicate to the other side of the operation
 
-along with indication of operation termination. May be None.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.NoSuchMethodError.details">
 
-<code class="descname">details</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.NoSuchMethodError.details" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A details value to communicate to the other side of the
 
-operation along with indication of operation termination. May be None.</p>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.base.base.OperationContext">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.base.base.</code><code class="descname">OperationContext</code><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#OperationContext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.OperationContext" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Provides operation-related information and action.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.OperationContext.add_termination_callback">
 
-<code class="descname">add_termination_callback</code><span class="sig-paren">(</span><em>callback</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#OperationContext.add_termination_callback"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.OperationContext.add_termination_callback" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Adds a function to be called upon operation termination.</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>callback</strong> – A callable to be passed an Outcome value on operation
 
-termination.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>None if the operation has not yet terminated and the passed callback will</dt>
 
-<dd>later be called when it does terminate, or if the operation has already
 
-terminated an Outcome value describing the operation termination and the
 
-passed callback will not be called as a result of this method call.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.OperationContext.cancel">
 
-<code class="descname">cancel</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#OperationContext.cancel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.OperationContext.cancel" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Cancels the operation if the operation has not yet terminated.</p>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.OperationContext.fail">
 
-<code class="descname">fail</code><span class="sig-paren">(</span><em>exception</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#OperationContext.fail"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.OperationContext.fail" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Indicates that the operation has failed.</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>exception</strong> – An exception germane to the operation failure. May be None.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.OperationContext.outcome">
 
-<code class="descname">outcome</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#OperationContext.outcome"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.OperationContext.outcome" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Indicates the operation’s outcome (or that the operation is ongoing).</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">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>None if the operation is still active or the Outcome value for the</dt>
 
-<dd>operation if it has terminated.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.OperationContext.time_remaining">
 
-<code class="descname">time_remaining</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#OperationContext.time_remaining"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.OperationContext.time_remaining" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Describes the length of allowed time remaining for the operation.</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">Returns:</th><td class="field-body">A nonnegative float indicating the length of allowed time in seconds
 
-remaining for the operation to complete before it is considered to have
 
-timed out. Zero is returned if the operation has terminated.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.base.base.Operator">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.base.base.</code><code class="descname">Operator</code><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#Operator"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.Operator" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>An interface through which to participate in an operation.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.Operator.advance">
 
-<code class="descname">advance</code><span class="sig-paren">(</span><em>initial_metadata=None</em>, <em>payload=None</em>, <em>completion=None</em>, <em>allowance=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#Operator.advance"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.Operator.advance" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Progresses the operation.</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"><ul class="first last simple">
 
-<li><strong>initial_metadata</strong> – An initial metadata value. Only one may ever be
 
-communicated in each direction for an operation, and they must be
 
-communicated no later than either the first payload or the completion.</li>
 
-<li><strong>payload</strong> – A payload value.</li>
 
-<li><strong>completion</strong> – A Completion value. May only ever be non-None once in either
 
-direction, and no payloads may be passed after it has been communicated.</li>
 
-<li><strong>allowance</strong> – A positive integer communicating the number of additional
 
-payloads allowed to be passed by the remote side of the operation.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.base.base.</code><code class="descname">Outcome</code><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#Outcome"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>The outcome of an operation.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.kind">
 
-<code class="descname">kind</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.kind" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A Kind value coarsely identifying how the operation terminated.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.code">
 
-<code class="descname">code</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.code" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>An application-specific code value or None if no such value was
 
-provided.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.details">
 
-<code class="descname">details</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.details" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>An application-specific details value or None if no such value was
 
-provided.</p>
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.Kind">
 
-<em class="property">class </em><code class="descname">Kind</code><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#Outcome.Kind"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.Kind" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">enum.Enum</span></code></p>
 
-<p>Ways in which an operation can terminate.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.Kind.CANCELLED">
 
-<code class="descname">CANCELLED</code><em class="property"> = 'cancelled'</em><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.Kind.CANCELLED" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.Kind.COMPLETED">
 
-<code class="descname">COMPLETED</code><em class="property"> = 'completed'</em><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.Kind.COMPLETED" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.Kind.EXPIRED">
 
-<code class="descname">EXPIRED</code><em class="property"> = 'expired'</em><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.Kind.EXPIRED" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.Kind.LOCAL_FAILURE">
 
-<code class="descname">LOCAL_FAILURE</code><em class="property"> = 'local failure'</em><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.Kind.LOCAL_FAILURE" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.Kind.LOCAL_SHUTDOWN">
 
-<code class="descname">LOCAL_SHUTDOWN</code><em class="property"> = 'local shutdown'</em><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.Kind.LOCAL_SHUTDOWN" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.Kind.RECEPTION_FAILURE">
 
-<code class="descname">RECEPTION_FAILURE</code><em class="property"> = 'reception failure'</em><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.Kind.RECEPTION_FAILURE" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.Kind.REMOTE_FAILURE">
 
-<code class="descname">REMOTE_FAILURE</code><em class="property"> = 'remote failure'</em><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.Kind.REMOTE_FAILURE" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.Kind.REMOTE_SHUTDOWN">
 
-<code class="descname">REMOTE_SHUTDOWN</code><em class="property"> = 'remote shutdown'</em><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.Kind.REMOTE_SHUTDOWN" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Outcome.Kind.TRANSMISSION_FAILURE">
 
-<code class="descname">TRANSMISSION_FAILURE</code><em class="property"> = 'transmission failure'</em><a class="headerlink" href="#grpc.framework.interfaces.base.base.Outcome.Kind.TRANSMISSION_FAILURE" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.base.base.ProtocolReceiver">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.base.base.</code><code class="descname">ProtocolReceiver</code><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#ProtocolReceiver"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.ProtocolReceiver" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>A means of receiving protocol values during an operation.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.ProtocolReceiver.context">
 
-<code class="descname">context</code><span class="sig-paren">(</span><em>protocol_context</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#ProtocolReceiver.context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.ProtocolReceiver.context" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accepts the protocol context object for the operation.</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>protocol_context</strong> – The protocol context object for the operation.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.base.base.Servicer">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.base.base.</code><code class="descname">Servicer</code><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#Servicer"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.Servicer" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Interface for service implementations.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.base.base.Servicer.service">
 
-<code class="descname">service</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>context</em>, <em>output_operator</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#Servicer.service"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.Servicer.service" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Services an operation.</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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the operation to be serviced.</li>
 
-<li><strong>method</strong> – The method identifier of the operation to be serviced.</li>
 
-<li><strong>context</strong> – An OperationContext object affording contextual information and
 
-actions.</li>
 
-<li><strong>output_operator</strong> – An Operator that will accept output values of the
 
-operation.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first"><dl class="docutils">
 
-<dt>A Subscription via which this object may or may not accept more values of</dt>
 
-<dd><p class="first last">the operation.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><ul class="first last simple">
 
-<li><a class="reference internal" href="#grpc.framework.interfaces.base.base.NoSuchMethodError" title="grpc.framework.interfaces.base.base.NoSuchMethodError"><code class="xref py py-exc docutils literal"><span class="pre">NoSuchMethodError</span></code></a> – If this Servicer does not handle operations with the
 
-given group and method.</li>
 
-<li><code class="xref py py-exc docutils literal"><span class="pre">abandonment.Abandoned</span></code> – If the operation has been aborted and there no
 
-longer is any reason to service the operation.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.base.base.Subscription">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.base.base.</code><code class="descname">Subscription</code><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#Subscription"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.Subscription" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Describes customer code’s interest in values from the other side.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Subscription.kind">
 
-<code class="descname">kind</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.Subscription.kind" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A Kind value describing the overall kind of this value.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Subscription.termination_callback">
 
-<code class="descname">termination_callback</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.Subscription.termination_callback" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A callable to be passed the Outcome associated with
 
-the operation after it has terminated. Must be non-None if kind is
 
-Kind.TERMINATION_ONLY. Must be None otherwise.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Subscription.allowance">
 
-<code class="descname">allowance</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.Subscription.allowance" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A callable behavior that accepts positive integers representing
 
-the number of additional payloads allowed to be passed to the other side
 
-of the operation. Must be None if kind is Kind.FULL. Must not be None
 
-otherwise.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Subscription.operator">
 
-<code class="descname">operator</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.Subscription.operator" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>An Operator to be passed values from the other side of the
 
-operation. Must be non-None if kind is Kind.FULL. Must be None otherwise.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Subscription.protocol_receiver">
 
-<code class="descname">protocol_receiver</code><a class="headerlink" href="#grpc.framework.interfaces.base.base.Subscription.protocol_receiver" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A ProtocolReceiver to be passed protocol objects as they
 
-become available during the operation. Must be non-None if kind is
 
-Kind.FULL.</p>
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.base.base.Subscription.Kind">
 
-<em class="property">class </em><code class="descname">Kind</code><a class="reference internal" href="_modules/grpc/framework/interfaces/base/base.html#Subscription.Kind"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.base.Subscription.Kind" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">enum.Enum</span></code></p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Subscription.Kind.FULL">
 
-<code class="descname">FULL</code><em class="property"> = 'full'</em><a class="headerlink" href="#grpc.framework.interfaces.base.base.Subscription.Kind.FULL" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Subscription.Kind.NONE">
 
-<code class="descname">NONE</code><em class="property"> = 'none'</em><a class="headerlink" href="#grpc.framework.interfaces.base.base.Subscription.Kind.NONE" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.base.base.Subscription.Kind.TERMINATION_ONLY">
 
-<code class="descname">TERMINATION_ONLY</code><em class="property"> = 'termination only'</em><a class="headerlink" href="#grpc.framework.interfaces.base.base.Subscription.Kind.TERMINATION_ONLY" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.framework.interfaces.base.utilities">
 
-<span id="grpc-framework-interfaces-base-utilities-module"></span><h2>grpc.framework.interfaces.base.utilities module<a class="headerlink" href="#module-grpc.framework.interfaces.base.utilities" title="Permalink to this headline">¶</a></h2>
 
-<p>Utilities for use with the base interface of RPC Framework.</p>
 
-<dl class="function">
 
-<dt id="grpc.framework.interfaces.base.utilities.completion">
 
-<code class="descclassname">grpc.framework.interfaces.base.utilities.</code><code class="descname">completion</code><span class="sig-paren">(</span><em>terminal_metadata</em>, <em>code</em>, <em>message</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/utilities.html#completion"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.utilities.completion" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a base.Completion aggregating the given operation values.</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"><ul class="first simple">
 
-<li><strong>terminal_metadata</strong> – A terminal metadata value for an operaton.</li>
 
-<li><strong>code</strong> – A code value for an operation.</li>
 
-<li><strong>message</strong> – A message value for an operation.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A base.Completion aggregating the given operation values.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.framework.interfaces.base.utilities.full_subscription">
 
-<code class="descclassname">grpc.framework.interfaces.base.utilities.</code><code class="descname">full_subscription</code><span class="sig-paren">(</span><em>operator</em>, <em>protocol_receiver</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/base/utilities.html#full_subscription"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.base.utilities.full_subscription" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a “full” base.Subscription for the given base.Operator.</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"><ul class="first simple">
 
-<li><strong>operator</strong> – A base.Operator to be used in an operation.</li>
 
-<li><strong>protocol_receiver</strong> – A base.ProtocolReceiver to be used in an operation.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>A base.Subscription of kind base.Subscription.Kind.FULL wrapping the given</dt>
 
-<dd><p class="first last">base.Operator and base.ProtocolReceiver.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.framework.interfaces.base">
 
-<span id="module-contents"></span><h2>Module contents<a class="headerlink" href="#module-grpc.framework.interfaces.base" title="Permalink to this headline">¶</a></h2>
 
-</div>
 
-</div>
 
-
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 
-      
-        <a href="grpc.framework.interfaces.face.html" class="btn btn-neutral float-right" title="grpc.framework.interfaces.face package" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
 
-      
-      
-        <a href="grpc.framework.interfaces.html" class="btn btn-neutral" title="grpc.framework.interfaces package" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
 
-      
-    </div>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'./',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="_static/jquery.js"></script>
 
-      <script type="text/javascript" src="_static/underscore.js"></script>
 
-      <script type="text/javascript" src="_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 1815
python/grpc.framework.interfaces.face.html
查看文件 

@@ -1,1815 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.interfaces.face package &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="genindex.html"/>
 
-        <link rel="search" title="Search" href="search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="index.html"/>
 
-        <link rel="up" title="grpc.framework.interfaces package" href="grpc.framework.interfaces.html"/>
 
-        <link rel="prev" title="grpc.framework.interfaces.base package" href="grpc.framework.interfaces.base.html"/> 
-
 
-  
-  <script src="_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul class="current">
 
-<li class="toctree-l1 current"><a class="reference internal" href="grpc.html">grpc package</a><ul class="current">
 
-<li class="toctree-l2 current"><a class="reference internal" href="grpc.html#subpackages">Subpackages</a><ul class="current">
 
-<li class="toctree-l3"><a class="reference internal" href="grpc.beta.html">grpc.beta package</a></li>
 
-<li class="toctree-l3 current"><a class="reference internal" href="grpc.framework.html">grpc.framework package</a><ul class="current">
 
-<li class="toctree-l4 current"><a class="reference internal" href="grpc.framework.html#subpackages">Subpackages</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.html#module-grpc.framework">Module contents</a></li>
 
-</ul>
 
-</li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.html#module-grpc">Module contents</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="grpc.html">grpc package</a> &raquo;</li>
 
-        
-          <li><a href="grpc.framework.html">grpc.framework package</a> &raquo;</li>
 
-        
-          <li><a href="grpc.framework.interfaces.html">grpc.framework.interfaces package</a> &raquo;</li>
 
-        
-      <li>grpc.framework.interfaces.face package</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-            <a href="_sources/grpc.framework.interfaces.face.rst.txt" rel="nofollow"> View page source</a>
 
-          
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <div class="section" id="grpc-framework-interfaces-face-package">
 
-<h1>grpc.framework.interfaces.face package<a class="headerlink" href="#grpc-framework-interfaces-face-package" title="Permalink to this headline">¶</a></h1>
 
-<div class="section" id="submodules">
 
-<h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this headline">¶</a></h2>
 
-</div>
 
-<div class="section" id="module-grpc.framework.interfaces.face.face">
 
-<span id="grpc-framework-interfaces-face-face-module"></span><h2>grpc.framework.interfaces.face.face module<a class="headerlink" href="#module-grpc.framework.interfaces.face.face" title="Permalink to this headline">¶</a></h2>
 
-<p>Interfaces defining the Face layer of RPC Framework.</p>
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">Abortion</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#Abortion"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.interfaces.face.face.Abortion" title="grpc.framework.interfaces.face.face.Abortion"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.interfaces.face.face.Abortion</span></code></a></p>
 
-<p>A value describing RPC abortion.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.kind">
 
-<code class="descname">kind</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.kind" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A Kind value identifying how the RPC failed.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.initial_metadata">
 
-<code class="descname">initial_metadata</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.initial_metadata" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The initial metadata from the other side of the RPC or
 
-None if no initial metadata value was received.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.terminal_metadata">
 
-<code class="descname">terminal_metadata</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.terminal_metadata" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The terminal metadata from the other side of the RPC or
 
-None if no terminal metadata value was received.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.code">
 
-<code class="descname">code</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.code" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The code value from the other side of the RPC or None if no code value
 
-was received.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.details">
 
-<code class="descname">details</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.details" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The details value from the other side of the RPC or None if no
 
-details value was received.</p>
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.Kind">
 
-<em class="property">class </em><code class="descname">Kind</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#Abortion.Kind"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.Kind" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">enum.Enum</span></code></p>
 
-<p>Types of RPC abortion.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.Kind.CANCELLED">
 
-<code class="descname">CANCELLED</code><em class="property"> = 'cancelled'</em><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.Kind.CANCELLED" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.Kind.EXPIRED">
 
-<code class="descname">EXPIRED</code><em class="property"> = 'expired'</em><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.Kind.EXPIRED" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.Kind.LOCAL_FAILURE">
 
-<code class="descname">LOCAL_FAILURE</code><em class="property"> = 'local failure'</em><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.Kind.LOCAL_FAILURE" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.Kind.LOCAL_SHUTDOWN">
 
-<code class="descname">LOCAL_SHUTDOWN</code><em class="property"> = 'local shutdown'</em><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.Kind.LOCAL_SHUTDOWN" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.Kind.NETWORK_FAILURE">
 
-<code class="descname">NETWORK_FAILURE</code><em class="property"> = 'network failure'</em><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.Kind.NETWORK_FAILURE" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.Kind.REMOTE_FAILURE">
 
-<code class="descname">REMOTE_FAILURE</code><em class="property"> = 'remote failure'</em><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.Kind.REMOTE_FAILURE" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.Abortion.Kind.REMOTE_SHUTDOWN">
 
-<code class="descname">REMOTE_SHUTDOWN</code><em class="property"> = 'remote shutdown'</em><a class="headerlink" href="#grpc.framework.interfaces.face.face.Abortion.Kind.REMOTE_SHUTDOWN" title="Permalink to this definition">¶</a></dt>
 
-<dd></dd></dl>
 
-
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="exception">
 
-<dt id="grpc.framework.interfaces.face.face.AbortionError">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">AbortionError</code><span class="sig-paren">(</span><em>initial_metadata</em>, <em>terminal_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#AbortionError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.AbortionError" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">exceptions.Exception</span></code></p>
 
-<p>Common super type for exceptions indicating RPC abortion.</p>
 
-<dl class="docutils">
 
-<dt>initial_metadata: The initial metadata from the other side of the RPC or</dt>
 
-<dd>None if no initial metadata value was received.</dd>
 
-<dt>terminal_metadata: The terminal metadata from the other side of the RPC or</dt>
 
-<dd>None if no terminal metadata value was received.</dd>
 
-<dt>code: The code value from the other side of the RPC or None if no code value</dt>
 
-<dd>was received.</dd>
 
-<dt>details: The details value from the other side of the RPC or None if no</dt>
 
-<dd>details value was received.</dd>
 
-</dl>
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.Call">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">Call</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#Call"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.Call" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.interfaces.face.face.RpcContext" title="grpc.framework.interfaces.face.face.RpcContext"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.interfaces.face.face.RpcContext</span></code></a></p>
 
-<p>Invocation-side utility object for an RPC.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.Call.code">
 
-<code class="descname">code</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#Call.code"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.Call.code" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accesses the code emitted by the service-side of the RPC.</p>
 
-<p>This method blocks until the value is available or is known not to have been
 
-emitted from the service-side of the RPC.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>The code object emitted by the service-side of the RPC, or None if there</dt>
 
-<dd>was no such value.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.Call.details">
 
-<code class="descname">details</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#Call.details"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.Call.details" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accesses the details value emitted by the service-side of the RPC.</p>
 
-<p>This method blocks until the value is available or is known not to have been
 
-emitted from the service-side of the RPC.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>The details value emitted by the service-side of the RPC, or None if there</dt>
 
-<dd>was no such value.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.Call.initial_metadata">
 
-<code class="descname">initial_metadata</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#Call.initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.Call.initial_metadata" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accesses the initial metadata from the service-side of the RPC.</p>
 
-<p>This method blocks until the value is available or is known not to have been
 
-emitted from the service-side of the RPC.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>The initial metadata object emitted by the service-side of the RPC, or</dt>
 
-<dd>None if there was no such value.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.Call.terminal_metadata">
 
-<code class="descname">terminal_metadata</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#Call.terminal_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.Call.terminal_metadata" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accesses the terminal metadata from the service-side of the RPC.</p>
 
-<p>This method blocks until the value is available or is known not to have been
 
-emitted from the service-side of the RPC.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>The terminal metadata object emitted by the service-side of the RPC, or</dt>
 
-<dd>None if there was no such value.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="exception">
 
-<dt id="grpc.framework.interfaces.face.face.CancellationError">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">CancellationError</code><span class="sig-paren">(</span><em>initial_metadata</em>, <em>terminal_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#CancellationError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.CancellationError" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.interfaces.face.face.AbortionError" title="grpc.framework.interfaces.face.face.AbortionError"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.interfaces.face.face.AbortionError</span></code></a></p>
 
-<p>Indicates that an RPC has been cancelled.</p>
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.DynamicStub">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">DynamicStub</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#DynamicStub"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.DynamicStub" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Affords RPC invocation via attributes corresponding to afforded methods.</p>
 
-<p>Instances of this type may be scoped to a single group so that attribute
 
-access is unambiguous.</p>
 
-<p>Instances of this type respond to attribute access as follows: if the
 
-requested attribute is the name of a unary-unary method, the value of the
 
-attribute will be a UnaryUnaryMultiCallable with which to invoke an RPC; if
 
-the requested attribute is the name of a unary-stream method, the value of the
 
-attribute will be a UnaryStreamMultiCallable with which to invoke an RPC; if
 
-the requested attribute is the name of a stream-unary method, the value of the
 
-attribute will be a StreamUnaryMultiCallable with which to invoke an RPC; and
 
-if the requested attribute is the name of a stream-stream method, the value of
 
-the attribute will be a StreamStreamMultiCallable with which to invoke an RPC.</p>
 
-</dd></dl>
 
-
 
-<dl class="exception">
 
-<dt id="grpc.framework.interfaces.face.face.ExpirationError">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">ExpirationError</code><span class="sig-paren">(</span><em>initial_metadata</em>, <em>terminal_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#ExpirationError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.ExpirationError" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.interfaces.face.face.AbortionError" title="grpc.framework.interfaces.face.face.AbortionError"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.interfaces.face.face.AbortionError</span></code></a></p>
 
-<p>Indicates that an RPC has expired (“timed out”).</p>
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">GenericStub</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Affords RPC invocation via generic methods.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.blocking_stream_unary">
 
-<code class="descname">blocking_stream_unary</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>request_iterator</em>, <em>timeout</em>, <em>metadata=None</em>, <em>with_call=False</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.blocking_stream_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.blocking_stream_unary" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Invokes a stream-request-unary-response method.</p>
 
-<p>This method blocks until either returning the response value of the RPC
 
-(in the event of RPC completion) or raising an exception (in the event of
 
-RPC abortion).</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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-<li><strong>request_iterator</strong> – An iterator that yields request values for the RPC.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of the RPC.</li>
 
-<li><strong>with_call</strong> – Whether or not to include return a Call for the RPC in addition
 
-to the response.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first"><dl class="docutils">
 
-<dt>The response value for the RPC, and a Call for the RPC if with_call was</dt>
 
-<dd><p class="first last">set to True at invocation.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last"><a class="reference internal" href="#grpc.framework.interfaces.face.face.AbortionError" title="grpc.framework.interfaces.face.face.AbortionError"><code class="xref py py-exc docutils literal"><span class="pre">AbortionError</span></code></a> – Indicating that the RPC was aborted.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.blocking_unary_unary">
 
-<code class="descname">blocking_unary_unary</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>request</em>, <em>timeout</em>, <em>metadata=None</em>, <em>with_call=False</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.blocking_unary_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.blocking_unary_unary" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Invokes a unary-request-unary-response method.</p>
 
-<p>This method blocks until either returning the response value of the RPC
 
-(in the event of RPC completion) or raising an exception (in the event of
 
-RPC abortion).</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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-<li><strong>request</strong> – The request value for the RPC.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of the RPC.</li>
 
-<li><strong>with_call</strong> – Whether or not to include return a Call for the RPC in addition
 
-to the response.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first"><dl class="docutils">
 
-<dt>The response value for the RPC, and a Call for the RPC if with_call was</dt>
 
-<dd><p class="first last">set to True at invocation.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last"><a class="reference internal" href="#grpc.framework.interfaces.face.face.AbortionError" title="grpc.framework.interfaces.face.face.AbortionError"><code class="xref py py-exc docutils literal"><span class="pre">AbortionError</span></code></a> – Indicating that the RPC was aborted.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.event_stream_stream">
 
-<code class="descname">event_stream_stream</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>receiver</em>, <em>abortion_callback</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.event_stream_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.event_stream_stream" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Event-driven invocation of a unary-request-stream-response 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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-<li><strong>receiver</strong> – A ResponseReceiver to be passed the response data of the RPC.</li>
 
-<li><strong>abortion_callback</strong> – A callback to be called and passed an Abortion value
 
-in the event of RPC abortion.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>A pair of a Call object for the RPC and a stream.Consumer to which the</dt>
 
-<dd><p class="first last">request values of the RPC should be passed.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.event_stream_unary">
 
-<code class="descname">event_stream_unary</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>receiver</em>, <em>abortion_callback</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.event_stream_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.event_stream_unary" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Event-driven invocation of a unary-request-unary-response 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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-<li><strong>receiver</strong> – A ResponseReceiver to be passed the response data of the RPC.</li>
 
-<li><strong>abortion_callback</strong> – A callback to be called and passed an Abortion value
 
-in the event of RPC abortion.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>A pair of a Call object for the RPC and a stream.Consumer to which the</dt>
 
-<dd><p class="first last">request values of the RPC should be passed.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.event_unary_stream">
 
-<code class="descname">event_unary_stream</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>request</em>, <em>receiver</em>, <em>abortion_callback</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.event_unary_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.event_unary_stream" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Event-driven invocation of a unary-request-stream-response 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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-<li><strong>request</strong> – The request value for the RPC.</li>
 
-<li><strong>receiver</strong> – A ResponseReceiver to be passed the response data of the RPC.</li>
 
-<li><strong>abortion_callback</strong> – A callback to be called and passed an Abortion value
 
-in the event of RPC abortion.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A Call for the RPC.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.event_unary_unary">
 
-<code class="descname">event_unary_unary</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>request</em>, <em>receiver</em>, <em>abortion_callback</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.event_unary_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.event_unary_unary" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Event-driven invocation of a unary-request-unary-response 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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-<li><strong>request</strong> – The request value for the RPC.</li>
 
-<li><strong>receiver</strong> – A ResponseReceiver to be passed the response data of the RPC.</li>
 
-<li><strong>abortion_callback</strong> – A callback to be called and passed an Abortion value
 
-in the event of RPC abortion.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A Call for the RPC.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.future_stream_unary">
 
-<code class="descname">future_stream_unary</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>request_iterator</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.future_stream_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.future_stream_unary" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Invokes a stream-request-unary-response 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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-<li><strong>request_iterator</strong> – An iterator that yields request values for the RPC.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>An object that is both a Call for the RPC and a future.Future. In the</dt>
 
-<dd><p class="first last">event of RPC completion, the return Future’s result value will be the
 
-response value of the RPC. In the event of RPC abortion, the returned
 
-Future’s exception value will be an AbortionError.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.future_unary_unary">
 
-<code class="descname">future_unary_unary</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>request</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.future_unary_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.future_unary_unary" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Invokes a unary-request-unary-response 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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-<li><strong>request</strong> – The request value for the RPC.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>An object that is both a Call for the RPC and a future.Future. In the</dt>
 
-<dd><p class="first last">event of RPC completion, the return Future’s result value will be the
 
-response value of the RPC. In the event of RPC abortion, the returned
 
-Future’s exception value will be an AbortionError.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.inline_stream_stream">
 
-<code class="descname">inline_stream_stream</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>request_iterator</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.inline_stream_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.inline_stream_stream" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Invokes a stream-request-stream-response 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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-<li><strong>request_iterator</strong> – An iterator that yields request values for the RPC.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>An object that is both a Call for the RPC and an iterator of response</dt>
 
-<dd><p class="first last">values. Drawing response values from the returned iterator may raise
 
-AbortionError indicating abortion of the RPC.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.inline_unary_stream">
 
-<code class="descname">inline_unary_stream</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>request</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.inline_unary_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.inline_unary_stream" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Invokes a unary-request-stream-response 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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-<li><strong>request</strong> – The request value for the RPC.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>An object that is both a Call for the RPC and an iterator of response</dt>
 
-<dd><p class="first last">values. Drawing response values from the returned iterator may raise
 
-AbortionError indicating abortion of the RPC.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.stream_stream">
 
-<code class="descname">stream_stream</code><span class="sig-paren">(</span><em>group</em>, <em>method</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.stream_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.stream_stream" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a StreamStreamMultiCallable for a stream-stream 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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A StreamStreamMultiCallable value for the named stream-stream method.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.stream_unary">
 
-<code class="descname">stream_unary</code><span class="sig-paren">(</span><em>group</em>, <em>method</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.stream_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.stream_unary" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a StreamUnaryMultiCallable for a stream-unary 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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A StreamUnaryMultiCallable value for the named stream-unary method.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.unary_stream">
 
-<code class="descname">unary_stream</code><span class="sig-paren">(</span><em>group</em>, <em>method</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.unary_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.unary_stream" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a UnaryStreamMultiCallable for a unary-stream 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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A UnaryStreamMultiCallable value for the name unary-stream method.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.GenericStub.unary_unary">
 
-<code class="descname">unary_unary</code><span class="sig-paren">(</span><em>group</em>, <em>method</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#GenericStub.unary_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.GenericStub.unary_unary" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates a UnaryUnaryMultiCallable for a unary-unary 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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A UnaryUnaryMultiCallable value for the named unary-unary method.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="exception">
 
-<dt id="grpc.framework.interfaces.face.face.LocalError">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">LocalError</code><span class="sig-paren">(</span><em>initial_metadata</em>, <em>terminal_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#LocalError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.LocalError" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.interfaces.face.face.AbortionError" title="grpc.framework.interfaces.face.face.AbortionError"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.interfaces.face.face.AbortionError</span></code></a></p>
 
-<p>Indicates that an RPC has terminated due to a local defect.</p>
 
-</dd></dl>
 
-
 
-<dl class="exception">
 
-<dt id="grpc.framework.interfaces.face.face.LocalShutdownError">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">LocalShutdownError</code><span class="sig-paren">(</span><em>initial_metadata</em>, <em>terminal_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#LocalShutdownError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.LocalShutdownError" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.interfaces.face.face.AbortionError" title="grpc.framework.interfaces.face.face.AbortionError"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.interfaces.face.face.AbortionError</span></code></a></p>
 
-<p>Indicates that an RPC has terminated due to local shutdown of RPCs.</p>
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.MethodImplementation">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">MethodImplementation</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#MethodImplementation"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.MethodImplementation" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>A sum type that describes a method implementation.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.MethodImplementation.cardinality">
 
-<code class="descname">cardinality</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.MethodImplementation.cardinality" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A cardinality.Cardinality value.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.MethodImplementation.style">
 
-<code class="descname">style</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.MethodImplementation.style" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>A style.Service value.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.MethodImplementation.unary_unary_inline">
 
-<code class="descname">unary_unary_inline</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.MethodImplementation.unary_unary_inline" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The implementation of the method as a callable value
 
-that takes a request value and a ServicerContext object and returns a
 
-response value. Only non-None if cardinality is
 
-cardinality.Cardinality.UNARY_UNARY and style is style.Service.INLINE.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.MethodImplementation.unary_stream_inline">
 
-<code class="descname">unary_stream_inline</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.MethodImplementation.unary_stream_inline" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The implementation of the method as a callable value
 
-that takes a request value and a ServicerContext object and returns an
 
-iterator of response values. Only non-None if cardinality is
 
-cardinality.Cardinality.UNARY_STREAM and style is style.Service.INLINE.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.MethodImplementation.stream_unary_inline">
 
-<code class="descname">stream_unary_inline</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.MethodImplementation.stream_unary_inline" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The implementation of the method as a callable value
 
-that takes an iterator of request values and a ServicerContext object and
 
-returns a response value. Only non-None if cardinality is
 
-cardinality.Cardinality.STREAM_UNARY and style is style.Service.INLINE.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.MethodImplementation.stream_stream_inline">
 
-<code class="descname">stream_stream_inline</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.MethodImplementation.stream_stream_inline" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The implementation of the method as a callable value
 
-that takes an iterator of request values and a ServicerContext object and
 
-returns an iterator of response values. Only non-None if cardinality is
 
-cardinality.Cardinality.STREAM_STREAM and style is style.Service.INLINE.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.MethodImplementation.unary_unary_event">
 
-<code class="descname">unary_unary_event</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.MethodImplementation.unary_unary_event" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The implementation of the method as a callable value that
 
-takes a request value, a response callback to which to pass the response
 
-value of the RPC, and a ServicerContext. Only non-None if cardinality is
 
-cardinality.Cardinality.UNARY_UNARY and style is style.Service.EVENT.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.MethodImplementation.unary_stream_event">
 
-<code class="descname">unary_stream_event</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.MethodImplementation.unary_stream_event" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The implementation of the method as a callable value
 
-that takes a request value, a stream.Consumer to which to pass the
 
-response values of the RPC, and a ServicerContext. Only non-None if
 
-cardinality is cardinality.Cardinality.UNARY_STREAM and style is
 
-style.Service.EVENT.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.MethodImplementation.stream_unary_event">
 
-<code class="descname">stream_unary_event</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.MethodImplementation.stream_unary_event" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The implementation of the method as a callable value
 
-that takes a response callback to which to pass the response value of the
 
-RPC and a ServicerContext and returns a stream.Consumer to which the
 
-request values of the RPC should be passed. Only non-None if cardinality
 
-is cardinality.Cardinality.STREAM_UNARY and style is style.Service.EVENT.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.MethodImplementation.stream_stream_event">
 
-<code class="descname">stream_stream_event</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.MethodImplementation.stream_stream_event" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The implementation of the method as a callable value
 
-that takes a stream.Consumer to which to pass the response values of the
 
-RPC and a ServicerContext and returns a stream.Consumer to which the
 
-request values of the RPC should be passed. Only non-None if cardinality
 
-is cardinality.Cardinality.STREAM_STREAM and style is
 
-style.Service.EVENT.</p>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.MultiMethodImplementation">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">MultiMethodImplementation</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#MultiMethodImplementation"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.MultiMethodImplementation" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>A general type able to service many methods.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.MultiMethodImplementation.service">
 
-<code class="descname">service</code><span class="sig-paren">(</span><em>group</em>, <em>method</em>, <em>response_consumer</em>, <em>context</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#MultiMethodImplementation.service"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.MultiMethodImplementation.service" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Services an RPC.</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"><ul class="first simple">
 
-<li><strong>group</strong> – The group identifier of the RPC.</li>
 
-<li><strong>method</strong> – The method identifier of the RPC.</li>
 
-<li><strong>response_consumer</strong> – A stream.Consumer to be called to accept the response
 
-values of the RPC.</li>
 
-<li><strong>context</strong> – a ServicerContext object.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first"><dl class="docutils">
 
-<dt>A stream.Consumer with which to accept the request values of the RPC. The</dt>
 
-<dd><p class="first last">consumer returned from this method may or may not be invoked to
 
-completion: in the case of RPC abortion, RPC Framework will simply stop
 
-passing values to this object. Implementations must not assume that this
 
-object will be called to completion of the request stream or even called
 
-at all.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><ul class="first last simple">
 
-<li><code class="xref py py-exc docutils literal"><span class="pre">abandonment.Abandoned</span></code> – May or may not be raised when the RPC has been
 
-aborted.</li>
 
-<li><a class="reference internal" href="#grpc.framework.interfaces.face.face.NoSuchMethodError" title="grpc.framework.interfaces.face.face.NoSuchMethodError"><code class="xref py py-exc docutils literal"><span class="pre">NoSuchMethodError</span></code></a> – If this MultiMethod does not recognize the given group
 
-and name for the RPC and is not able to service the RPC.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="exception">
 
-<dt id="grpc.framework.interfaces.face.face.NetworkError">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">NetworkError</code><span class="sig-paren">(</span><em>initial_metadata</em>, <em>terminal_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#NetworkError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.NetworkError" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.interfaces.face.face.AbortionError" title="grpc.framework.interfaces.face.face.AbortionError"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.interfaces.face.face.AbortionError</span></code></a></p>
 
-<p>Indicates that some error occurred on the network.</p>
 
-</dd></dl>
 
-
 
-<dl class="exception">
 
-<dt id="grpc.framework.interfaces.face.face.NoSuchMethodError">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">NoSuchMethodError</code><span class="sig-paren">(</span><em>group</em>, <em>method</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#NoSuchMethodError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.NoSuchMethodError" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">exceptions.Exception</span></code></p>
 
-<p>Raised by customer code to indicate an unrecognized method.</p>
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.NoSuchMethodError.group">
 
-<code class="descname">group</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.NoSuchMethodError.group" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The group of the unrecognized method.</p>
 
-</dd></dl>
 
-
 
-<dl class="attribute">
 
-<dt id="grpc.framework.interfaces.face.face.NoSuchMethodError.name">
 
-<code class="descname">name</code><a class="headerlink" href="#grpc.framework.interfaces.face.face.NoSuchMethodError.name" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>The name of the unrecognized method.</p>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="exception">
 
-<dt id="grpc.framework.interfaces.face.face.RemoteError">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">RemoteError</code><span class="sig-paren">(</span><em>initial_metadata</em>, <em>terminal_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#RemoteError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.RemoteError" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.interfaces.face.face.AbortionError" title="grpc.framework.interfaces.face.face.AbortionError"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.interfaces.face.face.AbortionError</span></code></a></p>
 
-<p>Indicates that an RPC has terminated due to a remote defect.</p>
 
-</dd></dl>
 
-
 
-<dl class="exception">
 
-<dt id="grpc.framework.interfaces.face.face.RemoteShutdownError">
 
-<em class="property">exception </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">RemoteShutdownError</code><span class="sig-paren">(</span><em>initial_metadata</em>, <em>terminal_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#RemoteShutdownError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.RemoteShutdownError" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.interfaces.face.face.AbortionError" title="grpc.framework.interfaces.face.face.AbortionError"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.interfaces.face.face.AbortionError</span></code></a></p>
 
-<p>Indicates that an RPC has terminated due to remote shutdown of RPCs.</p>
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.ResponseReceiver">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">ResponseReceiver</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#ResponseReceiver"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.ResponseReceiver" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Invocation-side object used to accept the output of an RPC.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.ResponseReceiver.complete">
 
-<code class="descname">complete</code><span class="sig-paren">(</span><em>terminal_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#ResponseReceiver.complete"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.ResponseReceiver.complete" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Receives the completion values emitted from the service-side of the RPC.</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"><ul class="first last simple">
 
-<li><strong>terminal_metadata</strong> – The terminal metadata object emitted from the
 
-service-side of the RPC.</li>
 
-<li><strong>code</strong> – The code object emitted from the service-side of the RPC.</li>
 
-<li><strong>details</strong> – The details object emitted from the service-side of the RPC.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.ResponseReceiver.initial_metadata">
 
-<code class="descname">initial_metadata</code><span class="sig-paren">(</span><em>initial_metadata</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#ResponseReceiver.initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.ResponseReceiver.initial_metadata" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Receives the initial metadata from the service-side of the RPC.</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>initial_metadata</strong> – The initial metadata object emitted from the
 
-service-side of the RPC.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.ResponseReceiver.response">
 
-<code class="descname">response</code><span class="sig-paren">(</span><em>response</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#ResponseReceiver.response"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.ResponseReceiver.response" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Receives a response from the service-side of the RPC.</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>response</strong> – A response object emitted from the service-side of the RPC.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.RpcContext">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">RpcContext</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#RpcContext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.RpcContext" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Provides RPC-related information and action.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.RpcContext.add_abortion_callback">
 
-<code class="descname">add_abortion_callback</code><span class="sig-paren">(</span><em>abortion_callback</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#RpcContext.add_abortion_callback"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.RpcContext.add_abortion_callback" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Registers a callback to be called if the RPC is aborted.</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>abortion_callback</strong> – A callable to be called and passed an Abortion value
 
-in the event of RPC abortion.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.RpcContext.cancel">
 
-<code class="descname">cancel</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#RpcContext.cancel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.RpcContext.cancel" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Cancels the RPC.</p>
 
-<p>Idempotent and has no effect if the RPC has already terminated.</p>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.RpcContext.is_active">
 
-<code class="descname">is_active</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#RpcContext.is_active"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.RpcContext.is_active" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Describes whether the RPC is active or has terminated.</p>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.RpcContext.protocol_context">
 
-<code class="descname">protocol_context</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#RpcContext.protocol_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.RpcContext.protocol_context" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accesses a custom object specified by an implementation provider.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>A value specified by the provider of a Face interface implementation</dt>
 
-<dd>affording custom state and behavior.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.RpcContext.time_remaining">
 
-<code class="descname">time_remaining</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#RpcContext.time_remaining"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.RpcContext.time_remaining" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Describes the length of allowed time remaining for the RPC.</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">Returns:</th><td class="field-body">A nonnegative float indicating the length of allowed time in seconds
 
-remaining for the RPC to complete before it is considered to have timed
 
-out.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.ServicerContext">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">ServicerContext</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#ServicerContext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.ServicerContext" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <a class="reference internal" href="#grpc.framework.interfaces.face.face.RpcContext" title="grpc.framework.interfaces.face.face.RpcContext"><code class="xref py py-class docutils literal"><span class="pre">grpc.framework.interfaces.face.face.RpcContext</span></code></a></p>
 
-<p>A context object passed to method implementations.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.ServicerContext.code">
 
-<code class="descname">code</code><span class="sig-paren">(</span><em>code</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#ServicerContext.code"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.ServicerContext.code" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accepts the service-side code of the RPC.</p>
 
-<p>This method need not be called by method implementations if they have no
 
-code to transmit.</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>code</strong> – The code of the RPC to be transmitted to the invocation side of the
 
-RPC.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.ServicerContext.details">
 
-<code class="descname">details</code><span class="sig-paren">(</span><em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#ServicerContext.details"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.ServicerContext.details" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accepts the service-side details of the RPC.</p>
 
-<p>This method need not be called by method implementations if they have no
 
-service-side details to transmit.</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>details</strong> – The service-side details value of the RPC to be transmitted to
 
-the invocation side of the RPC.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.ServicerContext.initial_metadata">
 
-<code class="descname">initial_metadata</code><span class="sig-paren">(</span><em>initial_metadata</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#ServicerContext.initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.ServicerContext.initial_metadata" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accepts the service-side initial metadata value of the RPC.</p>
 
-<p>This method need not be called by method implementations if they have no
 
-service-side initial metadata to transmit.</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>initial_metadata</strong> – The service-side initial metadata value of the RPC to
 
-be transmitted to the invocation side of the RPC.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.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/framework/interfaces/face/face.html#ServicerContext.invocation_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.ServicerContext.invocation_metadata" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accesses the metadata from the invocation-side of the RPC.</p>
 
-<p>This method blocks until the value is available or is known not to have been
 
-emitted from the invocation-side of the RPC.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
-<dt>The metadata object emitted by the invocation-side of the RPC, or None if</dt>
 
-<dd>there was no such value.</dd>
 
-</dl>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.ServicerContext.terminal_metadata">
 
-<code class="descname">terminal_metadata</code><span class="sig-paren">(</span><em>terminal_metadata</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#ServicerContext.terminal_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.ServicerContext.terminal_metadata" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Accepts the service-side terminal metadata value of the RPC.</p>
 
-<p>This method need not be called by method implementations if they have no
 
-service-side terminal metadata to transmit.</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>terminal_metadata</strong> – The service-side terminal metadata value of the RPC to
 
-be transmitted to the invocation side of the RPC.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.StreamStreamMultiCallable">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">StreamStreamMultiCallable</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#StreamStreamMultiCallable"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.StreamStreamMultiCallable" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Affords invoking a stream-stream RPC in any call style.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.StreamStreamMultiCallable.__call__">
 
-<code class="descname">__call__</code><span class="sig-paren">(</span><em>request_iterator</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#StreamStreamMultiCallable.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.StreamStreamMultiCallable.__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" />
 
-<col class="field-body" />
 
-<tbody valign="top">
 
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
 
-<li><strong>request_iterator</strong> – An iterator that yields request values for the RPC.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of
 
-the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>An object that is both a Call for the RPC and an iterator of response</dt>
 
-<dd><p class="first last">values. Drawing response values from the returned iterator may raise
 
-AbortionError indicating abortion of the RPC.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.StreamStreamMultiCallable.event">
 
-<code class="descname">event</code><span class="sig-paren">(</span><em>receiver</em>, <em>abortion_callback</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#StreamStreamMultiCallable.event"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.StreamStreamMultiCallable.event" 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" />
 
-<col class="field-body" />
 
-<tbody valign="top">
 
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
 
-<li><strong>receiver</strong> – A ResponseReceiver to be passed the response data of the RPC.</li>
 
-<li><strong>abortion_callback</strong> – A callback to be called and passed an Abortion value
 
-in the event of RPC abortion.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of
 
-the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>A single object that is both a Call object for the RPC and a</dt>
 
-<dd><p class="first last">stream.Consumer to which the request values of the RPC should be passed.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.StreamUnaryMultiCallable">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">StreamUnaryMultiCallable</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#StreamUnaryMultiCallable"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.StreamUnaryMultiCallable" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Affords invoking a stream-unary RPC in any call style.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.StreamUnaryMultiCallable.__call__">
 
-<code class="descname">__call__</code><span class="sig-paren">(</span><em>request_iterator</em>, <em>timeout</em>, <em>metadata=None</em>, <em>with_call=False</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#StreamUnaryMultiCallable.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.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" />
 
-<col class="field-body" />
 
-<tbody valign="top">
 
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
 
-<li><strong>request_iterator</strong> – An iterator that yields request values for the RPC.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of
 
-the RPC.</li>
 
-<li><strong>with_call</strong> – Whether or not to include return a Call for the RPC in addition
 
-to the response.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first"><dl class="docutils">
 
-<dt>The response value for the RPC, and a Call for the RPC if with_call was</dt>
 
-<dd><p class="first last">set to True at invocation.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last"><a class="reference internal" href="#grpc.framework.interfaces.face.face.AbortionError" title="grpc.framework.interfaces.face.face.AbortionError"><code class="xref py py-exc docutils literal"><span class="pre">AbortionError</span></code></a> – Indicating that the RPC was aborted.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.StreamUnaryMultiCallable.event">
 
-<code class="descname">event</code><span class="sig-paren">(</span><em>receiver</em>, <em>abortion_callback</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#StreamUnaryMultiCallable.event"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.StreamUnaryMultiCallable.event" 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" />
 
-<col class="field-body" />
 
-<tbody valign="top">
 
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
 
-<li><strong>receiver</strong> – A ResponseReceiver to be passed the response data of the RPC.</li>
 
-<li><strong>abortion_callback</strong> – A callback to be called and passed an Abortion value
 
-in the event of RPC abortion.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of
 
-the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>A single object that is both a Call object for the RPC and a</dt>
 
-<dd><p class="first last">stream.Consumer to which the request values of the RPC should be passed.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.StreamUnaryMultiCallable.future">
 
-<code class="descname">future</code><span class="sig-paren">(</span><em>request_iterator</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#StreamUnaryMultiCallable.future"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.StreamUnaryMultiCallable.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" />
 
-<col class="field-body" />
 
-<tbody valign="top">
 
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
 
-<li><strong>request_iterator</strong> – An iterator that yields request values for the RPC.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of
 
-the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>An object that is both a Call for the RPC and a future.Future. In the</dt>
 
-<dd><p class="first last">event of RPC completion, the return Future’s result value will be the
 
-response value of the RPC. In the event of RPC abortion, the returned
 
-Future’s exception value will be an AbortionError.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.UnaryStreamMultiCallable">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">UnaryStreamMultiCallable</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#UnaryStreamMultiCallable"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.UnaryStreamMultiCallable" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Affords invoking a unary-stream RPC in any call style.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.UnaryStreamMultiCallable.__call__">
 
-<code class="descname">__call__</code><span class="sig-paren">(</span><em>request</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#UnaryStreamMultiCallable.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.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" />
 
-<col class="field-body" />
 
-<tbody valign="top">
 
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
 
-<li><strong>request</strong> – The request value for the RPC.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of
 
-the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>An object that is both a Call for the RPC and an iterator of response</dt>
 
-<dd><p class="first last">values. Drawing response values from the returned iterator may raise
 
-AbortionError indicating abortion of the RPC.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.UnaryStreamMultiCallable.event">
 
-<code class="descname">event</code><span class="sig-paren">(</span><em>request</em>, <em>receiver</em>, <em>abortion_callback</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#UnaryStreamMultiCallable.event"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.UnaryStreamMultiCallable.event" 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" />
 
-<col class="field-body" />
 
-<tbody valign="top">
 
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
 
-<li><strong>request</strong> – The request value for the RPC.</li>
 
-<li><strong>receiver</strong> – A ResponseReceiver to be passed the response data of the RPC.</li>
 
-<li><strong>abortion_callback</strong> – A callback to be called and passed an Abortion value
 
-in the event of RPC abortion.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of
 
-the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A Call object for the RPC.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-<dl class="class">
 
-<dt id="grpc.framework.interfaces.face.face.UnaryUnaryMultiCallable">
 
-<em class="property">class </em><code class="descclassname">grpc.framework.interfaces.face.face.</code><code class="descname">UnaryUnaryMultiCallable</code><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#UnaryUnaryMultiCallable"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.UnaryUnaryMultiCallable" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
 
-<p>Affords invoking a unary-unary RPC in any call style.</p>
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.UnaryUnaryMultiCallable.__call__">
 
-<code class="descname">__call__</code><span class="sig-paren">(</span><em>request</em>, <em>timeout</em>, <em>metadata=None</em>, <em>with_call=False</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#UnaryUnaryMultiCallable.__call__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.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" />
 
-<col class="field-body" />
 
-<tbody valign="top">
 
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
 
-<li><strong>request</strong> – The request value for the RPC.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of
 
-the RPC.</li>
 
-<li><strong>with_call</strong> – Whether or not to include return a Call for the RPC in addition
 
-to the response.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first"><dl class="docutils">
 
-<dt>The response value for the RPC, and a Call for the RPC if with_call was</dt>
 
-<dd><p class="first last">set to True at invocation.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last"><a class="reference internal" href="#grpc.framework.interfaces.face.face.AbortionError" title="grpc.framework.interfaces.face.face.AbortionError"><code class="xref py py-exc docutils literal"><span class="pre">AbortionError</span></code></a> – Indicating that the RPC was aborted.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.UnaryUnaryMultiCallable.event">
 
-<code class="descname">event</code><span class="sig-paren">(</span><em>request</em>, <em>receiver</em>, <em>abortion_callback</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#UnaryUnaryMultiCallable.event"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.UnaryUnaryMultiCallable.event" 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" />
 
-<col class="field-body" />
 
-<tbody valign="top">
 
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
 
-<li><strong>request</strong> – The request value for the RPC.</li>
 
-<li><strong>receiver</strong> – A ResponseReceiver to be passed the response data of the RPC.</li>
 
-<li><strong>abortion_callback</strong> – A callback to be called and passed an Abortion value
 
-in the event of RPC abortion.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of
 
-the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A Call for the RPC.</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="method">
 
-<dt id="grpc.framework.interfaces.face.face.UnaryUnaryMultiCallable.future">
 
-<code class="descname">future</code><span class="sig-paren">(</span><em>request</em>, <em>timeout</em>, <em>metadata=None</em>, <em>protocol_options=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/face.html#UnaryUnaryMultiCallable.future"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.face.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" />
 
-<col class="field-body" />
 
-<tbody valign="top">
 
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
 
-<li><strong>request</strong> – The request value for the RPC.</li>
 
-<li><strong>timeout</strong> – A duration of time in seconds to allow for the RPC.</li>
 
-<li><strong>metadata</strong> – A metadata value to be passed to the service-side of
 
-the RPC.</li>
 
-<li><strong>protocol_options</strong> – A value specified by the provider of a Face interface
 
-implementation affording custom state and behavior.</li>
 
-</ul>
 
-</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
-<dt>An object that is both a Call for the RPC and a future.Future. In the</dt>
 
-<dd><p class="first last">event of RPC completion, the return Future’s result value will be the
 
-response value of the RPC. In the event of RPC abortion, the returned
 
-Future’s exception value will be an AbortionError.</p>
 
-</dd>
 
-</dl>
 
-</p>
 
-</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.framework.interfaces.face.utilities">
 
-<span id="grpc-framework-interfaces-face-utilities-module"></span><h2>grpc.framework.interfaces.face.utilities module<a class="headerlink" href="#module-grpc.framework.interfaces.face.utilities" title="Permalink to this headline">¶</a></h2>
 
-<p>Utilities for RPC Framework’s Face interface.</p>
 
-<dl class="function">
 
-<dt id="grpc.framework.interfaces.face.utilities.stream_stream_event">
 
-<code class="descclassname">grpc.framework.interfaces.face.utilities.</code><code class="descname">stream_stream_event</code><span class="sig-paren">(</span><em>behavior</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/utilities.html#stream_stream_event"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.utilities.stream_stream_event" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates an face.MethodImplementation for the given behavior.</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>behavior</strong> – The implementation of a stream-stream RPC method as a callable
 
-value that takes a stream.Consumer to which to pass the response values
 
-of the RPC and an face.ServicerContext and returns a stream.Consumer to
 
-which the request values of the RPC should be passed.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">An face.MethodImplementation derived from the given behavior.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.framework.interfaces.face.utilities.stream_stream_inline">
 
-<code class="descclassname">grpc.framework.interfaces.face.utilities.</code><code class="descname">stream_stream_inline</code><span class="sig-paren">(</span><em>behavior</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/utilities.html#stream_stream_inline"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.utilities.stream_stream_inline" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates an face.MethodImplementation for the given behavior.</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>behavior</strong> – The implementation of a stream-stream RPC method as a callable
 
-value that takes an iterator of request values and an
 
-face.ServicerContext object and returns an iterator of response values.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">An face.MethodImplementation derived from the given behavior.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.framework.interfaces.face.utilities.stream_unary_event">
 
-<code class="descclassname">grpc.framework.interfaces.face.utilities.</code><code class="descname">stream_unary_event</code><span class="sig-paren">(</span><em>behavior</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/utilities.html#stream_unary_event"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.utilities.stream_unary_event" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates an face.MethodImplementation for the given behavior.</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>behavior</strong> – The implementation of a stream-unary RPC method as a callable
 
-value that takes a response callback to which to pass the response value
 
-of the RPC and an face.ServicerContext and returns a stream.Consumer to
 
-which the request values of the RPC should be passed.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">An face.MethodImplementation derived from the given behavior.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.framework.interfaces.face.utilities.stream_unary_inline">
 
-<code class="descclassname">grpc.framework.interfaces.face.utilities.</code><code class="descname">stream_unary_inline</code><span class="sig-paren">(</span><em>behavior</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/utilities.html#stream_unary_inline"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.utilities.stream_unary_inline" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates an face.MethodImplementation for the given behavior.</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>behavior</strong> – The implementation of a stream-unary RPC method as a callable
 
-value that takes an iterator of request values and an
 
-face.ServicerContext object and returns a response value.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">An face.MethodImplementation derived from the given behavior.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.framework.interfaces.face.utilities.unary_stream_event">
 
-<code class="descclassname">grpc.framework.interfaces.face.utilities.</code><code class="descname">unary_stream_event</code><span class="sig-paren">(</span><em>behavior</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/utilities.html#unary_stream_event"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.utilities.unary_stream_event" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates an face.MethodImplementation for the given behavior.</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>behavior</strong> – The implementation of a unary-stream RPC method as a callable
 
-value that takes a request value, a stream.Consumer to which to pass the
 
-the response values of the RPC, and an face.ServicerContext.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">An face.MethodImplementation derived from the given behavior.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.framework.interfaces.face.utilities.unary_stream_inline">
 
-<code class="descclassname">grpc.framework.interfaces.face.utilities.</code><code class="descname">unary_stream_inline</code><span class="sig-paren">(</span><em>behavior</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/utilities.html#unary_stream_inline"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.utilities.unary_stream_inline" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates an face.MethodImplementation for the given behavior.</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>behavior</strong> – The implementation of a unary-stream RPC method as a callable
 
-value that takes a request value and an face.ServicerContext object and
 
-returns an iterator of response values.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">An face.MethodImplementation derived from the given behavior.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.framework.interfaces.face.utilities.unary_unary_event">
 
-<code class="descclassname">grpc.framework.interfaces.face.utilities.</code><code class="descname">unary_unary_event</code><span class="sig-paren">(</span><em>behavior</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/utilities.html#unary_unary_event"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.utilities.unary_unary_event" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates an face.MethodImplementation for the given behavior.</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>behavior</strong> – The implementation of a unary-unary RPC method as a callable
 
-value that takes a request value, a response callback to which to pass
 
-the response value of the RPC, and an face.ServicerContext.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">An face.MethodImplementation derived from the given behavior.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-<dl class="function">
 
-<dt id="grpc.framework.interfaces.face.utilities.unary_unary_inline">
 
-<code class="descclassname">grpc.framework.interfaces.face.utilities.</code><code class="descname">unary_unary_inline</code><span class="sig-paren">(</span><em>behavior</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc/framework/interfaces/face/utilities.html#unary_unary_inline"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc.framework.interfaces.face.utilities.unary_unary_inline" title="Permalink to this definition">¶</a></dt>
 
-<dd><p>Creates an face.MethodImplementation for the given behavior.</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>behavior</strong> – The implementation of a unary-unary RPC method as a callable value
 
-that takes a request value and an face.ServicerContext object and
 
-returns a response value.</td>
 
-</tr>
 
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">An face.MethodImplementation derived from the given behavior.</td>
 
-</tr>
 
-</tbody>
 
-</table>
 
-</dd></dl>
 
-
 
-</div>
 
-<div class="section" id="module-grpc.framework.interfaces.face">
 
-<span id="module-contents"></span><h2>Module contents<a class="headerlink" href="#module-grpc.framework.interfaces.face" title="Permalink to this headline">¶</a></h2>
 
-</div>
 
-</div>
 
-
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 
-      
-      
-        <a href="grpc.framework.interfaces.base.html" class="btn btn-neutral" title="grpc.framework.interfaces.base package" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
 
-      
-    </div>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'./',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="_static/jquery.js"></script>
 
-      <script type="text/javascript" src="_static/underscore.js"></script>
 
-      <script type="text/javascript" src="_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

+ 0 - 277
python/grpc.framework.interfaces.html
查看文件 

@@ -1,277 +0,0 @@
 
-
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>grpc.framework.interfaces package &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
-  
-
 
-  
-
 
-  
-  
-    
-
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="genindex.html"/>
 
-        <link rel="search" title="Search" href="search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="index.html"/>
 
-        <link rel="up" title="grpc.framework package" href="grpc.framework.html"/>
 
-        <link rel="next" title="grpc.framework.interfaces.base package" href="grpc.framework.interfaces.base.html"/>
 
-        <link rel="prev" title="grpc.framework.foundation package" href="grpc.framework.foundation.html"/> 
-
 
-  
-  <script src="_static/js/modernizr.min.js"></script>
 
-
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
-
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
-
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul class="current">
 
-<li class="toctree-l1 current"><a class="reference internal" href="grpc.html">grpc package</a><ul class="current">
 
-<li class="toctree-l2 current"><a class="reference internal" href="grpc.html#subpackages">Subpackages</a><ul class="current">
 
-<li class="toctree-l3"><a class="reference internal" href="grpc.beta.html">grpc.beta package</a></li>
 
-<li class="toctree-l3 current"><a class="reference internal" href="grpc.framework.html">grpc.framework package</a><ul class="current">
 
-<li class="toctree-l4 current"><a class="reference internal" href="grpc.framework.html#subpackages">Subpackages</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.html#module-grpc.framework">Module contents</a></li>
 
-</ul>
 
-</li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.html#module-grpc">Module contents</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
-
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="index.html">Docs</a> &raquo;</li>
 
-        
-          <li><a href="grpc.html">grpc package</a> &raquo;</li>
 
-        
-          <li><a href="grpc.framework.html">grpc.framework package</a> &raquo;</li>
 
-        
-      <li>grpc.framework.interfaces package</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-            <a href="_sources/grpc.framework.interfaces.rst.txt" rel="nofollow"> View page source</a>
 
-          
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
-            
-  <div class="section" id="grpc-framework-interfaces-package">
 
-<h1>grpc.framework.interfaces package<a class="headerlink" href="#grpc-framework-interfaces-package" title="Permalink to this headline">¶</a></h1>
 
-<div class="section" id="subpackages">
 
-<h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to this headline">¶</a></h2>
 
-<div class="toctree-wrapper compound">
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.framework.interfaces.base.html">grpc.framework.interfaces.base package</a><ul>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.interfaces.base.html#submodules">Submodules</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.interfaces.base.html#module-grpc.framework.interfaces.base.base">grpc.framework.interfaces.base.base module</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.interfaces.base.html#module-grpc.framework.interfaces.base.utilities">grpc.framework.interfaces.base.utilities module</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.interfaces.base.html#module-grpc.framework.interfaces.base">Module contents</a></li>
 
-</ul>
 
-</li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.framework.interfaces.face.html">grpc.framework.interfaces.face package</a><ul>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.interfaces.face.html#submodules">Submodules</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.interfaces.face.html#module-grpc.framework.interfaces.face.face">grpc.framework.interfaces.face.face module</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.interfaces.face.html#module-grpc.framework.interfaces.face.utilities">grpc.framework.interfaces.face.utilities module</a></li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.framework.interfaces.face.html#module-grpc.framework.interfaces.face">Module contents</a></li>
 
-</ul>
 
-</li>
 
-</ul>
 
-</div>
 
-</div>
 
-<div class="section" id="module-grpc.framework.interfaces">
 
-<span id="module-contents"></span><h2>Module contents<a class="headerlink" href="#module-grpc.framework.interfaces" title="Permalink to this headline">¶</a></h2>
 
-</div>
 
-</div>
 
-
 
-
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
-          </div>
 
-          <footer>
 
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 
-      
-        <a href="grpc.framework.interfaces.base.html" class="btn btn-neutral float-right" title="grpc.framework.interfaces.base package" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
 
-      
-      
-        <a href="grpc.framework.foundation.html" class="btn btn-neutral" title="grpc.framework.foundation package" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
 
-      
-    </div>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
-        </div>
 
-      </div>
 
-
 
-    </section>
 
-
 
-  </div>
 
-  
-
 
-
 
-  
-
 
-    <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'./',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="_static/jquery.js"></script>
 
-      <script type="text/javascript" src="_static/underscore.js"></script>
 
-      <script type="text/javascript" src="_static/doctools.js"></script>
 
-
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="_static/js/theme.js"></script>
 
-  
-
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
-
 
-</body>
 
-</html>

File diff suppressed because it is too large
+ 664 - 428
python/grpc.html


+ 161 - 0
python/grpc_health_checking.html
查看文件 

@@ -0,0 +1,161 @@
 
+
 
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
+
 
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
 
+  <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.16.0 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>
 
+    <script type="text/javascript" src="_static/jquery.js"></script>
 
+    <script type="text/javascript" src="_static/underscore.js"></script>
 
+    <script type="text/javascript" src="_static/doctools.js"></script>
 
+    <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
 
+    <link rel="index" title="Index" href="genindex.html" />
 
+    <link rel="search" title="Search" href="search.html" />
 
+    <link rel="next" title="gRPC Reflection" href="grpc_reflection.html" />
 
+    <link rel="prev" title="gRPC" href="grpc.html" />
 
+   
+  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
 
+  
+  
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
 
+
 
+  </head><body>
 
+  <div class="document">
 
+    
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 
+        <div class="sphinxsidebarwrapper">
 
+<h1 class="logo"><a href="index.html">gRPC Python</a></h1>
 
+
 
+
 
+
 
+<p class="blurb">1.16.0</p>
 
+
 
+
 
+
 
+
 
+
 
+
 
+<h3>Navigation</h3>
 
+<p class="caption"><span class="caption-text">Contents:</span></p>
 
+<ul class="current">
 
+<li class="toctree-l1"><a class="reference internal" href="grpc.html">gRPC</a></li>
 
+<li class="toctree-l1 current"><a class="current reference internal" href="#">gRPC Health Checking</a><ul>
 
+<li class="toctree-l2"><a class="reference internal" href="#module-contents">Module Contents</a></li>
 
+</ul>
 
+</li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_reflection.html">gRPC Reflection</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_testing.html">gRPC Testing</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary</a></li>
 
+</ul>
 
+
 
+<div class="relations">
 
+<h3>Related Topics</h3>
 
+<ul>
 
+  <li><a href="index.html">Documentation overview</a><ul>
 
+      <li>Previous: <a href="grpc.html" title="previous chapter">gRPC</a></li>
 
+      <li>Next: <a href="grpc_reflection.html" title="next chapter">gRPC Reflection</a></li>
 
+  </ul></li>
 
+</ul>
 
+</div>
 
+<div id="searchbox" style="display: none" role="search">
 
+  <h3>Quick search</h3>
 
+    <div class="searchformwrapper">
 
+    <form class="search" action="search.html" method="get">
 
+      <input type="text" name="q" />
 
+      <input type="submit" value="Go" />
 
+      <input type="hidden" name="check_keywords" value="yes" />
 
+      <input type="hidden" name="area" value="default" />
 
+    </form>
 
+    </div>
 
+</div>
 
+<script type="text/javascript">$('#searchbox').show(0);</script>
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+        </div>
 
+      </div>
 
+      <div class="documentwrapper">
 
+        <div class="bodywrapper">
 
+          
+
 
+          <div class="body" role="main">
 
+            
+  <div class="section" id="grpc-health-checking">
 
+<h1>gRPC Health Checking<a class="headerlink" href="#grpc-health-checking" title="Permalink to this headline">¶</a></h1>
 
+<div class="section" id="module-contents">
 
+<h2>Module Contents<a class="headerlink" href="#module-contents" title="Permalink to this headline">¶</a></h2>
 
+<dl class="class">
 
+<dt id="grpc_health.v1.health.HealthServicer">
 
+<em class="property">class </em><code class="descclassname">grpc_health.v1.health.</code><code class="descname">HealthServicer</code><a class="reference internal" href="_modules/grpc_health/v1/health.html#HealthServicer"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_health.v1.health.HealthServicer" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Servicer handling RPCs for service statuses.</p>
 
+<dl class="method">
 
+<dt id="grpc_health.v1.health.HealthServicer.set">
 
+<code class="descname">set</code><span class="sig-paren">(</span><em>service</em>, <em>status</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_health/v1/health.html#HealthServicer.set"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_health.v1.health.HealthServicer.set" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Sets the status of a service.</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"><ul class="first last simple">
 
+<li><strong>service</strong> – string, the name of the service.
 
+NOTE, ‘’ must be set.</li>
 
+<li><strong>status</strong> – HealthCheckResponse.status enum value indicating
 
+the status of the service</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+</div>
 
+</div>
 
+
 
+
 
+          </div>
 
+          
+        </div>
 
+      </div>
 
+    <div class="clearer"></div>
 
+  </div>
 
+    <div class="footer">
 
+      &copy;2018, The gRPC Authors.
 
+      
+      |
 
+      <a href="_sources/grpc_health_checking.rst.txt"
 
+          rel="nofollow">Page source</a>
 
+    </div>
 
+
 
+    
+
 
+    
+    <script type="text/javascript">
 
+
 
+      var _gaq = _gaq || [];
 
+      _gaq.push(['_setAccount', 'UA-60127042-1']);
 
+      _gaq.push(['_setDomainName', 'none']);
 
+      _gaq.push(['_setAllowLinker', true]);
 
+      _gaq.push(['_trackPageview']);
 
+
 
+      (function() {
 
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 
+      })();
 
+
 
+    </script>
 
+    
+  </body>
 
+</html>

+ 171 - 0
python/grpc_reflection.html
查看文件 

@@ -0,0 +1,171 @@
 
+
 
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
+
 
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
 
+  <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.16.0 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>
 
+    <script type="text/javascript" src="_static/jquery.js"></script>
 
+    <script type="text/javascript" src="_static/underscore.js"></script>
 
+    <script type="text/javascript" src="_static/doctools.js"></script>
 
+    <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
 
+    <link rel="index" title="Index" href="genindex.html" />
 
+    <link rel="search" title="Search" href="search.html" />
 
+    <link rel="next" title="gRPC Testing" href="grpc_testing.html" />
 
+    <link rel="prev" title="gRPC Health Checking" href="grpc_health_checking.html" />
 
+   
+  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
 
+  
+  
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
 
+
 
+  </head><body>
 
+  <div class="document">
 
+    
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 
+        <div class="sphinxsidebarwrapper">
 
+<h1 class="logo"><a href="index.html">gRPC Python</a></h1>
 
+
 
+
 
+
 
+<p class="blurb">1.16.0</p>
 
+
 
+
 
+
 
+
 
+
 
+
 
+<h3>Navigation</h3>
 
+<p class="caption"><span class="caption-text">Contents:</span></p>
 
+<ul class="current">
 
+<li class="toctree-l1"><a class="reference internal" href="grpc.html">gRPC</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_health_checking.html">gRPC Health Checking</a></li>
 
+<li class="toctree-l1 current"><a class="current reference internal" href="#">gRPC Reflection</a><ul>
 
+<li class="toctree-l2"><a class="reference internal" href="#what-is-grpc-reflection">What is gRPC reflection?</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#example">Example</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="#module-grpc_reflection.v1alpha.reflection">Module Contents</a></li>
 
+</ul>
 
+</li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_testing.html">gRPC Testing</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary</a></li>
 
+</ul>
 
+
 
+<div class="relations">
 
+<h3>Related Topics</h3>
 
+<ul>
 
+  <li><a href="index.html">Documentation overview</a><ul>
 
+      <li>Previous: <a href="grpc_health_checking.html" title="previous chapter">gRPC Health Checking</a></li>
 
+      <li>Next: <a href="grpc_testing.html" title="next chapter">gRPC Testing</a></li>
 
+  </ul></li>
 
+</ul>
 
+</div>
 
+<div id="searchbox" style="display: none" role="search">
 
+  <h3>Quick search</h3>
 
+    <div class="searchformwrapper">
 
+    <form class="search" action="search.html" method="get">
 
+      <input type="text" name="q" />
 
+      <input type="submit" value="Go" />
 
+      <input type="hidden" name="check_keywords" value="yes" />
 
+      <input type="hidden" name="area" value="default" />
 
+    </form>
 
+    </div>
 
+</div>
 
+<script type="text/javascript">$('#searchbox').show(0);</script>
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+        </div>
 
+      </div>
 
+      <div class="documentwrapper">
 
+        <div class="bodywrapper">
 
+          
+
 
+          <div class="body" role="main">
 
+            
+  <div class="section" id="grpc-reflection">
 
+<h1>gRPC Reflection<a class="headerlink" href="#grpc-reflection" title="Permalink to this headline">¶</a></h1>
 
+<div class="section" id="what-is-grpc-reflection">
 
+<h2>What is gRPC reflection?<a class="headerlink" href="#what-is-grpc-reflection" title="Permalink to this headline">¶</a></h2>
 
+<p>Check this out <a class="reference external" href="https://github.com/grpc/grpc/blob/master/doc/python/server_reflection.md">gRPC Python Server Reflection</a></p>
 
+</div>
 
+<div class="section" id="example">
 
+<h2>Example<a class="headerlink" href="#example" title="Permalink to this headline">¶</a></h2>
 
+<p>Refer to the GitHub <a class="reference external" href="https://github.com/grpc/grpc/blob/master/examples/python/helloworld/greeter_server_with_reflection.py">reflection example</a></p>
 
+</div>
 
+<div class="section" id="module-grpc_reflection.v1alpha.reflection">
 
+<span id="module-contents"></span><h2>Module Contents<a class="headerlink" href="#module-grpc_reflection.v1alpha.reflection" title="Permalink to this headline">¶</a></h2>
 
+<p>Reference implementation for reflection in gRPC Python.</p>
 
+<dl class="class">
 
+<dt id="grpc_reflection.v1alpha.reflection.ReflectionServicer">
 
+<em class="property">class </em><code class="descclassname">grpc_reflection.v1alpha.reflection.</code><code class="descname">ReflectionServicer</code><span class="sig-paren">(</span><em>service_names</em>, <em>pool=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_reflection/v1alpha/reflection.html#ReflectionServicer"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_reflection.v1alpha.reflection.ReflectionServicer" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Servicer handling RPCs for service statuses.</p>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc_reflection.v1alpha.reflection.enable_server_reflection">
 
+<code class="descclassname">grpc_reflection.v1alpha.reflection.</code><code class="descname">enable_server_reflection</code><span class="sig-paren">(</span><em>service_names</em>, <em>server</em>, <em>pool=None</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_reflection/v1alpha/reflection.html#enable_server_reflection"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_reflection.v1alpha.reflection.enable_server_reflection" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Enables server reflection on a server.</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"><ul class="first last simple">
 
+<li><strong>service_names</strong> – Iterable of fully-qualified service names available.</li>
 
+<li><strong>server</strong> – grpc.Server to which reflection service will be added.</li>
 
+<li><strong>pool</strong> – DescriptorPool object to use (descriptor_pool.Default() if None).</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</div>
 
+</div>
 
+
 
+
 
+          </div>
 
+          
+        </div>
 
+      </div>
 
+    <div class="clearer"></div>
 
+  </div>
 
+    <div class="footer">
 
+      &copy;2018, The gRPC Authors.
 
+      
+      |
 
+      <a href="_sources/grpc_reflection.rst.txt"
 
+          rel="nofollow">Page source</a>
 
+    </div>
 
+
 
+    
+
 
+    
+    <script type="text/javascript">
 
+
 
+      var _gaq = _gaq || [];
 
+      _gaq.push(['_setAccount', 'UA-60127042-1']);
 
+      _gaq.push(['_setDomainName', 'none']);
 
+      _gaq.push(['_setAllowLinker', true]);
 
+      _gaq.push(['_trackPageview']);
 
+
 
+      (function() {
 
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 
+      })();
 
+
 
+    </script>
 
+    
+  </body>
 
+</html>

+ 1072 - 0
python/grpc_testing.html
查看文件 

@@ -0,0 +1,1072 @@
 
+
 
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
+
 
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
 
+  <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.16.0 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>
 
+    <script type="text/javascript" src="_static/jquery.js"></script>
 
+    <script type="text/javascript" src="_static/underscore.js"></script>
 
+    <script type="text/javascript" src="_static/doctools.js"></script>
 
+    <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
 
+    <link rel="index" title="Index" href="genindex.html" />
 
+    <link rel="search" title="Search" href="search.html" />
 
+    <link rel="next" title="Glossary" href="glossary.html" />
 
+    <link rel="prev" title="gRPC Reflection" href="grpc_reflection.html" />
 
+   
+  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
 
+  
+  
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
 
+
 
+  </head><body>
 
+  <div class="document">
 
+    
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 
+        <div class="sphinxsidebarwrapper">
 
+<h1 class="logo"><a href="index.html">gRPC Python</a></h1>
 
+
 
+
 
+
 
+<p class="blurb">1.16.0</p>
 
+
 
+
 
+
 
+
 
+
 
+
 
+<h3>Navigation</h3>
 
+<p class="caption"><span class="caption-text">Contents:</span></p>
 
+<ul class="current">
 
+<li class="toctree-l1"><a class="reference internal" href="grpc.html">gRPC</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_health_checking.html">gRPC Health Checking</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_reflection.html">gRPC Reflection</a></li>
 
+<li class="toctree-l1 current"><a class="current reference internal" href="#">gRPC Testing</a><ul>
 
+<li class="toctree-l2"><a class="reference internal" href="#module-grpc_testing">Module Contents</a></li>
 
+</ul>
 
+</li>
 
+<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary</a></li>
 
+</ul>
 
+
 
+<div class="relations">
 
+<h3>Related Topics</h3>
 
+<ul>
 
+  <li><a href="index.html">Documentation overview</a><ul>
 
+      <li>Previous: <a href="grpc_reflection.html" title="previous chapter">gRPC Reflection</a></li>
 
+      <li>Next: <a href="glossary.html" title="next chapter">Glossary</a></li>
 
+  </ul></li>
 
+</ul>
 
+</div>
 
+<div id="searchbox" style="display: none" role="search">
 
+  <h3>Quick search</h3>
 
+    <div class="searchformwrapper">
 
+    <form class="search" action="search.html" method="get">
 
+      <input type="text" name="q" />
 
+      <input type="submit" value="Go" />
 
+      <input type="hidden" name="check_keywords" value="yes" />
 
+      <input type="hidden" name="area" value="default" />
 
+    </form>
 
+    </div>
 
+</div>
 
+<script type="text/javascript">$('#searchbox').show(0);</script>
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+        </div>
 
+      </div>
 
+      <div class="documentwrapper">
 
+        <div class="bodywrapper">
 
+          
+
 
+          <div class="body" role="main">
 
+            
+  <div class="section" id="grpc-testing">
 
+<h1>gRPC Testing<a class="headerlink" href="#grpc-testing" title="Permalink to this headline">¶</a></h1>
 
+<div class="section" id="module-grpc_testing">
 
+<span id="module-contents"></span><h2>Module Contents<a class="headerlink" href="#module-grpc_testing" title="Permalink to this headline">¶</a></h2>
 
+<p>Objects for use in testing gRPC Python-using application code.</p>
 
+<dl class="class">
 
+<dt id="grpc_testing.Channel">
 
+<em class="property">class </em><code class="descclassname">grpc_testing.</code><code class="descname">Channel</code><a class="reference internal" href="_modules/grpc_testing.html#Channel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Channel" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>A grpc.Channel double with which to test a system that invokes RPCs.</p>
 
+<dl class="method">
 
+<dt id="grpc_testing.Channel.take_stream_stream">
 
+<code class="descname">take_stream_stream</code><span class="sig-paren">(</span><em>method_descriptor</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Channel.take_stream_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Channel.take_stream_stream" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Draws an RPC currently being made by the system under test.</p>
 
+<p>If the given descriptor does not identify any RPC currently being made
 
+by the system under test, this method blocks until the system under
 
+test invokes such an RPC.</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>method_descriptor</strong> – A descriptor.MethodDescriptor describing a
 
+stream-stream RPC method.</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><dl class="docutils">
 
+<dt>A (invocation_metadata, stream_stream_channel_rpc) tuple of the RPC’s</dt>
 
+<dd>invocation metadata and a StreamStreamChannelRpc with which to
 
+“play server” for the RPC.</dd>
 
+</dl>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.Channel.take_stream_unary">
 
+<code class="descname">take_stream_unary</code><span class="sig-paren">(</span><em>method_descriptor</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Channel.take_stream_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Channel.take_stream_unary" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Draws an RPC currently being made by the system under test.</p>
 
+<p>If the given descriptor does not identify any RPC currently being made
 
+by the system under test, this method blocks until the system under
 
+test invokes such an RPC.</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>method_descriptor</strong> – A descriptor.MethodDescriptor describing a
 
+stream-unary RPC method.</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><dl class="docutils">
 
+<dt>A (invocation_metadata, stream_unary_channel_rpc) tuple of the RPC’s</dt>
 
+<dd>invocation metadata and a StreamUnaryChannelRpc with which to “play
 
+server” for the RPC.</dd>
 
+</dl>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.Channel.take_unary_stream">
 
+<code class="descname">take_unary_stream</code><span class="sig-paren">(</span><em>method_descriptor</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Channel.take_unary_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Channel.take_unary_stream" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Draws an RPC currently being made by the system under test.</p>
 
+<p>If the given descriptor does not identify any RPC currently being made
 
+by the system under test, this method blocks until the system under
 
+test invokes such an RPC.</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>method_descriptor</strong> – A descriptor.MethodDescriptor describing a
 
+unary-stream RPC method.</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><dl class="docutils">
 
+<dt>A (invocation_metadata, request, unary_stream_channel_rpc) tuple of</dt>
 
+<dd>the RPC’s invocation metadata, its request, and a
 
+UnaryStreamChannelRpc with which to “play server” for the RPC.</dd>
 
+</dl>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.Channel.take_unary_unary">
 
+<code class="descname">take_unary_unary</code><span class="sig-paren">(</span><em>method_descriptor</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Channel.take_unary_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Channel.take_unary_unary" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Draws an RPC currently being made by the system under test.</p>
 
+<p>If the given descriptor does not identify any RPC currently being made
 
+by the system under test, this method blocks until the system under
 
+test invokes such an RPC.</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>method_descriptor</strong> – A descriptor.MethodDescriptor describing a
 
+unary-unary RPC method.</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><dl class="docutils">
 
+<dt>A (invocation_metadata, request, unary_unary_channel_rpc) tuple of</dt>
 
+<dd>the RPC’s invocation metadata, its request, and a
 
+UnaryUnaryChannelRpc with which to “play server” for the RPC.</dd>
 
+</dl>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc_testing.Server">
 
+<em class="property">class </em><code class="descclassname">grpc_testing.</code><code class="descname">Server</code><a class="reference internal" href="_modules/grpc_testing.html#Server"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Server" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>A server with which to test a system that services RPCs.</p>
 
+<dl class="method">
 
+<dt id="grpc_testing.Server.invoke_stream_stream">
 
+<code class="descname">invoke_stream_stream</code><span class="sig-paren">(</span><em>method_descriptor</em>, <em>invocation_metadata</em>, <em>timeout</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Server.invoke_stream_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Server.invoke_stream_stream" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Invokes an RPC to be serviced by the system under test.</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"><ul class="first simple">
 
+<li><strong>method_descriptor</strong> – A descriptor.MethodDescriptor describing a stream-stream
 
+RPC method.</li>
 
+<li><strong>invocation_metadata</strong> – The RPC’s invocation metadata.</li>
 
+<li><strong>timeout</strong> – A duration of time in seconds for the RPC or None to
 
+indicate that the RPC has no time limit.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A StreamStreamServerRpc with which to “play client” for the RPC.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.Server.invoke_stream_unary">
 
+<code class="descname">invoke_stream_unary</code><span class="sig-paren">(</span><em>method_descriptor</em>, <em>invocation_metadata</em>, <em>timeout</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Server.invoke_stream_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Server.invoke_stream_unary" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Invokes an RPC to be serviced by the system under test.</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"><ul class="first simple">
 
+<li><strong>method_descriptor</strong> – A descriptor.MethodDescriptor describing a stream-unary
 
+RPC method.</li>
 
+<li><strong>invocation_metadata</strong> – The RPC’s invocation metadata.</li>
 
+<li><strong>timeout</strong> – A duration of time in seconds for the RPC or None to
 
+indicate that the RPC has no time limit.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A StreamUnaryServerRpc with which to “play client” for the RPC.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.Server.invoke_unary_stream">
 
+<code class="descname">invoke_unary_stream</code><span class="sig-paren">(</span><em>method_descriptor</em>, <em>invocation_metadata</em>, <em>request</em>, <em>timeout</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Server.invoke_unary_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Server.invoke_unary_stream" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Invokes an RPC to be serviced by the system under test.</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"><ul class="first simple">
 
+<li><strong>method_descriptor</strong> – A descriptor.MethodDescriptor describing a unary-stream
 
+RPC method.</li>
 
+<li><strong>invocation_metadata</strong> – The RPC’s invocation metadata.</li>
 
+<li><strong>request</strong> – The RPC’s request.</li>
 
+<li><strong>timeout</strong> – A duration of time in seconds for the RPC or None to
 
+indicate that the RPC has no time limit.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A UnaryStreamServerRpc with which to “play client” for the RPC.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.Server.invoke_unary_unary">
 
+<code class="descname">invoke_unary_unary</code><span class="sig-paren">(</span><em>method_descriptor</em>, <em>invocation_metadata</em>, <em>request</em>, <em>timeout</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Server.invoke_unary_unary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Server.invoke_unary_unary" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Invokes an RPC to be serviced by the system under test.</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"><ul class="first simple">
 
+<li><strong>method_descriptor</strong> – A descriptor.MethodDescriptor describing a unary-unary
 
+RPC method.</li>
 
+<li><strong>invocation_metadata</strong> – The RPC’s invocation metadata.</li>
 
+<li><strong>request</strong> – The RPC’s request.</li>
 
+<li><strong>timeout</strong> – A duration of time in seconds for the RPC or None to
 
+indicate that the RPC has no time limit.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A UnaryUnaryServerRpc with which to “play client” for the RPC.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc_testing.StreamStreamChannelRpc">
 
+<em class="property">class </em><code class="descclassname">grpc_testing.</code><code class="descname">StreamStreamChannelRpc</code><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamChannelRpc"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamChannelRpc" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Fixture for a stream-stream RPC invoked by a system under test.</p>
 
+<p>Enables users to “play server” for the RPC.</p>
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamStreamChannelRpc.cancelled">
 
+<code class="descname">cancelled</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamChannelRpc.cancelled"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamChannelRpc.cancelled" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Blocks until the system under test has cancelled the RPC.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamStreamChannelRpc.requests_closed">
 
+<code class="descname">requests_closed</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamChannelRpc.requests_closed"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamChannelRpc.requests_closed" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Blocks until the system under test has closed the request stream.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamStreamChannelRpc.send_initial_metadata">
 
+<code class="descname">send_initial_metadata</code><span class="sig-paren">(</span><em>initial_metadata</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamChannelRpc.send_initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamChannelRpc.send_initial_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Sends the RPC’s initial metadata to the system under test.</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>initial_metadata</strong> – The RPC’s initial metadata to be “sent” to the
 
+system under test.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamStreamChannelRpc.send_response">
 
+<code class="descname">send_response</code><span class="sig-paren">(</span><em>response</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamChannelRpc.send_response"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamChannelRpc.send_response" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Sends a response to the system under test.</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>response</strong> – A response messages to be “sent” to the system under test.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamStreamChannelRpc.take_request">
 
+<code class="descname">take_request</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamChannelRpc.take_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamChannelRpc.take_request" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Draws one of the requests added to the RPC by the system under test.</p>
 
+<p>This method blocks until the system under test has added to the RPC
 
+the request to be returned.</p>
 
+<p>Successive calls to this method return requests in the same order in
 
+which the system under test added them to the RPC.</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">Returns:</th><td class="field-body">A request message added to the RPC by the system under test.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamStreamChannelRpc.terminate">
 
+<code class="descname">terminate</code><span class="sig-paren">(</span><em>trailing_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamChannelRpc.terminate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamChannelRpc.terminate" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Terminates the RPC.</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"><ul class="first last simple">
 
+<li><strong>trailing_metadata</strong> – The RPC’s trailing metadata.</li>
 
+<li><strong>code</strong> – The RPC’s status code.</li>
 
+<li><strong>details</strong> – The RPC’s status details.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc_testing.StreamStreamServerRpc">
 
+<em class="property">class </em><code class="descclassname">grpc_testing.</code><code class="descname">StreamStreamServerRpc</code><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamServerRpc"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamServerRpc" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Fixture for a stream-stream RPC serviced by a system under test.</p>
 
+<p>Enables users to “play client” for the RPC.</p>
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamStreamServerRpc.cancel">
 
+<code class="descname">cancel</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamServerRpc.cancel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamServerRpc.cancel" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Cancels the RPC.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamStreamServerRpc.initial_metadata">
 
+<code class="descname">initial_metadata</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamServerRpc.initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamServerRpc.initial_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Accesses the initial metadata emitted by the system under test.</p>
 
+<p>This method blocks until the system under test has added initial
 
+metadata to the RPC (or has provided one or more response messages or
 
+has terminated the RPC, either of which will cause gRPC Python to
 
+synthesize initial metadata for the RPC).</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">Returns:</th><td class="field-body">The initial metadata for the RPC.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamStreamServerRpc.requests_closed">
 
+<code class="descname">requests_closed</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamServerRpc.requests_closed"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamServerRpc.requests_closed" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Indicates the end of the RPC’s request stream.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamStreamServerRpc.send_request">
 
+<code class="descname">send_request</code><span class="sig-paren">(</span><em>request</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamServerRpc.send_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamServerRpc.send_request" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Sends a request to the system under test.</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>request</strong> – A request message for the RPC to be “sent” to the system
 
+under test.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamStreamServerRpc.take_response">
 
+<code class="descname">take_response</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamServerRpc.take_response"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamServerRpc.take_response" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Draws one of the responses added to the RPC by the system under test.</p>
 
+<p>Successive calls to this method return responses in the same order in
 
+which the system under test added them to the RPC.</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">Returns:</th><td class="field-body">A response message added to the RPC by the system under test.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamStreamServerRpc.termination">
 
+<code class="descname">termination</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamStreamServerRpc.termination"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamStreamServerRpc.termination" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Blocks until the system under test has terminated the RPC.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
+<dt>A (trailing_metadata, code, details) sequence with the RPC’s trailing</dt>
 
+<dd>metadata, code, and details.</dd>
 
+</dl>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc_testing.StreamUnaryChannelRpc">
 
+<em class="property">class </em><code class="descclassname">grpc_testing.</code><code class="descname">StreamUnaryChannelRpc</code><a class="reference internal" href="_modules/grpc_testing.html#StreamUnaryChannelRpc"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamUnaryChannelRpc" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Fixture for a stream-unary RPC invoked by a system under test.</p>
 
+<p>Enables users to “play server” for the RPC.</p>
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamUnaryChannelRpc.cancelled">
 
+<code class="descname">cancelled</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamUnaryChannelRpc.cancelled"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamUnaryChannelRpc.cancelled" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Blocks until the system under test has cancelled the RPC.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamUnaryChannelRpc.requests_closed">
 
+<code class="descname">requests_closed</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamUnaryChannelRpc.requests_closed"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamUnaryChannelRpc.requests_closed" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Blocks until the system under test has closed the request stream.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamUnaryChannelRpc.send_initial_metadata">
 
+<code class="descname">send_initial_metadata</code><span class="sig-paren">(</span><em>initial_metadata</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamUnaryChannelRpc.send_initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamUnaryChannelRpc.send_initial_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Sends the RPC’s initial metadata to the system under test.</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>initial_metadata</strong> – The RPC’s initial metadata to be “sent” to
 
+the system under test.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamUnaryChannelRpc.take_request">
 
+<code class="descname">take_request</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamUnaryChannelRpc.take_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamUnaryChannelRpc.take_request" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Draws one of the requests added to the RPC by the system under test.</p>
 
+<p>This method blocks until the system under test has added to the RPC
 
+the request to be returned.</p>
 
+<p>Successive calls to this method return requests in the same order in
 
+which the system under test added them to the RPC.</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">Returns:</th><td class="field-body">A request message added to the RPC by the system under test.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamUnaryChannelRpc.terminate">
 
+<code class="descname">terminate</code><span class="sig-paren">(</span><em>response</em>, <em>trailing_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamUnaryChannelRpc.terminate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamUnaryChannelRpc.terminate" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Terminates the RPC.</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"><ul class="first last simple">
 
+<li><strong>response</strong> – The response for the RPC.</li>
 
+<li><strong>trailing_metadata</strong> – The RPC’s trailing metadata.</li>
 
+<li><strong>code</strong> – The RPC’s status code.</li>
 
+<li><strong>details</strong> – The RPC’s status details.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc_testing.StreamUnaryServerRpc">
 
+<em class="property">class </em><code class="descclassname">grpc_testing.</code><code class="descname">StreamUnaryServerRpc</code><a class="reference internal" href="_modules/grpc_testing.html#StreamUnaryServerRpc"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamUnaryServerRpc" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Fixture for a stream-unary RPC serviced by a system under test.</p>
 
+<p>Enables users to “play client” for the RPC.</p>
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamUnaryServerRpc.cancel">
 
+<code class="descname">cancel</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamUnaryServerRpc.cancel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamUnaryServerRpc.cancel" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Cancels the RPC.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamUnaryServerRpc.initial_metadata">
 
+<code class="descname">initial_metadata</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamUnaryServerRpc.initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamUnaryServerRpc.initial_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Accesses the initial metadata emitted by the system under test.</p>
 
+<p>This method blocks until the system under test has added initial
 
+metadata to the RPC (or has provided one or more response messages or
 
+has terminated the RPC, either of which will cause gRPC Python to
 
+synthesize initial metadata for the RPC).</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">Returns:</th><td class="field-body">The initial metadata for the RPC.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamUnaryServerRpc.requests_closed">
 
+<code class="descname">requests_closed</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamUnaryServerRpc.requests_closed"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamUnaryServerRpc.requests_closed" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Indicates the end of the RPC’s request stream.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamUnaryServerRpc.send_request">
 
+<code class="descname">send_request</code><span class="sig-paren">(</span><em>request</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamUnaryServerRpc.send_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamUnaryServerRpc.send_request" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Sends a request to the system under test.</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>request</strong> – A request message for the RPC to be “sent” to the system
 
+under test.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.StreamUnaryServerRpc.termination">
 
+<code class="descname">termination</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#StreamUnaryServerRpc.termination"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.StreamUnaryServerRpc.termination" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Blocks until the system under test has terminated the RPC.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
+<dt>A (response, trailing_metadata, code, details) sequence with the RPC’s</dt>
 
+<dd>response, trailing metadata, code, and details.</dd>
 
+</dl>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc_testing.Time">
 
+<em class="property">class </em><code class="descclassname">grpc_testing.</code><code class="descname">Time</code><a class="reference internal" href="_modules/grpc_testing.html#Time"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Time" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>A simulation of time.</p>
 
+<p>Implementations needn’t be connected with real time as provided by the
 
+Python interpreter, but as long as systems under test use
 
+RpcContext.is_active and RpcContext.time_remaining for querying RPC liveness
 
+implementations may be used to change passage of time in tests.</p>
 
+<dl class="method">
 
+<dt id="grpc_testing.Time.call_at">
 
+<code class="descname">call_at</code><span class="sig-paren">(</span><em>behavior</em>, <em>time</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Time.call_at"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Time.call_at" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Adds a behavior to be called at a specific time.</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"><ul class="first simple">
 
+<li><strong>behavior</strong> – A behavior to be called with no arguments.</li>
 
+<li><strong>time</strong> – The test time at which to call the behavior.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
+<dt>A grpc.Future with which the call of the behavior may be cancelled</dt>
 
+<dd><p class="first last">before it is executed.</p>
 
+</dd>
 
+</dl>
 
+</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.Time.call_in">
 
+<code class="descname">call_in</code><span class="sig-paren">(</span><em>behavior</em>, <em>delay</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Time.call_in"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Time.call_in" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Adds a behavior to be called after some time.</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"><ul class="first simple">
 
+<li><strong>behavior</strong> – A behavior to be called with no arguments.</li>
 
+<li><strong>delay</strong> – A duration of time in seconds after which to call the behavior.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last"><dl class="docutils">
 
+<dt>A grpc.Future with which the call of the behavior may be cancelled</dt>
 
+<dd><p class="first last">before it is executed.</p>
 
+</dd>
 
+</dl>
 
+</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.Time.sleep_for">
 
+<code class="descname">sleep_for</code><span class="sig-paren">(</span><em>duration</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Time.sleep_for"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Time.sleep_for" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Blocks for some length of test time.</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>duration</strong> – A duration of test time in seconds for which to block.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.Time.sleep_until">
 
+<code class="descname">sleep_until</code><span class="sig-paren">(</span><em>time</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Time.sleep_until"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Time.sleep_until" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Blocks until some test time.</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>time</strong> – The test time until which to block.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.Time.time">
 
+<code class="descname">time</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#Time.time"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.Time.time" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Accesses the current test time.</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">Returns:</th><td class="field-body">The current test time (over which this object has authority).</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc_testing.UnaryStreamChannelRpc">
 
+<em class="property">class </em><code class="descclassname">grpc_testing.</code><code class="descname">UnaryStreamChannelRpc</code><a class="reference internal" href="_modules/grpc_testing.html#UnaryStreamChannelRpc"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryStreamChannelRpc" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Fixture for a unary-stream RPC invoked by a system under test.</p>
 
+<p>Enables users to “play server” for the RPC.</p>
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryStreamChannelRpc.cancelled">
 
+<code class="descname">cancelled</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryStreamChannelRpc.cancelled"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryStreamChannelRpc.cancelled" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Blocks until the system under test has cancelled the RPC.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryStreamChannelRpc.send_initial_metadata">
 
+<code class="descname">send_initial_metadata</code><span class="sig-paren">(</span><em>initial_metadata</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryStreamChannelRpc.send_initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryStreamChannelRpc.send_initial_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Sends the RPC’s initial metadata to the system under test.</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>initial_metadata</strong> – The RPC’s initial metadata to be “sent” to
 
+the system under test.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryStreamChannelRpc.send_response">
 
+<code class="descname">send_response</code><span class="sig-paren">(</span><em>response</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryStreamChannelRpc.send_response"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryStreamChannelRpc.send_response" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Sends a response to the system under test.</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>response</strong> – A response message to be “sent” to the system under test.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryStreamChannelRpc.terminate">
 
+<code class="descname">terminate</code><span class="sig-paren">(</span><em>trailing_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryStreamChannelRpc.terminate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryStreamChannelRpc.terminate" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Terminates the RPC.</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"><ul class="first last simple">
 
+<li><strong>trailing_metadata</strong> – The RPC’s trailing metadata.</li>
 
+<li><strong>code</strong> – The RPC’s status code.</li>
 
+<li><strong>details</strong> – The RPC’s status details.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc_testing.UnaryStreamServerRpc">
 
+<em class="property">class </em><code class="descclassname">grpc_testing.</code><code class="descname">UnaryStreamServerRpc</code><a class="reference internal" href="_modules/grpc_testing.html#UnaryStreamServerRpc"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryStreamServerRpc" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Fixture for a unary-stream RPC serviced by a system under test.</p>
 
+<p>Enables users to “play client” for the RPC.</p>
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryStreamServerRpc.cancel">
 
+<code class="descname">cancel</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryStreamServerRpc.cancel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryStreamServerRpc.cancel" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Cancels the RPC.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryStreamServerRpc.initial_metadata">
 
+<code class="descname">initial_metadata</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryStreamServerRpc.initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryStreamServerRpc.initial_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Accesses the initial metadata emitted by the system under test.</p>
 
+<p>This method blocks until the system under test has added initial
 
+metadata to the RPC (or has provided one or more response messages or
 
+has terminated the RPC, either of which will cause gRPC Python to
 
+synthesize initial metadata for the RPC).</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">Returns:</th><td class="field-body">The initial metadata for the RPC.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryStreamServerRpc.take_response">
 
+<code class="descname">take_response</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryStreamServerRpc.take_response"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryStreamServerRpc.take_response" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Draws one of the responses added to the RPC by the system under test.</p>
 
+<p>Successive calls to this method return responses in the same order in
 
+which the system under test added them to the RPC.</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">Returns:</th><td class="field-body">A response message added to the RPC by the system under test.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryStreamServerRpc.termination">
 
+<code class="descname">termination</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryStreamServerRpc.termination"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryStreamServerRpc.termination" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Blocks until the system under test has terminated the RPC.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
+<dt>A (trailing_metadata, code, details) sequence with the RPC’s trailing</dt>
 
+<dd>metadata, code, and details.</dd>
 
+</dl>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc_testing.UnaryUnaryChannelRpc">
 
+<em class="property">class </em><code class="descclassname">grpc_testing.</code><code class="descname">UnaryUnaryChannelRpc</code><a class="reference internal" href="_modules/grpc_testing.html#UnaryUnaryChannelRpc"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryUnaryChannelRpc" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Fixture for a unary-unary RPC invoked by a system under test.</p>
 
+<p>Enables users to “play server” for the RPC.</p>
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryUnaryChannelRpc.cancelled">
 
+<code class="descname">cancelled</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryUnaryChannelRpc.cancelled"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryUnaryChannelRpc.cancelled" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Blocks until the system under test has cancelled the RPC.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryUnaryChannelRpc.send_initial_metadata">
 
+<code class="descname">send_initial_metadata</code><span class="sig-paren">(</span><em>initial_metadata</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryUnaryChannelRpc.send_initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryUnaryChannelRpc.send_initial_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Sends the RPC’s initial metadata to the system under test.</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>initial_metadata</strong> – The RPC’s initial metadata to be “sent” to
 
+the system under test.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryUnaryChannelRpc.terminate">
 
+<code class="descname">terminate</code><span class="sig-paren">(</span><em>response</em>, <em>trailing_metadata</em>, <em>code</em>, <em>details</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryUnaryChannelRpc.terminate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryUnaryChannelRpc.terminate" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Terminates the RPC.</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"><ul class="first last simple">
 
+<li><strong>response</strong> – The response for the RPC.</li>
 
+<li><strong>trailing_metadata</strong> – The RPC’s trailing metadata.</li>
 
+<li><strong>code</strong> – The RPC’s status code.</li>
 
+<li><strong>details</strong> – The RPC’s status details.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="class">
 
+<dt id="grpc_testing.UnaryUnaryServerRpc">
 
+<em class="property">class </em><code class="descclassname">grpc_testing.</code><code class="descname">UnaryUnaryServerRpc</code><a class="reference internal" href="_modules/grpc_testing.html#UnaryUnaryServerRpc"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryUnaryServerRpc" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Fixture for a unary-unary RPC serviced by a system under test.</p>
 
+<p>Enables users to “play client” for the RPC.</p>
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryUnaryServerRpc.cancel">
 
+<code class="descname">cancel</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryUnaryServerRpc.cancel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryUnaryServerRpc.cancel" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Cancels the RPC.</p>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryUnaryServerRpc.initial_metadata">
 
+<code class="descname">initial_metadata</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryUnaryServerRpc.initial_metadata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryUnaryServerRpc.initial_metadata" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Accesses the initial metadata emitted by the system under test.</p>
 
+<p>This method blocks until the system under test has added initial
 
+metadata to the RPC (or has provided one or more response messages or
 
+has terminated the RPC, either of which will cause gRPC Python to
 
+synthesize initial metadata for the RPC).</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">Returns:</th><td class="field-body">The initial metadata for the RPC.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="method">
 
+<dt id="grpc_testing.UnaryUnaryServerRpc.termination">
 
+<code class="descname">termination</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#UnaryUnaryServerRpc.termination"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.UnaryUnaryServerRpc.termination" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Blocks until the system under test has terminated the RPC.</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">Returns:</th><td class="field-body"><dl class="docutils">
 
+<dt>A (response, trailing_metadata, code, details) sequence with the RPC’s</dt>
 
+<dd>response, trailing metadata, code, and details.</dd>
 
+</dl>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc_testing.channel">
 
+<code class="descclassname">grpc_testing.</code><code class="descname">channel</code><span class="sig-paren">(</span><em>service_descriptors</em>, <em>time</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#channel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.channel" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a Channel for use in tests of a gRPC Python-using system.</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"><ul class="first simple">
 
+<li><strong>service_descriptors</strong> – An iterable of descriptor.ServiceDescriptors
 
+describing the RPCs that will be made on the returned Channel by the
 
+system under test.</li>
 
+<li><strong>time</strong> – A Time to be used for tests.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A Channel for use in tests.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc_testing.server_from_dictionary">
 
+<code class="descclassname">grpc_testing.</code><code class="descname">server_from_dictionary</code><span class="sig-paren">(</span><em>descriptors_to_servicers</em>, <em>time</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#server_from_dictionary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.server_from_dictionary" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a Server for use in tests of a gRPC Python-using system.</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"><ul class="first simple">
 
+<li><strong>descriptors_to_servicers</strong> – A dictionary from descriptor.ServiceDescriptors
 
+defining RPC services to servicer objects (usually instances of classes
 
+that implement “Servicer” interfaces defined in generated “_pb2_grpc”
 
+modules) implementing those services.</li>
 
+<li><strong>time</strong> – A Time to be used for tests.</li>
 
+</ul>
 
+</td>
 
+</tr>
 
+<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A Server for use in tests.</p>
 
+</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc_testing.strict_fake_time">
 
+<code class="descclassname">grpc_testing.</code><code class="descname">strict_fake_time</code><span class="sig-paren">(</span><em>now</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#strict_fake_time"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.strict_fake_time" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a Time that can be manipulated by test code.</p>
 
+<p>The returned instance maintains an internal representation of time
 
+independent of real time. This internal representation only advances
 
+when user code calls the instance’s sleep_for and sleep_until methods.</p>
 
+<p>The returned instance will be “strict” with respect to callbacks
 
+submitted to it: it will ensure that all callbacks registered to
 
+be called at time t have been called before it describes the time
 
+as having advanced beyond t.</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">Returns:</th><td class="field-body">A Time that simulates the passage of time.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+<dl class="function">
 
+<dt id="grpc_testing.strict_real_time">
 
+<code class="descclassname">grpc_testing.</code><code class="descname">strict_real_time</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_testing.html#strict_real_time"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#grpc_testing.strict_real_time" title="Permalink to this definition">¶</a></dt>
 
+<dd><p>Creates a Time backed by the Python interpreter’s time.</p>
 
+<p>The returned instance will be “strict” with respect to callbacks
 
+submitted to it: it will ensure that all callbacks registered to
 
+be called at time t have been called before it describes the time
 
+as having advanced beyond t.</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">Returns:</th><td class="field-body">A Time backed by the “system” (Python interpreter’s) time.</td>
 
+</tr>
 
+</tbody>
 
+</table>
 
+</dd></dl>
 
+
 
+</div>
 
+</div>
 
+
 
+
 
+          </div>
 
+          
+        </div>
 
+      </div>
 
+    <div class="clearer"></div>
 
+  </div>
 
+    <div class="footer">
 
+      &copy;2018, The gRPC Authors.
 
+      
+      |
 
+      <a href="_sources/grpc_testing.rst.txt"
 
+          rel="nofollow">Page source</a>
 
+    </div>
 
+
 
+    
+
 
+    
+    <script type="text/javascript">
 
+
 
+      var _gaq = _gaq || [];
 
+      _gaq.push(['_setAccount', 'UA-60127042-1']);
 
+      _gaq.push(['_setDomainName', 'none']);
 
+      _gaq.push(['_setAllowLinker', true]);
 
+      _gaq.push(['_trackPageview']);
 
+
 
+      (function() {
 
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 
+      })();
 
+
 
+    </script>
 
+    
+  </body>
 
+</html>

+ 124 - 204
python/index.html
查看文件 

@@ -1,129 +1,74 @@
 
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>Welcome to grpcio’s documentation! &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
-  
-  
-  
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
+
 
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
 
+  <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.16.0 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>
 
+    <script type="text/javascript" src="_static/jquery.js"></script>
 
+    <script type="text/javascript" src="_static/underscore.js"></script>
 
+    <script type="text/javascript" src="_static/doctools.js"></script>
 
+    <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
 
+    <link rel="index" title="Index" href="genindex.html" />
 
+    <link rel="search" title="Search" href="search.html" />
 
+    <link rel="next" title="gRPC" href="grpc.html" />
 
+   
+  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
 
   
-
 
   
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
 
 
-  
-  
+  </head><body>
 
+  <div class="document">
 
     
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 
+        <div class="sphinxsidebarwrapper">
 
+<h1 class="logo"><a href="#">gRPC Python</a></h1>
 
 
-  
 
-  
-  
-    <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
 
-  
-
 
-  
-
 
-  
-        <link rel="index" title="Index"
 
-              href="genindex.html"/>
 
-        <link rel="search" title="Search" href="search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="#"/>
 
-        <link rel="next" title="grpc package" href="grpc.html"/> 
-
 
-  
-  <script src="_static/js/modernizr.min.js"></script>
 
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
+<p class="blurb">1.16.0</p>
 
 
-<body class="wy-body-for-nav" role="document">
 
-
 
-   
-  <div class="wy-grid-for-nav">
 
-
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="#" class="icon icon-home"> grpcio
 
-          
 
-          
-          </a>
 
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
 
-          
-        </div>
 
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
+<h3>Navigation</h3>
 
+<p class="caption"><span class="caption-text">Contents:</span></p>
 
 <ul>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html#glossary">Glossary</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc.html">gRPC</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_health_checking.html">gRPC Health Checking</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_reflection.html">gRPC Reflection</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_testing.html">gRPC Testing</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary</a></li>
 
 </ul>
 
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="#">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
+<div class="relations">
 
+<h3>Related Topics</h3>
 
+<ul>
 
+  <li><a href="#">Documentation overview</a><ul>
 
+      <li>Next: <a href="grpc.html" title="next chapter">gRPC</a></li>
 
+  </ul></li>
 
+</ul>
 
+</div>
 
+<div id="searchbox" style="display: none" role="search">
 
+  <h3>Quick search</h3>
 
+    <div class="searchformwrapper">
 
+    <form class="search" action="search.html" method="get">
 
+      <input type="text" name="q" />
 
+      <input type="submit" value="Go" />
 
+      <input type="hidden" name="check_keywords" value="yes" />
 
+      <input type="hidden" name="area" value="default" />
 
+    </form>
 
+    </div>
 
+</div>
 
+<script type="text/javascript">$('#searchbox').show(0);</script>
 
 
 
 
@@ -131,57 +76,67 @@
 
 
 
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="#">Docs</a> &raquo;</li>
 
-        
-      <li>Welcome to grpcio’s documentation!</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-            <a href="_sources/index.rst.txt" rel="nofollow"> View page source</a>
 
+        </div>
 
+      </div>
 
+      <div class="documentwrapper">
 
+        <div class="bodywrapper">
 
           
-        
-      </li>
 
-    
-  </ul>
 
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
+          <div class="body" role="main">
 
             
-  <div class="section" id="welcome-to-grpcio-s-documentation">
 
-<h1>Welcome to grpcio’s documentation!<a class="headerlink" href="#welcome-to-grpcio-s-documentation" title="Permalink to this headline">¶</a></h1>
 
+  <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.16.0 Release: 1.16.0</p>
 
+</div>
 
+<div class="section" id="api-reference">
 
+<h1>API Reference<a class="headerlink" href="#api-reference" title="Permalink to this headline">¶</a></h1>
 
 <div class="toctree-wrapper compound">
 
 <p class="caption"><span class="caption-text">Contents:</span></p>
 
 <ul>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html">grpc package</a><ul>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.html#subpackages">Subpackages</a><ul>
 
-<li class="toctree-l3"><a class="reference internal" href="grpc.beta.html">grpc.beta package</a><ul>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.beta.html#submodules">Submodules</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.beta.html#module-grpc.beta.implementations">grpc.beta.implementations module</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.beta.html#module-grpc.beta.interfaces">grpc.beta.interfaces module</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.beta.html#module-grpc.beta.utilities">grpc.beta.utilities module</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.beta.html#module-grpc.beta">Module contents</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc.html">gRPC</a><ul>
 
+<li class="toctree-l2"><a class="reference internal" href="grpc.html#tutorial">Tutorial</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="grpc.html#example">Example</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="grpc.html#module-contents">Module Contents</a><ul>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#create-client">Create Client</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#create-client-credentials">Create Client Credentials</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#create-server">Create Server</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#create-server-credentials">Create Server Credentials</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#rpc-method-handlers">RPC Method Handlers</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#channel-ready-future">Channel Ready Future</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#channel-connectivity">Channel Connectivity</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#grpc-status-code">gRPC Status Code</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#channel-object">Channel Object</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#server-object">Server Object</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#authentication-authorization-objects">Authentication &amp; Authorization Objects</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#grpc-exceptions">gRPC Exceptions</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#shared-context">Shared Context</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#client-side-context">Client-Side Context</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#client-side-interceptor">Client-Side Interceptor</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#service-side-context">Service-Side Context</a></li>
 
+<li class="toctree-l3"><a class="reference internal" href="grpc.html#service-side-handler">Service-Side Handler</a></li>
 
+<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>
 
 </ul>
 
 </li>
 
-<li class="toctree-l3"><a class="reference internal" href="grpc.framework.html">grpc.framework package</a><ul>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.html#subpackages">Subpackages</a></li>
 
-<li class="toctree-l4"><a class="reference internal" href="grpc.framework.html#module-grpc.framework">Module contents</a></li>
 
 </ul>
 
 </li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_health_checking.html">gRPC Health Checking</a><ul>
 
+<li class="toctree-l2"><a class="reference internal" href="grpc_health_checking.html#module-contents">Module Contents</a></li>
 
 </ul>
 
 </li>
 
-<li class="toctree-l2"><a class="reference internal" href="grpc.html#module-grpc">Module contents</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_reflection.html">gRPC Reflection</a><ul>
 
+<li class="toctree-l2"><a class="reference internal" href="grpc_reflection.html#what-is-grpc-reflection">What is gRPC reflection?</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="grpc_reflection.html#example">Example</a></li>
 
+<li class="toctree-l2"><a class="reference internal" href="grpc_reflection.html#module-grpc_reflection.v1alpha.reflection">Module Contents</a></li>
 
 </ul>
 
 </li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html#glossary">Glossary</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_testing.html">gRPC Testing</a><ul>
 
+<li class="toctree-l2"><a class="reference internal" href="grpc_testing.html#module-grpc_testing">Module Contents</a></li>
 
+</ul>
 
+</li>
 
+<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary</a></li>
 
 </ul>
 
 </div>
 
 </div>
 
@@ -195,73 +150,38 @@
 
 </div>
 
 
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
           </div>
 
-          <footer>
 
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 
-      
-        <a href="grpc.html" class="btn btn-neutral float-right" title="grpc package" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
 
-      
-      
-    </div>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
+          
         </div>
 
       </div>
 
-
 
-    </section>
 
-
 
+    <div class="clearer"></div>
 
   </div>
 
-  
-
 
+    <div class="footer">
 
+      &copy;2018, The gRPC Authors.
 
+      
+      |
 
+      <a href="_sources/index.rst.txt"
 
+          rel="nofollow">Page source</a>
 
+    </div>
 
 
-  
+    
 
+    
     <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'./',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="_static/jquery.js"></script>
 
-      <script type="text/javascript" src="_static/underscore.js"></script>
 
-      <script type="text/javascript" src="_static/doctools.js"></script>
 
 
-  
-
 
-  
-  
-    <script type="text/javascript" src="_static/js/theme.js"></script>
 
-  
+      var _gaq = _gaq || [];
 
+      _gaq.push(['_setAccount', 'UA-60127042-1']);
 
+      _gaq.push(['_setDomainName', 'none']);
 
+      _gaq.push(['_setAllowLinker', true]);
 
+      _gaq.push(['_trackPageview']);
 
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
+      (function() {
 
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 
+      })();
 
 
-</body>
 
+    </script>
 
+    
+  </body>
 
 </html>

二進制
python/objects.inv
查看文件


+ 92 - 284
python/py-modindex.html
查看文件 

@@ -1,160 +1,94 @@
 
 
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
+
 
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
 
+  <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.16.0 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>
 
+    <script type="text/javascript" src="_static/jquery.js"></script>
 
+    <script type="text/javascript" src="_static/underscore.js"></script>
 
+    <script type="text/javascript" src="_static/doctools.js"></script>
 
+    <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
 
+    <link rel="index" title="Index" href="genindex.html" />
 
+    <link rel="search" title="Search" href="search.html" />
 
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
+   
+  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
 
   
-  <title>Python Module Index &mdash; grpcio 1.8.0 documentation</title>
 
   
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
 
 
-  
-  
-  
-  
 
-  
+    <script type="text/javascript">
 
+      DOCUMENTATION_OPTIONS.COLLAPSE_INDEX = true;
 
+    </script>
 
 
-  
-  
+
 
+  </head><body>
 
+  <div class="document">
 
     
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 
+        <div class="sphinxsidebarwrapper">
 
+<h1 class="logo"><a href="index.html">gRPC Python</a></h1>
 
 
-  
 
-  
-  
-    <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
 
-  
 
-  
+<p class="blurb">1.16.0</p>
 
 
-  
-        <link rel="index" title="Index"
 
-              href="genindex.html"/>
 
-        <link rel="search" title="Search" href="search.html"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="index.html"/>
 
- 
 
 
 
-  
-  <script src="_static/js/modernizr.min.js"></script>
 
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
 
-<body class="wy-body-for-nav" role="document">
 
+<h3>Navigation</h3>
 
+<p class="caption"><span class="caption-text">Contents:</span></p>
 
+<ul>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc.html">gRPC</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_health_checking.html">gRPC Health Checking</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_reflection.html">gRPC Reflection</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_testing.html">gRPC Testing</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary</a></li>
 
+</ul>
 
 
-   
-  <div class="wy-grid-for-nav">
 
+<div class="relations">
 
+<h3>Related Topics</h3>
 
+<ul>
 
+  <li><a href="index.html">Documentation overview</a><ul>
 
+  </ul></li>
 
+</ul>
 
+</div>
 
+<div id="searchbox" style="display: none" role="search">
 
+  <h3>Quick search</h3>
 
+    <div class="searchformwrapper">
 
+    <form class="search" action="search.html" method="get">
 
+      <input type="text" name="q" />
 
+      <input type="submit" value="Go" />
 
+      <input type="hidden" name="check_keywords" value="yes" />
 
+      <input type="hidden" name="area" value="default" />
 
+    </form>
 
+    </div>
 
+</div>
 
+<script type="text/javascript">$('#searchbox').show(0);</script>
 
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
 
-          
-            <a href="index.html" class="icon icon-home"> grpcio
 
-          
 
-          
-          </a>
 
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
 
-          
-        </div>
 
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
-<ul>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html#glossary">Glossary</a></li>
 
-</ul>
 
 
-            
-          
         </div>
 
       </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
+      <div class="documentwrapper">
 
+        <div class="bodywrapper">
 
           
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
-
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="index.html">Docs</a> &raquo;</li>
 
-        
-      <li>Python Module Index</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-            
-        
-      </li>
 
-    
-  </ul>
 
-
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
+          <div class="body" role="main">
 
             
 
    <h1>Python Module Index</h1>
 
@@ -168,184 +102,58 @@
 
      <tr class="cap" id="cap-g"><td></td><td>
 
        <strong>g</strong></td><td></td></tr>
 
      <tr>
 
-       <td><img src="_static/minus.png" class="toggler"
 
-              id="toggle-1" style="display: none" alt="-" /></td>
 
+       <td></td>
 
        <td>
 
        <a href="grpc.html#module-grpc"><code class="xref">grpc</code></a></td><td>
 
        <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.beta.html#module-grpc.beta"><code class="xref">grpc.beta</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.beta.html#module-grpc.beta.implementations"><code class="xref">grpc.beta.implementations</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.beta.html#module-grpc.beta.interfaces"><code class="xref">grpc.beta.interfaces</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.beta.html#module-grpc.beta.utilities"><code class="xref">grpc.beta.utilities</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.html#module-grpc.framework"><code class="xref">grpc.framework</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.common.html#module-grpc.framework.common"><code class="xref">grpc.framework.common</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.common.html#module-grpc.framework.common.cardinality"><code class="xref">grpc.framework.common.cardinality</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.common.html#module-grpc.framework.common.style"><code class="xref">grpc.framework.common.style</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.foundation.html#module-grpc.framework.foundation"><code class="xref">grpc.framework.foundation</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.foundation.html#module-grpc.framework.foundation.abandonment"><code class="xref">grpc.framework.foundation.abandonment</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.foundation.html#module-grpc.framework.foundation.callable_util"><code class="xref">grpc.framework.foundation.callable_util</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.foundation.html#module-grpc.framework.foundation.future"><code class="xref">grpc.framework.foundation.future</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.foundation.html#module-grpc.framework.foundation.logging_pool"><code class="xref">grpc.framework.foundation.logging_pool</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.foundation.html#module-grpc.framework.foundation.stream"><code class="xref">grpc.framework.foundation.stream</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.foundation.html#module-grpc.framework.foundation.stream_util"><code class="xref">grpc.framework.foundation.stream_util</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.interfaces.html#module-grpc.framework.interfaces"><code class="xref">grpc.framework.interfaces</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.interfaces.base.html#module-grpc.framework.interfaces.base"><code class="xref">grpc.framework.interfaces.base</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.interfaces.base.html#module-grpc.framework.interfaces.base.base"><code class="xref">grpc.framework.interfaces.base.base</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.interfaces.base.html#module-grpc.framework.interfaces.base.utilities"><code class="xref">grpc.framework.interfaces.base.utilities</code></a></td><td>
 
-       <em></em></td></tr>
 
-     <tr class="cg-1">
 
-       <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.interfaces.face.html#module-grpc.framework.interfaces.face"><code class="xref">grpc.framework.interfaces.face</code></a></td><td>
 
+     <tr>
 
+       <td><img src="_static/minus.png" class="toggler"
 
+              id="toggle-1" style="display: none" alt="-" /></td>
 
+       <td>
 
+       <code class="xref">grpc_reflection</code></td><td>
 
        <em></em></td></tr>
 
      <tr class="cg-1">
 
        <td></td>
 
        <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.interfaces.face.html#module-grpc.framework.interfaces.face.face"><code class="xref">grpc.framework.interfaces.face.face</code></a></td><td>
 
+       <a href="grpc_reflection.html#module-grpc_reflection.v1alpha.reflection"><code class="xref">grpc_reflection.v1alpha.reflection</code></a></td><td>
 
        <em></em></td></tr>
 
-     <tr class="cg-1">
 
+     <tr>
 
        <td></td>
 
-       <td>&#160;&#160;&#160;
 
-       <a href="grpc.framework.interfaces.face.html#module-grpc.framework.interfaces.face.utilities"><code class="xref">grpc.framework.interfaces.face.utilities</code></a></td><td>
 
+       <td>
 
+       <a href="grpc_testing.html#module-grpc_testing"><code class="xref">grpc_testing</code></a></td><td>
 
        <em></em></td></tr>
 
    </table>
 
 
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
           </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
+          
         </div>
 
       </div>
 
-
 
-    </section>
 
-
 
+    <div class="clearer"></div>
 
   </div>
 
-  
-
 
+    <div class="footer">
 
+      &copy;2018, The gRPC Authors.
 
+      
+    </div>
 
 
-  
+    
 
+    
     <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'./',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="_static/jquery.js"></script>
 
-      <script type="text/javascript" src="_static/underscore.js"></script>
 
-      <script type="text/javascript" src="_static/doctools.js"></script>
 
-
 
-  
 
-  
-  
-    <script type="text/javascript" src="_static/js/theme.js"></script>
 
-  
+      var _gaq = _gaq || [];
 
+      _gaq.push(['_setAccount', 'UA-60127042-1']);
 
+      _gaq.push(['_setDomainName', 'none']);
 
+      _gaq.push(['_setAllowLinker', true]);
 
+      _gaq.push(['_trackPageview']);
 
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-   
+      (function() {
 
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 
+      })();
 
 
-</body>
 
+    </script>
 
+    
+  </body>
 
 </html>

+ 90 - 190
python/search.html
查看文件 

@@ -1,128 +1,69 @@
 
 
-
 
-<!DOCTYPE html>
 
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
-<head>
 
-  <meta charset="utf-8">
 
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-  
-  <title>Search &mdash; grpcio 1.8.0 documentation</title>
 
-  
-
 
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
+
 
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
 
+  <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.16.0 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>
 
+    <script type="text/javascript" src="_static/jquery.js"></script>
 
+    <script type="text/javascript" src="_static/underscore.js"></script>
 
+    <script type="text/javascript" src="_static/doctools.js"></script>
 
+    <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
 
+    <script type="text/javascript" src="_static/searchtools.js"></script>
 
+    <link rel="index" title="Index" href="genindex.html" />
 
+    <link rel="search" title="Search" href="#" />
 
+  <script type="text/javascript">
 
+    jQuery(function() { Search.loadIndex("searchindex.js"); });
 
+  </script>
 
   
+  <script type="text/javascript" id="searchindexloader"></script>
 
   
+   
+  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
 
   
   
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
 
 
-  
 
-  
-  
+  </head><body>
 
+  <div class="document">
 
     
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 
+        <div class="sphinxsidebarwrapper">
 
+<h1 class="logo"><a href="index.html">gRPC Python</a></h1>
 
 
-  
-
 
-  
-  
-    <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
 
-  
 
-  
 
-  
-        <link rel="index" title="Index"
 
-              href="genindex.html"/>
 
-        <link rel="search" title="Search" href="#"/>
 
-    <link rel="top" title="grpcio 1.8.0 documentation" href="index.html"/> 
+<p class="blurb">1.16.0</p>
 
 
-  
-  <script src="_static/js/modernizr.min.js"></script>
 
 
-<script type="text/javascript"> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60127042-1', 'auto'); ga('send', 'pageview'); </script></head>
 
 
-<body class="wy-body-for-nav" role="document">
 
 
-   
-  <div class="wy-grid-for-nav">
 
 
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
-      <div class="wy-side-scroll">
 
-        <div class="wy-side-nav-search">
 
-          
-
 
-          
-            <a href="index.html" class="icon icon-home"> grpcio
 
-          
-
 
-          
-          </a>
 
 
-          
-            
-            
-              <div class="version">
 
-                1.8.0
 
-              </div>
 
-            
-          
-
 
-          
-<div role="search">
 
-  <form id="rtd-search-form" class="wy-form" action="#" method="get">
 
-    <input type="text" name="q" placeholder="Search docs" />
 
-    <input type="hidden" name="check_keywords" value="yes" />
 
-    <input type="hidden" name="area" value="default" />
 
-  </form>
 
-</div>
 
-
 
-          
-        </div>
 
-
 
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
 
+<h3>Navigation</h3>
 
+<p class="caption"><span class="caption-text">Contents:</span></p>
 
 <ul>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html">grpc package</a></li>
 
-<li class="toctree-l1"><a class="reference internal" href="grpc.html#glossary">Glossary</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc.html">gRPC</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_health_checking.html">gRPC Health Checking</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_reflection.html">gRPC Reflection</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="grpc_testing.html">gRPC Testing</a></li>
 
+<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary</a></li>
 
 </ul>
 
 
-            
-          
-        </div>
 
-      </div>
 
-    </nav>
 
-
 
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
-
 
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
-          <a href="index.html">grpcio</a>
 
-        
-      </nav>
 
-
 
-
 
-      
-      <div class="wy-nav-content">
 
-        <div class="rst-content">
 
-          
-
 
-
 
-
 
-
 
-
 
-
 
-
 
-
 
+<div class="relations">
 
+<h3>Related Topics</h3>
 
+<ul>
 
+  <li><a href="index.html">Documentation overview</a><ul>
 
+  </ul></li>
 
+</ul>
 
+</div>
 
 
 
 
@@ -130,109 +71,68 @@
 
 
 
 
-<div role="navigation" aria-label="breadcrumbs navigation">
 
 
-  <ul class="wy-breadcrumbs">
 
-    
-      <li><a href="index.html">Docs</a> &raquo;</li>
 
-        
-      <li>Search</li>
 
-    
-    
-      <li class="wy-breadcrumbs-aside">
 
-        
-      </li>
 
-    
-  </ul>
 
+        </div>
 
+      </div>
 
+      <div class="documentwrapper">
 
+        <div class="bodywrapper">
 
+          
 
-  
-  <hr/>
 
-</div>
 
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 
-           <div itemprop="articleBody">
 
+          <div class="body" role="main">
 
             
-  <noscript>
 
+  <h1 id="search-documentation">Search</h1>
 
   <div id="fallback" class="admonition warning">
 
-    <p class="last">
 
-      Please activate JavaScript to enable the search
 
-      functionality.
 
-    </p>
 
+  <script type="text/javascript">$('#fallback').hide();</script>
 
+  <p>
 
+    Please activate JavaScript to enable the search
 
+    functionality.
 
+  </p>
 
   </div>
 
-  </noscript>
 
-
 
+  <p>
 
+    From here you can search these documents. Enter your search
 
+    words into the box below and click "search". Note that the search
 
+    function will automatically search for all of the words. Pages
 
+    containing fewer words won't appear in the result list.
 
+  </p>
 
+  <form action="" method="get">
 
+    <input type="text" name="q" value="" />
 
+    <input type="submit" value="search" />
 
+    <span id="search-progress" style="padding-left: 10px"></span>
 
+  </form>
 
   
   <div id="search-results">
 
   
   </div>
 
 
-           </div>
 
-           <div class="articleComments">
 
-            
-           </div>
 
           </div>
 
-          <footer>
 
-  
-
 
-  <hr/>
 
-
 
-  <div role="contentinfo">
 
-    <p>
 
-        &copy; Copyright 2016, The gRPC Authors.
 
-
 
-    </p>
 
-  </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 
-
 
-</footer>
 
-
 
+          
         </div>
 
       </div>
 
-
 
-    </section>
 
-
 
+    <div class="clearer"></div>
 
   </div>
 
-  
-
 
+    <div class="footer">
 
+      &copy;2018, The gRPC Authors.
 
+      
+    </div>
 
 
-  
+    
 
+    
     <script type="text/javascript">
 
-        var DOCUMENTATION_OPTIONS = {
 
-            URL_ROOT:'./',
 
-            VERSION:'1.8.0',
 
-            COLLAPSE_INDEX:false,
 
-            FILE_SUFFIX:'.html',
 
-            HAS_SOURCE:  true,
 
-            SOURCELINK_SUFFIX: '.txt'
 
-        };
 
-    </script>
 
-      <script type="text/javascript" src="_static/jquery.js"></script>
 
-      <script type="text/javascript" src="_static/underscore.js"></script>
 
-      <script type="text/javascript" src="_static/doctools.js"></script>
 
-      <script type="text/javascript" src="_static/searchtools.js"></script>
 
 
-  
+      var _gaq = _gaq || [];
 
+      _gaq.push(['_setAccount', 'UA-60127042-1']);
 
+      _gaq.push(['_setDomainName', 'none']);
 
+      _gaq.push(['_setAllowLinker', true]);
 
+      _gaq.push(['_trackPageview']);
 
 
-  
-  
-    <script type="text/javascript" src="_static/js/theme.js"></script>
 
-  
+      (function() {
 
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 
+      })();
 
 
-  
-  
-  <script type="text/javascript">
 
-      jQuery(function () {
 
-          SphinxRtdTheme.StickyNav.enable();
 
-      });
 
-  </script>
 
-  
-  <script type="text/javascript">
 
-    jQuery(function() { Search.loadIndex("searchindex.js"); });
 
-  </script>
 
-  
-  <script type="text/javascript" id="searchindexloader"></script>
 
-   
-
 
-
 
-</body>
 
+    </script>
 
+    
+  </body>
 
 </html>

File diff suppressed because it is too large
+ 0 - 0
python/searchindex.js


Some files were not shown because too many files changed in this diff