Add Sample.Any to the Python SDK to match Java's Sample.any

[SreeramaYeshwanthGowd]

Problem

Java has Sample.any(n), which returns up to n arbitrary elements from a PCollection without the cost of a uniform random sample. The Python SDK has no equivalent. Its only global option is Sample.FixedSizeGlobally(n), which runs a uniform reservoir sample and returns a single list[T]. This gap was reported in #18552.

Solution

Add Sample.Any, the Python equivalent of Java's Sample.any. It keeps up to n arbitrary elements using a small CombineFn and returns them as a PCollection of individual elements. It makes no uniformity guarantee and is cheaper than FixedSizeGlobally because it skips the per element random sampling. If the input has fewer than n elements, all of them are returned. This mirrors Java's semantics and its element returning result type.

Testing

Added unit tests in combiners_test.py that run on the DirectRunner and cover the normal case, an input smaller than n, a windowed input, an empty input, and n equal to zero. Also extended the existing display data test to cover the new transform.

Fixes #18552

---

Thank you for your contribution! Follow this checklist to help us incorporate your contribution quickly and easily:

• Mention the appropriate issue in your description (for example: addresses #123), if applicable. This will automatically add a link to the pull request in the issue. If you would like the issue to automatically close on merging the pull request, comment fixes #<ISSUE NUMBER> instead.
• Update CHANGES.md with noteworthy changes.
• If this contribution is large, please file an Apache Individual Contributor License Agreement.

See the Contributor Guide for more tips on how to make review process smoother.

[gemini-code-assist]

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

[github-actions]

Assigning reviewers:

R: @claudevdm for label python.

Note: If you would like to opt out of this review, comment assign to next reviewer.

Available commands:

• stop reviewer notifications - opt out of the automated review tooling
• remind me after tests pass - tag the comment author after tests pass
• waiting on author - shift the attention set back to the author (any comment or push by the author will return the attention set to the reviewers)

The PR bot will only process comments in the main thread (not review comments).

[github-actions]

Reminder, please take a look at this pr: @claudevdm

[bvolpato]

LGTM. Clean bounded implementation and focused coverage. Non-blocking follow-up: align Sample.Any(-1) with Java Sample.any by rejecting negative n, and add a regression test.

[SreeramaYeshwanthGowd]

Thanks @bvolpato. Done, Sample.Any now rejects negative n with a ValueError matching Java's Sample.any, and added a regression test.