pyopencl 2024.1__cp38-cp38-win_amd64.whl → 2024.2__cp38-cp38-win_amd64.whl

pyopencl/scan.py

@@ -22,33 +22,24 @@ limitations under the License.
 Derived from code within the Thrust project, https://github.com/NVIDIA/thrust
 """
 
+import logging
 from abc import ABC, abstractmethod
 from dataclasses import dataclass
 from typing import Any, Dict, List, Optional, Set, Tuple, Union
 
 import numpy as np
+from pytools.persistent_dict import WriteOncePersistentDict
 
 import pyopencl as cl
-import pyopencl.array
-from pyopencl.tools import (
-        KernelTemplateBase,
-        DtypedArgument,
-        bitlog2,
-        context_dependent_memoize,
-        dtype_to_ctype,
-        get_arg_list_scalar_arg_dtypes,
-        get_arg_offset_adjuster_code,
-        _process_code_for_macro,
-        _NumpyTypesKeyBuilder,
-        )
-
 import pyopencl._mymako as mako
+import pyopencl.array
 from pyopencl._cluda import CLUDA_PREAMBLE
-
-from pytools.persistent_dict import WriteOncePersistentDict
+from pyopencl.tools import (
+    DtypedArgument, KernelTemplateBase, _NumpyTypesKeyBuilder,
+    _process_code_for_macro, bitlog2, context_dependent_memoize, dtype_to_ctype,
+    get_arg_list_scalar_arg_dtypes, get_arg_offset_adjuster_code)
 
 
-import logging
 logger = logging.getLogger(__name__)
 
 
@@ -1141,10 +1132,14 @@ class GenericScanKernelBase(ABC):
         pass
 
 
-generic_scan_kernel_cache = WriteOncePersistentDict(
-        "pyopencl-generated-scan-kernel-cache-v1",
-        key_builder=_NumpyTypesKeyBuilder(),
-        in_mem_cache_size=0)
+if not cl._PYOPENCL_NO_CACHE:
+    generic_scan_kernel_cache: WriteOncePersistentDict[Any,
+                    Tuple[_GeneratedScanKernelInfo, _GeneratedScanKernelInfo,
+                    _GeneratedFinalUpdateKernelInfo]] = \
+        WriteOncePersistentDict(
+            "pyopencl-generated-scan-kernel-cache-v1",
+            key_builder=_NumpyTypesKeyBuilder(),
+            in_mem_cache_size=0)
 
 
 class GenericScanKernel(GenericScanKernelBase):
@@ -1199,7 +1194,8 @@ class GenericScanKernel(GenericScanKernelBase):
                       self.second_level_scan_gen_info,
                       self.final_update_gen_info)
 
-            generic_scan_kernel_cache.store_if_not_present(cache_key, result)
+            if not cl._PYOPENCL_NO_CACHE:
+                generic_scan_kernel_cache.store_if_not_present(cache_key, result)
 
         # Build the kernels.
         self.first_level_scan_info = self.first_level_scan_gen_info.build(

pyopencl/tools.py

@@ -126,27 +126,27 @@ FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 OTHER DEALINGS IN THE SOFTWARE.
 """
 
+import re
 from abc import ABC, abstractmethod
 from sys import intern
 from typing import Any, List, Optional, Union
 
-# Do not add a pyopencl import here: This will add an import cycle.
-
 import numpy as np
 from pytools import memoize, memoize_method
-from pyopencl._cl import bitlog2, get_cl_header_version  # noqa: F401
 from pytools.persistent_dict import KeyBuilder as KeyBuilderBase
 
-import re
-
+from pyopencl._cl import bitlog2, get_cl_header_version  # noqa: F401
+from pyopencl.compyte.dtypes import TypeNameNotKnown  # noqa: F401
 from pyopencl.compyte.dtypes import (  # noqa: F401
-        get_or_register_dtype, TypeNameNotKnown,
-        register_dtype, dtype_to_ctype)
+    dtype_to_ctype, get_or_register_dtype, register_dtype)
+
+
+# Do not add a pyopencl import here: This will add an import cycle.
 
 
 def _register_types():
     from pyopencl.compyte.dtypes import (
-            TYPE_REGISTRY, fill_registry_with_opencl_c_types)
+        TYPE_REGISTRY, fill_registry_with_opencl_c_types)
 
     fill_registry_with_opencl_c_types(TYPE_REGISTRY)
 
@@ -160,17 +160,11 @@ _register_types()
 # {{{ imported names
 
 from pyopencl._cl import (  # noqa: F401
-        PooledBuffer, AllocatorBase, DeferredAllocator,
-        ImmediateAllocator, MemoryPool,
-        )
+    AllocatorBase, DeferredAllocator, ImmediateAllocator, MemoryPool, PooledBuffer)
 
 
 if get_cl_header_version() >= (2, 0):
