Add uv support and update to python 3.11 minimum

Constructed to support both poetry and uv at the same time currently.

Fixes #204

Author: mattsta

.github/workflows/test.yml

@@ -1,14 +1,15 @@
 name: ib_async
 
-on: [ push, pull_request ]
+on: [push, pull_request]
 
 jobs:
-  build:
-    # https://github.com/actions/runner-images
+  build-poetry:
+    name: poetry (${{ matrix.python-version }})
     runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
-        python-version: [ "3.10", "3.11", "3.12", "3.13", "3.14", "pypy3.10", "pypy3.11" ]
+        python-version: ["3.11", "3.12", "3.13", "3.14", "pypy3.11"]
 
     steps:
       - uses: actions/checkout@v4
@@ -18,11 +19,11 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
-      - name: Install dependencies of dependencies
+      - name: Install Poetry toolchain
         run: |
-          pip install pip poetry uv setuptools wheel -U
+          pip install pip poetry setuptools wheel -U
 
-      - name: Install dependencies
+      - name: Install dependencies with Poetry
         run: |
           poetry install --with=dev
 
@@ -34,3 +35,36 @@ jobs:
       - name: Ruff check
         run: |
           poetry run ruff check
+
+  build-uv:
+    name: uv (${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14", "pypy3.11"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv toolchain
+        run: |
+          pip install pip uv setuptools wheel -U
+
+      - name: Install dependencies with uv
+        run: |
+          uv sync --group dev
+
+      - name: MyPy static code analysis
+        if: ${{ !startsWith(matrix.python-version, 'pypy') }}
+        run: |
+          uv run mypy --pretty ib_async
+
+      - name: Ruff check
+        run: |
+          uv run ruff check

README.md

@@ -1,4 +1,4 @@
-[![Build](https://github.com/ib-api-reloaded/ib_async/actions/workflows/test.yml/badge.svg?branch=next)](https://github.com/ib-api-reloaded/ib_async/actions) [![PyVersion](https://img.shields.io/badge/python-3.10+-blue.svg)](#) <!-- [![Status](https://img.shields.io/badge/status-beta-green.svg)](#) --> [![PyPiVersion](https://img.shields.io/pypi/v/ib_async.svg)](https://pypi.python.org/pypi/ib_async) [![License](https://img.shields.io/badge/license-BSD-blue.svg)](#) <!-- [![Downloads](https://static.pepy.tech/badge/ib-insync)](https://pepy.tech/project/ib-insync) --> [![Docs](https://img.shields.io/badge/Documentation-green.svg)](https://ib-api-reloaded.github.io/ib_async/)
+[![Build](https://github.com/ib-api-reloaded/ib_async/actions/workflows/test.yml/badge.svg?branch=next)](https://github.com/ib-api-reloaded/ib_async/actions) [![PyVersion](https://img.shields.io/badge/python-3.11+-blue.svg)](#) <!-- [![Status](https://img.shields.io/badge/status-beta-green.svg)](#) --> [![PyPiVersion](https://img.shields.io/pypi/v/ib_async.svg)](https://pypi.python.org/pypi/ib_async) [![License](https://img.shields.io/badge/license-BSD-blue.svg)](#) <!-- [![Downloads](https://static.pepy.tech/badge/ib-insync)](https://pepy.tech/project/ib-insync) --> [![Docs](https://img.shields.io/badge/Documentation-green.svg)](https://ib-api-reloaded.github.io/ib_async/)
 
 # ib_async
 
@@ -32,13 +32,29 @@ and the [API docs](https://ib-api-reloaded.github.io/ib_async/api.html).
 
 ## Installation
 
+`ib_async` now targets Python 3.11+ and publishes standard PEP 621 metadata, so the project installs cleanly with `pip`, `uv`, and `poetry`.
+
+### Install with pip
+
 ```
 pip install ib_async
 ```
 
+### Install with uv
+
+```
+uv add ib_async
+```
+
+### Install with poetry
+
+```
+poetry add ib_async
+```
+
 Requirements:
 
-- Python 3.10 or higher
+- Python 3.11 or higher
   - We plan to support Python releases [2 years back](https://devguide.python.org/versions/) which allows us to continue adding newer features and performance improvements over time.
 - A running IB Gateway application (or TWS with API mode enabled)
     - [stable gateway](https://www.interactivebrokers.com/en/trading/ibgateway-stable.php) — updated every few months
@@ -50,41 +66,59 @@ The ibapi package from IB is not needed. `ib_async` implements the full IBKR API
 
 ## Build Manually
 
-First, install poetry:
+First, install your preferred environment manager:
 
 ```
 pip install poetry -U
 ```
 
-### Installing Only Library
+or:
+
+```
+pip install uv -U
+```
+
+### Install the project with poetry
 
 ```
 poetry install
 ```
 
-### Install Everything (enable docs + dev testing)
+### Install the project with uv
 
 ```
+uv sync
+```
+
+### Install everything for development and docs
+
+```bash
 poetry install --with=docs,dev
+uv sync --group dev --group docs
 ```
 
 ## Generate Docs
 
-```
+```bash
 poetry install --with=docs
 poetry run sphinx-build -b html docs html
+
+uv sync --group docs
+uv run sphinx-build -b html docs html
 ```
 
 ## Check Types
 
-```
+```bash
 poetry run mypy ib_async
+uv run mypy ib_async
 ```
 
 ## Build Package
 
-```
+```bash
 poetry build
+python -m build
 ```
 
 ## Upload Package (if maintaining)
@@ -481,19 +515,26 @@ The complete [API documentation](https://ib-api-reloaded.github.io/ib_async/api.
 ```bash
 poetry install --with=dev
 poetry run pytest
+
+uv sync --group dev
+uv run pytest
 ```
 
 ### Type Checking
 
 ```bash
 poetry run mypy ib_async
+uv run mypy ib_async
 ```
 
 ### Code Formatting
 
 ```bash
 poetry run ruff format
 poetry run ruff check --fix
+
+uv run ruff format
+uv run ruff check --fix
 ```
 
 ### Local Development
@@ -507,6 +548,7 @@ cd ib_async
 2. Install dependencies:
 ```bash
 poetry install --with=dev,docs
+uv sync --group dev --group docs
 ```
 
 3. Make your changes and run tests:

ib_async/ib.py

@@ -457,7 +457,7 @@ def waitOnUpdate(self, timeout: float = 0) -> bool:
         if timeout:
             try:
                 util.run(asyncio.wait_for(self.updateEvent, timeout))
-            except asyncio.TimeoutError:
+            except TimeoutError:
                 return False
         else:
             util.run(self.updateEvent)
@@ -2096,7 +2096,7 @@ async def connectAsync(
             if fetchFields & StartupFetch.EXECUTIONS:
                 try:
                     await asyncio.wait_for(self.reqExecutionsAsync(), timeout)
-                except asyncio.TimeoutError:
+                except TimeoutError:
                     msg = "executions request timed out"
                     errors.append(msg)
                     self._logger.error(msg)
@@ -2315,7 +2315,7 @@ async def reqMatchingSymbolsAsync(
         try:
             await asyncio.wait_for(future, 4)
             return future.result()
-        except asyncio.TimeoutError:
+        except TimeoutError:
             self._logger.error("reqMatchingSymbolsAsync: Timeout")
             return None
 
@@ -2327,7 +2327,7 @@ async def reqMarketRuleAsync(
             self.client.reqMarketRule(marketRuleId)
             await asyncio.wait_for(future, 1)
             return future.result()
-        except asyncio.TimeoutError:
+        except TimeoutError:
             self._logger.error("reqMarketRuleAsync: Timeout")
             return None
 
@@ -2375,7 +2375,7 @@ async def reqHistoricalDataAsync(
         task = asyncio.wait_for(future, timeout) if timeout else future
         try:
             await task
-        except asyncio.TimeoutError:
+        except TimeoutError:
             self.client.cancelHistoricalData(reqId)
             self._logger.warning(f"reqHistoricalData: Timeout for {contract}")
             bars.clear()
@@ -2520,7 +2520,7 @@ async def calculateImpliedVolatilityAsync(
         try:
             await asyncio.wait_for(future, 4)
             return future.result()
-        except asyncio.TimeoutError:
+        except TimeoutError:
             self._logger.error("calculateImpliedVolatilityAsync: Timeout")
             return None
         finally:
@@ -2541,7 +2541,7 @@ async def calculateOptionPriceAsync(
         try:
             await asyncio.wait_for(future, 4)
             return future.result()
-        except asyncio.TimeoutError:
+        except TimeoutError:
             self._logger.error("calculateOptionPriceAsync: Timeout")
             return None
         finally:
@@ -2596,7 +2596,7 @@ async def reqHistoricalNewsAsync(
         try:
             await asyncio.wait_for(future, 4)
             return future.result()
-        except asyncio.TimeoutError:
+        except TimeoutError:
             self._logger.error("reqHistoricalNewsAsync: Timeout")
             return None
 
@@ -2606,7 +2606,7 @@ async def requestFAAsync(self, faDataType: int):
         try:
             await asyncio.wait_for(future, 4)
             return future.result()
-        except asyncio.TimeoutError:
+        except TimeoutError:
             self._logger.error("requestFAAsync: Timeout")
 
     async def getWshMetaDataAsync(self) -> str:

ib_async/objects.py

@@ -3,8 +3,8 @@
 from __future__ import annotations
 
 from dataclasses import dataclass, field
+from datetime import UTC, datetime, tzinfo
 from datetime import date as date_
-from datetime import datetime, timezone, tzinfo
 from typing import Any, NamedTuple
 
 from eventkit import Event
@@ -591,4 +591,4 @@ class IBDefaults:
     unset: Any = nan
 
     # optionally change the timezone used for log history events in objects (no impact on orders or data processing)
-    timezone: tzinfo = timezone.utc
+    timezone: tzinfo = UTC

ib_async/util.py

@@ -23,7 +23,7 @@
 Event to emit global exceptions.
 """
 
-EPOCH: Final = dt.datetime(1970, 1, 1, tzinfo=dt.timezone.utc)
+EPOCH: Final = dt.datetime(1970, 1, 1, tzinfo=dt.UTC)
 UNSET_INTEGER: Final = 2**31 - 1
 UNSET_DOUBLE: Final = sys.float_info.max
 
@@ -421,7 +421,7 @@ def timeRange(start: Time_t, end: Time_t, step: float) -> Iterator[dt.datetime]:
     assert step > 0
     delta = dt.timedelta(seconds=step)
     t = _fillDate(start)
-    tz = dt.timezone.utc if t.tzinfo else None
+    tz = dt.UTC if t.tzinfo else None
     now = dt.datetime.now(tz)
     while t < now:
         t += delta
@@ -454,7 +454,7 @@ async def timeRangeAsync(
 
     delta = dt.timedelta(seconds=step)
     t = _fillDate(start)
-    tz = dt.timezone.utc if t.tzinfo else None
+    tz = dt.UTC if t.tzinfo else None
     now = dt.datetime.now(tz)
     while t < now:
         t += delta
@@ -577,11 +577,11 @@ def formatIBDatetime(t: dt.date | dt.datetime | str | None) -> str:
         s = ""
     elif isinstance(t, dt.datetime):
         # convert to UTC timezone
-        t = t.astimezone(tz=dt.timezone.utc)
+        t = t.astimezone(tz=dt.UTC)
         s = t.strftime("%Y%m%d %H:%M:%S UTC")
     elif isinstance(t, dt.date):
         t = dt.datetime(t.year, t.month, t.day, 23, 59, 59).astimezone(
-            tz=dt.timezone.utc
+            tz=dt.UTC
         )
         s = t.strftime("%Y%m%d %H:%M:%S UTC")
     else:
@@ -599,7 +599,7 @@ def parseIBDatetime(s: str) -> dt.date | dt.datetime:
         d = int(s[6:8])
         t = dt.date(y, m, d)
     elif s.isdigit():
-        t = dt.datetime.fromtimestamp(int(s), dt.timezone.utc)
+        t = dt.datetime.fromtimestamp(int(s), dt.UTC)
     elif s.count(" ") >= 2 and "  " not in s:
         # 20221125 10:00:00 Europe/Amsterdam
         s0, s1, s2 = s.split(" ", 2)