appwindows 1.2.0__tar.gz → 1.2.2__tar.gz

appwindows-1.2.2/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

appwindows-1.2.2/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

appwindows-1.2.2/.github/workflows/build.yml

@@ -0,0 +1,78 @@
+name: build
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+  workflow_dispatch:
+
+jobs:
+  build_wheels:
+    name: Build on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-22.04, windows-2019]
+      fail-fast: false
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install cibuildwheel
+        run: |
+          pip install cibuildwheel==3.3.0
+
+      - name: Set up MSVC (Windows only)
+        if: runner.os == 'Windows'
+        uses: microsoft/setup-msbuild@v1
+
+      - name: Install delvewheel (Windows only)
+        if: runner.os == 'Windows'
+        run: pip install delvewheel
+
+      - name: Build wheels
+        run: python -m cibuildwheel --output-dir wheelhouse
+        env:
+          CIBW_BUILD: "cp38-* cp39-* cp310-* cp311-* cp312-* cp313-* cp314-*"
+          CIBW_SKIP: "*-musllinux_*"
+          CIBW_ARCHS_LINUX: "x86_64"
+          CIBW_ARCHS_WINDOWS: "AMD64"
+          CIBW_MANYLINUX_X86_64_IMAGE: quay.io/pypa/manylinux2014_x86_64
+          CIBW_BEFORE_BUILD_LINUX: |
+            yum install -y \
+              libX11-devel \
+              libXext-devel \
+              libXrender-devel \
+              libXtst-devel \
+              libXi-devel \
+              libXinerama-devel \
+              libXcursor-devel \
+              libXrandr-devel \
+              libXfixes-devel \
+              libXdamage-devel \
+              libXcomposite-devel \
+              libxkbcommon-devel \
+              mesa-libGL-devel \
+              mesa-libEGL-devel \
+              libgbm-devel \
+              pkgconfig
+          CIBW_BEFORE_BUILD_WINDOWS: "pip install meson ninja pybind11"
+          CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: "delvewheel repair --wheel-dir {dest_dir} {wheel}"
+          CIBW_REPAIR_WHEEL_COMMAND_LINUX: "auditwheel repair --wheel-dir {dest_dir} {wheel}"
+          CIBW_ENVIRONMENT_WINDOWS: >
+            PYBIND11_INCLUDE="${{ github.workspace }}/pybind11/include"
+            PYBIND11_ABI=1
+
+      - name: Upload wheels as artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: ./wheelhouse/*.whl
+          retention-days: 7

appwindows-1.2.2/.github/workflows/unit_tests.yml

@@ -0,0 +1,110 @@
+name: unit_tests
+
+on:
+  workflow_run:
+    workflows: ["build"]
+    types: [completed]
+    branches: [main, master]
+
+jobs:
+  test_windows:
+    name: Test on Windows
+    runs-on: windows-2019
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Download wheels from build workflow
+        uses: dawidd6/action-download-artifact@v2
+        with:
+          workflow: build.yml
+          workflow_conclusion: success
+          name: wheels-windows-2019
+          path: ./wheelhouse
+          run_id: ${{ github.event.workflow_run.id }}
+          
+      - name: Install dependencies
+        run: |
+          pip install pytest pillow numpy
+        shell: powershell
+        
+      - name: Install wheel
+        run: |
+          $wheel = Get-ChildItem -Path "./wheelhouse/*cp313*.whl" -ErrorAction SilentlyContinue | Select-Object -First 1
+          Write-Host "Found wheel: $($wheel.FullName)"
+          pip install --force-reinstall "$($wheel.FullName)"
+        shell: powershell
+        
+      - name: Run tests
+        run: |
+          pytest tests/ -v
+        env:
+          PYTHONPATH: ${{ github.workspace }}
+        shell: powershell
+        
+  test_linux:
+    runs-on: ubuntu-22.04
+    name: Test on Linux
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    timeout-minutes: 15
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install X11 utilities
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            xvfb \
+            x11-utils \
+            xterm \
+            xdotool \
+            wmctrl \
+            zenity \
+            yad \
+        shell: bash
+
+      - name: Install Python dependencies
+        run: |
+          pip install pytest pillow numpy
+        shell: bash
+
+      - name: Download wheels
+        uses: dawidd6/action-download-artifact@v2
+        with:
+          workflow: build.yml
+          workflow_conclusion: success
+          name: wheels-ubuntu-22.04
+          path: ./wheelhouse
+          run_id: ${{ github.event.workflow_run.id }}
+
+      - name: Install wheel
+        run: |
+          wheel=$(find ./wheelhouse -name "*cp313*.whl" -print -quit)
+          pip install --force-reinstall "$wheel"
+        shell: bash
+
+      - name: Run tests with xterm windows
+        run: |
+          # Запускаем Xvfb
+          Xvfb :99 -screen 0 1024x768x24 &
+          export DISPLAY=:99
+          sleep 2
+          
+          # Запускаем тесты
+          python -m pytest tests/ -v
+        env:
+          PYTHONPATH: ${{ github.workspace }}
+          DISPLAY: ":99"
+        shell: bash

{appwindows-1.2.0 → appwindows-1.2.2}/.gitignore

@@ -4,4 +4,5 @@
 dist/
 .dist/
 test.py
-Dockerfile
+Dockerfile
+__pycache__

{appwindows-1.2.0 → appwindows-1.2.2}/PKG-INFO

@@ -1,9 +1,8 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: appwindows
-Version: 1.2.0
+Version: 1.2.2
 Summary: The appwindows library solves the problem of working with a graphical shell on different operating systems.
 Author-Email: "Terochkin A.S" <apparser.development@gmail.com>
-License-File: LICENSE.md
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: Microsoft :: Windows :: Windows 10
@@ -11,15 +10,20 @@ Classifier: Operating System :: Microsoft :: Windows :: Windows 11
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Environment :: X11 Applications
 Classifier: Environment :: Win32 (MS Windows)
+Classifier: Typing :: Stubs Only
 Project-URL: Repository, https://github.com/lexter0705/appwindows
 Project-URL: Issues, https://github.com/lexter0705/appwindows/issues
 Project-URL: Docs, https://apparser.gitbook.io/appwindows
-Requires-Python: >=3.7
+Requires-Python: >=3.8
 Requires-Dist: numpy>=2.0
 Description-Content-Type: text/markdown
 
 <img src="https://raw.githubusercontent.com/lexter0705/appwindows/refs/heads/master/appwindows.svg" alt="" width="40%" >
 
+[![Py-Pi Downloads](https://img.shields.io/pypi/dm/appwindows.svg)](https://pypi.org/project/appwindows/) [![License - BSD 3-Clause](https://img.shields.io/pypi/l/appwindows.svg)](https://github.com/lexter0705/appwindows/blob/master/LICENSE.md)
+<br>
+[![unit_tests](https://github.com/lexter0705/appwindows/actions/workflows/unit_tests.yml/badge.svg)](https://github.com/lexter0705/appwindows/actions/workflows/unit_tests.yml)
+
 # Appwindows
 The appwindows library solves the problem of working with a graphical shell on different operating systems.
 # Install
@@ -27,7 +31,8 @@ The appwindows library solves the problem of working with a graphical shell on d
 pip install appwindows
 ```
 # Docs
-All documentation <a href="https://apparser.gitbook.io/appwindows">here</a>
+All documentation <a href="https://apparser.gitbook.io/appwindows">here</a> <br>
+Link to <a href="https://pypi.org/project/appwindows/">PyPi</a>
 # For Developers
 1) If something doesn't work - open issue.
 2) If you want something fixed - open issue.

{appwindows-1.2.0 → appwindows-1.2.2}/README.md

@@ -1,5 +1,9 @@
 <img src="https://raw.githubusercontent.com/lexter0705/appwindows/refs/heads/master/appwindows.svg" alt="" width="40%" >
 
+[![Py-Pi Downloads](https://img.shields.io/pypi/dm/appwindows.svg)](https://pypi.org/project/appwindows/) [![License - BSD 3-Clause](https://img.shields.io/pypi/l/appwindows.svg)](https://github.com/lexter0705/appwindows/blob/master/LICENSE.md)
+<br>
+[![unit_tests](https://github.com/lexter0705/appwindows/actions/workflows/unit_tests.yml/badge.svg)](https://github.com/lexter0705/appwindows/actions/workflows/unit_tests.yml)
+
 # Appwindows
 The appwindows library solves the problem of working with a graphical shell on different operating systems.
 # Install
@@ -7,7 +11,8 @@ The appwindows library solves the problem of working with a graphical shell on d
 pip install appwindows
 ```
 # Docs
-All documentation <a href="https://apparser.gitbook.io/appwindows">here</a>
+All documentation <a href="https://apparser.gitbook.io/appwindows">here</a> <br>
+Link to <a href="https://pypi.org/project/appwindows/">PyPi</a>
 # For Developers
 1) If something doesn't work - open issue.
 2) If you want something fixed - open issue.

appwindows-1.2.2/lib/__init__.pyi

@@ -0,0 +1,192 @@
+"""
+Python bindings for appwindows library
+
+The appwindows library solves the problem of working with a graphical shell on different operating systems.
+"""
+from __future__ import annotations
+import numpy
+import numpy.typing
+import typing
+from . import exceptions
+from . import geometry
+__all__: list[str] = ['Finder', 'Window', 'exceptions', 'geometry', 'get_finder']
+class Finder:
+    """
+    Interface for finding application windows
+    """
+    def get_all_titles(self) -> list[str]:
+        """
+        Get all window titles
+        
+        Returns:
+            list[str]: Found titles
+        """
+    def get_all_windows(self) -> list[Window]:
+        """
+        Find all opened windows
+        
+        Returns:
+            list[Window]: Found windows
+        """
+    def get_os(self) -> str:
+        """
+        Get os and graphical shell
+        
+        Returns:
+            str: your <<os>>::<<graphical shell>>
+        """
+    def get_window_by_process_id(self, process_id: typing.SupportsInt) -> Window:
+        """
+        Find window by process id
+        
+        Args:
+            process_id (int): Window title to search for
+        
+        Returns:
+            Window | None: Found window or null if window does not exist
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotFoundxception: If window is not found
+        """
+    def get_window_by_title(self, title: str) -> Window:
+        """
+        Find window by its title substring
+        
+        Args:
+            title (str): Window title to search for
+        
+        Returns:
+            Window: Found window
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotFoundxception: If window is not found
+        """
+class Window:
+    """
+    Interface representing an application window
+    """
+    def close(self) -> None:
+        """
+        Close the window
+        """
+    def get_points(self) -> geometry.QuadPoints:
+        """
+        Get all points associated with the window
+        
+        Returns:
+            appwindows.geometry.QuadPoints: QuadPoints object with all points
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotValidException: If window is invalid
+        """
+    def get_process_id(self) -> int:
+        """
+        Get the window process id
+        
+        Returns:
+            int: process id
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotValidException: If window is invalid
+        """
+    def get_screenshot(self) -> numpy.typing.NDArray[numpy.uint8]:
+        """
+        Get current window image
+        
+        Returns:
+            ndarray: image in ndarray
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotValidException: If window is invalid
+        """
+    def get_size(self) -> geometry.Size:
+        """
+        Get current window size
+        
+        Returns:
+            Size: Current window dimensions
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotValidException: If window is invalid
+        """
+    def get_title(self) -> str:
+        """
+        Get the window title
+        
+        Returns:
+            str: Window title
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotValidException: If window is invalid
+        """
+    def is_valid(self) -> bool:
+        """
+        Is window valid
+        
+        Returns:
+            bool: is valid
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotValidException: If window is invalid
+        """
+    def move(self, point: geometry.Point) -> None:
+        """
+        Move window to specified position
+        
+        Args:
+            point (appwindows.geometry.Point): New window position
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotValidException: If window is invalid
+        """
+    def resize(self, size: geometry.Size) -> None:
+        """
+        Resize the window
+        
+        Args:
+            size (appwindows.geometry.Size): New window dimensions
+        
+        Raises:
+            appwindows.exceptions.InvalidSizeError: If size is invalid    appwindows.exceptions.WindowDoesNotValidException: If window is invalid
+        """
+    def set_fullscreen(self, is_maximize: bool) -> None:
+        """
+        Maximize or restore the window
+        
+        Args:
+            is_fullscreen (bool): True to window on fullscreen
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotValidException: If window is invalid
+        """
+    def set_minimize(self, is_minimize: bool) -> None:
+        """
+        Set window active state
+        
+        Args:
+            is_minimize (bool): True to activate window
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotValidException: If window is invalid
+        """
+    def to_background(self) -> None:
+        """
+        Moved window to background
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotValidException: If window is invalid
+        """
+    def to_foreground(self) -> None:
+        """
+        Moved window to foreground
+        
+        Raises:
+            appwindows.exceptions.WindowDoesNotValidException: If window is invalid
+        """
+def get_finder() -> Finder:
+    """
+    Get the window finder instance
+    
+    Returns:
+        Finder: Instance of window finder interface
+    """

appwindows-1.2.2/lib/exceptions/__init__.pyi

@@ -0,0 +1,11 @@
+"""
+exception classes
+"""
+from __future__ import annotations
+__all__: list[str] = ['InvalidSizeException', 'WindowDoesNotFoundException', 'WindowDoesNotValidException']
+class InvalidSizeException(Exception):
+    pass
+class WindowDoesNotFoundException(Exception):
+    pass
+class WindowDoesNotValidException(Exception):
+    pass

appwindows-1.2.2/lib/geometry/__init__.pyi

@@ -0,0 +1,151 @@
+"""
+classes for work with geometry
+"""
+from __future__ import annotations
+import typing
+
+__all__: list[str] = ['Point', 'QuadPoints', 'Size']
+
+
+class Point:
+    """
+    Represents a 2D point with x and y coordinates
+    """
+    __hash__: typing.ClassVar[None] = None
+
+    def __add__(self, arg0: Point) -> Point:
+        """
+        Add two points
+        """
+
+    def __eq__(self, arg0: Point) -> bool:
+        """
+        Points is equal
+        """
+
+    def __init__(self, x: typing.SupportsInt, y: typing.SupportsInt) -> None:
+        """
+        Create a point with specified coordinates
+        
+        Args:
+            x (int): X coordinate
+            y (int): Y coordinate
+        """
+
+    def __mul__(self, arg0: Point) -> Point:
+        """
+        Multiply two points
+        """
+
+    def __sub__(self, arg0: Point) -> Point:
+        """
+        Subtract two points
+        """
+
+    def __truediv__(self, arg0: Point) -> Point:
+        """
+        Divide two points
+        """
+
+    def __str__(self) -> str:
+        """
+        To string
+        """
+
+    @property
+    def x(self) -> int:
+        """
+        X coordinate
+        """
+
+    @property
+    def y(self) -> int:
+        """
+        Y coordinate
+        """
+
+
+class QuadPoints:
+    """
+    Vertices of a quadrilateral
+    """
+
+    def __init__(self, left_top: Point, right_top: Point, right_bottom: Point, left_bottom: Point) -> None:
+        """
+        QuadPoints constructor
+        
+        Args:
+            left_top (appwindows.geometry.Point): left top point
+            right_top (appwindows.geometry.Point): right top point
+            right_bottom (appwindows.geometry.Point): right bottom point
+            left_bottom (appwindows.geometry.Point): left bottom point
+        """
+
+    def __str__(self) -> str:
+        """
+        To string
+        """
+
+    @property
+    def left_bottom(self) -> Point:
+        """
+        Left bottom point
+        """
+
+    @property
+    def left_top(self) -> Point:
+        """
+        Left top point
+        """
+
+    @property
+    def right_bottom(self) -> Point:
+        """
+        Right bottom point
+        """
+
+    @property
+    def right_top(self) -> Point:
+        """
+        Right top point
+        """
+
+
+class Size:
+    """
+    Represents dimensions with width and height
+    """
+
+    def __init__(self, width: typing.SupportsInt, height: typing.SupportsInt) -> None:
+        """
+        Create size with specified dimensions
+        
+        Args:
+            width (int): Width dimension
+            height (int): Height dimension
+        
+        Raises:
+            InvalidSizeError: If width or height are invalid
+        """
+
+    def __str__(self) -> str:
+        """
+        To string
+        """
+
+    def __eq__(self, arg0: Point) -> bool:
+        """
+        Points is equal
+        """
+
+    @property
+    def height(self) -> int:
+        """
+        Height dimension
+        """
+
+    @property
+    def width(self) -> int:
+        """
+        Width dimension
+        """