Metadata-Version: 2.1
Name: pmon
Version: 0.2.1
Summary: A process monitor for linux
Home-page: https://github.com/pmav99/pmon
License: MIT
Keywords: cli,typer,process,monitor
Author: Panos Mavrogiorgos
Author-email: pmav99@gmail.com
Requires-Python: >=3.6,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development
Classifier: Topic :: System
Classifier: Topic :: Utilities
Requires-Dist: psutil (>=5.7.3,<6.0.0)
Requires-Dist: typer[all] (>=0.3.2,<0.4.0)
Project-URL: Repository, https://github.com/pmav99/pmon
Description-Content-Type: text/markdown

## pmon

A process monitor for linux that shows detailed RAM usage info.

```
$ pmon 261071
vms       rss       pss       uss       shared    swap      rss (%)   pss (%)   uss (%)   cpu (%)
2.576G    1.122G    1.110G    1.107G    99.699M   0B        7.22      7.14      7.12      0.00
2.576G    1.122G    1.110G    1.107G    99.699M   0B        7.22      7.14      7.12      12.23
2.576G    1.122G    1.110G    1.107G    99.699M   0B        7.22      7.14      7.12      6.48
```

### Rationale

Measuring RAM usage on Linux can be
[tricky](https://web.archive.org/web/20120520221529/http://emilics.com/blog/article/mconsumption.html).
Probably the most correct way to measure it is to use
[`USS`](https://gmpy.dev/blog/2016/real-process-memory-and-environ-in-python), i.e:

> USS (Unique Set Size) is the memory which is unique to a process and which would be freed if the
> process was terminated right now.

Unfortunately, tools like `top` and `htop` do not report this metric. Nevertheless,
[psutil](https://github.com/giampaolo/psutil) does collect it, so, we use it as the backend to monitor
RAM usage.

### Install

```
pipx install pmon
```

### Usage

```
pmon --help
```

