chore: use ruff to import annotations

.pre-commit-config.yaml

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

dev/example-objects.py

@@ -1,6 +1,7 @@
 """
 Use this to make an example ROOT file for src/uproot/models/TH.py and src/uproot/models/TGraph.py.
 """
+from __future__ import annotations
 
 import numpy as np
 import ROOT

dev/make-models.py

@@ -1,6 +1,7 @@
 """
 Use this to make src/uproot/models/TH.py and src/uproot/models/TGraph.py.
 """
+from __future__ import annotations
 
 import numpy as np
 

pyproject.toml

@@ -141,6 +141,9 @@ select = [
 ]
 src = ["src"]
 
+[tool.ruff.lint]
+isort.required-imports = ["from __future__ import annotations"]
+
 [tool.ruff.mccabe]
 max-complexity = 100
 

src/uproot/_awkward_forth.py

@@ -3,6 +3,7 @@
 """
 This module defines utilities for adding components to the forth reader.
 """
+from __future__ import annotations
 
 import numpy as np
 

src/uproot/behavior.py

@@ -5,7 +5,7 @@
 Behaviors are defined by specially named classes in specially named modules
 that get auto-detected by :doc:`uproot.behavior.behavior_of`.
 """
-
+from __future__ import annotations
 
 import pkgutil
 

src/uproot/behaviors/RooCurve.py

@@ -3,7 +3,7 @@
 """
 This module defines the behaviors of ``RooCurve``.
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/behaviors/RooHist.py

@@ -3,7 +3,7 @@
 """
 This module defines the behaviors of ``RooHist``.
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/behaviors/TAxis.py

@@ -3,7 +3,7 @@
 """
 This module defines the behaviors of ``TAxis``, an axis of a histogram or profile plot.
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/behaviors/TBranch.py

@@ -10,6 +10,7 @@
 See :doc:`uproot.models.TBranch` for deserialization of the ``TBranch``
 objects themselves.
 """
+from __future__ import annotations
 
 import queue
 import re

src/uproot/behaviors/TBranchElement.py

@@ -4,7 +4,7 @@
 This module defines the behaviors of ``TBranchElement``, which is entirely inherited from
 functions in :doc:`uproot.behaviors.TBranch.TBranch`.
 """
-
+from __future__ import annotations
 
 import uproot
 

src/uproot/behaviors/TDatime.py

@@ -3,7 +3,7 @@
 """
 This module defines the behaviors of ``TDatime``.
 """
-
+from __future__ import annotations
 
 import uproot
 

src/uproot/behaviors/TGraph.py

@@ -3,7 +3,7 @@
 """
 This module defines the behaviors of ``TGraph``.
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/behaviors/TGraphAsymmErrors.py

@@ -3,7 +3,7 @@
 """
 This module defines the behaviors of ``TGraphAsymmErrors``.
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/behaviors/TGraphErrors.py

@@ -3,6 +3,7 @@
 """
 This module defines the behaviors of ``TGraphErrors``.
 """
+from __future__ import annotations
 
 
 class TGraphErrors:

src/uproot/behaviors/TH1.py

@@ -4,7 +4,7 @@
 This module defines the behaviors of ``TH1`` and its subclasses (not including ``TH2``,
 ``TH3``, or ``TProfile``).
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/behaviors/TH2.py

@@ -4,7 +4,7 @@
 This module defines the behaviors of ``TH2`` and its subclasses (not including
 ``TProfile2D`` and ``TH2Poly``).
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/behaviors/TH2Poly.py

@@ -3,7 +3,7 @@
 """
 This module defines the behavior of ``TH2Poly``.
 """
-
+from __future__ import annotations
 
 import uproot
 

src/uproot/behaviors/TH3.py

@@ -4,7 +4,7 @@
 This module defines the behaviors of ``TH3`` and its subclasses (not including
 ``TProfile3D``).
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/behaviors/TParameter.py

@@ -3,6 +3,7 @@
 """
 This module defines the behavior of ``TParameter<T>``.
 """
+from __future__ import annotations
 
 
 class TParameter_3c_boolean_3e_:

src/uproot/behaviors/TProfile.py

@@ -3,7 +3,7 @@
 """
 This module defines the behavior of ``TProfile``.
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/behaviors/TProfile2D.py

@@ -3,7 +3,7 @@
 """
 This module defines the behavior of ``TProfile2D``.
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/behaviors/TProfile3D.py

@@ -3,7 +3,7 @@
 """
 This module defines the behavior of ``TProfile3D``.
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/behaviors/TTree.py

@@ -4,7 +4,7 @@
 This module defines the behaviors of ``TTree``, which is almost entirely inherited from
 functions in :doc:`uproot.behaviors.TBranch`.
 """
-
+from __future__ import annotations
 
 import uproot
 

src/uproot/cache.py

@@ -11,7 +11,7 @@
 The :doc:`uproot.cache.LRUArrayCache` implements the same policy, limiting the
 total number of bytes, as reported by ``nbytes``.
 """
-
+from __future__ import annotations
 
 import threading
 from collections.abc import MutableMapping

src/uproot/const.py

@@ -3,6 +3,7 @@
 """
 This module defines integer constants used by serialization and deserialization routines.
 """
+from __future__ import annotations
 
 import struct
 

src/uproot/containers.py

@@ -6,7 +6,7 @@
 
 See :doc:`uproot.interpretation` and :doc:`uproot.model`.
 """
