feat: add features from boost-histogram 1.4

.github/workflows/ci.yml

@@ -37,13 +37,15 @@ jobs:
         - "3.9"
         - "3.10"
         - "3.11"
+        - "3.12"
     name: Check Python ${{ matrix.python-version }}
     steps:
     - uses: actions/checkout@v4
 
     - uses: actions/setup-python@v4
       with:
         python-version: ${{ matrix.python-version }}
+        allow-prereleases: true
 
     - name: Requirements check
       run: python -m pip list
@@ -55,9 +57,9 @@ jobs:
       run: python -m pytest
 
     - name: Install plotting requirements too
-      if: matrix.python-version != '3.10'
+      if: matrix.python-version != '3.12'
       run: python -m pip install -e ".[test,plot]"
 
     - name: Test plotting too
-      if: matrix.python-version != '3.10'
+      if: matrix.python-version != '3.12'
       run: python -m pytest --mpl

docs/user-guide/notebooks/Histogram.ipynb

@@ -220,7 +220,7 @@
     "    Unif=np.random.uniform(size=1000),\n",
     "    Greet=[\"hi\"] * 800 + [\"hello\"] * 200,\n",
     "    Yes=[True] * 600 + [False] * 400,\n",
-    "    Int=np.ones(1000),\n",
+    "    Int=np.ones(1000, dtype=int),\n",
     ")"
    ]
   },

pyproject.toml

@@ -22,6 +22,7 @@ classifiers = [
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
     "Topic :: Scientific/Engineering",
     "Topic :: Scientific/Engineering :: Information Analysis",
     "Topic :: Scientific/Engineering :: Mathematics",
@@ -37,7 +38,8 @@ requires-python = ">=3.7"
 dependencies = [
     "boost-histogram>=1.3.1,<1.5",
     "histoprint>=2.2.0",
-    "numpy>=1.14.5",
+    'numpy>=1.14.5;python_version<"3.12"',
+    'numpy>=1.26.0b1;python_version>="3.12"',
     'typing-extensions>=4;python_version<"3.11"',
 ]
 dynamic = ["version"]
@@ -72,8 +74,8 @@ dask = [
 test = [
     "pytest >=6",
     "pytest-mpl >=0.12",
-    "dask[dataframe] >=2022; python_version>='3.8'",
-    "dask_histogram >=2023.1; python_version>='3.8'",
+    "dask[dataframe] >=2022; python_version>='3.8' and python_version<'3.12'",
+    "dask_histogram >=2023.1; python_version>='3.8' and python_version<'3.12'",
 ]
 dev = [
     "pytest >=6",
@@ -185,7 +187,7 @@ messages_control.disable = [
 [tool.ruff]
 select = [
   "E", "F", "W", # flake8
-  "B",  "B904",  # flake8-bugbear
+  "B",           # flake8-bugbear
   "I",           # isort
   "ARG",         # flake8-unused-arguments
   "C4",          # flake8-comprehensions

src/hist/axis/__init__.py

@@ -2,6 +2,7 @@
 
 from typing import Any, Iterable
 
+import boost_histogram as bh
 import boost_histogram.axis as bha
 
 import hist
@@ -212,12 +213,23 @@ def __init__(
         label: str = "",
         metadata: Any = None,
         growth: bool = False,
+        flow: bool = True,
+        overflow: bool | None = None,
         __dict__: dict[str, Any] | None = None,
     ) -> None:
+        has_flow = flow if overflow is None else overflow
+        if tuple(int(x) for x in bh.__version__.split(".")[:2]) < (1, 4):
+            if not has_flow:
+                msg = "Boost-histogram 1.4+ required for flowless Category axes"
+                raise TypeError(msg)
+            kwargs = {}
+        else:
+            kwargs = {"overflow": has_flow}
         super().__init__(
             categories,
             metadata=metadata,
             growth=growth,
+            **kwargs,
             __dict__=__dict__,
         )
         self._ax.metadata["name"] = name
@@ -235,12 +247,23 @@ def __init__(
         label: str = "",
         metadata: Any = None,
         growth: bool = False,
+        flow: bool = True,
+        overflow: bool | None = None,
         __dict__: dict[str, Any] | None = None,
     ) -> None:
+        has_flow = flow if overflow is None else overflow
+        if tuple(int(x) for x in bh.__version__.split(".")[:2]) < (1, 4):
+            if not has_flow:
+                msg = "Boost-histogram 1.4+ required for flowless Category axes"
+                raise TypeError(msg)
+            kwargs = {}
+        else:
+            kwargs = {"overflow": has_flow}
         super().__init__(
             categories,
             metadata=metadata,
             growth=growth,
+            **kwargs,
             __dict__=__dict__,
         )
         self._ax.metadata["name"] = name

tests/test_general.py

@@ -198,15 +198,19 @@ def test_general_fill():
 
     # IntCategory
     h = Hist(
-        axis.IntCategory(range(10), name="x"),
-        axis.IntCategory(range(10), name="y"),
+        axis.IntCategory(range(10), name="x", flow=False),
+        axis.IntCategory(range(10), name="y", overflow=False),
         axis.IntCategory(range(2), name="z"),
     ).fill(
         x=[3, 3, 3, 4, 5, 5, 5],
         y=[3, 3, 4, 4, 4, 4, 4],
         z=[0, 0, 1, 1, 1, 1, 1],
     )
 
+    assert not h.axes[0].traits.overflow
+    assert not h.axes[1].traits.overflow
+    assert h.axes[2].traits.overflow
+
     z_one_only = h[{2: bh.loc(1)}]
     for idx_x in range(10):
         for idx_y in range(10):
@@ -219,15 +223,19 @@ def test_general_fill():
 
     # StrCategory
     h = Hist(
-        axis.StrCategory("FT", name="x"),
-        axis.StrCategory(list("FT"), name="y"),
+        axis.StrCategory("FT", name="x", flow=False),
+        axis.StrCategory(list("FT"), name="y", overflow=False),
         axis.StrCategory(["F", "T"], name="z"),
     ).fill(
         ["T", "T", "T", "T", "T", "F", "T"],
         ["F", "T", "T", "F", "F", "T", "F"],
         ["F", "F", "T", "T", "T", "T", "T"],
     )
 
+    assert not h.axes[0].traits.overflow
+    assert not h.axes[1].traits.overflow
+    assert h.axes[2].traits.overflow
+
     z_one_only = h[{2: bh.loc("T")}]
     assert z_one_only[bh.loc("F"), bh.loc("F")] == 0
     assert z_one_only[bh.loc("F"), bh.loc("T")] == 1
@@ -282,7 +290,7 @@ def test_general_access():
     h = Hist(
         axis.Regular(50, -5, 5, name="Norm", label="normal distribution"),
         axis.Regular(50, -5, 5, name="Unif", label="uniform distribution"),
-        axis.StrCategory(["hi", "hello"], name="Greet"),
+        axis.StrCategory(["hi", "hello"], name="Greet", flow=False),
         axis.Boolean(name="Yes"),
         axis.Integer(0, 1000, name="Int"),
     ).fill(