Add support for Python 3.14

cjdsellers · cjdsellers · commit a9352841597a · 2025-10-30T15:31:52.000+10:00
diff --git a/.github/workflows/build-v2.yml b/.github/workflows/build-v2.yml
@@ -74,6 +74,7 @@ jobs:
         python-version:
           - "3.12"
           - "3.13"
+          - "3.14"
     runs-on: ${{ matrix.os }}
     defaults:
       run:
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -67,6 +67,7 @@ jobs:
         python-version:
           - "3.12"
           - "3.13"
+          - "3.14"
           # REMINDER: Update EXPECTED_WHEEL_COUNT below when changing Python versions
     defaults:
       run:
@@ -158,6 +159,8 @@ jobs:
         python-version:
           - "3.12"
           - "3.13"
+          - "3.14"
+          # REMINDER: Update EXPECTED_WHEEL_COUNT below when changing Python versions
     defaults:
       run:
         shell: bash
@@ -252,6 +255,8 @@ jobs:
         python-version:
           - "3.12"
           - "3.13"
+          - "3.14"
+          # REMINDER: Update EXPECTED_WHEEL_COUNT below when changing Python versions
     defaults:
       run:
         shell: bash
@@ -308,6 +313,7 @@ jobs:
         python-version:
           - "3.12"
           - "3.13"
+          # REMINDER: Update EXPECTED_WHEEL_COUNT below when changing Python versions
     defaults:
       run:
         shell: bash
@@ -380,7 +386,7 @@ jobs:
       CLOUDFLARE_R2_URL: ${{ secrets.CLOUDFLARE_R2_URL }}
       CLOUDFLARE_R2_REGION: "auto"
       CLOUDFLARE_R2_BUCKET_NAME: "packages"
-      EXPECTED_WHEEL_COUNT: 6  # 2 Python versions (3.12, 3.13) × 3 platforms (ARM skipped on develop)
+      EXPECTED_WHEEL_COUNT: 8  # Linux x86 (3) + macOS (3) + Windows (2, no 3.14 support)
     steps:
       # https://github.com/step-security/harden-runner
       - uses: step-security/harden-runner@f4a75cfd619ee5ce8d5b864b0d183aff3c69b55a # v2.13.1
@@ -444,7 +450,7 @@ jobs:
       CLOUDFLARE_R2_URL: ${{ secrets.CLOUDFLARE_R2_URL }}
       CLOUDFLARE_R2_REGION: "auto"
       CLOUDFLARE_R2_BUCKET_NAME: "packages"
-      EXPECTED_WHEEL_COUNT: 8  # 2 Python versions (3.12, 3.13) × 4 platforms
+      EXPECTED_WHEEL_COUNT: 11  # Linux x86 (3) + Linux ARM (3) + macOS (3) + Windows (2, no 3.14 support)
     steps:
       # https://github.com/step-security/harden-runner
       - uses: step-security/harden-runner@f4a75cfd619ee5ce8d5b864b0d183aff3c69b55a # v2.13.1
@@ -508,7 +514,7 @@ jobs:
       CLOUDFLARE_R2_URL: ${{ secrets.CLOUDFLARE_R2_URL }}
       CLOUDFLARE_R2_REGION: "auto"
       CLOUDFLARE_R2_BUCKET_NAME: "packages"
-      EXPECTED_WHEEL_COUNT: 8  # 2 Python versions (3.12, 3.13) × 4 platforms
+      EXPECTED_WHEEL_COUNT: 11  # Linux x86 (3) + Linux ARM (3) + macOS (3) + Windows (2, no 3.14 support)
     steps:
       # https://github.com/step-security/harden-runner
       - uses: step-security/harden-runner@f4a75cfd619ee5ce8d5b864b0d183aff3c69b55a # v2.13.1
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -239,20 +239,22 @@ repos:
         entry: "isort"
         args: ["--settings-file", "pyproject.toml"]
 