-    from pyopencl._cl import (  # noqa: F401
-            SVMPool,
-            PooledSVM,
-            SVMAllocator,
-            )
+    from pyopencl._cl import PooledSVM, SVMAllocator, SVMPool  # noqa: F401
 
 # }}}
 
@@ -518,6 +512,7 @@ def first_arg_dependent_memoize_nested(nested_func):
                 nested_func.__code__.co_firstlineno))
 
     from inspect import currentframe
+
     # prevent ref cycle
     try:
         caller_frame = currentframe().f_back
@@ -560,6 +555,8 @@ def clear_first_arg_caches():
 
 
 import atexit
+
+
 atexit.register(clear_first_arg_caches)
 
 # }}}

pyopencl/version.py

@@ -1,3 +1,3 @@
-VERSION = (2024, 1)
+VERSION = (2024, 2)
 VERSION_STATUS = ""
 VERSION_TEXT = ".".join(str(x) for x in VERSION) + VERSION_STATUS

pyopencl-2024.2.data/data/CITATION.cff

@@ -0,0 +1,74 @@
+cff-version: 1.2.0
+message: "If you use this software, please cite it as below."
+authors:
+- family-names: "Kloeckner"
+  given-names: "Andreas"
+  orcid: "https://orcid.org/0000-0003-1228-519X"
+- family-names: "Yu"
+  given-names: "Yichao"
+- family-names: "Wala"
+  given-names: "Matt"
+- family-names: "Fernando"
+  given-names: "Isuru"
+- family-names: "Bencun"
+  given-names: "Marko"
+- family-names: "Kulkarni"
+  given-names: "Kaushik"
+- family-names: "Diener"
+  given-names: "Matthias"
+- family-names: "Gao"
+  given-names: "Hao"
+- family-names: "Fikl"
+  given-names: "Alex"
+- family-names: "Weiner"
+  given-names: "Zach"
+- family-names: "Weigert"
+  given-names: "Martin"
+- family-names: "Palmer"
+  given-names: "Rebecca"
+- family-names: "Latham"
+  given-names: "Shane"
+- family-names: "Magno"
+  given-names: "Gonçalo"
+- family-names: "Fuller"
+  given-names: "Henry"
+- family-names: "Mackenzie"
+  given-names: "Jonathan"
+- family-names: "Niarchos"
+  given-names: "Sotiris"
+- family-names: "Gill"
+  given-names: "Shahzaib"
+- family-names: "Gohlke"
+  given-names: "Christoph"
+- family-names: "Bhosale"
+  given-names: "Aditya"
+- family-names: "Rothberg"
+  given-names: "Alex"
+- family-names: "Ey"
+  given-names: "Emanuel"
+- family-names: "Rapp"
+  given-names: "Holger"
+- family-names: "van der Walt"
+  given-names: "Stefan"
+# Removed pending resolution of https://github.com/zenodo/zenodo/issues/2343
+# - alias: "gw0"
+- family-names: "Thalhammer"
+  given-names: "Gregor"
+- family-names: "Kieffer"
+  given-names: "Jerome"
+- family-names: "Poliarnyi"
+  given-names: "Nikolai"
+- family-names: "Bollinger"
+  given-names: "Drew"
+- family-names: "Nitz"
+  given-names: "Alex"
+- family-names: "Bokota"
+  given-names: "Grzegorz"
+  orcid: 'https://orcid.org/0000-0002-5470-1676'
+
+title: "PyOpenCL"
+version: 2022.1.3
+doi: 10.5281/zenodo.6533956
+date-released: 2022-03-10
+url: "https://github.com/inducer/pyopencl"
+license: MIT

{pyopencl-2024.1.dist-info → pyopencl-2024.2.data/data}/LICENSE

@@ -78,29 +78,6 @@ PyOpenCL includes parts of the Random123 suite of random number generators:
     THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
     OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-PyOpenCL includes the RANLUXCL random number generator:
-
-    Copyright (c) 2011 Ivar Ursin Nikolaisen
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy of this
-    software and associated documentation files (the "Software"), to deal in the Software
-    without restriction, including without limitation the rights to use, copy, modify,
-    merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
-    permit persons to whom the Software is furnished to do so, subject to the following
-    conditions:
-
-    The above copyright notice and this permission notice shall be included in all copies
-    or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-    INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
-    PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
-    HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
-    CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
-    OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-
 PyOpenCL wheel includes Khronos Group OpenCL-ICD-Loader which is licensed as below:
                                  Apache License
                            Version 2.0, January 2004

pyopencl-2024.2.data/data/Makefile.in

@@ -0,0 +1,21 @@
+.PHONY	: all install clean tags dist userdoc devdoc
+
+all: tags
+	${PYTHON_EXE} setup.py build
+
+dist:
+	${PYTHON_EXE} setup.py sdist
+
+install: tags
+	${PYTHON_EXE} setup.py install
+
+clean:
+	rm -Rf build
+	rm -f tags
+
+tags:
+	ctags -R src || true
+
+tests:
+	echo "running tests"
+	find ./test -type f -name "*.py" -exec python {} \;

