uproot 5.7.1__tar.gz → 5.7.2__tar.gz

{uproot-5.7.1 → uproot-5.7.2}/.all-contributorsrc

@@ -668,6 +668,24 @@
       "contributions": [
         "doc"
       ]
+    },
+    {
+      "login": "wdconinc",
+      "name": "Wouter Deconinck",
+      "avatar_url": "https://avatars.githubusercontent.com/u/4656391?v=4",
+      "profile": "https://github.com/wdconinc",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "KaranSinghDev",
+      "name": "Karan Singh",
+      "avatar_url": "https://avatars.githubusercontent.com/u/102300776?v=4",
+      "profile": "https://github.com/KaranSinghDev",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 7,

{uproot-5.7.1 → uproot-5.7.2}/.github/workflows/build-test.yml

@@ -233,16 +233,40 @@ jobs:
             python=3.13
             cuda-version=${{ matrix.cuda-version }}
             cuda-toolkit
+            cuda-python
+            cccl-python
             cupy
             kvikio
+            nvcomp
+            pytest-cov
+            ${{ matrix.cuda-version == 13 && 'root' || '' }}
 
       - name: Pip install the package
-        run: pip install --group=test .
+        run: pip install --group=dev .
 
-      - name: Run pytest
+      - name: Run only GPU tests
+        if: matrix.cuda-version != 13
         run: |
           python -m pytest -vv tests-cuda --reruns 10 --reruns-delay 30 --only-rerun "(?i)http|ssl|timeout|expired|connection|socket"
 
+      - name: Run full test suite and collect coverage
+        if: matrix.cuda-version == 13
+        run: |
+          python -m pytest -vv tests tests-cuda --reruns 10 --reruns-delay 30 --only-rerun "(?i)http|ssl|timeout|expired|connection|socket"\
+                           --cov=uproot --cov-branch --cov-report=xml --junitxml=junit.xml -o junit_family=legacy
+
+      - name: Upload coverage reports to Codecov
+        if: matrix.cuda-version == 13
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+      - name: Upload test results to Codecov
+        if: ${{ !cancelled() }}
+        uses: codecov/test-results-action@v1
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+
   pass:
     if: always()
     needs: [build, vanilla-build, numpy1-build, pyodide-build]

{uproot-5.7.1 → uproot-5.7.2}/.github/workflows/deploy.yml

@@ -29,7 +29,7 @@ jobs:
       contents: read
 
     steps:
-      - uses: actions/download-artifact@v7
+      - uses: actions/download-artifact@v8
         with:
           name: Packages
           path: dist
@@ -38,7 +38,7 @@ jobs:
         run: ls -lha dist/
 
       - name: Generate artifact attestation for sdist and wheel
-        uses: actions/attest-build-provenance@00014ed6ed5efc5b1ab7f7f34a39eb55d41aa4f8 # v3.1.0
+        uses: actions/attest-build-provenance@a2bbfa25375fe432b6a289bc6b6cd05ecd0c4c32 # v4.1.0
         with:
           subject-path: dist/uproot-*
 

{uproot-5.7.1 → uproot-5.7.2}/.github/workflows/upload-nightly-wheels.yml

@@ -24,7 +24,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/download-artifact@v7
+      - uses: actions/download-artifact@v8
         with:
           name: Packages
           path: dist

{uproot-5.7.1 → uproot-5.7.2}/.pre-commit-config.yaml

@@ -19,18 +19,18 @@ repos:
       - id: trailing-whitespace
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.12.0
+    rev: 26.1.0
     hooks:
       - id: black
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.10
+    rev: v0.15.4
     hooks:
       - id: ruff-check
         args: [--fix, --show-fixes]
 
   - repo: https://github.com/macisamuele/language-formatters-pre-commit-hooks
-    rev: v2.15.0
+    rev: v2.16.0
     hooks:
       - id: pretty-format-toml
         args: [--autofix]

{uproot-5.7.1 → uproot-5.7.2}/CONTRIBUTING.md

@@ -107,6 +107,23 @@ Some tests may depend on having ROOT or XRootD installed. These are covered in t
 
 ---
 
+## 🤖 AI-assisted contributions
+
+We welcome the use of AI tools as part of the development process. They can be valuable aids for drafting, refactoring, documentation, and exploration. However, contributions to Uproot require human judgment, contextual understanding, and familiarity with the project’s structure, goals, and standards.
+
+When using AI tools:
+
+* **You remain the author of the contribution.** Review, understand, and test all AI-assisted code or documentation before submitting it under your name. You should be able to explain and defend the changes on request.
+* **Avoid fully automated submissions.** Issues or pull requests generated end-to-end by automated tools, without meaningful human review or intent, are not appropriate.
+* **Be respectful of reviewers’ time.** Ensure that both the content of the PR and its description reflect your own understanding. Reviewers should not be expected to infer authorship or unknowingly interact with an AI during review.
+* **Disclose significant AI assistance.** If AI tools were used for a substantial portion of the contribution, please note this in the PR description. (This guide is an example of that: we used ChatGPT to help with the writing, and in this comment, we acknowledge that fact.)
+
+Contributors are responsible for the correctness, maintainability, and long-term impact of all submitted changes, regardless of whether AI tools were used.
+
+Pull requests that do not meet these expectations may be closed without review.
+
+---
+
 ## 🐛 Reporting Bugs
 
 1. Check if the bug is already reported on the [issue tracker](https://github.com/scikit-hep/uproot/issues).

{uproot-5.7.1 → uproot-5.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uproot
-Version: 5.7.1
+Version: 5.7.2
 Summary: ROOT I/O in pure Python and NumPy.
 Project-URL: Download, https://github.com/scikit-hep/uproot5/releases
 Project-URL: Homepage, https://github.com/scikit-hep/uproot5
@@ -31,15 +31,17 @@ Classifier: Topic :: Utilities
 Requires-Python: >=3.10
 Requires-Dist: awkward>=2.8.2
 Requires-Dist: cramjam>=2.5.0
-Requires-Dist: fsspec!=2025.7.0
+Requires-Dist: fsspec!=2026.2.0
 Requires-Dist: numpy
 Requires-Dist: packaging
 Requires-Dist: typing-extensions>=4.1.0; python_version < '3.11'
 Requires-Dist: xxhash
-Provides-Extra: gds-cu11
-Requires-Dist: kvikio-cu11>=25.02.01; extra == 'gds-cu11'
 Provides-Extra: gds-cu12
-Requires-Dist: kvikio-cu12>=25.02.01; extra == 'gds-cu12'
+Requires-Dist: kvikio-cu12; extra == 'gds-cu12'
+Requires-Dist: nvidia-nvcomp-cu12; extra == 'gds-cu12'
+Provides-Extra: gds-cu13
+Requires-Dist: kvikio-cu13; extra == 'gds-cu13'
+Requires-Dist: nvidia-nvcomp-cu13; extra == 'gds-cu13'
 Provides-Extra: http
 Requires-Dist: aiohttp; extra == 'http'
 Provides-Extra: s3
@@ -115,20 +117,10 @@ If you need to develop Awkward Array as well, see its [installation for develope
 
 # Dependencies
 
-**Uproot's only strict dependencies are NumPy and packaging.** Strict dependencies are automatically installed by pip (or conda).
-
-**[Awkward Array](https://anaconda.org/conda-forge/awkward) is highly recommended** and is automatically installed by pip (or conda), though it is _possible_ to use Uproot without it. If you need a minimal installation, pass `--no-deps` to pip and pass `library="np"` to every array-fetching function, or globally set `uproot.default_library` to get NumPy arrays instead of Awkward Arrays.
-
-   * `awkward`: Uproot 5.x requires Awkward 2.x.
+**Uproot's only strict dependencies are Awkward, Cramjam, xxhash, fsspec, NumPy, packaging.** Strict dependencies are automatically installed by pip (or conda).
 
 The following libraries are also useful in conjunction with Uproot, but are not necessary. If you call a function that needs one, you'll be prompted to install it. (Conda installs most of these automatically.)
 
-**For ROOT files, compressed different ways:**
-
-   * `lz4` and `xxhash`: if reading ROOT files that have been LZ4-compressed.
-   * `zstandard`: if reading ROOT files that have been ZSTD-compressed.
-   * ZLIB and LZMA are built in (Python standard library).
-
 **For accessing remote files:**
 
    * `s3fs`: if reading files with `s3://` URIs.
@@ -255,6 +247,8 @@ Thanks especially to the gracious help of Uproot contributors (including the [or
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/ianna"><img src="https://avatars.githubusercontent.com/u/1390682?v=4?s=100" width="100px;" alt="Ianna Osborne"/><br /><sub><b>Ianna Osborne</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=ianna" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Rachit931"><img src="https://avatars.githubusercontent.com/u/199397286?v=4?s=100" width="100px;" alt="Rachit931"/><br /><sub><b>Rachit931</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=Rachit931" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/wdconinc"><img src="https://avatars.githubusercontent.com/u/4656391?v=4?s=100" width="100px;" alt="Wouter Deconinck"/><br /><sub><b>Wouter Deconinck</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=wdconinc" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/KaranSinghDev"><img src="https://avatars.githubusercontent.com/u/102300776?v=4?s=100" width="100px;" alt="Karan Singh"/><br /><sub><b>Karan Singh</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=KaranSinghDev" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

{uproot-5.7.1 → uproot-5.7.2}/README.md

@@ -65,20 +65,10 @@ If you need to develop Awkward Array as well, see its [installation for develope
 
 # Dependencies
 
-**Uproot's only strict dependencies are NumPy and packaging.** Strict dependencies are automatically installed by pip (or conda).
-
-**[Awkward Array](https://anaconda.org/conda-forge/awkward) is highly recommended** and is automatically installed by pip (or conda), though it is _possible_ to use Uproot without it. If you need a minimal installation, pass `--no-deps` to pip and pass `library="np"` to every array-fetching function, or globally set `uproot.default_library` to get NumPy arrays instead of Awkward Arrays.
-
-   * `awkward`: Uproot 5.x requires Awkward 2.x.
+**Uproot's only strict dependencies are Awkward, Cramjam, xxhash, fsspec, NumPy, packaging.** Strict dependencies are automatically installed by pip (or conda).
 
 The following libraries are also useful in conjunction with Uproot, but are not necessary. If you call a function that needs one, you'll be prompted to install it. (Conda installs most of these automatically.)
 
-**For ROOT files, compressed different ways:**
-
-   * `lz4` and `xxhash`: if reading ROOT files that have been LZ4-compressed.
-   * `zstandard`: if reading ROOT files that have been ZSTD-compressed.
-   * ZLIB and LZMA are built in (Python standard library).
-
 **For accessing remote files:**
 
    * `s3fs`: if reading files with `s3://` URIs.
@@ -205,6 +195,8 @@ Thanks especially to the gracious help of Uproot contributors (including the [or
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/ianna"><img src="https://avatars.githubusercontent.com/u/1390682?v=4?s=100" width="100px;" alt="Ianna Osborne"/><br /><sub><b>Ianna Osborne</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=ianna" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Rachit931"><img src="https://avatars.githubusercontent.com/u/199397286?v=4?s=100" width="100px;" alt="Rachit931"/><br /><sub><b>Rachit931</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=Rachit931" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/wdconinc"><img src="https://avatars.githubusercontent.com/u/4656391?v=4?s=100" width="100px;" alt="Wouter Deconinck"/><br /><sub><b>Wouter Deconinck</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=wdconinc" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/KaranSinghDev"><img src="https://avatars.githubusercontent.com/u/102300776?v=4?s=100" width="100px;" alt="Karan Singh"/><br /><sub><b>Karan Singh</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=KaranSinghDev" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

uproot-5.7.2/codecov.yml

@@ -0,0 +1,22 @@
+codecov:
+  require_ci_to_pass: true
+
+comment:
+  layout: files
+
+coverage:
+  status:
+    project:
+      default:
+        # 'auto' sets the target to our current coverage %
+        # 'threshold' allows a tiny 0.5% drop to prevent "flaky" failures
+        target: auto
+        threshold: 0.5%
+    patch:
+      default:
+        # Ensures 98% of NEW code added in the PR is covered
+        target: 98%
+        threshold: 0%
+
+github_checks:
+  annotations: false

{uproot-5.7.1 → uproot-5.7.2}/dev/make-models.py

@@ -70,8 +70,7 @@ with uproot.open("example-objects.root") as f:
     for classname, class_version in superclasses:
         cls = f.file.class_named(classname, class_version)
         print(cls.class_code)
-        print(
-            f"""
+        print(f"""
     writable = True
 
     def _serialize(self, out, header, name):
@@ -90,16 +89,13 @@ class {uproot.model.classname_encode(classname)}(uproot.model.DispatchByVersion)
     \"\"\"
 
     known_versions = {{{class_version}: {cls.__name__}}}
-"""
-        )
+""")
 
     for key in keys:
         obj = f[key]
         print(type(obj).class_code)
-        print(
-            """
-    class_rawstreamers = ("""
-        )
+        print("""
+    class_rawstreamers = (""")
         for streamer_name, streamer_version in f.file.streamer_dependencies(
             obj.classname, obj.class_version
         ):
@@ -110,16 +106,13 @@ class {uproot.model.classname_encode(classname)}(uproot.model.DispatchByVersion)
             ).tobytes()
             preamble = b"\xff\xff\xff\xffTStreamerInfo\x00"
             full = header + preamble + inner + b"\x00"
-            print(
-                f"""        uproot._writing.RawStreamerInfo(
+            print(f"""        uproot._writing.RawStreamerInfo(
             None,
             {full},
             {streamer_name!r},
             {streamer_version},
-        ),"""
-            )
-        print(
-            f"""    )
+        ),""")
+        print(f"""    )
     writable = True
 
     def _serialize(self, out, header, name):
@@ -131,19 +124,16 @@ class {uproot.model.classname_encode(classname)}(uproot.model.DispatchByVersion)
             num_bytes = sum(len(x) for x in out[where:])
             version = {obj.class_version}
             out.insert(where, uproot.serialization.numbytes_version(num_bytes, version))
-"""
-        )
+""")
 
-        print(
-            f"""
+        print(f"""
 class {uproot.model.classname_encode(obj.classname)}(uproot.model.DispatchByVersion):
     \"\"\"
     A :doc:`uproot.model.DispatchByVersion` for ``{obj.classname}``.
     \"\"\"
 
     known_versions = {{{obj.class_version}: {type(obj).__name__}}}
-"""
-        )
+""")
 
     for classname, _ in superclasses:
         print(

{uproot-5.7.1 → uproot-5.7.2}/docs-sphinx/basic.rst

@@ -965,6 +965,28 @@ Note that for the last input we used the ``filter_field`` argument instead of ``
 
 There are still significant work required to achieve feature-parity with TTrees, but all the basic functionality is already implemented. We will continue to make the transition to RNTuples as seamless as possible.
 
+GPU reading with CUDA support
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Uproot supports GPU-based reading and processing of payload data on CUDA-capable GPUs for CUDA major versions 12 and 13. On systems that support GPU Direct Storage (GDS), raw payload data can be transferred directly from storage into GPU memory without a CPU bounce buffer. File metadata is still read by the CPU in both cases. GPU reading over HTTP is not supported.
+
+For GPU reading of RNTuple data, the values ``backend="cuda"`` and ``interpreter="gpu"`` must be passed to ``RNTuple.arrays()``.
+
+.. code-block:: python
+
+    >>> rntuple = uproot.open("ntpl001_staff_rntuple_v1-0-0-0.root:Staff")
+    >>> rntuple["Age"].array(backend="cuda", interpreter="gpu")
+    <Array [58, 63, 56, 61, 52, 60, ..., 51, 25, 35, 28, 43] type='3354 * int32'>
+    >>> rntuple.arrays(["Age", "Cost", "Nation"], backend="cuda", interpreter="gpu")
+    <Array [{Age: 58, Cost: 11975, ...}, ...] type='3354 * {Age: int32, Cost: i...'>
+
+Uproot uses the ``kvikio`` library to perform GPU-efficient I/O using CuFile and POSIX APIs. ``kvikio`` provides runtime settings that can be configured, documented `here <https://docs.rapids.ai/api/kvikio/stable/runtime_settings/#>`__.
+
+By default, ``KVIKIO_NTHREADS`` is 1. Increasing this value can improve I/O performance by allowing multiple threads to perform I/O concurrently (up to a system-dependent limit).
+
+.. code-block:: python
+
+    >>> kvikio.defaults.set({"num_threads": 5})
+
 Opening a file for writing
 --------------------------
 

{uproot-5.7.1 → uproot-5.7.2}/docs-sphinx/make_changelog.py

@@ -203,8 +203,7 @@ with open("changelog.rst", "w") as outfile:
 
             first = False
 
-    outfile.write(
-        """
+    outfile.write("""
 Earlier releases
 ================
 
@@ -217,5 +216,4 @@ This was to allow users to transition from Awkward Array 0.x and Uproot 3.x, whi
 
 .. image:: https://raw.githubusercontent.com/scikit-hep/uproot5/main/docs-img/diagrams/uproot-awkward-timeline.png
   :width: 100%
-"""
-    )
+""")

{uproot-5.7.1 → uproot-5.7.2}/docs-sphinx/prepare_docstrings.py

@@ -74,23 +74,17 @@ latest_commit = (
 )
 
 main = open("main.toctree", "w")
-main.write(
-    """.. toctree::
+main.write(""".. toctree::
     :caption: Main Interface
     :hidden:
 
-{}""".format(
-        "".join(f"    {x}\n" for x in common)
-    )
-)
+{}""".format("".join(f"    {x}\n" for x in common)))
 toctree = open("uproot.toctree", "w")
-toctree.write(
-    """.. toctree::
+toctree.write(""".. toctree::
     :caption: Detailed Reference
     :hidden:
 
-"""
-)
+""")
 toctree2 = None
 
 
@@ -115,9 +109,7 @@ def handle_module(modulename, module):
 {1}
 
 .. automodule:: {0}
-""".format(
-        modulename, "=" * len(modulename)
-    )
+""".format(modulename, "=" * len(modulename))
     ensure(modulename + ".rst", content)
     if toctree2 is None:
         toctree.write("    " + modulename + " (module) <" + modulename + ">\n")
@@ -241,13 +233,9 @@ def handle_class(classname, cls):
     +-{}-+
     | **Inheritance order:** {}|
     +={}=+
-    | """.format(
-            "-" * longest_cell, " " * (longest_cell - 22), "=" * longest_cell
-        )
+    | """.format("-" * longest_cell, " " * (longest_cell - 22), "=" * longest_cell)
         inheritance_footer = """ |
-    +-{}-+""".format(
-            "-" * longest_cell
-        )
+    +-{}-+""".format("-" * longest_cell)
         inheritance = [x + " " * (longest_cell - len(x)) for x in inheritance]
         inheritance_sep = """ |
     | """
@@ -304,9 +292,7 @@ def handle_function(functionname, cls):
 Defined in {} on {}.
 
 .. autofunction:: {}
-""".format(
-        title, "=" * len(title), link, linelink, functionname
-    )
+""".format(title, "=" * len(title), link, linelink, functionname)
     ensure(functionname + ".rst", content)
     if upfront or toctree2 is None:
         if functionname not in common:
@@ -321,15 +307,11 @@ for modulename in order:
 
     if modulename != "uproot":
         toctree2 = open(modulename + ".toctree", "w")
-        toctree2.write(
-            """.. toctree::
+        toctree2.write(""".. toctree::
     :caption: {}
     :hidden:
 
-""".format(
-                modulename.replace("uproot.", "")
-            )
-        )
+""".format(modulename.replace("uproot.", "")))
 
     handle_module(modulename, module)
     if module.__file__.endswith("__init__.py") and modulename != "uproot":

{uproot-5.7.1 → uproot-5.7.2}/pyproject.toml

@@ -35,8 +35,14 @@ test-core = [
   "pytest>=6",
   "scikit-hep-testdata"
 ]
-test-gpu = [
-  "kvikio-cu12>=25.02.01",
+test-gpu-cu12 = [
+  "kvikio-cu12",
+  "nvidia-nvcomp-cu12",
+  {include-group = "test-core"}
+]
+test-gpu-cu13 = [
+  "kvikio-cu13",
+  "nvidia-nvcomp-cu13",
   {include-group = "test-core"}
 ]
 test-pyodide = [
@@ -76,7 +82,7 @@ dependencies = [
   "cramjam>=2.5.0",
   "xxhash",
   "numpy",
-  "fsspec!=2025.7.0",
+  "fsspec!=2026.2.0",
   "packaging",
   "typing_extensions>=4.1.0; python_version < '3.11'"
 ]
@@ -90,11 +96,13 @@ readme = "README.md"
 requires-python = ">=3.10"
 
 [project.optional-dependencies]
-GDS_cu11 = [
-  "kvikio-cu11>=25.02.01"
+gds-cu12 = [
+  "kvikio-cu12",
+  "nvidia-nvcomp-cu12"
 ]
-GDS_cu12 = [
-  "kvikio-cu12>=25.02.01"
+gds-cu13 = [
+  "kvikio-cu13",
+  "nvidia-nvcomp-cu13"
 ]
 http = ["aiohttp"]
 s3 = ["s3fs"]

{uproot-5.7.1 → uproot-5.7.2}/src/uproot/_awkwardforth.py

@@ -3,6 +3,7 @@
 """
 This module defines utilities for adding components to the forth reader.
 """
+
 from __future__ import annotations
 
 import json
@@ -165,10 +166,10 @@ class Node:
         if len(self._children) != 0:
             children = "\n" + indent + "  " + children + "\n" + indent
         return f"""Node({self._name!r},
-{indent}  pre={''.join(self._pre_code)!r},
-{indent}  post={''.join(self._post_code)!r},
-{indent}  init={''.join(self._init_code)!r},
-{indent}  header={''.join(self._header_code)!r},
+{indent}  pre={"".join(self._pre_code)!r},
+{indent}  post={"".join(self._post_code)!r},
+{indent}  init={"".join(self._init_code)!r},
+{indent}  header={"".join(self._header_code)!r},
 {indent}  form_details={json.dumps(self._form_details)},
 {indent}  field_name={self._field_name!r},
 {indent}  children=[{children}])"""