-  - repo: https://github.com/PyCQA/docformatter
-    rev: v1.7.7
-    hooks:
-      - id: docformatter
-        additional_dependencies: [tomli]
-        args: [
-          "--wrap-summaries", "88",
-          "--wrap-descriptions", "88",
-          "--make-summary-multi-line",
-          "--pre-summary-newline",
-          "--blank",
-          "--recursive",
-          "--in-place",
-        ]
+  # Temporarily disabled due to untokenize incompatibility with Python 3.14
+  # - repo: https://github.com/PyCQA/docformatter
+  #   rev: v1.7.7
+  #   hooks:
+  #     - id: docformatter
+  #       language_version: python3.13  # Pin to 3.13 due to untokenize incompatibility with 3.14
+  #       additional_dependencies: [tomli]
+  #       args: [
+  #         "--wrap-summaries", "88",
+  #         "--wrap-descriptions", "88",
+  #         "--make-summary-multi-line",
+  #         "--pre-summary-newline",
+  #         "--blank",
+  #         "--recursive",
+  #         "--in-place",
+  #       ]
 
   - repo: https://github.com/pre-commit/mirrors-mypy
     rev: v1.18.2
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -123,7 +123,7 @@ chrono = { version = "0.4.42", default-features = false, features = [
   "clock",
 ] }
 chrono-tz = "0.10.4"
-clap = { version = "4.5.50", features = ["derive", "env"] }
+clap = { version = "4.5.51", features = ["derive", "env"] }
 compare = "0.1.0"
 csv = "1.4.0"
 dashmap = "6.1.0"
diff --git a/README.md b/README.md
@@ -16,9 +16,9 @@
 
 | Platform           | Rust   | Python    |
 | :----------------- | :----- | :-------- |
-| `Linux (x86_64)`   | 1.90.0 | 3.12-3.13 |
-| `Linux (ARM64)`    | 1.90.0 | 3.12-3.13 |
-| `macOS (ARM64)`    | 1.90.0 | 3.12-3.13 |
+| `Linux (x86_64)`   | 1.90.0 | 3.12-3.14 |
+| `Linux (ARM64)`    | 1.90.0 | 3.12-3.14 |
+| `macOS (ARM64)`    | 1.90.0 | 3.12-3.14 |
 | `Windows (x86_64)` | 1.90.0 | 3.12-3.13 |
 
 - **Docs**: <https://nautilustrader.io/docs/>
diff --git a/RELEASES.md b/RELEASES.md
@@ -2,7 +2,13 @@
 
 Released on TBD (UTC).
 
+This release adds support for Python 3.14 with the following limitations:
+- Windows platform: Python 3.14 not supported yet (available on Python 3.12-3.13)
+- dYdX adapter extras (`[dydx]`) unavailable due to upstream `coincurve` compatibility (available on Python 3.12-3.13)
+- Interactive Brokers adapter extras (`[ib]`) unavailable due to upstream `nautilus-ibapi` compatibility (available on Python 3.12-3.13)
+
 ### Enhancements
+- Added support for Python 3.14
 - Added initial backtest visualization tearsheets with plotly
 - Added `proxy_url` support for HTTP clients
 - Added `CAGR` portfolio statistic
@@ -16,18 +22,23 @@ Released on TBD (UTC).
 ### Breaking Changes
 - Dropped support for Python 3.11
 - Removed `use_ws_trade_api` config option from Bybit execution client (using WebSocket trade API only)
+- dYdX adapter extras (`[dydx]`) unavailable on Python 3.14 due to upstream `coincurve` compatibility (available on Python 3.12-3.13)
+- Interactive Brokers adapter extras (`[ib]`) unavailable on Python 3.14 due to upstream `nautilus-ibapi` compatibility (available on Python 3.12-3.13)
 
 ### Security
 TBD
 
 ### Fixes
-- Fixed OKX spot margin position reports for borrowing
 - Fixed spawned order client_id caching in `ExecAlgorithm`, thanks for reporting @kirill-gr1
 
 ### Internal Improvements
 - Added BitMEX submit broadcaster
