Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id B9BAE200C7F for ; Wed, 19 Apr 2017 00:43:17 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id B8777160BAC; Tue, 18 Apr 2017 22:43:17 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 0FCCF160BAF for ; Wed, 19 Apr 2017 00:43:16 +0200 (CEST) Received: (qmail 32928 invoked by uid 500); 18 Apr 2017 22:43:16 -0000 Mailing-List: contact commits-help@beam.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@beam.apache.org Delivered-To: mailing list commits@beam.apache.org Received: (qmail 32793 invoked by uid 99); 18 Apr 2017 22:43:16 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 18 Apr 2017 22:43:16 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 07F5FDFBC8; Tue, 18 Apr 2017 22:43:16 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: davor@apache.org To: commits@beam.apache.org Date: Tue, 18 Apr 2017 22:43:16 -0000 Message-Id: <062953c7dcc64abeadf85af07f8b001f@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [1/3] beam-site git commit: [BEAM-1949] Doc changes for Python SideOutputValue to OutputValue rename archived-at: Tue, 18 Apr 2017 22:43:17 -0000 Repository: beam-site Updated Branches: refs/heads/asf-site 64b7bca76 -> 9511ebfe8 [BEAM-1949] Doc changes for Python SideOutputValue to OutputValue rename Project: http://git-wip-us.apache.org/repos/asf/beam-site/repo Commit: http://git-wip-us.apache.org/repos/asf/beam-site/commit/679ed218 Tree: http://git-wip-us.apache.org/repos/asf/beam-site/tree/679ed218 Diff: http://git-wip-us.apache.org/repos/asf/beam-site/diff/679ed218 Branch: refs/heads/asf-site Commit: 679ed218ae81841baba25e1228cc546f00a05c21 Parents: 64b7bca Author: melissa Authored: Tue Apr 18 11:36:42 2017 -0700 Committer: Davor Bonaci Committed: Tue Apr 18 15:42:35 2017 -0700 ---------------------------------------------------------------------- src/documentation/programming-guide.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/beam-site/blob/679ed218/src/documentation/programming-guide.md ---------------------------------------------------------------------- diff --git a/src/documentation/programming-guide.md b/src/documentation/programming-guide.md index 4b9f960..2e10884 100644 --- a/src/documentation/programming-guide.md +++ b/src/documentation/programming-guide.md @@ -889,16 +889,16 @@ While `ParDo` always produces a main output `PCollection` (as the return value f ``` ```py -# To emit elements to a side output PCollection, invoke with_outputs() on the ParDo, optionally specifying the expected tags for the output. +# To emit elements to multiple output PCollections, invoke with_outputs() on the ParDo, and specify the expected tags for the outputs. # with_outputs() returns a DoOutputsTuple object. Tags specified in with_outputs are attributes on the returned DoOutputsTuple object. # The tags give access to the corresponding output PCollections. -{% github_sample /apache/beam/blob/master/sdks/python/apache_beam/examples/snippets/snippets_test.py tag:model_pardo_with_side_outputs +{% github_sample /apache/beam/blob/master/sdks/python/apache_beam/examples/snippets/snippets_test.py tag:model_pardo_with_tagged_outputs %} # The result is also iterable, ordered in the same order that the tags were passed to with_outputs(), the main tag (if specified) first. -{% github_sample /apache/beam/blob/master/sdks/python/apache_beam/examples/snippets/snippets_test.py tag:model_pardo_with_side_outputs_iter +{% github_sample /apache/beam/blob/master/sdks/python/apache_beam/examples/snippets/snippets_test.py tag:model_pardo_with_tagged_outputs_iter %}``` ##### Emitting to multiple outputs in your DoFn: @@ -928,17 +928,17 @@ While `ParDo` always produces a main output `PCollection` (as the return value f ``` ```py -# Inside your ParDo's DoFn, you can emit an element to a side output by wrapping the value and the output tag (str). -# using the pvalue.SideOutputValue wrapper class. -# Based on the previous example, this shows the DoFn emitting to the main and side outputs. +# Inside your ParDo's DoFn, you can emit an element to a specific output by wrapping the value and the output tag (str). +# using the pvalue.OutputValue wrapper class. +# Based on the previous example, this shows the DoFn emitting to the main output and two additional outputs. -{% github_sample /apache/beam/blob/master/sdks/python/apache_beam/examples/snippets/snippets_test.py tag:model_pardo_emitting_values_on_side_outputs +{% github_sample /apache/beam/blob/master/sdks/python/apache_beam/examples/snippets/snippets_test.py tag:model_pardo_emitting_values_on_tagged_outputs %} -# Side outputs are also available in Map and FlatMap. +# Producing multiple outputs is also available in Map and FlatMap. # Here is an example that uses FlatMap and shows that the tags do not need to be specified ahead of time. -{% github_sample /apache/beam/blob/master/sdks/python/apache_beam/examples/snippets/snippets_test.py tag:model_pardo_with_side_outputs_undeclared +{% github_sample /apache/beam/blob/master/sdks/python/apache_beam/examples/snippets/snippets_test.py tag:model_pardo_with_undeclared_outputs %}``` ## Composite Transforms