Skip to content

[BEAM-1340] Mark PValue and PValueBase Internal#3033

Closed
tgroh wants to merge 2 commits intoapache:masterfrom
tgroh:pvalues_internal
Closed

[BEAM-1340] Mark PValue and PValueBase Internal#3033
tgroh wants to merge 2 commits intoapache:masterfrom
tgroh:pvalues_internal

Conversation

@tgroh
Copy link
Member

@tgroh tgroh commented May 10, 2017

Be sure to do all of the following to help us incorporate your contribution
quickly and easily:

  • Make sure the PR title is formatted like:
    [BEAM-<Jira issue #>] Description of pull request
  • Make sure tests pass via mvn clean verify.
  • Replace <Jira issue #> in the title with the actual Jira issue
    number, if there is one.
  • If this contribution is large, please file an Apache
    Individual Contributor License Agreement.

These should not be referred to as their abstract types by users, and
PipelineRunners won't interact with PValues that aren't PCollections or
PCollectionViews.

These should not be referred to as their abstract types by users, and
PipelineRunners won't interact with PValues that aren't PCollections or
PCollectionViews.
@tgroh
Copy link
Member Author

tgroh commented May 10, 2017

R: @kennknowles

Copy link
Member

@kennknowles kennknowles left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM with totally optional nits. Definitely get this into the release.

* The interface for values that can be input to and output from {@link PTransform PTransforms}.
* <b><i>For internal use. No backwards compatibility guarantees.</i></b>
*
* <p>The interface for primitive values that can be input to and output from
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since this paragraph is tautological and the next is about backwards compat (for which there is none), consider deleting them. Anyone who doesn't "already know" what PValue is for should not be touching it.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done. Replaced with a terse description ("A primitive within Beam")

* A {@link PValueBase} is an abstract base class that provides
* <b><i>For internal use. No backwards compatibility guarantees.</i></b>
*
* <p>A {@link PValueBase} is an abstract base class that provides
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FWIW I don't think we need "sensible defaults" for an non-user-facing interface with one implementation. But no need to mess with that now, obvs.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mostly removed.

@tgroh tgroh force-pushed the pvalues_internal branch from 76847b5 to d4b0e30 Compare May 10, 2017 04:01
@asfgit asfgit closed this in 8312b6f May 10, 2017
@coveralls
Copy link

Coverage Status

Coverage remained the same at 70.48% when pulling d4b0e30 on tgroh:pvalues_internal into e2be696 on apache:master.

@coveralls
Copy link

Coverage Status

Coverage increased (+0.003%) to 70.484% when pulling d4b0e30 on tgroh:pvalues_internal into e2be696 on apache:master.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants