Modernize project setup + Removed unused dependency on typing_extensions

.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - master
+    paths:
+      - ".github/workflows/ci.yml"
+      - "pyproject.toml"
+      - "mypy.ini"
+      - "**/*.py"
+  pull_request:
+    paths:
+      - ".github/workflows/ci.yml"
+      - "pyproject.toml"
+      - "mypy.ini"
+      - "**/*.py"
+
+concurrency:
+  # Cancel previous runs for the same PR
+  # Don't cancel successive pushes to master
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  mypy:
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: &timeout-minutes 5
+    strategy:
+      # mypy is os and python-version sensitive. Test on all supported combinations
+      matrix:
+        # Arm runners are faster (as long as the same wheels are available)
+        os: [windows-11-arm, ubuntu-24.04-arm, macos-latest]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v8.2.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          activate-environment: true
+      - run: uv sync --locked
+      - run: mypy . --python-version=${{ matrix.python-version }}

.readthedocs.yaml

@@ -6,9 +6,9 @@ version: 2
 
 # Set the OS, Python version and other tools you might need
 build:
-  os: ubuntu-22.04
+  os: ubuntu-24.04 # Keep in sync with runs-on in .github/workflows/ci.yml
   tools:
-    python: "3.11"
+    python: "3.14" # Keep in sync with python-version in .github/workflows/ci.yml
     # You can also specify other tool versions:
     # nodejs: "20"
     # rust: "1.70"
@@ -32,4 +32,8 @@ sphinx:
 # See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
 python:
   install:
-    - requirements: requirements.txt
+    # https://docs.readthedocs.com/platform/latest/build-customization.html#install-dependencies-with-uv
+    - method: uv
+      command: sync
+      groups:
+        - docs

AUTHORS.txt

