numpy を 2.x 系へアップグレードする

[rikunosuke]

概要

numpy の依存バージョンを 1.26 系から 2.x 系へアップグレードしたい。
事前調査の結果をまとめる。

現在の状態

• pyproject.toml / requirements.txt: numpy>=1.26.0,<2.0.0
• requires-python: >=3.8
• CI (.github/workflows/test.yml): Python 3.10.11
• Release (.github/workflows/release.yml): Python 3.8

numpy 2.0 の主な互換性要件

1. Python 3.9 以上が必須 — numpy 2.0 で Python 3.8 サポート終了
2. 依存ライブラリの numpy 2.x 対応バージョン:
   • opencv-python → 4.10.0+ で numpy 2 対応(現状下限は >=4.0.0)
   • Pillow>=10.0.0,<11.0.0 → 対応済み
   • pandas(robotics extra) → 2.2.2+ で対応(現状 >=2.0.0)
   • pyarrow(robotics extra) → 16.0+ で対応(現状 >=14.0.0)
   • geojson / requests / xmltodict / aiohttp → numpy 非依存

コードへの影響

numpy を使用しているのは下記 4 ファイルのみ:

• fastlabel/__init__.py
• fastlabel/converters.py
• fastlabel/utils/__init__.py
• fastlabel/utils/mask_image_util.py

使用 API: np.array, np.ndarray, np.dot, np.roll, np.abs, np.ravel, np.vstack, np.flipud, np.all, np.append, np.array_equal, np.integer, np.floating, np.uint8, np.int32

numpy 2.0 で削除された API(np.float_, np.int_, np.NaN, np.Inf, np.product, np.cumproduct, np.alltrue, np.sometrue, np.in1d, np.bool8, np.string_ 等)は 一切使用されていない。コード修正は基本不要の見込み。

アップグレード対象の変更点(案)

項目	現状	提案
numpy バージョン	>=1.26.0,<2.0.0	>=2.0.0,<3.0.0
requires-python	>=3.8	>=3.9 以上
opencv-python 下限	>=4.0.0	>=4.10.0
.github/workflows/release.yml の Python	3.8	3.9+(推奨 3.10)
pandas(extras)	>=2.0.0	>=2.2.2
pyarrow(extras)	>=14.0.0	>=16.0.0

確認事項

• Python 3.8 サポートを切ることに問題ないか(numpy 2 の前提)
• requires-python を >=3.9 にするか、>=3.10 にするか
• robotics extras(pandas / pyarrow)も同時に更新するか

TODO

• pyproject.toml / requirements.txt の numpy バージョン制約更新
• requires-python の更新
• opencv-python 下限引き上げ
• .github/workflows/release.yml の Python バージョン更新
• (任意)robotics extras の更新
• テスト実行による動作確認

[rikunosuke]

追加方針: numpy 1.x / 2.x 両対応

「numpy 2.x 専用」ではなく 1.x / 2.x 両対応 で進める。Python 3.8 のみ切り、それ以外の利用者影響を抑える。

pyproject.toml 変更点

項目	現状	変更後
numpy	>=1.26.0,<2.0.0	>=1.26.0,<3.0.0
requires-python	>=3.8	>=3.9
opencv-python	>=4.0.0,<5.0.0	>=4.10.0,<5.0.0(numpy 2 対応下限)
pandas (robotics)	>=2.0.0	>=2.2.2
pyarrow (robotics)	>=14.0.0	>=16.0.0

requirements.txt も同様に更新。

.github/workflows/test.yml 変更点

現状 lint のみで pytest が走っていないため、両対応を担保するには テストの追加が前提。その上でマトリクス化する。

strategy:
  fail-fast: false
  matrix:
    python-version: ["3.9", "3.12"]
    numpy-version: ["1.26.*", "2.*"]

• インストール後 pip install "numpy==${{ matrix.numpy-version }}" で numpy を上書きしてバージョン軸を効かせる
• lint ジョブは Python マトリクスから分離(1回だけ走らせる)
• pytest 実行ステップを追加(別 issue / PR で先行整備が必要であれば切り出し)

.github/workflows/release.yml

Python 3.8 → 3.9(または最新の Python に揃える)。

コード対応

numpy 2.0 で削除された API は未使用のため修正不要見込み。型昇格(NEP 50)が影響しうる mask_image_util.py の挙動はマトリクス CI で検証する。

[rikunosuke]

計画更新(前コメントを差し替え)

前提が以下に変わったため、計画を再整理。

1. numpy>=1.26.0,<3.0.0(1.x / 2.x 両対応)
2. Python 3.8 と 3.9 のサポートを終了
3. Python 3.14 に対応

1. pyproject.toml / requirements.txt

項目	現状	変更後
requires-python	>=3.8	>=3.10
numpy	>=1.26.0,<2.0.0	>=1.26.0,<3.0.0
Pillow	>=10.0.0,<11.0.0	>=11.0.0,<13.0.0(3.13/3.14 wheel 対応に必須)
opencv-python	>=4.0.0,<5.0.0	>=4.10.0,<5.0.0(本 PR で対応済み)
aiohttp	>=3.8.5	削除(コード未使用のため本 PR で対応済み)
robotics pandas	>=2.0.0	>=2.2.2(numpy 2 対応下限)
robotics pyarrow	>=14.0.0	>=18.0.0(numpy 2 + Python 3.13/3.14 対応)

2. .github/workflows/test.yml

Python 3.10〜3.14 × numpy 1.26 / 2.x のマトリクス。numpy 1.26 は Python 3.12 まで対応なので 3.13/3.14 は除外。

strategy:
  fail-fast: false
  matrix:
    python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
    numpy-version: ["1.26.*", "2.*"]
    exclude:
      - python-version: "3.13"
        numpy-version: "1.26.*"
      - python-version: "3.14"
        numpy-version: "1.26.*"

各 job 内で pip install "numpy==${{ matrix.numpy-version }}" により numpy を上書き。

3. .github/workflows/release.yml

Python 3.8 → 3.10(または最新の安定版)。

4. コード対応

• numpy 2.0 で削除された API は未使用 → 修正不要見込み
• 型昇格(NEP 50)が影響しうる mask_image_util.py の挙動はマトリクス CI で検証

PR 分割案

PR	内容	状態
A(feature/bump-opencv-python #274)	opencv 4.10 + テスト追加 + aiohttp 削除 + CI(3.9-3.12)	進行中
B	Pillow >=11.0.0,<13.0.0 への bump	A マージ後
C	numpy <3.0 + requires-python>=3.10 + release.yml + マトリクス完全版(3.10-3.14 × numpy 1/2)	B マージ後の本命
D(任意)	robotics extras(pandas/pyarrow)更新	C に同梱でも可

A は現状の CI を最小修正で通すスコープに留め、3.13/3.14 や numpy 2 対応は B 以降で段階的に進める。