pyopencl-2024.2.data/data/README.rst

@@ -0,0 +1,70 @@
+PyOpenCL: Pythonic Access to OpenCL, with Arrays and Algorithms
+===============================================================
+
+.. |badge-gitlab-ci| image:: https://gitlab.tiker.net/inducer/pyopencl/badges/main/pipeline.svg
+    :alt: Gitlab Build Status
+    :target: https://gitlab.tiker.net/inducer/pyopencl/commits/main
+.. |badge-github-ci| image:: https://github.com/inducer/pyopencl/workflows/CI/badge.svg?branch=main&event=push
+    :alt: Github Build Status
+    :target: https://github.com/inducer/pyopencl/actions?query=branch%3Amain+workflow%3ACI+event%3Apush
+.. |badge-pypi| image:: https://badge.fury.io/py/pyopencl.svg
+    :alt: Python Package Index Release Page
+    :target: https://pypi.org/project/pyopencl/
+.. |badge-zenodo| image:: https://zenodo.org/badge/1575307.svg
+    :alt: Zenodo DOI for latest release
+    :target: https://zenodo.org/badge/latestdoi/1575307
+
+|badge-gitlab-ci| |badge-github-ci| |badge-pypi| |badge-zenodo|
+
+PyOpenCL lets you access GPUs and other massively parallel compute
+devices from Python. It tries to offer computing goodness in the
+spirit of its sister project `PyCUDA <https://mathema.tician.de/software/pycuda>`__:
+
+* Object cleanup tied to lifetime of objects. This idiom, often
+  called `RAII <https://en.wikipedia.org/wiki/Resource_Acquisition_Is_Initialization>`__
+  in C++, makes it much easier to write correct, leak- and
+  crash-free code.
+
+* Completeness. PyOpenCL puts the full power of OpenCL's API at
+  your disposal, if you wish.  Every obscure ``get_info()`` query and
+  all CL calls are accessible.
+
+* Automatic Error Checking. All CL errors are automatically
+  translated into Python exceptions.
+
+* Speed. PyOpenCL's base layer is written in C++, so all the niceties
+  above are virtually free.
+
+* Helpful and complete `Documentation <https://documen.tician.de/pyopencl>`__
+  as well as a `Wiki <https://wiki.tiker.net/PyOpenCL>`__.
+
+* Liberal license. PyOpenCL is open-source under the
+  `MIT license <https://en.wikipedia.org/wiki/MIT_License>`__
+  and free for commercial, academic, and private use.
+
+* Broad support. PyOpenCL was tested and works with Apple's, AMD's, and Nvidia's
+  CL implementations.
+
+Simple 4-step `install instructions <https://documen.tician.de/pyopencl/misc.html#installation>`__
+using Conda on Linux and macOS (that also install a working OpenCL implementation!)
+can be found in the `documentation <https://documen.tician.de/pyopencl/>`__.
+
+What you'll need if you do *not* want to use the convenient instructions above and
+instead build from source:
+
+* g++/clang new enough to be compatible with nanobind (specifically, full support of C++17 is needed)
+* `numpy <https://numpy.org>`__, and
+* an OpenCL implementation. (See this `howto <https://wiki.tiker.net/OpenCLHowTo>`__
+  for how to get one.)
+
+Links
+-----
+
+* `Documentation <https://documen.tician.de/pyopencl>`__
+  (read how things work)
+* `Python package index <https://pypi.python.org/pypi/pyopencl>`__
+  (download releases, including binary wheels for Linux, macOS, Windows)
+* `Conda Forge <https://anaconda.org/conda-forge/pyopencl>`__
+  (download binary packages for Linux, macOS, Windows)
+* `Github <https://github.com/inducer/pyopencl>`__
+  (get latest source code, file bugs)

pyopencl-2024.2.data/data/README_SETUP.txt

@@ -0,0 +1,34 @@
+Hi, welcome.
+
+This Python package uses aksetup for installation, which means that
+installation should be easy and quick.
+
+If you don't want to continue reading, just try the regular
+
+  ./configure.py --help
+  ./configure.py --some-options
+  make
+  sudo make install
+
+That should do the trick. (By the way: If a config option says "several ok",
+then you may specify several values, separated by commas.)
+
+aksetup also supports regular distutils installation, without using 
+configure:
+
+  python setup.py build
+  sudo python setup.py install
+
+In this case, configuration is obtained from files in this order:
+
+/etc/aksetup-defaults.py
+$HOME/.aksetup-defaults.py
+$PACKAGEDIR/siteconf.py
+
+Once you've run configure, you can copy options from your siteconf.py file to
+one of these files, and you won't ever have to configure them again manually.
+In fact, you may pass the options "--update-user" and "--update-global" to
+configure, and it will automatically update these files for you.
+
+This is particularly handy if you want to perform an unattended or automatic
+installation via easy_install.