Google Git
Sign in
apache / beam-site / refs/heads/revert-643-revert-642-updates_release_2.47.0 / . / pydoc / 2.47.0 / _modules / apache_beam / yaml / yaml_transform.html
blob: 9644fd9ee32677a2c2cd88fb51d1a7433a256612 [file] [log] [blame]
<!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>apache_beam.yaml.yaml_transform &mdash; Apache Beam 2.47.0 documentation</title>
<script type="text/javascript" src="../../../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../../../" src="../../../_static/documentation_options.js"></script>
<script type="text/javascript" src="../../../_static/jquery.js"></script>
<script type="text/javascript" src="../../../_static/underscore.js"></script>
<script type="text/javascript" src="../../../_static/doctools.js"></script>
<script type="text/javascript" src="../../../_static/language_data.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../../../_static/js/theme.js"></script>
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="index" title="Index" href="../../../genindex.html" />
<link rel="search" title="Search" href="../../../search.html" />
</head>
<body class="wy-body-for-nav">
<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"> Apache Beam
</a>
<div class="version">
2.47.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.coders.html">apache_beam.coders package</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.dataframe.html">apache_beam.dataframe package</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.io.html">apache_beam.io package</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.metrics.html">apache_beam.metrics package</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.ml.html">apache_beam.ml package</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.options.html">apache_beam.options package</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.portability.html">apache_beam.portability package</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.runners.html">apache_beam.runners package</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.testing.html">apache_beam.testing package</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.transforms.html">apache_beam.transforms package</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.typehints.html">apache_beam.typehints package</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.utils.html">apache_beam.utils package</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.yaml.html">apache_beam.yaml package</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.error.html">apache_beam.error module</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.pipeline.html">apache_beam.pipeline module</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../apache_beam.pvalue.html">apache_beam.pvalue module</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../../../index.html">Apache Beam</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="../../../index.html">Docs</a> &raquo;</li>
<li><a href="../../index.html">Module code</a> &raquo;</li>
<li>apache_beam.yaml.yaml_transform</li>
<li class="wy-breadcrumbs-aside">
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<h1>Source code for apache_beam.yaml.yaml_transform</h1><div class="highlight"><pre>
<span></span><span class="c1">#</span>
<span class="c1"># Licensed to the Apache Software Foundation (ASF) under one or more</span>
<span class="c1"># contributor license agreements. See the NOTICE file distributed with</span>
<span class="c1"># this work for additional information regarding copyright ownership.</span>
<span class="c1"># The ASF licenses this file to You under the Apache License, Version 2.0</span>
<span class="c1"># (the &quot;License&quot;); you may not use this file except in compliance with</span>
<span class="c1"># the License. You may obtain a copy of the License at</span>
<span class="c1">#</span>
<span class="c1"># http://www.apache.org/licenses/LICENSE-2.0</span>
<span class="c1">#</span>
<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
<span class="c1"># See the License for the specific language governing permissions and</span>
<span class="c1"># limitations under the License.</span>
<span class="c1">#</span>
<span class="c1"># This module is experimental. No backwards-compatibility guarantees.</span>
<span class="kn">import</span> <span class="nn">collections</span>
<span class="kn">import</span> <span class="nn">json</span>
<span class="kn">import</span> <span class="nn">logging</span>
<span class="kn">import</span> <span class="nn">re</span>
<span class="kn">import</span> <span class="nn">uuid</span>
<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Iterable</span>
<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Mapping</span>
<span class="kn">import</span> <span class="nn">yaml</span>
<span class="kn">from</span> <span class="nn">yaml.loader</span> <span class="kn">import</span> <span class="n">SafeLoader</span>
<span class="kn">import</span> <span class="nn">apache_beam</span> <span class="k">as</span> <span class="nn">beam</span>
<span class="kn">from</span> <span class="nn">apache_beam.transforms.fully_qualified_named_transform</span> <span class="kn">import</span> <span class="n">FullyQualifiedNamedTransform</span>
<span class="kn">from</span> <span class="nn">apache_beam.yaml</span> <span class="kn">import</span> <span class="n">yaml_provider</span>
<span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;YamlTransform&quot;</span><span class="p">]</span>
<span class="n">_LOGGER</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">getLogger</span><span class="p">(</span><span class="vm">__name__</span><span class="p">)</span>
<span class="n">yaml_provider</span><span class="o">.</span><span class="n">fix_pycallable</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">memoize_method</span><span class="p">(</span><span class="n">func</span><span class="p">):</span>
<span class="k">def</span> <span class="nf">wrapper</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">):</span>
<span class="k">if</span> <span class="ow">not</span> <span class="nb">hasattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="s1">&#39;_cache&#39;</span><span class="p">):</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_cache</span> <span class="o">=</span> <span class="p">{}</span>
<span class="n">key</span> <span class="o">=</span> <span class="n">func</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span> <span class="n">args</span>
<span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cache</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_cache</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">func</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">)</span>
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cache</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
<span class="k">return</span> <span class="n">wrapper</span>
<span class="k">def</span> <span class="nf">only_element</span><span class="p">(</span><span class="n">xs</span><span class="p">):</span>
<span class="n">x</span><span class="p">,</span> <span class="o">=</span> <span class="n">xs</span>
<span class="k">return</span> <span class="n">x</span>
<span class="k">class</span> <span class="nc">SafeLineLoader</span><span class="p">(</span><span class="n">SafeLoader</span><span class="p">):</span>
<span class="w"> </span><span class="sd">&quot;&quot;&quot;A yaml loader that attaches line information to mappings and strings.&quot;&quot;&quot;</span>
<span class="k">class</span> <span class="nc">TaggedString</span><span class="p">(</span><span class="nb">str</span><span class="p">):</span>
<span class="w"> </span><span class="sd">&quot;&quot;&quot;A string class to which we can attach metadata.</span>
<span class="sd"> This is primarily used to trace a string&#39;s origin back to its place in a</span>
<span class="sd"> yaml file.</span>
<span class="sd"> &quot;&quot;&quot;</span>
<span class="k">def</span> <span class="nf">__reduce__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="c1"># Pickle as an ordinary string.</span>
<span class="k">return</span> <span class="nb">str</span><span class="p">,</span> <span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="p">),</span> <span class="p">)</span>
<span class="k">def</span> <span class="nf">construct_scalar</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">node</span><span class="p">):</span>
<span class="n">value</span> <span class="o">=</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">construct_scalar</span><span class="p">(</span><span class="n">node</span><span class="p">)</span>
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span>
<span class="n">value</span> <span class="o">=</span> <span class="n">SafeLineLoader</span><span class="o">.</span><span class="n">TaggedString</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
<span class="n">value</span><span class="o">.</span><span class="n">_line_</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">start_mark</span><span class="o">.</span><span class="n">line</span> <span class="o">+</span> <span class="mi">1</span>
<span class="k">return</span> <span class="n">value</span>
<span class="k">def</span> <span class="nf">construct_mapping</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">node</span><span class="p">,</span> <span class="n">deep</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
<span class="n">mapping</span> <span class="o">=</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">construct_mapping</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">deep</span><span class="o">=</span><span class="n">deep</span><span class="p">)</span>
<span class="n">mapping</span><span class="p">[</span><span class="s1">&#39;__line__&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">start_mark</span><span class="o">.</span><span class="n">line</span> <span class="o">+</span> <span class="mi">1</span>
<span class="n">mapping</span><span class="p">[</span><span class="s1">&#39;__uuid__&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">())</span>
<span class="k">return</span> <span class="n">mapping</span>
<span class="nd">@classmethod</span>
<span class="k">def</span> <span class="nf">strip_metadata</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">spec</span><span class="p">,</span> <span class="n">tagged_str</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">Mapping</span><span class="p">):</span>
<span class="k">return</span> <span class="p">{</span>
<span class="n">key</span><span class="p">:</span> <span class="bp">cls</span><span class="o">.</span><span class="n">strip_metadata</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">tagged_str</span><span class="p">)</span>
<span class="k">for</span> <span class="n">key</span><span class="p">,</span>
<span class="n">value</span> <span class="ow">in</span> <span class="n">spec</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="p">(</span><span class="s1">&#39;__line__&#39;</span><span class="p">,</span> <span class="s1">&#39;__uuid__&#39;</span><span class="p">)</span>
<span class="p">}</span>
<span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">Iterable</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="p">(</span><span class="nb">str</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">)):</span>
<span class="k">return</span> <span class="p">[</span><span class="bp">cls</span><span class="o">.</span><span class="n">strip_metadata</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">tagged_str</span><span class="p">)</span> <span class="k">for</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">]</span>
<span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">SafeLineLoader</span><span class="o">.</span><span class="n">TaggedString</span><span class="p">)</span> <span class="ow">and</span> <span class="n">tagged_str</span><span class="p">:</span>
<span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">return</span> <span class="n">spec</span>
<span class="nd">@staticmethod</span>
<span class="k">def</span> <span class="nf">get_line</span><span class="p">(</span><span class="n">obj</span><span class="p">):</span>
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
<span class="k">return</span> <span class="n">obj</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;__line__&#39;</span><span class="p">,</span> <span class="s1">&#39;unknown&#39;</span><span class="p">)</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">return</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="s1">&#39;_line_&#39;</span><span class="p">,</span> <span class="s1">&#39;unknown&#39;</span><span class="p">)</span>
<span class="k">class</span> <span class="nc">Scope</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
<span class="w"> </span><span class="sd">&quot;&quot;&quot;To look up PCollections (typically outputs of prior transforms) by name.&quot;&quot;&quot;</span>
<span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">root</span><span class="p">,</span> <span class="n">inputs</span><span class="p">,</span> <span class="n">transforms</span><span class="p">,</span> <span class="n">providers</span><span class="p">):</span>
<span class="bp">self</span><span class="o">.</span><span class="n">root</span> <span class="o">=</span> <span class="n">root</span>
<span class="bp">self</span><span class="o">.</span><span class="n">providers</span> <span class="o">=</span> <span class="n">providers</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_inputs</span> <span class="o">=</span> <span class="n">inputs</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_transforms</span> <span class="o">=</span> <span class="n">transforms</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_transforms_by_uuid</span> <span class="o">=</span> <span class="p">{</span><span class="n">t</span><span class="p">[</span><span class="s1">&#39;__uuid__&#39;</span><span class="p">]:</span> <span class="n">t</span> <span class="k">for</span> <span class="n">t</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transforms</span><span class="p">}</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_uuid_by_name</span> <span class="o">=</span> <span class="n">collections</span><span class="o">.</span><span class="n">defaultdict</span><span class="p">(</span><span class="nb">list</span><span class="p">)</span>
<span class="k">for</span> <span class="n">spec</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transforms</span><span class="p">:</span>
<span class="k">if</span> <span class="s1">&#39;name&#39;</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_uuid_by_name</span><span class="p">[</span><span class="n">spec</span><span class="p">[</span><span class="s1">&#39;name&#39;</span><span class="p">]]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">spec</span><span class="p">[</span><span class="s1">&#39;__uuid__&#39;</span><span class="p">])</span>
<span class="k">if</span> <span class="s1">&#39;type&#39;</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_uuid_by_name</span><span class="p">[</span><span class="n">spec</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">]]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">spec</span><span class="p">[</span><span class="s1">&#39;__uuid__&#39;</span><span class="p">])</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_seen_names</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">compute_all</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="k">for</span> <span class="n">transform_id</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transforms_by_uuid</span><span class="o">.</span><span class="n">keys</span><span class="p">():</span>
<span class="bp">self</span><span class="o">.</span><span class="n">compute_outputs</span><span class="p">(</span><span class="n">transform_id</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">get_pcollection</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">):</span>
<span class="k">if</span> <span class="n">name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_inputs</span><span class="p">:</span>
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_inputs</span><span class="p">[</span><span class="n">name</span><span class="p">]</span>
<span class="k">elif</span> <span class="s1">&#39;.&#39;</span> <span class="ow">in</span> <span class="n">name</span><span class="p">:</span>
<span class="n">transform</span><span class="p">,</span> <span class="n">output</span> <span class="o">=</span> <span class="n">name</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
<span class="n">outputs</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_outputs</span><span class="p">(</span><span class="n">transform</span><span class="p">)</span>
<span class="k">if</span> <span class="n">output</span> <span class="ow">in</span> <span class="n">outputs</span><span class="p">:</span>
<span class="k">return</span> <span class="n">outputs</span><span class="p">[</span><span class="n">output</span><span class="p">]</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
<span class="sa">f</span><span class="s1">&#39;Unknown output </span><span class="si">{</span><span class="nb">repr</span><span class="p">(</span><span class="n">output</span><span class="p">)</span><span class="si">}</span><span class="s1"> &#39;</span>
<span class="sa">f</span><span class="s1">&#39;at line </span><span class="si">{</span><span class="n">SafeLineLoader</span><span class="o">.</span><span class="n">get_line</span><span class="p">(</span><span class="n">name</span><span class="p">)</span><span class="si">}</span><span class="s1">: &#39;</span>
<span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">transform</span><span class="si">}</span><span class="s1"> only has outputs </span><span class="si">{</span><span class="nb">list</span><span class="p">(</span><span class="n">outputs</span><span class="o">.</span><span class="n">keys</span><span class="p">())</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">outputs</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_outputs</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>
<span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">outputs</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
<span class="k">return</span> <span class="n">only_element</span><span class="p">(</span><span class="n">outputs</span><span class="o">.</span><span class="n">values</span><span class="p">())</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
<span class="sa">f</span><span class="s1">&#39;Ambiguous output at line </span><span class="si">{</span><span class="n">SafeLineLoader</span><span class="o">.</span><span class="n">get_line</span><span class="p">(</span><span class="n">name</span><span class="p">)</span><span class="si">}</span><span class="s1">: &#39;</span>
<span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s1"> has outputs </span><span class="si">{</span><span class="nb">list</span><span class="p">(</span><span class="n">outputs</span><span class="o">.</span><span class="n">keys</span><span class="p">())</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">get_outputs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">transform_name</span><span class="p">):</span>
<span class="k">if</span> <span class="n">transform_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transforms_by_uuid</span><span class="p">:</span>
<span class="n">transform_id</span> <span class="o">=</span> <span class="n">transform_name</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">candidates</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_uuid_by_name</span><span class="p">[</span><span class="n">transform_name</span><span class="p">]</span>
<span class="k">if</span> <span class="ow">not</span> <span class="n">candidates</span><span class="p">:</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
<span class="sa">f</span><span class="s1">&#39;Unknown transform at line &#39;</span>
<span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">SafeLineLoader</span><span class="o">.</span><span class="n">get_line</span><span class="p">(</span><span class="n">transform_name</span><span class="p">)</span><span class="si">}</span><span class="s1">: </span><span class="si">{</span><span class="n">transform_name</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
<span class="k">elif</span> <span class="nb">len</span><span class="p">(</span><span class="n">candidates</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
<span class="sa">f</span><span class="s1">&#39;Ambiguous transform at line &#39;</span>
<span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">SafeLineLoader</span><span class="o">.</span><span class="n">get_line</span><span class="p">(</span><span class="n">transform_name</span><span class="p">)</span><span class="si">}</span><span class="s1">: </span><span class="si">{</span><span class="n">transform_name</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">transform_id</span> <span class="o">=</span> <span class="n">only_element</span><span class="p">(</span><span class="n">candidates</span><span class="p">)</span>
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">compute_outputs</span><span class="p">(</span><span class="n">transform_id</span><span class="p">)</span>
<span class="nd">@memoize_method</span>
<span class="k">def</span> <span class="nf">compute_outputs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">transform_id</span><span class="p">):</span>
<span class="k">return</span> <span class="n">expand_transform</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_transforms_by_uuid</span><span class="p">[</span><span class="n">transform_id</span><span class="p">],</span> <span class="bp">self</span><span class="p">)</span>
<span class="c1"># A method on scope as providers may be scoped...</span>
<span class="k">def</span> <span class="nf">create_ptransform</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">spec</span><span class="p">):</span>
<span class="k">if</span> <span class="s1">&#39;type&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;Missing transform type: </span><span class="si">{</span><span class="n">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
<span class="k">if</span> <span class="n">spec</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">]</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">providers</span><span class="p">:</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
<span class="s1">&#39;Unknown transform type </span><span class="si">%r</span><span class="s1"> at </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span>
<span class="p">(</span><span class="n">spec</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">],</span> <span class="n">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">)))</span>
<span class="k">for</span> <span class="n">provider</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">providers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">spec</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">]):</span>
<span class="k">if</span> <span class="n">provider</span><span class="o">.</span><span class="n">available</span><span class="p">():</span>
<span class="k">break</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
<span class="s1">&#39;No available provider for type </span><span class="si">%r</span><span class="s1"> at </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span>
<span class="p">(</span><span class="n">spec</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">],</span> <span class="n">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">)))</span>
<span class="k">if</span> <span class="s1">&#39;args&#39;</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="n">args</span> <span class="o">=</span> <span class="n">spec</span><span class="p">[</span><span class="s1">&#39;args&#39;</span><span class="p">]</span>
<span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">args</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
<span class="s1">&#39;Arguments for transform at </span><span class="si">%s</span><span class="s1"> must be a mapping.&#39;</span> <span class="o">%</span>
<span class="n">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">))</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">args</span> <span class="o">=</span> <span class="p">{</span>
<span class="n">key</span><span class="p">:</span> <span class="n">value</span>
<span class="k">for</span> <span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span> <span class="ow">in</span> <span class="n">spec</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
<span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="p">(</span><span class="s1">&#39;type&#39;</span><span class="p">,</span> <span class="s1">&#39;name&#39;</span><span class="p">,</span> <span class="s1">&#39;input&#39;</span><span class="p">,</span> <span class="s1">&#39;output&#39;</span><span class="p">)</span>
<span class="p">}</span>
<span class="n">real_args</span> <span class="o">=</span> <span class="n">SafeLineLoader</span><span class="o">.</span><span class="n">strip_metadata</span><span class="p">(</span><span class="n">args</span><span class="p">)</span>
<span class="k">try</span><span class="p">:</span>
<span class="c1"># pylint: disable=undefined-loop-variable</span>
<span class="n">ptransform</span> <span class="o">=</span> <span class="n">provider</span><span class="o">.</span><span class="n">create_transform</span><span class="p">(</span><span class="n">spec</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">],</span> <span class="n">real_args</span><span class="p">)</span>
<span class="c1"># TODO(robertwb): Should we have a better API for adding annotations</span>
<span class="c1"># than this?</span>
<span class="n">annotations</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span>
<span class="n">yaml_type</span><span class="o">=</span><span class="n">spec</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">],</span>
<span class="n">yaml_args</span><span class="o">=</span><span class="n">json</span><span class="o">.</span><span class="n">dumps</span><span class="p">(</span><span class="n">real_args</span><span class="p">),</span>
<span class="n">yaml_provider</span><span class="o">=</span><span class="n">json</span><span class="o">.</span><span class="n">dumps</span><span class="p">(</span><span class="n">provider</span><span class="o">.</span><span class="n">to_json</span><span class="p">()),</span>
<span class="o">**</span><span class="n">ptransform</span><span class="o">.</span><span class="n">annotations</span><span class="p">())</span>
<span class="n">ptransform</span><span class="o">.</span><span class="n">annotations</span> <span class="o">=</span> <span class="k">lambda</span><span class="p">:</span> <span class="n">annotations</span>
<span class="k">return</span> <span class="n">ptransform</span>
<span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">exn</span><span class="p">:</span>
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">exn</span><span class="p">,</span> <span class="ne">TypeError</span><span class="p">):</span>
<span class="c1"># Create a slightly more generic error message for argument errors.</span>
<span class="n">msg</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">exn</span><span class="p">)</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">&#39;positional&#39;</span><span class="p">,</span> <span class="s1">&#39;&#39;</span><span class="p">)</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">&#39;keyword&#39;</span><span class="p">,</span> <span class="s1">&#39;&#39;</span><span class="p">)</span>
<span class="n">msg</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="sa">r</span><span class="s1">&#39;\S+lambda\S+&#39;</span><span class="p">,</span> <span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">msg</span><span class="p">)</span>
<span class="n">msg</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="s1">&#39; +&#39;</span><span class="p">,</span> <span class="s1">&#39; &#39;</span><span class="p">,</span> <span class="n">msg</span><span class="p">)</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">msg</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">exn</span><span class="p">)</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
<span class="sa">f</span><span class="s1">&#39;Invalid transform specification at </span><span class="si">{</span><span class="n">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span><span class="si">}</span><span class="s1">: </span><span class="si">{</span><span class="n">msg</span><span class="si">}</span><span class="s1">&#39;</span>
<span class="p">)</span> <span class="kn">from</span> <span class="nn">exn</span>
<span class="k">def</span> <span class="nf">unique_name</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">spec</span><span class="p">,</span> <span class="n">ptransform</span><span class="p">,</span> <span class="n">strictness</span><span class="o">=</span><span class="mi">0</span><span class="p">):</span>
<span class="k">if</span> <span class="s1">&#39;name&#39;</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="n">name</span> <span class="o">=</span> <span class="n">spec</span><span class="p">[</span><span class="s1">&#39;name&#39;</span><span class="p">]</span>
<span class="n">strictness</span> <span class="o">+=</span> <span class="mi">1</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">name</span> <span class="o">=</span> <span class="n">ptransform</span><span class="o">.</span><span class="n">label</span>
<span class="k">if</span> <span class="n">name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_seen_names</span><span class="p">:</span>
<span class="k">if</span> <span class="n">strictness</span> <span class="o">&gt;=</span> <span class="mi">2</span><span class="p">:</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;Duplicate name at </span><span class="si">{</span><span class="n">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span><span class="si">}</span><span class="s1">: </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">name</span> <span class="o">=</span> <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s1">@</span><span class="si">{</span><span class="n">SafeLineLoader</span><span class="o">.</span><span class="n">get_line</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span><span class="si">}</span><span class="s1">&#39;</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_seen_names</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>
<span class="k">return</span> <span class="n">name</span>
<span class="k">def</span> <span class="nf">expand_transform</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">scope</span><span class="p">):</span>
<span class="k">if</span> <span class="s1">&#39;type&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span>
<span class="sa">f</span><span class="s1">&#39;Missing type parameter for transform at </span><span class="si">{</span><span class="n">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
<span class="nb">type</span> <span class="o">=</span> <span class="n">spec</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">]</span>
<span class="k">if</span> <span class="nb">type</span> <span class="o">==</span> <span class="s1">&#39;composite&#39;</span><span class="p">:</span>
<span class="k">return</span> <span class="n">expand_composite_transform</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">scope</span><span class="p">)</span>
<span class="k">elif</span> <span class="nb">type</span> <span class="o">==</span> <span class="s1">&#39;chain&#39;</span><span class="p">:</span>
<span class="k">return</span> <span class="n">expand_chain_transform</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">scope</span><span class="p">)</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">return</span> <span class="n">expand_leaf_transform</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">scope</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">expand_leaf_transform</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">scope</span><span class="p">):</span>
<span class="n">spec</span> <span class="o">=</span> <span class="n">normalize_inputs_outputs</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span>
<span class="n">inputs_dict</span> <span class="o">=</span> <span class="p">{</span>
<span class="n">key</span><span class="p">:</span> <span class="n">scope</span><span class="o">.</span><span class="n">get_pcollection</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
<span class="k">for</span> <span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">[</span><span class="s1">&#39;input&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
<span class="p">}</span>
<span class="n">input_type</span> <span class="o">=</span> <span class="n">spec</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;input_type&#39;</span><span class="p">,</span> <span class="s1">&#39;default&#39;</span><span class="p">)</span>
<span class="k">if</span> <span class="n">input_type</span> <span class="o">==</span> <span class="s1">&#39;list&#39;</span><span class="p">:</span>
<span class="n">inputs</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span><span class="n">inputs_dict</span><span class="o">.</span><span class="n">values</span><span class="p">())</span>
<span class="k">elif</span> <span class="n">input_type</span> <span class="o">==</span> <span class="s1">&#39;map&#39;</span><span class="p">:</span>
<span class="n">inputs</span> <span class="o">=</span> <span class="n">inputs_dict</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">inputs_dict</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
<span class="n">inputs</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">root</span>
<span class="k">elif</span> <span class="nb">len</span><span class="p">(</span><span class="n">inputs_dict</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
<span class="n">inputs</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="nb">iter</span><span class="p">(</span><span class="n">inputs_dict</span><span class="o">.</span><span class="n">values</span><span class="p">()))</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">inputs</span> <span class="o">=</span> <span class="n">inputs_dict</span>
<span class="n">_LOGGER</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;Expanding </span><span class="si">%s</span><span class="s2"> &quot;</span><span class="p">,</span> <span class="n">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">))</span>
<span class="n">ptransform</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">create_ptransform</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span>
<span class="k">try</span><span class="p">:</span>
<span class="c1"># TODO: Move validation to construction?</span>
<span class="k">with</span> <span class="n">FullyQualifiedNamedTransform</span><span class="o">.</span><span class="n">with_filter</span><span class="p">(</span><span class="s1">&#39;*&#39;</span><span class="p">):</span>
<span class="n">outputs</span> <span class="o">=</span> <span class="n">inputs</span> <span class="o">|</span> <span class="n">scope</span><span class="o">.</span><span class="n">unique_name</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">ptransform</span><span class="p">)</span> <span class="o">&gt;&gt;</span> <span class="n">ptransform</span>
<span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">exn</span><span class="p">:</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
<span class="sa">f</span><span class="s2">&quot;Error apply transform </span><span class="si">{</span><span class="n">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">exn</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span> <span class="kn">from</span> <span class="nn">exn</span>
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">outputs</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
<span class="c1"># TODO: Handle (or at least reject) nested case.</span>
<span class="k">return</span> <span class="n">outputs</span>
<span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">outputs</span><span class="p">,</span> <span class="p">(</span><span class="nb">tuple</span><span class="p">,</span> <span class="nb">list</span><span class="p">)):</span>
<span class="k">return</span> <span class="p">{</span><span class="s1">&#39;out</span><span class="si">{ix}</span><span class="s1">&#39;</span><span class="p">:</span> <span class="n">pcoll</span> <span class="k">for</span> <span class="p">(</span><span class="n">ix</span><span class="p">,</span> <span class="n">pcoll</span><span class="p">)</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">outputs</span><span class="p">)}</span>
<span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">outputs</span><span class="p">,</span> <span class="n">beam</span><span class="o">.</span><span class="n">PCollection</span><span class="p">):</span>
<span class="k">return</span> <span class="p">{</span><span class="s1">&#39;out&#39;</span><span class="p">:</span> <span class="n">outputs</span><span class="p">}</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
<span class="sa">f</span><span class="s1">&#39;Transform </span><span class="si">{</span><span class="n">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span><span class="si">}</span><span class="s1"> returned an unexpected type &#39;</span>
<span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">outputs</span><span class="p">)</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">expand_composite_transform</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">scope</span><span class="p">):</span>
<span class="n">spec</span> <span class="o">=</span> <span class="n">normalize_inputs_outputs</span><span class="p">(</span><span class="n">normalize_source_sink</span><span class="p">(</span><span class="n">spec</span><span class="p">))</span>
<span class="n">inner_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="p">(</span>
<span class="n">scope</span><span class="o">.</span><span class="n">root</span><span class="p">,</span> <span class="p">{</span>
<span class="n">key</span><span class="p">:</span> <span class="n">scope</span><span class="o">.</span><span class="n">get_pcollection</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
<span class="k">for</span> <span class="n">key</span><span class="p">,</span>
<span class="n">value</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">[</span><span class="s1">&#39;input&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
<span class="p">},</span>
<span class="n">spec</span><span class="p">[</span><span class="s1">&#39;transforms&#39;</span><span class="p">],</span>
<span class="n">yaml_provider</span><span class="o">.</span><span class="n">merge_providers</span><span class="p">(</span>
<span class="n">yaml_provider</span><span class="o">.</span><span class="n">parse_providers</span><span class="p">(</span><span class="n">spec</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;providers&#39;</span><span class="p">,</span> <span class="p">[])),</span>
<span class="n">scope</span><span class="o">.</span><span class="n">providers</span><span class="p">))</span>
<span class="k">class</span> <span class="nc">CompositePTransform</span><span class="p">(</span><span class="n">beam</span><span class="o">.</span><span class="n">PTransform</span><span class="p">):</span>
<span class="nd">@staticmethod</span>
<span class="k">def</span> <span class="nf">expand</span><span class="p">(</span><span class="n">inputs</span><span class="p">):</span>
<span class="n">inner_scope</span><span class="o">.</span><span class="n">compute_all</span><span class="p">()</span>
<span class="k">return</span> <span class="p">{</span>
<span class="n">key</span><span class="p">:</span> <span class="n">inner_scope</span><span class="o">.</span><span class="n">get_pcollection</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
<span class="k">for</span> <span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">[</span><span class="s1">&#39;output&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
<span class="p">}</span>
<span class="k">if</span> <span class="s1">&#39;name&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="n">spec</span><span class="p">[</span><span class="s1">&#39;name&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;Composite&#39;</span>
<span class="k">if</span> <span class="n">spec</span><span class="p">[</span><span class="s1">&#39;name&#39;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> <span class="c1"># top-level pipeline, don&#39;t nest</span>
<span class="k">return</span> <span class="n">CompositePTransform</span><span class="o">.</span><span class="n">expand</span><span class="p">(</span><span class="kc">None</span><span class="p">)</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">_LOGGER</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;Expanding </span><span class="si">%s</span><span class="s2"> &quot;</span><span class="p">,</span> <span class="n">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">))</span>
<span class="k">return</span> <span class="p">({</span>
<span class="n">key</span><span class="p">:</span> <span class="n">scope</span><span class="o">.</span><span class="n">get_pcollection</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
<span class="k">for</span> <span class="n">key</span><span class="p">,</span>
<span class="n">value</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">[</span><span class="s1">&#39;input&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
<span class="p">}</span> <span class="ow">or</span> <span class="n">scope</span><span class="o">.</span><span class="n">root</span><span class="p">)</span> <span class="o">|</span> <span class="n">scope</span><span class="o">.</span><span class="n">unique_name</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> <span class="o">&gt;&gt;</span> <span class="n">CompositePTransform</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">expand_chain_transform</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">scope</span><span class="p">):</span>
<span class="k">return</span> <span class="n">expand_composite_transform</span><span class="p">(</span><span class="n">chain_as_composite</span><span class="p">(</span><span class="n">spec</span><span class="p">),</span> <span class="n">scope</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">chain_as_composite</span><span class="p">(</span><span class="n">spec</span><span class="p">):</span>
<span class="c1"># A chain is simply a composite transform where all inputs and outputs</span>
<span class="c1"># are implicit.</span>
<span class="n">spec</span> <span class="o">=</span> <span class="n">normalize_source_sink</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span>
<span class="k">if</span> <span class="s1">&#39;transforms&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span>
<span class="sa">f</span><span class="s2">&quot;Chain at </span><span class="si">{</span><span class="n">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span><span class="si">}</span><span class="s2"> missing transforms property.&quot;</span><span class="p">)</span>
<span class="n">has_explicit_outputs</span> <span class="o">=</span> <span class="s1">&#39;output&#39;</span> <span class="ow">in</span> <span class="n">spec</span>
<span class="n">composite_spec</span> <span class="o">=</span> <span class="n">normalize_inputs_outputs</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span>
<span class="n">new_transforms</span> <span class="o">=</span> <span class="p">[]</span>
<span class="k">for</span> <span class="n">ix</span><span class="p">,</span> <span class="n">transform</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">composite_spec</span><span class="p">[</span><span class="s1">&#39;transforms&#39;</span><span class="p">]):</span>
<span class="k">if</span> <span class="nb">any</span><span class="p">(</span><span class="n">io</span> <span class="ow">in</span> <span class="n">transform</span> <span class="k">for</span> <span class="n">io</span> <span class="ow">in</span> <span class="p">(</span><span class="s1">&#39;input&#39;</span><span class="p">,</span> <span class="s1">&#39;output&#39;</span><span class="p">,</span> <span class="s1">&#39;input&#39;</span><span class="p">,</span> <span class="s1">&#39;output&#39;</span><span class="p">)):</span>
<span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
<span class="sa">f</span><span class="s1">&#39;Transform </span><span class="si">{</span><span class="n">identify_object</span><span class="p">(</span><span class="n">transform</span><span class="p">)</span><span class="si">}</span><span class="s1"> is part of a chain, &#39;</span>
<span class="s1">&#39;must have implicit inputs and outputs.&#39;</span><span class="p">)</span>
<span class="k">if</span> <span class="n">ix</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
<span class="n">transform</span><span class="p">[</span><span class="s1">&#39;input&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="n">key</span><span class="p">:</span> <span class="n">key</span> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">composite_spec</span><span class="p">[</span><span class="s1">&#39;input&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">keys</span><span class="p">()}</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">transform</span><span class="p">[</span><span class="s1">&#39;input&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">new_transforms</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="s1">&#39;__uuid__&#39;</span><span class="p">]</span>
<span class="n">new_transforms</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">transform</span><span class="p">)</span>
<span class="n">composite_spec</span><span class="p">[</span><span class="s1">&#39;transforms&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">new_transforms</span>
<span class="n">last_transform</span> <span class="o">=</span> <span class="n">new_transforms</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="s1">&#39;__uuid__&#39;</span><span class="p">]</span>
<span class="k">if</span> <span class="n">has_explicit_outputs</span><span class="p">:</span>
<span class="n">composite_spec</span><span class="p">[</span><span class="s1">&#39;output&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
<span class="n">key</span><span class="p">:</span> <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">last_transform</span><span class="si">}</span><span class="s1">.</span><span class="si">{</span><span class="n">value</span><span class="si">}</span><span class="s1">&#39;</span>
<span class="k">for</span> <span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span> <span class="ow">in</span> <span class="n">composite_spec</span><span class="p">[</span><span class="s1">&#39;output&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
<span class="p">}</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">composite_spec</span><span class="p">[</span><span class="s1">&#39;output&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">last_transform</span>
<span class="k">if</span> <span class="s1">&#39;name&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">composite_spec</span><span class="p">:</span>
<span class="n">composite_spec</span><span class="p">[</span><span class="s1">&#39;name&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;Chain&#39;</span>
<span class="n">composite_spec</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;composite&#39;</span>
<span class="k">return</span> <span class="n">composite_spec</span>
<span class="k">def</span> <span class="nf">pipeline_as_composite</span><span class="p">(</span><span class="n">spec</span><span class="p">):</span>
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
<span class="k">return</span> <span class="p">{</span>
<span class="s1">&#39;type&#39;</span><span class="p">:</span> <span class="s1">&#39;composite&#39;</span><span class="p">,</span>
<span class="s1">&#39;name&#39;</span><span class="p">:</span> <span class="kc">None</span><span class="p">,</span>
<span class="s1">&#39;transforms&#39;</span><span class="p">:</span> <span class="n">spec</span><span class="p">,</span>
<span class="s1">&#39;__line__&#39;</span><span class="p">:</span> <span class="n">spec</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="s1">&#39;__line__&#39;</span><span class="p">],</span>
<span class="s1">&#39;__uuid__&#39;</span><span class="p">:</span> <span class="nb">str</span><span class="p">(</span><span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()),</span>
<span class="p">}</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">return</span> <span class="nb">dict</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="s1">&#39;composite&#39;</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">normalize_source_sink</span><span class="p">(</span><span class="n">spec</span><span class="p">):</span>
<span class="k">if</span> <span class="s1">&#39;source&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">spec</span> <span class="ow">and</span> <span class="s1">&#39;sink&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="k">return</span> <span class="n">spec</span>
<span class="n">spec</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span>
<span class="n">spec</span><span class="p">[</span><span class="s1">&#39;transforms&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">spec</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;transforms&#39;</span><span class="p">,</span> <span class="p">[]))</span>
<span class="k">if</span> <span class="s1">&#39;source&#39;</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="n">spec</span><span class="p">[</span><span class="s1">&#39;transforms&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="n">spec</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;source&#39;</span><span class="p">))</span>
<span class="k">if</span> <span class="s1">&#39;sink&#39;</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="n">spec</span><span class="p">[</span><span class="s1">&#39;transforms&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">spec</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;sink&#39;</span><span class="p">))</span>
<span class="k">return</span> <span class="n">spec</span>
<span class="k">def</span> <span class="nf">normalize_inputs_outputs</span><span class="p">(</span><span class="n">spec</span><span class="p">):</span>
<span class="n">spec</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">normalize_io</span><span class="p">(</span><span class="n">tag</span><span class="p">):</span>
<span class="n">io</span> <span class="o">=</span> <span class="n">spec</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">tag</span><span class="p">,</span> <span class="p">{})</span>
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">io</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span>
<span class="k">return</span> <span class="p">{</span><span class="n">tag</span><span class="p">:</span> <span class="n">io</span><span class="p">}</span>
<span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">io</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
<span class="k">return</span> <span class="p">{</span><span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">tag</span><span class="si">}{</span><span class="n">ix</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">:</span> <span class="n">value</span> <span class="k">for</span> <span class="n">ix</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">io</span><span class="p">)}</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">return</span> <span class="n">SafeLineLoader</span><span class="o">.</span><span class="n">strip_metadata</span><span class="p">(</span><span class="n">io</span><span class="p">,</span> <span class="n">tagged_str</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
<span class="k">return</span> <span class="nb">dict</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="nb">input</span><span class="o">=</span><span class="n">normalize_io</span><span class="p">(</span><span class="s1">&#39;input&#39;</span><span class="p">),</span> <span class="n">output</span><span class="o">=</span><span class="n">normalize_io</span><span class="p">(</span><span class="s1">&#39;output&#39;</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">identify_object</span><span class="p">(</span><span class="n">spec</span><span class="p">):</span>
<span class="n">line</span> <span class="o">=</span> <span class="n">SafeLineLoader</span><span class="o">.</span><span class="n">get_line</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span>
<span class="n">name</span> <span class="o">=</span> <span class="n">extract_name</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span>
<span class="k">if</span> <span class="n">name</span><span class="p">:</span>
<span class="k">return</span> <span class="sa">f</span><span class="s1">&#39;&quot;</span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s1">&quot; at line </span><span class="si">{</span><span class="n">line</span><span class="si">}</span><span class="s1">&#39;</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">return</span> <span class="sa">f</span><span class="s1">&#39;at line </span><span class="si">{</span><span class="n">line</span><span class="si">}</span><span class="s1">&#39;</span>
<span class="k">def</span> <span class="nf">extract_name</span><span class="p">(</span><span class="n">spec</span><span class="p">):</span>
<span class="k">if</span> <span class="s1">&#39;name&#39;</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="k">return</span> <span class="n">spec</span><span class="p">[</span><span class="s1">&#39;name&#39;</span><span class="p">]</span>
<span class="k">elif</span> <span class="s1">&#39;id&#39;</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="k">return</span> <span class="n">spec</span><span class="p">[</span><span class="s1">&#39;id&#39;</span><span class="p">]</span>
<span class="k">elif</span> <span class="s1">&#39;type&#39;</span> <span class="ow">in</span> <span class="n">spec</span><span class="p">:</span>
<span class="k">return</span> <span class="n">spec</span><span class="p">[</span><span class="s1">&#39;type&#39;</span><span class="p">]</span>
<span class="k">elif</span> <span class="nb">len</span><span class="p">(</span><span class="n">spec</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
<span class="k">return</span> <span class="n">extract_name</span><span class="p">(</span><span class="nb">next</span><span class="p">(</span><span class="nb">iter</span><span class="p">(</span><span class="n">spec</span><span class="o">.</span><span class="n">values</span><span class="p">())))</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">return</span> <span class="s1">&#39;&#39;</span>
<div class="viewcode-block" id="YamlTransform"><a class="viewcode-back" href="../../../apache_beam.yaml.yaml_transform.html#apache_beam.yaml.yaml_transform.YamlTransform">[docs]</a><span class="k">class</span> <span class="nc">YamlTransform</span><span class="p">(</span><span class="n">beam</span><span class="o">.</span><span class="n">PTransform</span><span class="p">):</span>
<span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">spec</span><span class="p">,</span> <span class="n">providers</span><span class="o">=</span><span class="p">{}):</span> <span class="c1"># pylint: disable=dangerous-default-value</span>
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span>
<span class="n">spec</span> <span class="o">=</span> <span class="n">yaml</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">spec</span><span class="p">,</span> <span class="n">Loader</span><span class="o">=</span><span class="n">SafeLineLoader</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_spec</span> <span class="o">=</span> <span class="n">spec</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_providers</span> <span class="o">=</span> <span class="n">yaml_provider</span><span class="o">.</span><span class="n">merge_providers</span><span class="p">(</span>
<span class="n">providers</span><span class="p">,</span> <span class="n">yaml_provider</span><span class="o">.</span><span class="n">standard_providers</span><span class="p">())</span>
<div class="viewcode-block" id="YamlTransform.expand"><a class="viewcode-back" href="../../../apache_beam.yaml.yaml_transform.html#apache_beam.yaml.yaml_transform.YamlTransform.expand">[docs]</a> <span class="k">def</span> <span class="nf">expand</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">pcolls</span><span class="p">):</span>
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">pcolls</span><span class="p">,</span> <span class="n">beam</span><span class="o">.</span><span class="n">pvalue</span><span class="o">.</span><span class="n">PBegin</span><span class="p">):</span>
<span class="n">root</span> <span class="o">=</span> <span class="n">pcolls</span>
<span class="n">pcolls</span> <span class="o">=</span> <span class="p">{}</span>
<span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">pcolls</span><span class="p">,</span> <span class="n">beam</span><span class="o">.</span><span class="n">PCollection</span><span class="p">):</span>
<span class="n">root</span> <span class="o">=</span> <span class="n">pcolls</span><span class="o">.</span><span class="n">pipeline</span>
<span class="n">pcolls</span> <span class="o">=</span> <span class="p">{</span><span class="s1">&#39;input&#39;</span><span class="p">:</span> <span class="n">pcolls</span><span class="p">}</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">root</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="nb">iter</span><span class="p">(</span><span class="n">pcolls</span><span class="o">.</span><span class="n">values</span><span class="p">()))</span><span class="o">.</span><span class="n">pipeline</span>
<span class="n">result</span> <span class="o">=</span> <span class="n">expand_transform</span><span class="p">(</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_spec</span><span class="p">,</span>
<span class="n">Scope</span><span class="p">(</span><span class="n">root</span><span class="p">,</span> <span class="n">pcolls</span><span class="p">,</span> <span class="n">transforms</span><span class="o">=</span><span class="p">[],</span> <span class="n">providers</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_providers</span><span class="p">))</span>
<span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">result</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
<span class="k">return</span> <span class="n">only_element</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">values</span><span class="p">())</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">return</span> <span class="n">result</span></div></div>
<span class="k">def</span> <span class="nf">expand_pipeline</span><span class="p">(</span><span class="n">pipeline</span><span class="p">,</span> <span class="n">pipeline_spec</span><span class="p">):</span>
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">pipeline_spec</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span>
<span class="n">pipeline_spec</span> <span class="o">=</span> <span class="n">yaml</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">pipeline_spec</span><span class="p">,</span> <span class="n">Loader</span><span class="o">=</span><span class="n">SafeLineLoader</span><span class="p">)</span>
<span class="c1"># Calling expand directly to avoid outer layer of nesting.</span>
<span class="k">return</span> <span class="n">YamlTransform</span><span class="p">(</span>
<span class="n">pipeline_as_composite</span><span class="p">(</span><span class="n">pipeline_spec</span><span class="p">[</span><span class="s1">&#39;pipeline&#39;</span><span class="p">]),</span>
<span class="n">yaml_provider</span><span class="o">.</span><span class="n">parse_providers</span><span class="p">(</span><span class="n">pipeline_spec</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;providers&#39;</span><span class="p">,</span> <span class="p">[])))</span><span class="o">.</span><span class="n">expand</span><span class="p">(</span>
<span class="n">beam</span><span class="o">.</span><span class="n">pvalue</span><span class="o">.</span><span class="n">PBegin</span><span class="p">(</span><span class="n">pipeline</span><span class="p">))</span>
</pre></div>
</div>
</div>
<footer>
<hr/>
<div role="contentinfo">
<p>
&copy; Copyright
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/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">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>