-
+from __future__ import annotations
 
 import json
 import struct

src/uproot/deserialization.py

@@ -7,7 +7,7 @@
 :doc:`uproot.deserialization.read_object_any`, which manages references to
 previously read objects.
 """
-
+from __future__ import annotations
 
 import struct
 import sys

src/uproot/dynamic.py

@@ -12,6 +12,7 @@
 classes, which are used as a container in which data from pickled
 :doc:`uproot.model.VersionedModel` instances are filled.
 """
+from __future__ import annotations
 
 
 def __getattr__(name):

src/uproot/exceptions.py

@@ -4,6 +4,7 @@
 This module defines Uproot-specific exceptions, such as
 :doc:`uproot.exceptions.KeyInFileError`.
 """
+from __future__ import annotations
 
 import uproot
 

src/uproot/extras.py

@@ -7,6 +7,7 @@
 If a library cannot be imported, these functions raise ``ModuleNotFoundError`` with
 error messages containing instructions on how to install the library.
 """
+from __future__ import annotations
 
 import atexit
 import importlib.metadata as importlib_metadata

src/uproot/interpretation/__init__.py

@@ -10,6 +10,7 @@
 that determine the default interpretation of a
 :doc:`uproot.behaviors.TBranch.TBranch`.
 """
+from __future__ import annotations
 
 
 class Interpretation:

src/uproot/interpretation/grouped.py

@@ -5,7 +5,7 @@
 temporary array for grouped data; usually applied to a ``TBranch`` that does
 not contain data but has subbranches that do.
 """
-
+from __future__ import annotations
 
 import uproot
 

src/uproot/interpretation/identify.py

@@ -11,7 +11,7 @@
 observed in ROOT files (perhaps forever), unless a systematic study can be
 performed to exhaustively discover all cases.
 """
-
+from __future__ import annotations
 
 import ast
 import numbers

src/uproot/interpretation/jagged.py

@@ -8,7 +8,7 @@
 an array is being built from ``TBaskets``. Its final form is determined by
 :doc:`uproot.interpretation.library`.
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/interpretation/library.py

@@ -21,7 +21,7 @@
 Lazy arrays (:doc:`uproot.behaviors.TBranch.lazy`) can only use the
 :doc:`uproot.interpretation.library.Awkward` library.
 """
-
+from __future__ import annotations
 
 import gc
 import json

src/uproot/interpretation/numerical.py

@@ -15,7 +15,7 @@
 * :doc:`uproot.interpretation.numerical.AsSTLBits`: an ``std::bitset<N>``
   for some ``N``.
 """
-
+from __future__ import annotations
 
 import numpy
 

src/uproot/interpretation/objects.py

@@ -18,6 +18,7 @@
 while an array is being built from ``TBaskets``. Its final form is determined
 by the :doc:`uproot.interpretation.library.Library`.
 """
+from __future__ import annotations
 
 import contextlib
 import threading

src/uproot/interpretation/strings.py

@@ -12,6 +12,7 @@
 an array is being built from ``TBaskets``. Its final form is determined by the
 :doc:`uproot.interpretation.library.Library`.
 """
+from __future__ import annotations
 
 import struct
 import threading

src/uproot/language/__init__.py

@@ -8,6 +8,7 @@
 
 All languages must be subclasses of :doc:`uproot.language.Language`.
 """
+from __future__ import annotations
 
 
 class Language:

src/uproot/language/python.py

@@ -7,7 +7,7 @@
 The :doc:`uproot.language.python.PythonLanguage` evaluates Python code. It is
 the default language.
 """
-
+from __future__ import annotations
 
 import ast
 import warnings

src/uproot/model.py

@@ -16,7 +16,7 @@
 not be modeled, either because the class has no streamer or no streamer for its
 version.
 """
-
+from __future__ import annotations
 
 import re
 import sys

src/uproot/models/RNTuple.py

@@ -3,6 +3,7 @@
 """
 This module defines a versionless model for ``ROOT::Experimental::RNTuple``.
 """
+from __future__ import annotations
 
 import struct
 import zlib

src/uproot/models/TArray.py

@@ -3,7 +3,7 @@
 """
 This module defines versionless models for ``TArray`` and its subclasses.
 """
-
+from __future__ import annotations
 
 import struct
 from collections.abc import Sequence

src/uproot/models/TAtt.py

@@ -3,7 +3,7 @@
 """
 This module defines versioned models for ``TAttLine``, ``TAttFill``, and ``TAttMarker``.
 """
-
+from __future__ import annotations
 
 import struct
 

src/uproot/models/TBasket.py

@@ -7,7 +7,7 @@
 Includes both "embedded" ``TBaskets`` (as a member of TBranch) and "free"
 ``TBaskets`` (top-level objects, located by ``TKeys``).
 """
-
+from __future__ import annotations
 
 import struct