blob: 112958811343e87c6e70caf257598f518be2c3f7 [file] [log] [blame]
<!DOCTYPE html>
<html class="writer-html5" lang="en" data-content_root="./">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>apache_beam.runners.interactive.testing.pipeline_assertion module &mdash; Apache Beam 2.68.0 documentation</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=b86133f3" />
<link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=e59714d7" />
<script src="_static/jquery.js?v=5d32c60e"></script>
<script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
<script src="_static/documentation_options.js?v=2388e03a"></script>
<script src="_static/doctools.js?v=9a2dae69"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="apache_beam.runners.interactive.testing.test_cache_manager module" href="apache_beam.runners.interactive.testing.test_cache_manager.html" />
<link rel="prev" title="apache_beam.runners.interactive.testing.mock_ipython module" href="apache_beam.runners.interactive.testing.mock_ipython.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 role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="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="Navigation menu">
<ul class="current">
<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 current"><a class="reference internal" href="apache_beam.runners.html">apache_beam.runners package</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="apache_beam.runners.html#subpackages">Subpackages</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="apache_beam.runners.dask.html">apache_beam.runners.dask package</a></li>
<li class="toctree-l3"><a class="reference internal" href="apache_beam.runners.dataflow.html">apache_beam.runners.dataflow package</a></li>
<li class="toctree-l3"><a class="reference internal" href="apache_beam.runners.direct.html">apache_beam.runners.direct package</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="apache_beam.runners.interactive.html">apache_beam.runners.interactive package</a><ul class="current">
<li class="toctree-l4 current"><a class="reference internal" href="apache_beam.runners.interactive.html#subpackages">Subpackages</a></li>
<li class="toctree-l4"><a class="reference internal" href="apache_beam.runners.interactive.html#submodules">Submodules</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="apache_beam.runners.job.html">apache_beam.runners.job package</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="apache_beam.runners.html#submodules">Submodules</a></li>
</ul>
</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="Mobile navigation menu" >
<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="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item"><a href="apache_beam.runners.html">apache_beam.runners package</a></li>
<li class="breadcrumb-item"><a href="apache_beam.runners.interactive.html">apache_beam.runners.interactive package</a></li>
<li class="breadcrumb-item"><a href="apache_beam.runners.interactive.testing.html">apache_beam.runners.interactive.testing package</a></li>
<li class="breadcrumb-item active">apache_beam.runners.interactive.testing.pipeline_assertion module</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/apache_beam.runners.interactive.testing.pipeline_assertion.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="module-apache_beam.runners.interactive.testing.pipeline_assertion">
<span id="apache-beam-runners-interactive-testing-pipeline-assertion-module"></span><h1>apache_beam.runners.interactive.testing.pipeline_assertion module<a class="headerlink" href="#module-apache_beam.runners.interactive.testing.pipeline_assertion" title="Link to this heading"></a></h1>
<p>Module to verify implicit cache transforms applied by Interactive Beam.</p>
<p>For internal use only; no backwards-compatibility guarantees.
This utility should only be used by Interactive Beam tests. For example, it can
be used to verify if the implicit cache transforms are applied as expected when
running a pipeline with the InteractiveRunner. It can also be used to verify if
a pipeline fragment has pruned unnecessary transforms. It shouldn’t be used to
verify equivalence between pipelines if the code to be tested depends on or
mutates user code within transforms in pipelines.</p>
<dl class="py function">
<dt class="sig sig-object py" id="apache_beam.runners.interactive.testing.pipeline_assertion.assert_pipeline_equal">
<span class="sig-prename descclassname"><span class="pre">apache_beam.runners.interactive.testing.pipeline_assertion.</span></span><span class="sig-name descname"><span class="pre">assert_pipeline_equal</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">test_case</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">expected_pipeline</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">actual_pipeline</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/apache_beam/runners/interactive/testing/pipeline_assertion.html#assert_pipeline_equal"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#apache_beam.runners.interactive.testing.pipeline_assertion.assert_pipeline_equal" title="Link to this definition"></a></dt>
<dd><p>Asserts the equivalence between two given apache_beam.Pipeline instances.</p>
<dl class="field-list simple">
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
<dd class="field-odd"><ul class="simple">
<li><p><strong>test_case</strong> – (unittest.TestCase) the unittest testcase where it asserts.</p></li>
<li><p><strong>expected_pipeline</strong> – (Pipeline) the pipeline instance expected.</p></li>
<li><p><strong>actual_pipeline</strong> – (Pipeline) the actual pipeline instance to be asserted.</p></li>
</ul>
</dd>
</dl>
</dd></dl>
<dl class="py function">
<dt class="sig sig-object py" id="apache_beam.runners.interactive.testing.pipeline_assertion.assert_pipeline_proto_equal">
<span class="sig-prename descclassname"><span class="pre">apache_beam.runners.interactive.testing.pipeline_assertion.</span></span><span class="sig-name descname"><span class="pre">assert_pipeline_proto_equal</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">test_case</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">expected_pipeline_proto</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">actual_pipeline_proto</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/apache_beam/runners/interactive/testing/pipeline_assertion.html#assert_pipeline_proto_equal"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#apache_beam.runners.interactive.testing.pipeline_assertion.assert_pipeline_proto_equal" title="Link to this definition"></a></dt>
<dd><p>Asserts the equivalence between two pipeline proto representations.</p>
</dd></dl>
<dl class="py function">
<dt class="sig sig-object py" id="apache_beam.runners.interactive.testing.pipeline_assertion.assert_pipeline_proto_contain_top_level_transform">
<span class="sig-prename descclassname"><span class="pre">apache_beam.runners.interactive.testing.pipeline_assertion.</span></span><span class="sig-name descname"><span class="pre">assert_pipeline_proto_contain_top_level_transform</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">test_case</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">pipeline_proto</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">transform_label</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/apache_beam/runners/interactive/testing/pipeline_assertion.html#assert_pipeline_proto_contain_top_level_transform"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#apache_beam.runners.interactive.testing.pipeline_assertion.assert_pipeline_proto_contain_top_level_transform" title="Link to this definition"></a></dt>
<dd><p>Asserts the top level transforms contain a transform with the given
transform label.</p>
</dd></dl>
<dl class="py function">
<dt class="sig sig-object py" id="apache_beam.runners.interactive.testing.pipeline_assertion.assert_pipeline_proto_not_contain_top_level_transform">
<span class="sig-prename descclassname"><span class="pre">apache_beam.runners.interactive.testing.pipeline_assertion.</span></span><span class="sig-name descname"><span class="pre">assert_pipeline_proto_not_contain_top_level_transform</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">test_case</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">pipeline_proto</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">transform_label</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/apache_beam/runners/interactive/testing/pipeline_assertion.html#assert_pipeline_proto_not_contain_top_level_transform"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#apache_beam.runners.interactive.testing.pipeline_assertion.assert_pipeline_proto_not_contain_top_level_transform" title="Link to this definition"></a></dt>
<dd><p>Asserts the top level transforms do not contain a transform with the given
transform label.</p>
</dd></dl>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="apache_beam.runners.interactive.testing.mock_ipython.html" class="btn btn-neutral float-left" title="apache_beam.runners.interactive.testing.mock_ipython module" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="apache_beam.runners.interactive.testing.test_cache_manager.html" class="btn btn-neutral float-right" title="apache_beam.runners.interactive.testing.test_cache_manager module" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright %Y, Apache Beam.</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>