[cuda.compute]: API cleanup before 1.0

[shwina]

Description

• All cuda.compute algorithm parameters are now keyword-only — positional calls raise TypeError
• Parameter order aligned with CUB's C++ API (e.g. num_items before op in reduce_into and merge_sort)
• merge_sort parameter rename: d_in_items/d_out_items → d_in_values/d_out_values
• CUB header device_merge_sort.cuh: matching rename of d_items/d_input_items/d_output_items → d_values/d_input_values/d_output_values
• Docs updated: keyword-only convention documented in API conventions section

Changed files

Algorithm implementations (7)

File	Change
_reduce.py	Keyword-only; num_items before op
_segmented_reduce.py	Keyword-only; num_segments before offsets; op/h_init after offsets
_scan.py	Keyword-only; removed | None from exclusive_scan's init_value annotation
_binary_search.py	Keyword-only; reordered to d_data, num_items, d_values, num_values, d_out
_sort/_radix_sort.py	Keyword-only; num_items before order
_sort/_merge_sort.py	Keyword-only; d_in_items/d_out_items → d_in_values/d_out_values; num_items before op
_sort/_segmented_sort.py	Keyword-only

CUB C++ (1)

• cub/device/device_merge_sort.cuh: rename d_items → d_values throughout

Tests / examples / benchmarks (72)

All call sites updated to keyword-only form with corrected parameter order.

Docs (1)

• docs/python/compute/index.rst: added keyword-only convention to API conventions section; updated object-based API code example

Migration

# Before
cuda.compute.reduce_into(d_in, d_out, op, num_items, h_init)
cuda.compute.merge_sort(d_in_keys, d_in_items, d_out_keys, d_out_items, op, num_items)
cuda.compute.lower_bound(d_data, d_values, d_out, num_items, num_values)

# After
cuda.compute.reduce_into(d_in=d_in, d_out=d_out, num_items=num_items, op=op, h_init=h_init)
cuda.compute.merge_sort(d_in_keys=d_in_keys, d_in_values=d_in_values, d_out_keys=d_out_keys, d_out_values=d_out_values, num_items=num_items, op=op)
cuda.compute.lower_bound(d_data=d_data, num_items=num_items, d_values=d_values, num_values=num_values, d_out=d_out)

Checklist

• New or existing tests cover these changes.
• The documentation is up to date with these changes.

[oleksandr-pavlyk]

Change from key/item to key/value improves readability, 👍.

Suggestion: Move this change to separate PR. It is not related to Python changes.

[oleksandr-pavlyk]

Suggestion: Per naming convention outlined above, this should be d_temp_storage, or even d_temp.

[github-actions]

🥳 CI Workflow Results

🟩 Finished in 1h 27m: Pass: 100%/315 | Total: 4d 15h | Max: 1h 04m | Hits: 94%/186907

See results here.

[NaderAlAwar]

Nit: this works because it is keyword only but it would look better if we consistently put num_items before op

[oleksandr-pavlyk]

I suppose in examples as well.