| Name | macos-window-info JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | None |
| Summary | A Python tool to find the process ID (PID) of a macOS window by its title or other attributes |
| upload_time | 2025-07-25 01:39:34 |
| maintainer | None |
| docs_url | None |
| author | Bernardo Martins |
| requires_python | >=3.13 |
| license | MIT |
| keywords |
macos
window
pid
process
quartz
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# macos-window-info
A Python project to find the process ID (PID) of a window by its title or other attributes.
[](https://github.com/bsamartins/macos-window-info/actions/workflows/build.yml)
[](https://github.com/bsamartins/macos-window-info/actions/workflows/code-quality.yml)
[](https://badge.fury.io/py/macos-window-info)
## Requirements
- Python 3.13 or higher
- macOS (uses Quartz framework)
## Installation
### From PyPI
```bash
pip install macos-window-info
```
### From source
This project uses [Poetry](https://python-poetry.org/) for dependency management.
```bash
poetry install
```
## Usage
Run the main script:
```bash
python macos-window-info.py
```
Or if installed via pip:
```bash
macos-window-info
```
## Development
### Setting up development environment
```bash
# 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 (<bsamartins@gmail.com>)
Raw data
{
"_id": null,
"home_page": null,
"name": "macos-window-info",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13",
"maintainer_email": null,
"keywords": "macos, window, pid, process, quartz",
"author": "Bernardo Martins",
"author_email": "bsamartins@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/04/55/b627c9ac14d28282a0544437d1f1bdcbd49c876be8e7682d89ff953215b5/macos_window_info-0.1.0.tar.gz",
"platform": null,
"description": "# macos-window-info\n\nA Python project to find the process ID (PID) of a window by its title or other attributes.\n\n[](https://github.com/bsamartins/macos-window-info/actions/workflows/build.yml)\n[](https://github.com/bsamartins/macos-window-info/actions/workflows/code-quality.yml)\n[](https://badge.fury.io/py/macos-window-info)\n\n## Requirements\n- Python 3.13 or higher\n- macOS (uses Quartz framework)\n\n## Installation\n\n### From PyPI\n```bash\npip install macos-window-info\n```\n\n### From source\nThis project uses [Poetry](https://python-poetry.org/) for dependency management.\n\n```bash\npoetry install\n```\n\n## Usage\nRun the main script:\n\n```bash\npython macos-window-info.py\n```\n\nOr if installed via pip:\n\n```bash\nmacos-window-info\n```\n\n## Development\n\n### Setting up development environment\n```bash\n# Clone the repository\ngit clone https://github.com/bsamartins/macos-window-info.git\ncd macos-window-info\n\n# Install with development dependencies\npoetry install --with dev\n\n# Run tests\npoetry run pytest\n\n# Run code formatting\npoetry run black src/\n\n# Run linting\npoetry run flake8 src/\n```\n\n### CI/CD\n\nThis project uses GitHub Actions for continuous integration and deployment:\n\n- **Build and Test**: Runs on every push and pull request, testing across multiple OS and Python versions\n- **Code Quality**: Runs code formatting, linting, and security checks\n- **Publish**: Automatically publishes to PyPI when a new release is created\n\n#### Setting up PyPI publishing\n\nTo enable automatic publishing to PyPI, you need to set up the following secrets in your GitHub repository:\n\n1. `PYPI_API_TOKEN`: Your PyPI API token for publishing to the main PyPI\n2. `TEST_PYPI_API_TOKEN`: Your Test PyPI API token for testing releases\n\nYou can create these tokens at:\n- PyPI: https://pypi.org/manage/account/token/\n- Test PyPI: https://test.pypi.org/manage/account/token/\n\n#### Manual publishing\n\nYou can also manually trigger publishing to Test PyPI using the workflow dispatch feature in GitHub Actions.\n\n## Author\nBernardo Martins (<bsamartins@gmail.com>)\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python tool to find the process ID (PID) of a macOS window by its title or other attributes",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/bsamartins/macos-window-info",
"Issues": "https://github.com/bsamartins/macos-window-info/issues",
"Repository": "https://github.com/bsamartins/macos-window-info"
},
"split_keywords": [
"macos",
" window",
" pid",
" process",
" quartz"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "2b6f45a7d105945ad3573edf6dc395dce8d69229882a795b8b6ab1e3ffe20b22",
"md5": "7cb625333085ed92954eb47b070177b0",
"sha256": "845fed0ec934b625b77dfab92a2bc5e4e425da4971d81a28b1549ac0db321bc3"
},
"downloads": -1,
"filename": "macos_window_info-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7cb625333085ed92954eb47b070177b0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 4122,
"upload_time": "2025-07-25T01:39:33",
"upload_time_iso_8601": "2025-07-25T01:39:33.311876Z",
"url": "https://files.pythonhosted.org/packages/2b/6f/45a7d105945ad3573edf6dc395dce8d69229882a795b8b6ab1e3ffe20b22/macos_window_info-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0455b627c9ac14d28282a0544437d1f1bdcbd49c876be8e7682d89ff953215b5",
"md5": "29d3f76468f2c7f3856ba7c5aee22790",
"sha256": "31adcbd6c1f891bf26779c1ea60b3d028ce7153a4eef8bb69edc4e1dad4764d4"
},
"downloads": -1,
"filename": "macos_window_info-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "29d3f76468f2c7f3856ba7c5aee22790",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 3162,
"upload_time": "2025-07-25T01:39:34",
"upload_time_iso_8601": "2025-07-25T01:39:34.453422Z",
"url": "https://files.pythonhosted.org/packages/04/55/b627c9ac14d28282a0544437d1f1bdcbd49c876be8e7682d89ff953215b5/macos_window_info-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-25 01:39:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bsamartins",
"github_project": "macos-window-info",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "macos-window-info"
}
