Metadata-Version: 2.1
Name: process_monitoring_package
Version: 0.0.3
Summary: A package to monitor a process and send email notifications
Author: Chengran
License: MIT
Description-Content-Type: text/markdown
License-File: LICENSE

# Process Monitoring Package (Work in Progress ...)

The Process Monitoring package provides functionality to monitor a process by its PID and send email notifications when the process completes.

HOMEPAGE: https://github.com/ChengranAA/Process_Monitor_Python

## Installation

You can install the package using `pip`:

```
pip install process-monitoring-package
```

## Usage

### Show PID

To display the PID (Process ID) of the current script, use the `show_pid` function:

```python
from process_monitoring.show_pid import show_pid

show_pid()
```

This will print the PID of the current script to the console.

### Monitor Process

To monitor a specific process by its PID and receive email notifications when it is completed, use the `monitor_process` function:

```python
from process_monitoring.monitor import monitor_process

pid = 1234  # Replace with the PID of the process you want to monitor
sender_email = "your_email@gmail.com"
receiver_email = "recipient_email@gmail.com"
password = "your_email_password"

monitor_process(pid, sender_email, receiver_email, password)
```

Replace `pid` with the PID of the process you want to monitor. Provide the necessary email configuration, including the sender's email, receiver's email, and email password. This function will continuously check if the process is running. When the process is completed, an email notification will be sent.

## Email 

I recommend creating a separate Gmail email account and utilizing an app-specific password for this package, as it operates through the Gmail server. To access this option, navigate to the security settings within your Gmail account.

see this video for details: https://www.youtube.com/watch?v=Sddnn6dpqk0&t=548s

## Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, please feel free to open an issue or submit a pull request on the GitHub repository.

## License

This package is licensed under the MIT License. See the [LICENSE](https://github.com/ChengranAA/Process_Monitor_Python/blob/main/LICENSE) file for more information.
