process-inspector 0.1.4

A Python package for cross-platform process management, providing process data as dicts/JSON and allowing process control (start, stop, kill) on Windows, Mac, and Linux.

Process Inspector

Overview

A Python package for cross-platform process management, providing process data as dicts/JSON and allowing process/service control (start, stop, kill) on Windows, Mac, and Linux.

Installation

Use uv or pip.

uv add process-inspector
python3 -m pip install process-inspector

Development

To get a list of all commands with descriptions simply run make.

make env
make pip_install_editable

Testing

make pytest
make coverage
make open_coverage

Issues

If you experience any issues, please create an issue on Github.

Example Usage

from process_inspector import NativeApp
from process_inspector import Service
from process_inspector import Teamviewer
from process_inpsector import OperatingSystem

# App control
app = NativeApp('C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe')
app.open()
app.is_running()
app.get_version()
app.to_dict()
app.process_info()
app.close()

# Service control
service = Service("Spooler")
service.start()
service.is_running()
service.stop()

# Teamviewer
tv = Teamviewer()
tv.open()
tv.is_running()
tv.close()
tv.get_teamviewer_info()

# This operation requires sudo priveleges on Linux and Mac so ensure you allow it for the user the application is running under.
OperatingSystem().reboot()

History

All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.

0.1.0 (2025-09-11)

• First release

0.1.1 (2025-09-11)

• ADDED - more test coverage

0.1.2 (2025-09-11)

• ADDED - Service control (Windows Services or Linux/ Mac supervisorctl processes)
• ADDED - TeamViewer status and basic control (start, stop)

0.1.3 (2025-09-16)

• CHANGED - Improved query times for process running and process info

0.1.4 (2025-09-23)

• CHANGED - Fixed failing Linux tests