Metadata-Version: 2.1
Name: instance_checker
Version: 0.4.3
Summary: A utility module to track and limit the number of running application instances by checking processes and lock files.
Author-Email: dkurchigin <kurchigin.dmitry@yandex.ru>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python
Classifier: Typing :: Typed
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Project-URL: Homepage, https://gitverse.ru/dkurchigin/instance_checker
Project-URL: Documentation, https://instance-checker.dkurchigin.ru/
Project-URL: Source, https://gitverse.ru/dkurchigin/instance_checker
Requires-Python: >=3.10
Requires-Dist: psutil>=7.0.0
Description-Content-Type: text/markdown

# Instance Checker

A simple and powerful Python utility to **count running instances of an application**.

### Usage Example

```python
from instance_checker.utils import CountHelper

helper = CountHelper(lock_dir="/tmp/my_app_locks")

print(helper.process_count("my_app"))        #> 2
print(helper.pid_file_count("my_app"))       #> 1
```

### Installation

```bash
pip install instance-checker
```

### License

MIT License — feel free to use it in any project! 🎉

### Documentation

[https://instance-checker.dkurchigin.ru/](https://instance-checker.dkurchigin.ru/)

### Author

Made with ❤️ by [@dkurchigin](https://gitverse.ru/dkurchigin)

### Gitverse

[https://gitverse.ru/dkurchigin/instance-checker](https://gitverse.ru/dkurchigin/instance-checker)