uproot 5.4.2__tar.gz → 5.5.1__tar.gz

{uproot-5.4.2 → uproot-5.5.1}/.all-contributorsrc

@@ -605,6 +605,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "ariostas",
+      "name": "Andres Rios Tascon",
+      "avatar_url": "https://avatars.githubusercontent.com/u/7596837?v=4",
+      "profile": "http://www.ariostas.com",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 7,

{uproot-5.4.2 → uproot-5.5.1}/.github/workflows/build-test.yml

@@ -16,7 +16,7 @@ jobs:
       fail-fast: false
       matrix:
         platform: [windows-latest, macos-latest, ubuntu-latest]
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
 
     runs-on: ${{ matrix.platform }}
     timeout-minutes: 30
@@ -41,7 +41,7 @@ jobs:
         run: python -c "import sys; assert '.'.join(str(s) for s in sys.version_info[:2]) == '${{ matrix.python-version }}', f'{version} incorrect!'"
 
       - name: Install ROOT
-        if: matrix.python-version == 3.8  &&  runner.os != 'macOS'  &&  runner.os != 'Windows'
+        if: matrix.python-version == 3.9  &&  runner.os != 'macOS'  &&  runner.os != 'Windows'
         run: |
           conda env list
           mamba install root

{uproot-5.4.2 → uproot-5.5.1}/.github/workflows/deploy.yml

@@ -36,7 +36,7 @@ jobs:
         run: ls -lha dist/
 
       - name: Generate artifact attestation for sdist and wheel
-        uses: actions/attest-build-provenance@1c608d11d69870c2092266b3f9a6f3abbf17002c # v1.4.3
+        uses: actions/attest-build-provenance@ef244123eb79f2f7a7e75d99086184180e6d0018 # v1.4.4
         with:
           subject-path: dist/uproot-*
 

{uproot-5.4.2 → uproot-5.5.1}/.pre-commit-config.yaml

@@ -23,7 +23,7 @@ repos:
       - id: black
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.7.2
+    rev: v0.7.4
     hooks:
       - id: ruff
         args: [--fix, --show-fixes]

{uproot-5.4.2 → uproot-5.5.1}/.readthedocs.yml

@@ -6,7 +6,7 @@ sphinx:
 build:
   os: ubuntu-22.04
   tools:
-    python: '3.8'
+    python: '3.9'
 
 python:
   install:

{uproot-5.4.2 → uproot-5.5.1}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.3
 Name: uproot
-Version: 5.4.2
+Version: 5.5.1
 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
 Author-email: Jim Pivarski <pivarski@princeton.edu>
-License-Expression: BSD-3-Clause
-License-File: LICENSE
+License: BSD-3-Clause
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
@@ -18,7 +17,6 @@ Classifier: Operating System :: Unix
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -30,7 +28,7 @@ Classifier: Topic :: Scientific/Engineering :: Mathematics
 Classifier: Topic :: Scientific/Engineering :: Physics
 Classifier: Topic :: Software Development
 Classifier: Topic :: Utilities
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Requires-Dist: awkward>=2.4.6
 Requires-Dist: cramjam>=2.5.0
 Requires-Dist: fsspec
@@ -68,7 +66,6 @@ Requires-Dist: pytest-pyodide; extra == 'test-pyodide'
 Requires-Dist: pytest-timeout; extra == 'test-pyodide'
 Requires-Dist: pytest>=6; extra == 'test-pyodide'
 Requires-Dist: scikit-hep-testdata; extra == 'test-pyodide'
-Requires-Dist: selenium<=4.25.0; extra == 'test-pyodide'
 Provides-Extra: xrootd
 Requires-Dist: fsspec-xrootd; extra == 'xrootd'
 Description-Content-Type: text/markdown