@@ -4,4 +4,5 @@ Kalmat https://github.com/Kalmat
 elraymond (https://github.com/elraymond)
 Leonard Bruns https://github.com/roym899
 lappely - https://github.com/poipoiPIO
+Avasam - https://github.com/Avasam
 

CHANGES.txt

@@ -1,3 +1,4 @@
+0.8, 2026/XX/XX -- ALL: Removed unused dependency on `typing_extensions`
 0.7, 2024/03/22 -- LINUX: Added ewmhlib as separate module. (Really) Fixed position and size for GNOME (by using GTK_EXTENTS)
 0.6, 2023/10/12 -- LINUX: Improved position and size for GNOME (by using GTK_EXTENTS)
                    WIN32: Fixed GetAwarenessFromDpiAwarenessContext not supported on Windows Server

README.md

@@ -1,6 +1,6 @@
 # PyWinBox
 
-[![Type Checking](https://github.com/Kalmat/PyWinBox/actions/workflows/type-checking.yml/badge.svg)](https://github.com/Kalmat/PyWinBox/actions/workflows/type-checking.yml)
+[![CI](https://github.com/Kalmat/PyWinBox/actions/workflows/ci.yml/badge.svg)](https://github.com/Kalmat/PyWinBox/actions/workflows/ci.yml)
 [![PyPI version](https://badge.fury.io/py/PyWinBox.svg)](https://badge.fury.io/py/PyWinBox)
 
 
@@ -85,17 +85,17 @@ These are useful data structs (named tuples, actually) you can use to better man
 
 ## INSTALL <a name="install"></a>
 
-To install this module on your system, you can use pip: 
+To install this module on your system, you can use pip:
 
-    pip3 install pywinbox
+    python -m pip install pywinbox
 
-or
+or using uv:
 
-    python3 -m pip install pywinbox
+    uv add pywinbox
 
 Alternatively, you can download the wheel file (.whl) available in the [Download page](https://pypi.org/project/PyWinBox/#files) and the [dist folder](https://github.com/Kalmat/PyWinBox/tree/master/dist), and run this (don't forget to replace 'x.x.xx' with proper version number):
 
-    pip install PyWinBox-x.x.xx-py3-none-any.whl
+    python -m pip install PyWinBox-x.x.xx-py3-none-any.whl
 
 You may want to add `--force-reinstall` option to be sure you are installing the right dependencies version.
 
@@ -114,14 +114,20 @@ If you want to use this code or contribute, you can either:
 * Create a fork of the [repository](https://github.com/Kalmat/PyWinBox), or 
 * [Download the repository](https://github.com/Kalmat/PyWinBox/archive/refs/heads/master.zip), uncompress, and open it on your IDE of choice (e.g. PyCharm)
 
-Be sure you install all dependencies described on "requirements.txt" by using pip
+Be sure you install all dev dependencies by running:
+
+    uv sync
+
+or
+    python -m venv .venv
+    python -m pip install -e . --group=dev
 
 ## TEST <a name="test"></a>
 
 To test this module on your own system, cd to "tests" folder and run:
 
-    python3 test_pywinbox.py
+    uv run test_pywinbox.py
 
 For macOS NSWindow, you can also test using:
 
-    python3 test_MacNSBox.py
+    uv run test_MacNSBox.py

mypy.ini

@@ -0,0 +1,21 @@
+[mypy]
+mypy_path = src/, typings/
+exclude = build/, dist/
+strict = True
+
+# Leverage type inference for function return type
+disallow_untyped_calls = False
+disallow_incomplete_defs = False
+disallow_untyped_defs = False
+
+disable_error_code =
+  # https://github.com/python/mypy/issues/6232 (redefinition with correct type)
+  attr-defined, assignment,
+
+# https://github.com/ronaldoussoren/pyobjc/issues/198
+# https://github.com/ronaldoussoren/pyobjc/issues/417
+# https://github.com/ronaldoussoren/pyobjc/issues/419
+[mypy-objc.*]
+follow_untyped_imports = True
+[mypy-Quartz.*]
+allow_any_generics = True

pyproject.toml

@@ -0,0 +1,86 @@
+[build-system]
+requires = ["uv_build>=0.11.21,<0.12"]
+build-backend = "uv_build"
+
+[project.urls]
+Homepage = "https://github.com/Kalmat/PyWinBox"
+Repository = "https://github.com/Kalmat/PyWinBox.git"
+Issues = "https://github.com/Kalmat/PyWinBox/issues"
+Changelog = "https://github.com/Kalmat/PyWinBox/blob/HEAD/CHANGES.txt"
+Documentation = "https://pywinbox.readthedocs.io/"
+
+[project]
+name = "PyWinBox"
+version = "0.7"
+description = "Cross-Platform and multi-monitor toolkit to handle rectangular areas and windows box"
+authors = [{ name = "Kalmat", email = "palookjones@gmail.com" }]
+readme = "README.md"
+license = "BSD-3-Clause"
+license-files = ["LICENSE.txt"]
+requires-python = ">=3.9"
+keywords = [
+    "left",
+    "top",
+    "right",
+    "bottom",
+    "size",
+    "width",
+    "height",
+    "topleft",
+    "bottomleft",
+    "topright",
+    "bottomright",
+    "midtop",
+    "midleft",
+    "midbottom",
+    "midright",
+    "center",
+    "centerx",
+    "centery",
+    "box",
+    "rect",
+    "boundingbox",
+    "area",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Win32 (MS Windows)",
+    "Environment :: X11 Applications",
+    "Environment :: MacOS X",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: BSD License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+    "pywin32>=302; sys_platform == 'win32'",
+    "python-xlib>=0.21; sys_platform == 'linux'",
+    "ewmhlib>=0.1; sys_platform == 'linux'",
+    "pyobjc>=8.1; sys_platform == 'darwin'",
+]
+
+[dependency-groups]
+docs = ["myst-parser"]
+dev = [
+    { include-group = "docs" },
+    "ewmhlib",
+    "pywinctl>=0.3",
+    "mypy>=0.990,<2",
+    "types-python-xlib>=0.32",
+    "types-pywin32>=305.0.0.3",
+]
+
+[tool.uv]
+exclude-newer = "1 week"
+[tool.uv.exclude-newer-package]
+# Kalmat owns these packages
+ewmhlib = false
+pywinctl = false

src/pywinbox/__init__.py

@@ -1,11 +1,12 @@
 #!/usr/bin/python
 # -*- coding: utf-8 -*-
+from importlib.metadata import version as _importlib_version
 
 __all__ = [
     "version", "PyWinBox", "Box", "Rect", "Point", "Size", "pointInBox"
 ]
 
-__version__ = "0.7"
+__version__ = _importlib_version("pywinctl")
 
 
 def version(numberOnly: bool = True) -> str:

typings/Quartz/CoreGraphics/__init__.pyi

@@ -1,4 +1,3 @@
-# pyright: reportUnknownParameterType=false, reportMissingParameterType=false, reportMissingTypeArgument=false
 from typing import Any
 
 CFArrayCreate: Any

typings/Quartz/CoreVideo/__init__.pyi

@@ -1,4 +1,3 @@
-# pyright: reportUnknownParameterType=false, reportMissingParameterType=false, reportMissingTypeArgument=false
 from typing import Any
 
 CFArrayCreate: Any