+- Added non-mutating swap quote simulation for Pool tickmap profiling (#3123), thanks @filipmacek
 - Ported Bybit integration adapter to Rust
 - Refactored reading of feather files in catalog (#3114), thanks @faysou
+- Repaired OKX spot margin position reports for borrowing, thanks @sunlei
+- Repaired Bybit docs links in comment (#3125), thanks @sunlei
+- Repaired Bybit HTTP order place (#3127), thanks @sunlei
 - Upgraded implied-vol crate (#3115), thanks @faysou
 
 ### Documentation Updates
diff --git a/docs/getting_started/index.md b/docs/getting_started/index.md
@@ -2,7 +2,7 @@
 
 To get started with NautilusTrader, you will need:
 
-- A Python 3.12–3.13 environment with the `nautilus_trader` package installed.
+- A Python 3.12–3.14 environment with the `nautilus_trader` package installed.
 - A way to run Python scripts or Jupyter notebooks for backtesting and/or live trading.
 
 ## [Installation](installation.md)
diff --git a/docs/getting_started/installation.md b/docs/getting_started/installation.md
@@ -1,6 +1,6 @@
 # Installation
 
-NautilusTrader is officially supported for Python 3.12-3.13 on the following 64-bit platforms:
+NautilusTrader is officially supported for Python 3.12-3.14 on the following 64-bit platforms:
 
 | Operating System       | Supported Versions | CPU Architecture  |
 |------------------------|--------------------|-------------------|
diff --git a/nautilus_trader/model/custom.py b/nautilus_trader/model/custom.py
@@ -13,6 +13,7 @@
 #  limitations under the License.
 # -------------------------------------------------------------------------------------------------
 
+import sys
 from dataclasses import dataclass
 from typing import Any
 
@@ -85,7 +86,12 @@ def ts_init(self) -> int:
         if "to_dict" not in cls.__dict__:
 
             def to_dict(self) -> dict[str, Any]:
-                result = {attr: getattr(self, attr) for attr in self.__annotations__}
+                # Python 3.14+ uses PEP 649 lazy annotations
+                if sys.version_info >= (3, 14) and hasattr(self.__class__, "__annotate__") and self.__class__.__annotate__:
+                    annotations = self.__class__.__annotate__(1)  # 1 = eval annotations
+                else:
+                    annotations = getattr(self.__class__, "__annotations__", {})
+                result = {attr: getattr(self, attr) for attr in annotations}
 
                 if hasattr(self, "instrument_id"):
                     result["instrument_id"] = self.instrument_id.value
diff --git a/pyproject.toml b/pyproject.toml
@@ -10,6 +10,7 @@ classifiers = [
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Topic :: Software Development :: Libraries",
   "Topic :: Software Development :: Libraries :: Python Modules",
   "Topic :: Scientific/Engineering",
@@ -21,11 +22,13 @@ classifiers = [
 ]
 license = { text = "LGPL-3.0-or-later" }
 readme = "README.md"
-requires-python = ">=3.12,<3.14"
+requires-python = ">=3.12,<3.15"
 dependencies = [
   "click>=8.0.0,<9.0.0",
   "fsspec>=2025.2.0,<2026.0.0",
-  "msgspec>=0.19.0,<1.0.0",
+  "msgspec>=0.19.0,<1.0.0; python_version < '3.14'",
+  "msgspec @ git+https://github.com/jcrist/msgspec.git@0c764a6ed7c641918e66963b9a41367d288a8abe ; python_version >= '3.14' and sys_platform != 'win32'", # Temporary: waiting for 0.19.1+ release with Python 3.14 support
+  "msgspec>=0.19.0,<1.0.0; python_version >= '3.14' and sys_platform == 'win32'", # Fallback for Windows 3.14 (untested, may not work - see README)
   "numpy>=1.26.4",
   "pandas>=2.2.3,<3.0.0",
   "portion>=2.6.1",
@@ -73,16 +76,19 @@ generate-setup-file = false
 
 [project.optional-dependencies]
 betfair = ["betfair-parser==0.17.2"] # Pinned to 0.17.2 for stability
-ib = ["defusedxml>=0.7.1,<1.0.0", "nautilus-ibapi==10.30.1"]
+ib = [
+  "defusedxml>=0.7.1,<1.0.0; python_version < '3.14'",
+  "nautilus-ibapi==10.30.1; python_version < '3.14'",
+]
 docker = ["docker>=7.1.0,<8.0.0"]
 dydx = [
-  "v4-proto==7.0.5",
-  "grpcio==1.68.1",
-  "protobuf==5.29.1",
-  "bech32>=1.2.0,<2.0.0",
-  "ecdsa>=0.19.1,<1.0.0",
-  "bip-utils>=2.10.0,<3.0.0",
-  "pycryptodome>=3.20.0,<4.0.0",
+  "v4-proto==7.0.5; python_version < '3.14'",
+  "grpcio==1.68.1; python_version < '3.14'",
+  "protobuf==5.29.1; python_version < '3.14'",
+  "bech32>=1.2.0,<2.0.0; python_version < '3.14'",
+  "ecdsa>=0.19.1,<1.0.0; python_version < '3.14'",
+  "bip-utils>=2.10.0,<3.0.0; python_version < '3.14'",
+  "pycryptodome>=3.20.0,<4.0.0; python_version < '3.14'",
 ]
 polymarket = [
   "py-clob-client==0.28.0,<1.0.0", # Pinned to 0.28.0 for stability
@@ -93,7 +99,6 @@ visualization = ["plotly>=6.3.1,<7.0.0"]
 dev = [
   "cython==3.1.6",
   "setuptools>=75",
-  "docformatter>=1.7.7,<2.0.0",
   "mypy>=1.18.2,<2.0.0",
   "pandas-stubs>=2.3.2,<3.0.0",
   "pre-commit>=4.3.0,<5.0.0",
diff --git a/python/README.md b/python/README.md
@@ -48,7 +48,7 @@ All commands should be run from within this `python/` directory.
 ### Prerequisites
 
 - Rust toolchain (via `rustup`).
-- Python 3.12-3.13
+- Python 3.12-3.14
 - A virtual environment activated at the project root (e.g., `.venv`).
 - `patchelf` (Linux only) - required for setting rpath on the compiled extension. Install with `uv pip install patchelf`.
 
@@ -110,8 +110,8 @@ pip install --index-url https://packages.nautechsystems.io/v2/simple/ --pre naut
 
 | Platform         | Python  | Develop | Nightly |
 | :--------------- | :------ | :------ | :------ |
-| `Linux (x86_64)` | 3.12-13 | ✓       | ✓       |
-| `macOS (ARM64)`  | 3.12-13 | ✓       | ✓       |
+| `Linux (x86_64)` | 3.12-14 | ✓       | ✓       |
+| `macOS (ARM64)`  | 3.12-14 | ✓       | ✓       |
 
 The `--pre` flag is required because wheels are tagged as development releases (e.g., `0.2.0.dev20250601`).
 
diff --git a/python/pyproject.toml b/python/pyproject.toml
@@ -10,6 +10,7 @@ classifiers = [
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Programming Language :: Rust",
   "Topic :: Software Development :: Libraries",
   "Topic :: Scientific/Engineering",
@@ -21,7 +22,7 @@ classifiers = [
 ]
 license = { text = "LGPL-3.0-or-later" }
 readme = "../README.md"
-requires-python = ">=3.12,<3.14"
+requires-python = ">=3.12,<3.15"
 dependencies = [
   "numpy>=1.26.4",
   "pandas>=2.2.3,<3.0.0",
diff --git a/python/uv.lock b/python/uv.lock
diff --git a/tests/integration_tests/adapters/dydx/conftest.py b/tests/integration_tests/adapters/dydx/conftest.py
diff --git a/tests/integration_tests/adapters/interactive_brokers/conftest.py b/tests/integration_tests/adapters/interactive_brokers/conftest.py
diff --git a/uv-version b/uv-version
diff --git a/uv.lock b/uv.lock
