pyopencl 2025.2.4__tar.gz → 2025.2.6__tar.gz

{pyopencl-2025.2.4 → pyopencl-2025.2.6}/.gitignore

@@ -10,7 +10,6 @@ _skbuild
 *.pyc
 build
 *.prof
-doc/hedge-notes.pdf
 *.vtk
 *.silo
 *.session
@@ -73,7 +72,4 @@ wheelhouse
 memray-*.bin
 memray-*.html
 
-.pylintrc.yml
-.run-pylint.py
-
 pyopencl/_cl_gen.pyi

{pyopencl-2025.2.4 → pyopencl-2025.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyopencl
-Version: 2025.2.4
+Version: 2025.2.6
 Summary: Python wrapper for OpenCL
 Author-Email: Andreas Kloeckner <inform@tiker.net>
 License-Expression: MIT
@@ -30,11 +30,10 @@ Requires-Dist: oclgrind-binary-distribution>=18.3; extra == "oclgrind"
 Provides-Extra: pocl
 Requires-Dist: pocl-binary-distribution>=1.2; extra == "pocl"
 Provides-Extra: test
-Requires-Dist: ruff; extra == "test"
+Requires-Dist: basedpyright; extra == "test"
 Requires-Dist: mako; extra == "test"
-Requires-Dist: mypy; extra == "test"
-Requires-Dist: pylint; extra == "test"
 Requires-Dist: pytest>=7; extra == "test"
+Requires-Dist: ruff; extra == "test"
 Description-Content-Type: text/x-rst
 
 PyOpenCL: Pythonic Access to OpenCL, with Arrays and Algorithms

{pyopencl-2025.2.4 → pyopencl-2025.2.6}/doc/algorithm.rst

@@ -24,6 +24,13 @@ Here's a usage example:
 :download:`examples/demo_elementwise.py <../examples/demo_elementwise.py>`
 in the PyOpenCL distribution.)
 
+References
+^^^^^^^^^^
+
+.. class:: WaitList
+
+    See :class:`pyopencl.WaitList`.
+
 .. _custom-reductions:
 
 Sums and counts ("reduce")

{pyopencl-2025.2.4 → pyopencl-2025.2.6}/doc/array.rst

@@ -308,3 +308,10 @@ Generating Arrays of Random Numbers
 -----------------------------------
 
 .. automodule:: pyopencl.clrandom
+
+Type Aliases
+------------
+
+.. class:: cl.Device
+
+    See :class:`pyopencl.Device`.

{pyopencl-2025.2.4 → pyopencl-2025.2.6}/doc/conf.py

@@ -18,10 +18,11 @@ version = ".".join(str(x) for x in ver_dic["VERSION"])
 # The full version, including alpha/beta/rc tags.
 release = ver_dic["VERSION_TEXT"]
 
