macos-window-info 0.1.0

A Python tool to find the process ID (PID) of a macOS window by its title or other attributes

macos-window-info

A Python project to find the process ID (PID) of a window by its title or other attributes.

Requirements

• Python 3.13 or higher
• macOS (uses Quartz framework)

Installation

From PyPI

pip install macos-window-info

From source

This project uses Poetry for dependency management.

poetry install

Usage

Run the main script:

python macos-window-info.py

Or if installed via pip:

macos-window-info

Development

Setting up development environment

# Clone the repository
git clone https://github.com/bsamartins/macos-window-info.git
cd macos-window-info

# Install with development dependencies
poetry install --with dev

# Run tests
poetry run pytest

# Run code formatting
poetry run black src/

# Run linting
poetry run flake8 src/

CI/CD

This project uses GitHub Actions for continuous integration and deployment:

• Build and Test: Runs on every push and pull request, testing across multiple OS and Python versions
• Code Quality: Runs code formatting, linting, and security checks
• Publish: Automatically publishes to PyPI when a new release is created

Setting up PyPI publishing

To enable automatic publishing to PyPI, you need to set up the following secrets in your GitHub repository:

1. PYPI_API_TOKEN: Your PyPI API token for publishing to the main PyPI
2. TEST_PYPI_API_TOKEN: Your Test PyPI API token for testing releases

You can create these tokens at:

• PyPI: https://pypi.org/manage/account/token/
• Test PyPI: https://test.pypi.org/manage/account/token/

Manual publishing

You can also manually trigger publishing to Test PyPI using the workflow dispatch feature in GitHub Actions.

Author

Bernardo Martins ([e-mail])