Metadata-Version: 2.1
Name: WindowManager
Version: 0.0.2
Summary: WindowManager: Simplified window management.
Author: Itamar Katzover
Author-email: itamar43.katzover43@gmail.com
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE.txt

WindowManager
This Python package provides a set of functions for managing windows on your system. It utilizes the win32gui and psutil libraries to interact with windows and processes.

Installation
oip install WindowManager

Usage
The WindowManager package offers several functions for manipulating windows and processes. Here's a breakdown of each function:

windowHandler(hwnd, windows:list): Internal function used for enumerating windows.

getsize(window_title:str): Gets the width and height of a window based on its title.

Arguments:

window_title: The title (or part of the title) of the window you want to get the size of.
Returns:

A tuple containing the width and height of the window.
Raises:

SyntaxError: If the window with the specified title is not found.
ontop(window_title:str, hide=False): Brings a window to the top of the screen or hides it optionally.

Arguments:

window_title: The title (or part of the title) of the window you want to manipulate.
hide (optional): A boolean value indicating whether to hide the window (True) or show it on top (False). Defaults to False.
Returns:

True if the window is found and manipulated successfully, False otherwise.
close(AppName:str): Terminates a program by its process name.

Arguments:

AppName: The name of the process you want to terminate (e.g., "notepad++.exe").
Returns:

True if the process is found and terminated successfully, False otherwise.
Raises:

SyntaxError: If the process with the specified name is not found.
reposition(window_title:str, y:int, x:int, width:int=-1, height:int=-1): Moves and resizes a window.

Arguments:

window_title: The title (or part of the title) of the window you want to reposition.
y: The new y-coordinate (top position) of the window.
x: The new x-coordinate (left position) of the window.
width (optional): The new width of the window (defaults to the current width if -1).
height (optional): The new height of the window (defaults to the current height if -1).
Returns:

True if the window is found and repositioned successfully, False otherwise.
open(path:str): Opens a program by its file path.

Arguments:

path: The full path to the program's executable file (e.g., "C:/Program Files/Notepad++/notepad++.exe").
Notes:

The path separator needs to be forward slash ("/") even on Windows systems.
getPID(process_name:str): Gets the process ID (PID) of a running program.

Arguments:

process_name: The name of the process you want to get the PID for (e.g., "notepad++.exe").
Returns:

The PID of the process if found, otherwise raises an error.
Raises:

SyntaxError: If the process with the specified name is not found.
Examples
Here are some examples of how to use the WindowManager functions:

Python
import WindowManager as wm

# Get the size of a window titled "Notepad"
width, height = WindowManager.getsize("Notepad")
print(f"Notepad size: {width}x{height}")

# Bring the window titled "Calculator" on top
wm.ontop("Calculator")

# Close the program named "notepad++.exe"
wm.close("notepad++.exe")

# Move the window titled "Command Prompt" to (100, 100) with a width of
wm.reposition("Command Prompt", 100, 100)

# Open `notpad++.exe` by its path `C:/Program Files/Notepad++`
wm.open('C:/Program Files/Notepad++')

# Get the PID of notepad++ by its Process name `notpad++.exe`
wm.getPID('notpad++.exe')
