carto
/
grpc


			
							12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670
							

<!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 0.11.0b1 documentation</title>
  

    <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
  

    <link rel="top" title="grpcio 0.11.0b1 documentation" href="index.html"/>
        <link rel="up" title="grpc.framework.interfaces package" href="grpc.framework.interfaces.html"/>
        <link rel="next" title="grpc.framework.interfaces.links package" href="grpc.framework.interfaces.links.html"/>
        <link rel="prev" title="grpc.framework.interfaces.base package" href="grpc.framework.interfaces.base.html"/> 

  
  <script src="_static/js/modernizr.min.js"></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">
                0.11.0b1
              </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">
          
            
                <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"><a class="reference internal" href="grpc.early_adopter.html">grpc.early_adopter 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>
</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.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>
</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">The code object emitted by the service-side of the RPC, or None if there
was no such value.</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">The details value emitted by the service-side of the RPC, or None if there
was no such value.</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">The initial metadata object emitted by the service-side of the RPC, or
None if there was no such value.</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">The terminal metadata object emitted by the service-side of the RPC, or
None if there was no such value.</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 (&#8220;timed out&#8221;).</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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; The method identifier of the RPC.</li>
<li><strong>request_iterator</strong> &#8211; An iterator that yields request values for the RPC.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of the RPC.</li>
<li><strong>with_call</strong> &#8211; Whether or not to include return a Call for the RPC in addition
to the reponse.</li>
<li><strong>protocol_options</strong> &#8211; 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">The response value for the RPC, and a Call for the RPC if with_call was
set to True at invocation.</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> &#8211;
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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; The method identifier of the RPC.</li>
<li><strong>request</strong> &#8211; The request value for the RPC.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of the RPC.</li>
<li><strong>with_call</strong> &#8211; Whether or not to include return a Call for the RPC in addition
to the reponse.</li>
<li><strong>protocol_options</strong> &#8211; 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">The response value for the RPC, and a Call for the RPC if with_call was
set to True at invocation.</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> &#8211;
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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; The method identifier of the RPC.</li>
<li><strong>receiver</strong> &#8211; A ResponseReceiver to be passed the response data of the RPC.</li>
<li><strong>abortion_callback</strong> &#8211; A callback to be called and passed an Abortion value
in the event of RPC abortion.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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 pair of a Call object for the RPC and a stream.Consumer to which the
request values of the RPC should be passed.</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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; The method identifier of the RPC.</li>
<li><strong>receiver</strong> &#8211; A ResponseReceiver to be passed the response data of the RPC.</li>
<li><strong>abortion_callback</strong> &#8211; A callback to be called and passed an Abortion value
in the event of RPC abortion.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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 pair of a Call object for the RPC and a stream.Consumer to which the
request values of the RPC should be passed.</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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; The method identifier of the RPC.</li>
<li><strong>request</strong> &#8211; The request value for the RPC.</li>
<li><strong>receiver</strong> &#8211; A ResponseReceiver to be passed the response data of the RPC.</li>
<li><strong>abortion_callback</strong> &#8211; A callback to be called and passed an Abortion value
in the event of RPC abortion.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; The method identifier of the RPC.</li>
<li><strong>request</strong> &#8211; The request value for the RPC.</li>
<li><strong>receiver</strong> &#8211; A ResponseReceiver to be passed the response data of the RPC.</li>
<li><strong>abortion_callback</strong> &#8211; A callback to be called and passed an Abortion value
in the event of RPC abortion.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; The method identifier of the RPC.</li>
<li><strong>request_iterator</strong> &#8211; An iterator that yields request values for the RPC.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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">An object that is both a Call for the RPC and a future.Future. In the
event of RPC completion, the return Future&#8217;s result value will be the
response value of the RPC. In the event of RPC abortion, the returned
Future&#8217;s exception value will be an AbortionError.</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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; The method identifier of the RPC.</li>
<li><strong>request</strong> &#8211; The request value for the RPC.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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">An object that is both a Call for the RPC and a future.Future. In the
event of RPC completion, the return Future&#8217;s result value will be the
response value of the RPC. In the event of RPC abortion, the returned
Future&#8217;s exception value will be an AbortionError.</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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; The method identifier of the RPC.</li>
<li><strong>request_iterator</strong> &#8211; An iterator that yields request values for the RPC.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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">An object that is both a Call for the RPC and an iterator of response
values. Drawing response values from the returned iterator may raise
AbortionError indicating abortion of the RPC.</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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; The method identifier of the RPC.</li>
<li><strong>request</strong> &#8211; The request value for the RPC.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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">An object that is both a Call for the RPC and an iterator of response
values. Drawing response values from the returned iterator may raise
AbortionError indicating abortion of the RPC.</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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; 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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; 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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; 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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; 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> &#8211; The group identifier of the RPC.</li>
<li><strong>method</strong> &#8211; The method identifier of the RPC.</li>
<li><strong>response_consumer</strong> &#8211; A stream.Consumer to be called to accept the response
values of the RPC.</li>
<li><strong>context</strong> &#8211; 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">A stream.Consumer with which to accept the request values of the RPC. The
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>
</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> &#8211;
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> &#8211;
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> &#8211; The terminal metadata object emitted from the
service-side of the RPC.</li>
<li><strong>code</strong> &#8211; The code object emitted from the service-side of the RPC.</li>
<li><strong>details</strong> &#8211; 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> &#8211; 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> &#8211; 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> &#8211; 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">A value specified by the provider of a Face interface implementation
affording custom state and behavior.</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> &#8211; 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> &#8211; 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> &#8211; 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">The metadata object emitted by the invocation-side of the RPC, or None if
there was no such value.</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> &#8211; 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> &#8211; An iterator that yields request values for the RPC.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of
the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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">An object that is both a Call for the RPC and an iterator of response
values. Drawing response values from the returned iterator may raise
AbortionError indicating abortion of the RPC.</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> &#8211; A ResponseReceiver to be passed the response data of the RPC.</li>
<li><strong>abortion_callback</strong> &#8211; A callback to be called and passed an Abortion value
in the event of RPC abortion.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of
the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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 single object that is both a Call object for the RPC and a
stream.Consumer to which the request values of the RPC should be passed.</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> &#8211; An iterator that yields request values for the RPC.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of
the RPC.</li>
<li><strong>with_call</strong> &#8211; Whether or not to include return a Call for the RPC in addition
to the reponse.</li>
<li><strong>protocol_options</strong> &#8211; 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">The response value for the RPC, and a Call for the RPC if with_call was
set to True at invocation.</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> &#8211;
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> &#8211; A ResponseReceiver to be passed the response data of the RPC.</li>
<li><strong>abortion_callback</strong> &#8211; A callback to be called and passed an Abortion value
in the event of RPC abortion.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of
the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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 single object that is both a Call object for the RPC and a
stream.Consumer to which the request values of the RPC should be passed.</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> &#8211; An iterator that yields request values for the RPC.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of
the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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">An object that is both a Call for the RPC and a future.Future. In the
event of RPC completion, the return Future&#8217;s result value will be the
response value of the RPC. In the event of RPC abortion, the returned
Future&#8217;s exception value will be an AbortionError.</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> &#8211; The request value for the RPC.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of
the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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">An object that is both a Call for the RPC and an iterator of response
values. Drawing response values from the returned iterator may raise
AbortionError indicating abortion of the RPC.</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> &#8211; The request value for the RPC.</li>
<li><strong>receiver</strong> &#8211; A ResponseReceiver to be passed the response data of the RPC.</li>
<li><strong>abortion_callback</strong> &#8211; A callback to be called and passed an Abortion value
in the event of RPC abortion.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of
the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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> &#8211; The request value for the RPC.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of
the RPC.</li>
<li><strong>with_call</strong> &#8211; Whether or not to include return a Call for the RPC in addition
to the reponse.</li>
<li><strong>protocol_options</strong> &#8211; 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">The response value for the RPC, and a Call for the RPC if with_call was
set to True at invocation.</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> &#8211;
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> &#8211; The request value for the RPC.</li>
<li><strong>receiver</strong> &#8211; A ResponseReceiver to be passed the response data of the RPC.</li>
<li><strong>abortion_callback</strong> &#8211; A callback to be called and passed an Abortion value
in the event of RPC abortion.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of
the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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> &#8211; The request value for the RPC.</li>
<li><strong>timeout</strong> &#8211; A duration of time in seconds to allow for the RPC.</li>
<li><strong>metadata</strong> &#8211; A metadata value to be passed to the service-side of
the RPC.</li>
<li><strong>protocol_options</strong> &#8211; 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">An object that is both a Call for the RPC and a future.Future. In the
event of RPC completion, the return Future&#8217;s result value will be the
response value of the RPC. In the event of RPC abortion, the returned
Future&#8217;s exception value will be an AbortionError.</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&#8217;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> &#8211; 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> &#8211; 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> &#8211; 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> &#8211; 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> &#8211; 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> &#8211; 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> &#8211; 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> &#8211; 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>
          <footer>
  
    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
      
        <a href="grpc.framework.interfaces.links.html" class="btn btn-neutral float-right" title="grpc.framework.interfaces.links package" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
      
      
        <a href="grpc.framework.interfaces.base.html" class="btn btn-neutral" title="grpc.framework.interfaces.base package" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
      
    </div>
  

  <hr/>

  <div role="contentinfo">
    <p>
        &copy; Copyright 2015, Author.

    </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:'0.11.0b1',
            COLLAPSE_INDEX:false,
            FILE_SUFFIX:'.html',
            HAS_SOURCE:  true
        };
    </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>