Merge branch 'master' of https://github.com/Kalmat/PyWinBox into Manual-ruff-fixes

Author: Avasam

.github/workflows/ci.yml

@@ -65,22 +65,26 @@ jobs:
       fail-fast: false
     steps:
       - uses: actions/checkout@v6
-      # - name: Install Linux Packages
-      #   if: ${{ startsWith(matrix.os, 'ubuntu') }}
-      #   run: |
-      #     sudo apt update
-      #     sudo apt install gedit xvfb x11-xserver-utils openbox dbus-x11
+      - name: Install Linux Packages
+        if: ${{ startsWith(matrix.os, 'ubuntu') }}
+        run: |
+          sudo apt update
+          # xvfb+openbox: headless X server and WM
+          # gedit: the test window (not preinstalled on GitHub runners)
+          # x11-xserver-utils (xrandr/xset): required by tests for window geometry
+          # dbus-x11: dbus-launch, so the GTK app (gedit) gets a session bus
+          sudo apt install -y xvfb openbox gedit x11-xserver-utils dbus-x11
       - uses: astral-sh/setup-uv@v8.2.0
         with:
           python-version: ${{ matrix.python-version }}
           activate-environment: true
       - run: uv sync --locked
-      # - name: Run tests (Linux)
-      #   if: ${{ startsWith(matrix.os, 'ubuntu') }}
-      #   working-directory: tests
-      #   run: xvfb-run --server-args="-screen 0 1280x1024x24" bash -c "openbox & sleep 1 && dbus-launch --exit-with-session python test_pywinbox.py"
-      - name: Run tests # (Windows & macOS)
-        # if: ${{ !startsWith(matrix.os, 'ubuntu') }}
+      - name: Run tests (Linux)
+        if: ${{ startsWith(matrix.os, 'ubuntu') }}
+        working-directory: tests
+        run: xvfb-run --server-args="-screen 0 1280x1024x24" bash -c "openbox & sleep 1 && dbus-launch --exit-with-session python test_pywinbox.py"
+      - name: Run tests (Windows & macOS)
+        if: ${{ !startsWith(matrix.os, 'ubuntu') }}
         working-directory: tests
         run: python test_pywinbox.py
       - name: Run tests (MacNSBox)

CHANGES.txt

@@ -1,8 +1,11 @@
-0.8, 2026/XX/XX -- ALL: Removed unused dependency on `typing_extensions`
-                   WIN32: Replaced bare `except:` clauses with `except Exception:`, preventing accidental suppression of system-exit signals (KeyboardInterrupt, SystemExit) during error handling.
+0.8, 2026/XX/XX -- WIN32: Replaced bare `except (thanks to Avasam):` clauses with `except Exception:`, preventing accidental suppression of system-exit signals (KeyboardInterrupt, SystemExit) during error handling.
+                   ALL: Removed unused dependency on `typing_extensions` (thanks to Avasam - https://github.com/Avasam)
+                   ALL: Deprecated PyWinBox class in favor of WindowBox (window areas) and ScreenBox (screen areas)
+                   ALL: Added general functions: collidepoint, collidebox, contains, clip, union
+                   ALL: Added class methods: collidepoint, collidebox, contains, clip, union, move, inflate, clamp, isclamped, unclamp, fit
 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
+                   WIN32: Fixed GetAwarenessFromDpiAwarenessContext not supported on Windows Server (thanks to popoiPIO - https://github.com/poipoiPIO)
 0.5, 2023/09/06 -- MACOS: Tested OK in multi-monitor setup
 0.4, 2023/08/25 -- Reorganized to avoid IDEs showing external and / or private elements
 0.3, 2023/08/21 -- Linux: Improved window geometry (thanks to elraymond - https://github.com/elraymond)

README.md

@@ -0,0 +1 @@
+- Handle multi-monitor box

TODO.txt

@@ -11,8 +11,8 @@ 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"
+version = "0.8"
+description = "Cross-platform Python module to manage window and rectangular screen areas — with full property access, live callbacks, and multi-monitor support."
 authors = [{ name = "Kalmat", email = "palookjones@gmail.com" }]
 readme = "README.md"
 license = "BSD-3-Clause"

pyproject.toml

@@ -1,10 +1,15 @@
 #!/usr/bin/python
 from importlib.metadata import version as _importlib_version
 
-from ._main import Box, Rect, Point, Size, pointInBox, PyWinBox
+from ._main import (Box, Rect, Point, Size,
+                    PyWinBox, WindowBox, ScreenBox,
+                    pointInBox, collidepoint, collidebox, contains, clip, union)
 
 __all__ = [
-    "version", "PyWinBox", "Box", "Rect", "Point", "Size", "pointInBox"
+    "version",
+    "Box", "Rect", "Point", "Size",
+    "PyWinBox", "WindowBox", "ScreenBox",
+    "pointInBox", "collidepoint", "collidebox", "contains", "clip", "union"
 ]
 
 __version__ = _importlib_version("pywinctl")