feat: python 3.13 support

Co-authored-by: mfranczel <mfranczel@users.noreply.github.com>

Author: FilipPyrek

.cursorrules

@@ -137,6 +137,7 @@ Supported versions:
 - Python 3.10
 - Python 3.11
 - Python 3.12
+- Python 3.13
 
 ## Code Examples
 

.github/workflows/cd.yml

@@ -35,7 +35,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python_version: ["3.9", "3.10", "3.11", "3.12"]
+        python_version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
     permissions:
       id-token: write
       contents: read
@@ -413,7 +413,7 @@ jobs:
     needs: build-and-push-artifacts-status
     if: github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/')
     env:
-      PYTHON_VERSIONS: "3.9,3.10,3.11,3.12"
+      PYTHON_VERSIONS: "3.9,3.10,3.11,3.12,3.13"
     steps:
       - name: Checkout code
         uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4

.github/workflows/ci.yml

@@ -162,7 +162,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
     steps:
     - name: Checkout code
@@ -283,7 +283,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
     steps:
       - name: Checkout code
         uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4
@@ -299,11 +299,11 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
-      - name: Set up Java 11
+      - name: Set up Java 17
         uses: actions/setup-java@c5195efecf7bdfc987ee8bae7a71cb8b11521c00 # v4
         with:
           distribution: 'temurin'
-          java-version: '11'
+          java-version: '17'
 
       - name: Load cached Poetry installation
         id: cached-poetry

.mise.toml

@@ -4,7 +4,7 @@
 
 [tools]
 python = "3.12"
-java = "temurin-11"
+java = "temurin-17"
 poetry = "2.2.0"
 
 [tasks.setup]

CLAUDE.md

@@ -52,7 +52,7 @@
 
 ## Python Version Support
 
-- Python 3.9, 3.10, 3.11, 3.12
+- Python 3.9, 3.10, 3.11, 3.12, 3.13
 
 ## Dependencies
 

README.md

@@ -37,17 +37,17 @@ The toolkit consists of two main bundle types:
 2. Run setup:
 
     ```bash
-    mise install        # Installs Python 3.12 and Java 11
+    mise install        # Installs Python 3.12 and Java 17
     mise run setup      # Installs dependencies and pre-commit hooks
     ```
 
 #### Option 2: Manual setup
 
 1. Install poetry: [Installation](https://python-poetry.org/docs/#installation)
-2. Install Java 11 (required for PySpark tests):
+2. Install Java 17 (required for PySpark tests):
     - macOS: `brew install openjdk@11`
-    - Ubuntu/Debian: `sudo apt-get install openjdk-11-jdk`
-    - RHEL/Fedora: `sudo dnf install java-11-openjdk-devel`
+    - Ubuntu/Debian: `sudo apt-get install openjdk-17-jdk`
+    - RHEL/Fedora: `sudo dnf install java-17-openjdk-devel`
 3. Set up venv for development package:
 
     ```bash
@@ -277,7 +277,7 @@ $ ./bin/test-local
 
 We use Docker to ensure reproducible environments due to Jupyter libraries' binary dependencies:
 
-- `builder.Dockerfile`: Creates Python package bundles for different versions (3.9-3.12), generates kernel and server bundles, and packages the toolkit for distribution using Poetry.
+- `builder.Dockerfile`: Creates Python package bundles for different versions (3.9-3.13), generates kernel and server bundles, and packages the toolkit for distribution using Poetry.
 
 - `test.Dockerfile`: Provides consistent test environment for running unit and integration tests across Python versions using nox. Used both locally and in CI/CD pipeline.
 

deepnote_toolkit/ocelots/pandas/analyze.py

@@ -83,9 +83,15 @@ def _get_histogram(pd_series):
             {"bin_start": bins[i], "bin_end": bins[i + 1], "count": count.item()}
             for i, count in enumerate(y)
         ]
-    except IndexError:
-        # numpy bug https://github.com/numpy/numpy/issues/8627
-        return None
+    except ValueError as e:
+        # NumPy 2.2+ raises "Too many bins for data range" when:
+        # - Data range is zero (all values identical), or
+        # - For integer data, bin width would be < 1.0, or
+        # - Floating point precision prevents creating finite-sized bins at large scales
+        # Numpy implementation: https://github.com/numpy/numpy/blob/e7a123b2d3eca9897843791dd698c1803d9a39c2/numpy/lib/_histograms_impl.py#L454
+        if "Too many bins for data range" in str(e):
+            return None
+        raise
 
 
 def _calculate_min_max(column):

dockerfiles/test.Dockerfile

@@ -2,7 +2,7 @@ FROM quay.io/pypa/manylinux_2_28_x86_64:2025.05.28-1
 RUN pipx install nox poetry==2.2.0
 
 RUN dnf -y update && \
-    dnf -y install java-11-openjdk-devel \
+    dnf -y install java-17-openjdk-devel \
     # Required for pymssql - provides sqlfront.h header file
     freetds-devel \
     # Required for database connectivity through ODBC

noxfile.py

@@ -3,7 +3,7 @@
 from nox import session
 
 
-@session(python=["3.9", "3.10", "3.11", "3.12"], reuse_venv=True)
+@session(python=["3.9", "3.10", "3.11", "3.12", "3.13"], reuse_venv=True)
 def unit(session):
     """Run unit tests. Coverage is disabled by default, use --coverage to enable."""
 
@@ -67,7 +67,7 @@ def unit(session):
     )
 
 
-@session(python=["3.9", "3.10", "3.11", "3.12"], reuse_venv=True)
+@session(python=["3.9", "3.10", "3.11", "3.12", "3.13"], reuse_venv=True)
 def integration(session):
     """Run integration tests. Coverage is disabled by default, use --coverage to enable."""
     # Validate required environment variables