williampy 0.0.1__tar.gz

williampy-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MrCoolGuy640
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

williampy-0.0.1/MANIFEST.in

@@ -0,0 +1,28 @@
+# Include necessary files
+include README.md
+include LICENSE
+recursive-include william *.py
+
+# Exclude development/test files
+recursive-exclude tests *
+recursive-exclude examples *
+recursive-exclude william __pycache__
+recursive-exclude william *.pyc
+recursive-exclude william *.pyo
+recursive-exclude william *.pyd
+
+# Exclude environment/config files
+exclude .env
+exclude .env.*
+exclude *.env
+exclude .private
+exclude .private/*
+exclude *.private
+exclude .secrets
+exclude .secrets/*
+exclude .git*
+exclude .vscode
+exclude .idea
+exclude build.bat
+exclude upload_to_pypi.bat
+exclude upload_to_pypi.py

williampy-0.0.1/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: williampy
+Version: 0.0.1
+Summary: neat python package to do many miscellaneous but helpful things
+Author: MrCoolGuy640
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# William
+![PyPI](https://img.shields.io/pypi/v/williampy)
+

williampy-0.0.1/README.md

@@ -0,0 +1,3 @@
+# William
+![PyPI](https://img.shields.io/pypi/v/williampy)
+

williampy-0.0.1/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "williampy"
+version = "0.0.1"
+description = "neat python package to do many miscellaneous but helpful things"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    { name = "MrCoolGuy640" }
+]
+
+# No runtime dependencies
+dependencies = []
+
+[tool.setuptools]
+packages = ["william"]
+include-package-data = true
+
+[tool.setuptools.package-data]
+"*" = ["*.txt", "*.md"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+
+[tool.black]
+line-length = 100
+target-version = ['py38']
+
+[tool.flake8]
+max-line-length = 100
+exclude = [".git", "__pycache__", "venv", "build", "dist", ".env", "upload_to_pypi.bat", "upload_to_pypi.py"]

williampy-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

williampy-0.0.1/william/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.1"

williampy-0.0.1/william/image/__init__.py

@@ -0,0 +1,3 @@
+from .image import Image
+
+__all__ = ["Image"]

williampy-0.0.1/william/image/image.py

@@ -0,0 +1,67 @@
+from pathlib import Path
+import numpy as np
+import cv2
+
+
+class Image:
+    def __init__(self, data: np.ndarray):
+        self.data = data
+
+    @classmethod
+    def from_file(cls, path) -> "Image":
+        """
+        Load image from file.
+        Supports str, Path, or any path-like object.
+        """
+
+        path = Path(path) # supports path or str
+
+        data = cv2.imread(str(path), cv2.IMREAD_COLOR)
+
+        if data is None:
+            raise ValueError(f"Failed to load image: {path}")
+
+        return cls(data)
+
+    @classmethod
+    def from_array(cls, array: np.ndarray) -> "Image":
+        """
+        Wrap existing numpy image.
+        """
+        return cls(array)
+
+    def copy(self):
+        return Image(self.data.copy())
+
+    def gray(self):
+        """Return grayscale numpy array."""
+        return cv2.cvtColor(self.data, cv2.COLOR_BGR2GRAY)
+
+    def crop(self, top_ratio=0, bottom_ratio=1, left_ratio=0, right_ratio=1):
+        h, w = self.data.shape[:2]
+
+        y1 = int(h * top_ratio)
+        y2 = int(h * bottom_ratio)
+        x1 = int(w * left_ratio)
+        x2 = int(w * right_ratio)
+
+        return Image(self.data[y1:y2, x1:x2])
+
+    def compare(self, template: "Image") -> float:
+        """
+        Returns similarity score (0-1) using OpenCV matchTemplate.
+        """
+
+        img_gray = self.gray()
+        tpl_gray = template.gray()
+
+        res = cv2.matchTemplate(
+            img_gray,
+            tpl_gray,
+            cv2.TM_CCOEFF_NORMED
+        )
+
+        return float(np.max(res))
+
+    def matches(self, other: "Image", threshold=0.8) -> bool:
+        return self.compare(other) >= threshold

williampy-0.0.1/william/windows/window.py

@@ -0,0 +1,65 @@
+import win32gui
+import win32ui
+import numpy as np
+from ctypes import windll
+
+from william.image import Image
+
+class Window:
+    """
+    Represents a window on the system, given its title.
+    Provides methods to interact with it, including capturing its contents.
+    """
+
+    def __init__(self, title: str):
+        self.title = title
+        self.hwnd = win32gui.FindWindow(None, title)
+        if not self.hwnd:
+            raise ValueError(f"Window with title '{title}' not found.")
+
+    def capture(self) -> np.ndarray | None:
+        """
+        Capture the window's current content as a numpy array (BGR format).
+        Returns None if the capture fails.
+        """
+        left, top, right, bottom = win32gui.GetWindowRect(self.hwnd)
+        width = right - left
+        height = bottom - top
+
+        hwndDC = win32gui.GetWindowDC(self.hwnd)
+        mfcDC = win32ui.CreateDCFromHandle(hwndDC)
+        saveDC = mfcDC.CreateCompatibleDC()
+
+        saveBitMap = win32ui.CreateBitmap()
+        saveBitMap.CreateCompatibleBitmap(mfcDC, width, height)
+        saveDC.SelectObject(saveBitMap)
+
+        result = windll.user32.PrintWindow(self.hwnd, saveDC.GetSafeHdc(), 2)
+        if result != 1:
+            # Cleanup resources
+            win32gui.DeleteObject(saveBitMap.GetHandle())
+            saveDC.DeleteDC()
+            mfcDC.DeleteDC()
+            win32gui.ReleaseDC(self.hwnd, hwndDC)
+            return None
+
+        bmpinfo = saveBitMap.GetInfo()
+        bmpstr = saveBitMap.GetBitmapBits(True)
+        img = np.frombuffer(bmpstr, dtype=np.uint8).reshape((bmpinfo['bmHeight'], bmpinfo['bmWidth'], 4))
+        img = img[:, :, :3]  # BGRA -> BGR
+
+        # Cleanup resources
+        win32gui.DeleteObject(saveBitMap.GetHandle())
+        saveDC.DeleteDC()
+        mfcDC.DeleteDC()
+        win32gui.ReleaseDC(self.hwnd, hwndDC)
+
+        return Image(img)
+
+    def exists(self) -> bool:
+        """Check if the window still exists."""
+        return bool(win32gui.IsWindow(self.hwnd))
+
+    def get_rect(self) -> tuple[int, int, int, int]:
+        """Return (left, top, right, bottom) of the window."""
+        return win32gui.GetWindowRect(self.hwnd)

williampy-0.0.1/williampy.egg-info/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: williampy
+Version: 0.0.1
+Summary: neat python package to do many miscellaneous but helpful things
+Author: MrCoolGuy640
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# William
+![PyPI](https://img.shields.io/pypi/v/williampy)
+

williampy-0.0.1/williampy.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+william/__init__.py
+william/image/__init__.py
+william/image/image.py
+william/logging/__init__.py
+william/windows/__init__.py
+william/windows/window.py
+williampy.egg-info/PKG-INFO
+williampy.egg-info/SOURCES.txt
+williampy.egg-info/dependency_links.txt
+williampy.egg-info/top_level.txt

williampy-0.0.1/williampy.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

williampy-0.0.1/williampy.egg-info/top_level.txt

@@ -0,0 +1 @@
+william