@@ -77,7 +74,7 @@ Description-Content-Type: text/markdown
 
 [![PyPI version](https://badge.fury.io/py/uproot.svg)](https://pypi.org/project/uproot)
 [![Conda-Forge](https://img.shields.io/conda/vn/conda-forge/uproot)](https://github.com/conda-forge/uproot-feedstock)
-[![Python 3.8‒3.12](https://img.shields.io/badge/python-3.8%E2%80%923.12-blue)](https://www.python.org)
+[![Python 3.9‒3.13](https://img.shields.io/badge/python-3.9%E2%80%923.13-blue)](https://www.python.org)
 [![BSD-3 Clause License](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
 [![Continuous integration tests](https://github.com/scikit-hep/uproot5/actions/workflows/build-test.yml/badge.svg)](https://github.com/scikit-hep/uproot5/actions)
 
@@ -268,6 +265,7 @@ 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/MatousVozak"><img src="https://avatars.githubusercontent.com/u/33348191?v=4?s=100" width="100px;" alt="MatousVozak"/><br /><sub><b>MatousVozak</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=MatousVozak" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/rossodisera"><img src="https://avatars.githubusercontent.com/u/46961664?v=4?s=100" width="100px;" alt="Andrea Serafini"/><br /><sub><b>Andrea Serafini</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=rossodisera" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://www.ariostas.com"><img src="https://avatars.githubusercontent.com/u/7596837?v=4?s=100" width="100px;" alt="Andres Rios Tascon"/><br /><sub><b>Andres Rios Tascon</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=ariostas" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

{uproot-5.4.2 → uproot-5.5.1}/README.md

@@ -2,7 +2,7 @@
 
 [![PyPI version](https://badge.fury.io/py/uproot.svg)](https://pypi.org/project/uproot)
 [![Conda-Forge](https://img.shields.io/conda/vn/conda-forge/uproot)](https://github.com/conda-forge/uproot-feedstock)
-[![Python 3.8‒3.12](https://img.shields.io/badge/python-3.8%E2%80%923.12-blue)](https://www.python.org)
+[![Python 3.9‒3.13](https://img.shields.io/badge/python-3.9%E2%80%923.13-blue)](https://www.python.org)
 [![BSD-3 Clause License](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
 [![Continuous integration tests](https://github.com/scikit-hep/uproot5/actions/workflows/build-test.yml/badge.svg)](https://github.com/scikit-hep/uproot5/actions)
 
@@ -193,6 +193,7 @@ 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/MatousVozak"><img src="https://avatars.githubusercontent.com/u/33348191?v=4?s=100" width="100px;" alt="MatousVozak"/><br /><sub><b>MatousVozak</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=MatousVozak" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/rossodisera"><img src="https://avatars.githubusercontent.com/u/46961664?v=4?s=100" width="100px;" alt="Andrea Serafini"/><br /><sub><b>Andrea Serafini</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=rossodisera" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://www.ariostas.com"><img src="https://avatars.githubusercontent.com/u/7596837?v=4?s=100" width="100px;" alt="Andres Rios Tascon"/><br /><sub><b>Andres Rios Tascon</b></sub></a><br /><a href="https://github.com/scikit-hep/uproot5/commits?author=ariostas" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

{uproot-5.4.2 → uproot-5.5.1}/pyproject.toml

@@ -24,7 +24,6 @@ classifiers = [
   "Programming Language :: Python",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.8",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
@@ -53,7 +52,7 @@ dynamic = [
 license = "BSD-3-Clause"
 name = "uproot"
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 
 [project.optional-dependencies]
 dev = [
@@ -83,7 +82,6 @@ test = [
 ]
 test-pyodide = [
   "pytest>=6",
-  "selenium<=4.25.0",  # unpin once >4.26.0 is available
   "pytest-pyodide",
   "pytest-timeout",
   "scikit-hep-testdata"

{uproot-5.4.2 → uproot-5.5.1}/src/uproot/_util.py

@@ -91,7 +91,10 @@ def ensure_numpy(array, types=(numpy.bool_, numpy.integer, numpy.floating)):
         else:
             try:
                 out = numpy.asarray(array)
-            except (ValueError, numpy.VisibleDeprecationWarning) as err:
+            except (
+                ValueError,
+                getattr(numpy, "exceptions", numpy).VisibleDeprecationWarning,
+            ) as err:
                 raise TypeError("cannot be converted to a NumPy array") from err
         if not issubclass(out.dtype.type, types):
             raise TypeError(f"cannot be converted to a NumPy array of type {types}")

uproot-5.5.1/src/uproot/const.py

@@ -0,0 +1,283 @@
+# BSD 3-Clause License; see https://github.com/scikit-hep/uproot5/blob/main/LICENSE
+
+"""
+This module defines integer constants used by serialization and deserialization routines.
+"""
+from __future__ import annotations
+
+from enum import IntEnum
+
+import numpy
+
+# determines when a file is "big"
+kStartBigFile = 2000000000
+
+# used in unmarshaling
+kByteCountMask = numpy.int64(0x40000000)
+kByteCountVMask = numpy.int64(0x4000)
+kClassMask = numpy.int64(0x80000000)
+kNewClassTag = numpy.int64(0xFFFFFFFF)
+
+kIsOnHeap = numpy.uint32(0x01000000)
+kNotDeleted = numpy.uint32(0x02000000)
+kMustCleanup = numpy.uint32(1 << 3)
+kIsReferenced = numpy.uint32(1 << 4)
+
+kMapOffset = 2
+
+# not used?
+kNullTag = 0
+kZombie = numpy.uint32(0x04000000)
+kBitMask = numpy.uint32(0x00FFFFFF)
+kDisplacementMask = numpy.uint32(0xFF000000)
+
+############# core/zip/inc/Compression.h
+
+kZLIB = 1
+kLZMA = 2
+kOldCompressionAlgo = 3
+kLZ4 = 4
+kZSTD = 5
+kUndefinedCompressionAlgorithm = 6
+
+############# constants for streamers
+
+kBase = 0
+kChar = 1
+kShort = 2
+kInt = 3
+kLong = 4
+kFloat = 5
+kCounter = 6
+kCharStar = 7
+kDouble = 8
+kDouble32 = 9
+kLegacyChar = 10
+kUChar = 11
+kUShort = 12
+kUInt = 13
+kULong = 14
+kBits = 15
+kLong64 = 16
+kULong64 = 17
+kBool = 18
+kFloat16 = 19
+kOffsetL = 20
+kOffsetP = 40
+kObject = 61
+kAny = 62
+kObjectp = 63
+kObjectP = 64
+kTString = 65
+kTObject = 66
+kTNamed = 67
+kAnyp = 68
+kAnyP = 69
+kAnyPnoVT = 70
+kSTLp = 71
+
+kSkip = 100
+kSkipL = 120
+kSkipP = 140
+
+kConv = 200
+kConvL = 220
+kConvP = 240
+
+kSTL = 300
+kSTLstring = 365
+
+kStreamer = 500
+kStreamLoop = 501
+
+############# constants from core/foundation/inc/ESTLType.h
+
+kNotSTL = 0
+kSTLvector = 1
+kSTLlist = 2
+kSTLdeque = 3
+kSTLmap = 4
+kSTLmultimap = 5
+kSTLset = 6
+kSTLmultiset = 7
+kSTLbitset = 8
+kSTLforwardlist = 9
+kSTLunorderedset = 10
+kSTLunorderedmultiset = 11
+kSTLunorderedmap = 12
+kSTLunorderedmultimap = 13
+kSTLend = 14
+kSTLany = 300
+
+############# IOFeatures
+
+kGenerateOffsetMap = numpy.uint8(1)
+
+############# other
+
+kStreamedMemberWise = numpy.uint16(1 << 14)
+
+############ RNTuple https://github.com/root-project/root/blob/0b9cdbcfd326ba50ee6c2f202675656129eafbe7/tree/ntuple/v7/doc/BinaryFormatSpecification.md
+rntuple_col_num_to_dtype_dict = {
+    0x00: "bit",
+    0x01: "uint8",  # uninterpreted byte
+    0x02: "uint8",  # char
+    0x03: "int8",
+    0x04: "uint8",
+    0x05: "int16",
+    0x06: "uint16",
+    0x07: "int32",
+    0x08: "uint32",
+    0x09: "int64",
+    0x0A: "uint64",
+    0x0B: "float16",
+    0x0C: "float32",
+    0x0D: "float64",
+    0x0E: "uint32",  # Index32
+    0x0F: "uint64",  # Index64
+    0x10: "switch",  # Switch: (uint64, uint32)
+    0x11: "int16",  # SplitInt16: split + zigzag encoding
+    0x12: "uint16",  # SplitUInt16: split encoding
+    0x13: "int32",  # SplitInt32: split + zigzag encoding
+    0x14: "uint32",  # SplitUInt32: split encoding
+    0x15: "int64",  # SplitInt64: split + zigzag encoding
+    0x16: "uint64",  # SplitUInt64: split encoding
+    0x17: "float16",  # SplitReal16: split encoding
+    0x18: "float32",  # SplitReal32: split encoding
+    0x19: "float64",  # SplitReal64: split encoding
+    0x1A: "uint32",  # SplitIndex32: split + delta encoding
+    0x1B: "uint64",  # SplitIndex64: split + delta encoding
+    0x1C: "real32trunc",  # Real32Trunc: float32 with truncated mantissa
+    0x1D: "real32quant",  # Real32Quant: float32 with quantized integer representation
+}
+rntuple_col_num_to_size_dict = {
+    0x00: 1,
+    0x01: 8,
+    0x02: 8,
+    0x03: 8,
+    0x04: 8,
+    0x05: 16,
+    0x06: 16,
+    0x07: 32,
+    0x08: 32,
+    0x09: 64,
+    0x0A: 64,
+    0x0B: 16,
+    0x0C: 32,
+    0x0D: 64,
+    0x0E: 32,
+    0x0F: 64,
+    0x10: 96,
+    0x11: 16,
+    0x12: 16,
+    0x13: 32,
+    0x14: 32,
+    0x15: 64,
+    0x16: 64,
+    0x17: 16,
+    0x18: 32,
+    0x19: 64,
+    0x1A: 32,
+    0x1B: 64,
+    0x1C: 31,  # variable from 10 to 31
+    0x1D: 32,  # variable from 1 to 32
+}
+rntuple_col_type_to_num_dict = {
+    "bit": 0x00,
+    "byte": 0x01,
+    "char": 0x02,
+    "int8": 0x03,
+    "uint8": 0x04,
+    "int16": 0x05,
+    "uint16": 0x06,
+    "int32": 0x07,
+    "uint32": 0x08,
+    "int64": 0x09,
+    "uint64": 0x0A,
+    "real16": 0x0B,
+    "real32": 0x0C,
+    "real64": 0x0D,
+    "index32": 0x0E,
+    "index64": 0x0F,
+    "switch": 0x10,
+    "splitint16": 0x11,
+    "splituint16": 0x12,
+    "splitint32": 0x13,
+    "splituint32": 0x14,
+    "splitint64": 0x15,
+    "splituint64": 0x16,
+    "splitreal16": 0x17,
+    "splitreal32": 0x18,
+    "splitreal64": 0x19,
+    "splitindex32": 0x1A,
+    "splitindex64": 0x1B,
+    "real32trunc": 0x1C,
+    "real32quant": 0x1D,
+}
+rntuple_index_types = (
+    rntuple_col_type_to_num_dict["index32"],
+    rntuple_col_type_to_num_dict["index64"],
+    rntuple_col_type_to_num_dict["splitindex32"],
+    rntuple_col_type_to_num_dict["splitindex64"],
+)
+rntuple_split_types = (
+    rntuple_col_type_to_num_dict["splitint16"],
+    rntuple_col_type_to_num_dict["splituint16"],
+    rntuple_col_type_to_num_dict["splitint32"],
+    rntuple_col_type_to_num_dict["splituint32"],
+    rntuple_col_type_to_num_dict["splitint64"],
+    rntuple_col_type_to_num_dict["splituint64"],
+    rntuple_col_type_to_num_dict["splitreal16"],
+    rntuple_col_type_to_num_dict["splitreal32"],
+    rntuple_col_type_to_num_dict["splitreal64"],
+    rntuple_col_type_to_num_dict["splitindex32"],
+    rntuple_col_type_to_num_dict["splitindex64"],
+)
+rntuple_zigzag_types = (
+    rntuple_col_type_to_num_dict["splitint16"],
+    rntuple_col_type_to_num_dict["splitint32"],
+    rntuple_col_type_to_num_dict["splitint64"],
+)
+rntuple_delta_types = (
+    rntuple_col_type_to_num_dict["splitindex32"],
+    rntuple_col_type_to_num_dict["splitindex64"],
+)
+
+
+class RNTupleLocatorType(IntEnum):
+    STANDARD = 0x00
+    LARGE = 0x01
+
+
+class RNTupleEnvelopeType(IntEnum):
+    RESERVED = 0x00
+    HEADER = 0x01
+    FOOTER = 0x02
+    PAGELIST = 0x03
+
+
+class RNTupleFieldRole(IntEnum):
+    LEAF = 0x00
+    COLLECTION = 0x01
+    RECORD = 0x02
+    VARIANT = 0x03
+    STREAMER = 0x04
+
+
+class RNTupleFieldFlag(IntEnum):
+    REPETITIVE = 0x01
+    PROJECTED = 0x02
+    CHECKSUM = 0x04
+
+
+class RNTupleColumnFlag(IntEnum):
+    DEFERRED = 0x01
+    RANGE = 0x02
+
+
+class RNTupleExtraTypeIdentifier(IntEnum):
+    ROOT = 0x00
+
+
+class RNTupleClusterFlag(IntEnum):
+    SHARDED = 0x01

uproot-5.5.1/src/uproot/interpretation/known_forth/__init__.py

@@ -0,0 +1,46 @@
+# BSD 3-Clause License; see https://github.com/scikit-hep/uproot5/blob/main/LICENSE
+
+"""
+This module provides known forth code and awkward forms for types where it is known a priori.
+
+See :doc:`uproot.interpretation.known_forth.known_forth_of` for the function
+that provides the lookup of known forth codes and :doc:`uproot.interpretation.known_forth.atlas.VectorVectorElementLink` for an
+implementation used in ATLAS (D)AODs.
+"""
+from __future__ import annotations
+
+import uproot
+from uproot.interpretation.known_forth.atlas import VectorVectorElementLink
+
+KNOWN_FORTH_DICT = {
+    "std::vector<std::vector<ElementLink<DataVector<xAOD::CaloCluster_v1>>>>": VectorVectorElementLink,
+    "std::vector<std::vector<ElementLink<DataVector<xAOD::IParticle>>>>": VectorVectorElementLink,
+    "std::vector<std::vector<ElementLink<DataVector<xAOD::MuonSegment_v1>>>>": VectorVectorElementLink,
+    "std::vector<std::vector<ElementLink<DataVector<xAOD::NeutralParticle_v1>>>>": VectorVectorElementLink,
+    "std::vector<std::vector<ElementLink<DataVector<xAOD::TauTrack_v1>>>>": VectorVectorElementLink,
+    "std::vector<std::vector<ElementLink<DataVector<xAOD::TrackParticle_v1>>>>": VectorVectorElementLink,
+    "std::vector<std::vector<ElementLink<DataVector<xAOD::TruthParticle_v1>>>>": VectorVectorElementLink,
+    "std::vector<std::vector<ElementLink<DataVector<xAOD::Vertex_v1>>>>": VectorVectorElementLink,
+}
+
+
+def known_forth_of(model):
+    """
+    Args:
+        model: The :doc:`uproot.model.Model` to look up known forth for
+
+    Returns an object with attributes `forth_code` and `awkward_form` if a known
+    special case exists, else None
+    """
+    try:
+        typename = model.typename
+    except AttributeError:
+        try:
+            typename = model.classname
+        except AttributeError:
+            typename = uproot.model.classname_decode(model.__name__)
+
+    if typename not in KNOWN_FORTH_DICT:
+        return
+
+    return KNOWN_FORTH_DICT[typename](typename)

uproot-5.5.1/src/uproot/interpretation/known_forth/atlas.py

@@ -0,0 +1,99 @@
+# BSD 3-Clause License; see https://github.com/scikit-hep/uproot5/blob/main/LICENSE
+
+"""
+This module defines ATLAS specific known forth code
+"""
+
+from __future__ import annotations
+
+import re
+
+
+class VectorVectorElementLink:
+    """
+    Known forth and awkward form for ``std::vector<std::vector<ElementLink<T>>`` types in ATLAS (D)AODs
+
+    The forth code was adjusted from what was provided in
+    ``branch._complete_forth_code`` after running ``.array()`` once.
+
+    The binary data of one vector<vector<ElementLink<T>> looks as follows:
+
+    * 6 bytes header for the outer vector
+    * 4 bytes big endian uint for the size of the outer vector (node1)
+    * for each outer vector element:
+    * 4 bytes big endian uint for the size of the inner vector (node2)
+    * for each inner vector element:
+    * 20 bytes header for the ElementLink object
+    * 4 bytes big endian uint for the ``m_persKey`` member (node3)
+    * 4 bytes big endian uint for the ``m_persIndex`` member (node4)
+    """
+
+    forth_code = """
+input stream
+input byteoffsets
+input bytestops
+output node1-offsets int64
+output node2-offsets int64
+output node3-data uint32
+output node4-data uint32
+
+0 node1-offsets <- stack
+0 node2-offsets <- stack
+
+0 do
+    byteoffsets I-> stack
+    stream seek
+    6 stream skip
+    stream !I-> stack
+    dup node1-offsets +<- stack
+    0 do
+        stream !I-> stack
+        dup node2-offsets +<- stack
+        0 do
+            20 stream skip
+            stream !I-> node3-data
+            stream !I-> node4-data
+        loop
+    loop
+loop
+"""
+
+    def __init__(self, typename):
+        self.typename = typename
+        self.inner_typename = re.sub(
+            "std::vector<std::vector<(.*)>>", r"\1", self.typename
+        )
+
+    @property
+    def awkward_form(self):
+        return {
+            "class": "ListOffsetArray",
+            "offsets": "i64",
+            "form_key": "node1",
+            "content": {
+                "class": "ListOffsetArray",
+                "offsets": "i64",
+                "form_key": "node2",
+                "content": {
+                    "class": "RecordArray",
+                    "fields": ["m_persKey", "m_persIndex"],
+                    "contents": [
+                        {
+                            "class": "NumpyArray",
+                            "primitive": "uint32",
+                            "inner_shape": [],
+                            "parameters": {},
+                            "form_key": "node3",
+                        },
+                        {
+                            "class": "NumpyArray",
+                            "primitive": "uint32",
+                            "inner_shape": [],
+                            "parameters": {},
+                            "form_key": "node4",
+                        },
+                    ],
+                    "parameters": {"__record__": f"{self.inner_typename}"},
+                },
+            },
+        }

{uproot-5.4.2 → uproot-5.5.1}/src/uproot/interpretation/objects.py

@@ -28,6 +28,7 @@ import numpy
 
 import uproot
 import uproot._awkwardforth
+from uproot.interpretation.known_forth import known_forth_of
 
 
 class AsObjects(uproot.interpretation.Interpretation):
@@ -45,14 +46,22 @@ class AsObjects(uproot.interpretation.Interpretation):
     :ref:`uproot.interpretation.objects.AsObjects.simplify` attempts to
     replace this interpretation with a faster-to-read equivalent, but not all
     data types can be simplified.
+
+    :doc:`uproot.interpretation.known_forth` defines forth code and forms for
+    special cases that will be picked up here as well
     """
 
     def __init__(self, model, branch=None):
         self._model = model
         self._branch = branch
-        self._form = None
         self._forth = True
-        self._complete_forth_code = None
+        known_forth = known_forth_of(self._model)
+        if known_forth is not None:
+            self._complete_forth_code = known_forth.forth_code
+            self._form = known_forth.awkward_form
+        else:
+            self._complete_forth_code = None
+            self._form = None
         self._forth_lock = threading.Lock()
 
     @property
@@ -122,6 +131,10 @@ class AsObjects(uproot.interpretation.Interpretation):
         tobject_header=False,
         breadcrumbs=(),
     ):
+        if self._form is not None:
+            awkward = uproot.extras.awkward()
+            return awkward.forms.from_dict(self._form)
+
         context = self._make_context(
             context, index_format, header, tobject_header, breadcrumbs
         )