-
 nitpick_ignore = [
+    ("py:class", r"builtins.slice"),
     ("py:class", r"numpy._typing._dtype_like._SupportsDType"),
     ("py:class", r"numpy._typing._dtype_like._DTypeDict"),
+    ("py:class", r"pytest.Metafunc"),
 ]
 
 intersphinx_mapping = {

{pyopencl-2025.2.4 → pyopencl-2025.2.6}/doc/runtime.rst

@@ -55,10 +55,6 @@ References
 These are only here because Sphinx, our documentation tool, struggles to
 resolve them.
 
-.. class:: WaitList
-
-    A :class:`Sequence` of :class:`Event`\ s or *None*.
-
 .. class:: NDArray
 
     See :data:`numpy.typing.NDArray`.
@@ -75,6 +71,10 @@ resolve them.
 
     A generic type variable, used for a return type.
 
+.. class:: HashableT
+
+   An invariant type variable that is bound to :class:`Hashable`.
+
 .. class:: P
 
     A :class:`~typing.ParamSpec`.
@@ -95,7 +95,7 @@ resolve them.
 
 .. class:: WaitList
 
-    A :class:`Sequence` of :class:`Event`\ s or *None*.
+    See :class:`pyopencl.WaitList`.
 
 .. class:: Context
 
@@ -109,6 +109,10 @@ resolve them.
 
     See :class:`pyopencl.Event`.
 
+.. class:: KernelArg
+
+    A union of allowed kernel arguments.
+
 .. currentmodule:: cl_tools
 ..
 .. class:: AllocatorBase

{pyopencl-2025.2.4 → pyopencl-2025.2.6}/doc/runtime_queue.rst

@@ -116,6 +116,15 @@ Event
 
     |comparable|
 
+.. autodata:: WaitList
+    :noindex:
+
+    A :class:`Sequence` of :class:`Event`\ s or *None*.
+
+.. class:: WaitList
+
+    See above.
+
 .. class:: ProfilingInfoGetter
 
    .. attribute:: info

{pyopencl-2025.2.4 → pyopencl-2025.2.6}/pyopencl/_cl.pyi

@@ -20,7 +20,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 """
 
-from collections.abc import Callable, Sequence
+from collections.abc import Callable, Hashable, Sequence
 from enum import IntEnum, auto
 from typing import TYPE_CHECKING, Generic, Literal, overload
 
@@ -591,12 +591,12 @@ class kernel_arg_type_qualifier(IntEnum):  # noqa: N801
     to_string = classmethod(pyopencl._monkeypatch.to_string)
 
 class kernel_work_group_info(IntEnum):  # noqa: N801
-    WORK_GROUP_SIZE = auto()
-    COMPILE_WORK_GROUP_SIZE = auto()
-    LOCAL_MEM_SIZE = auto()
-    PREFERRED_WORK_GROUP_SIZE_MULTIPLE = auto()
-    PRIVATE_MEM_SIZE = auto()
-    GLOBAL_WORK_SIZE = auto()
+    WORK_GROUP_SIZE = 0x11B0
+    COMPILE_WORK_GROUP_SIZE = 0x11B1
+    LOCAL_MEM_SIZE = 0x11B2
+    PREFERRED_WORK_GROUP_SIZE_MULTIPLE = 0x11B3
+    PRIVATE_MEM_SIZE = 0x11B4
+    GLOBAL_WORK_SIZE = 0x11B5
     to_string = classmethod(pyopencl._monkeypatch.to_string)
 
 class kernel_sub_group_info(IntEnum):  # noqa: N801
@@ -837,6 +837,9 @@ class Device:
 
     __repr__ = pyopencl._monkeypatch.device_repr
 
+    @property
+    def hashable_model_and_version_identifier(self) -> Hashable: ...
+
     type: device_type
     vendor_id: int
     max_compute_units: int

{pyopencl-2025.2.4 → pyopencl-2025.2.6}/pyopencl/_monkeypatch.py

@@ -27,9 +27,11 @@ from sys import intern
 from typing import (
     TYPE_CHECKING,
     Any,
+    Literal,
     TextIO,
     TypeVar,
     cast,
+    overload,
 )
 from warnings import warn
 
@@ -196,6 +198,12 @@ class ProfilingInfoGetter:
     def __getattr__(self, name: str):
         info_cls = _cl.profiling_info
 
+        if not name.islower():
+            warn(f"Using non-lower-case attributes with Event.profile "
+                 f"is deprecated. Got: '{name}', expected: '{name.lower()}'. "
+                 "This will stop working in 2026.",
+                 DeprecationWarning, stacklevel=2)
+
         try:
             inf_attr = getattr(info_cls, name.upper())
         except AttributeError as err:
@@ -204,18 +212,18 @@ class ProfilingInfoGetter:
         else:
             return self.event.get_profiling_info(inf_attr)
 
-    QUEUED: int  # pyright: ignore[reportUninitializedInstanceVariable]
-    SUBMIT: int  # pyright: ignore[reportUninitializedInstanceVariable]
-    START: int  # pyright: ignore[reportUninitializedInstanceVariable]
-    END: int  # pyright: ignore[reportUninitializedInstanceVariable]
-    COMPLETE: int  # pyright: ignore[reportUninitializedInstanceVariable]
+    queued: int  # pyright: ignore[reportUninitializedInstanceVariable]
+    submit: int  # pyright: ignore[reportUninitializedInstanceVariable]
+    start: int  # pyright: ignore[reportUninitializedInstanceVariable]
+    end: int  # pyright: ignore[reportUninitializedInstanceVariable]
+    complete: int  # pyright: ignore[reportUninitializedInstanceVariable]
 
 
 kernel_old_get_info = _cl.Kernel.get_info
 kernel_old_get_work_group_info = _cl.Kernel.get_work_group_info
 
 
-def kernel_set_arg_types(self: _cl.Kernel, arg_types):
+def kernel_set_arg_types(self: _cl.Kernel, arg_types) -> None:
     arg_types = tuple(arg_types)
 
     # {{{ arg counting bug handling
@@ -253,7 +261,42 @@ def kernel_set_arg_types(self: _cl.Kernel, arg_types):
                     devs=self.context.devices))
 
 
-def kernel_get_work_group_info(self: _cl.Kernel, param: int, device: _cl.Device):
+@overload
+def kernel_get_work_group_info(
+            self: _cl.Kernel,
+            param: Literal[
+                    _cl.kernel_work_group_info.WORK_GROUP_SIZE,
+                    _cl.kernel_work_group_info.PREFERRED_WORK_GROUP_SIZE_MULTIPLE,
+                    _cl.kernel_work_group_info.LOCAL_MEM_SIZE,
+                    _cl.kernel_work_group_info.PRIVATE_MEM_SIZE,
+                ],
+            device: _cl.Device
+        ) -> int: ...
+
+@overload
+def kernel_get_work_group_info(
+            self: _cl.Kernel,
+            param: Literal[
+                    _cl.kernel_work_group_info.COMPILE_WORK_GROUP_SIZE,
+                    _cl.kernel_work_group_info.GLOBAL_WORK_SIZE,
+                ],
+            device: _cl.Device
+        ) -> Sequence[int]: ...
+
+
+@overload
+def kernel_get_work_group_info(
+            self: _cl.Kernel,
+            param: int,
+            device: _cl.Device
+        ) -> object: ...
+
+
+def kernel_get_work_group_info(
+            self: _cl.Kernel,
+            param: int,
+            device: _cl.Device
+        ) -> object:
     try:
         wg_info_cache = self._wg_info_cache
     except AttributeError:
@@ -405,9 +448,7 @@ def image_init(self: _cl.Image,
         else:
             raise ValueError("images cannot have more than three dimensions")
 
-        desc = _cl.ImageDescriptor() \
-            # pylint: disable=possibly-used-before-assignment
-
+        desc = _cl.ImageDescriptor()
         desc.image_type = image_type
         desc.shape = shape  # also sets desc.array_size
 

{pyopencl-2025.2.4 → pyopencl-2025.2.6}/pyopencl/algorithm.py

@@ -1235,7 +1235,7 @@ class ListOfListsBuilder:
                 queue, (n_objects + 1,), index_dtype, allocator=allocator)
             info_record.compressed_indices[0] = 0
 
-            compress_events[name] = compress_kernel(  # pylint: disable=possibly-used-before-assignment
+            compress_events[name] = compress_kernel(
                 info_record.starts,
                 compressed_counts,
                 info_record.nonempty_indices,