Metadata-Version: 2.1
Name: tmonpy
Version: 0.4.0
Summary: A CLI tool to monitor temp while running a child process
Home-page: https://github.com/gmagno/tmon
Author: Goncalo Magno
Author-email: goncalo@gmagno.dev
License: MIT license
Description: ===================
        Temp Monitor
        ===================
        
        
        .. image:: https://img.shields.io/pypi/v/tmonpy.svg
                :target: https://pypi.python.org/pypi/tmonpy
        
        .. image:: https://img.shields.io/travis/gmagno/tmon.svg
                :target: https://travis-ci.org/gmagno/tmon
        
        .. image:: https://readthedocs.org/projects/tmon/badge/?version=latest
                :target: https://tmon.readthedocs.io/en/latest/?badge=latest
                :alt: Documentation Status
        
        .. .. image:: https://img.shields.io/pypi/dm/tmonpy
        ..         :alt: PyPI - Downloads
        
        .. image:: https://img.shields.io/github/downloads/gmagno/tmon/total
                :alt: GitHub All Releases
        
        
        
        A Python CLI utility to monitor cpu temperature
        
        
        * Free software: MIT license
        * Documentation: https://tmon.readthedocs.io.
        
        
        Install
        --------
        
        ::
        
                pip install tmonpy
        
        or
        
        ::
        
                $ # download the AppImage file from the releases page
                $ wget https://github.com/gmagno/tmon/releases/latest/download/tmon-???????-x86_64.AppImage
                $ chmod +x tmon-*-x86_64.AppImage
        
        
        
        Usage
        --------
        
        ::
        
            tmon -h
            usage: tmon [-h] [-v] [-y YSIZE] [-x XSIZE] [-l MIN MAX] ...
        
            Temperature Monitor (tmon v0.3.6) -- executes a program while
            monitoring CPU temperature, reporting the min, max and mean
            temperatures and plotting an ascii chart at the end to stderr.
            All signals are redirected to the program.
            If no program is passed, tmon runs as expected returning on
            SIGINT (Ctrl-C).
            For full documentation check the repo: https://github.com/gmagno/tmon
        
            positional arguments:
            CMD                   Command args to run.
        
            optional arguments:
            -h, --help            show this help message and exit
            -v, --version         Shows tmon version.
            -y YSIZE, --ysize YSIZE
                                    Y-axis size in number terminal characters
            -x XSIZE, --xsize XSIZE
                                    X-axis size in number terminal characters
            -l MIN MAX, --ylim MIN MAX
                                    Y-axis view limits with min and max values. It is
                                    ignored if the measured temperatures fall outside the
                                    specified range.
        
            return:
                tmon returns when the child program exits, stops, or is
                terminated by a signal. The return value of tmon is the return
                value of the program it executed.
        
            examples:
                $ tmon echo How can a clam cram in a clean cream can
                How can a clam cram in a clean cream can
        
                ===================
                Temp Monitor Report:
        
                Temp (°C) for a period of 0:00:00
                >> 53.0 °C <<
        
                /tmp/tmon-YYYYMMDD@HHhMMmSS-XXXXXXXX.txt
                ===================
        
                $ tmon bash -c 'sleep 6; stress -c 4 -t 3; sleep 6'
                stress: info: [17832] dispatching hogs: 4 cpu, 0 io, 0 vm, 0 hdd
                stress: info: [17832] successful run completed in 3s
        
                ===================
                Temp Monitor Report:
        
                Temp (°C) for a period of 0:00:15
                59.00  ┤
                58.67  ┤
                58.33  ┤
                58.00  ┤
                57.67  ┤      ╭─╮
                57.33  ┤      │ │
                57.00  ┤      │ │
                56.67  ┤     ╭╯ ╰╮
                56.33  ┤     │   │
                56.00  ┤     │   │
                55.67  ┼─╮   │   │
                55.33  ┤ │   │   │
                55.00  ┤ ╰───╯   ╰────╮
                54.67  ┤              │
                54.33  ┤              │
                54.00  ┤              ╰
        
                /tmp/tmon-YYYYMMDD@HHhMMmSS-XXXXXXXX.txt
                ===================
        
                $ tmon -y 5 -x 5 bash -c 'sleep 6; stress -c 4 -t 3; sleep 6'
                stress: info: [17181] dispatching hogs: 4 cpu, 0 io, 0 vm, 0 hdd
                stress: info: [17181] successful run completed in 3s
        
                ===================
                Temp Monitor Report:
        
                Temp (°C) for a period of 0:00:15
                60.00  ┤
                59.00  ┤  ╭╮
                58.00  ┼╮╭╯│
                57.00  ┤╰╯ │
                56.00  ┤   ╰─
        
                /tmp/tmon-YYYYMMDD@HHhMMmSS-XXXXXXXX.txt
                ===================
        
                $ tmon -l 40 70 -x 10 -y 10 bash -c 'stress -c 4 -t 3; sleep 6'
                stress: info: [19677] dispatching hogs: 4 cpu, 0 io, 0 vm, 0 hdd
                stress: info: [19677] successful run completed in 3s
        
                ===================
                Temp Monitor Report:
        
                Temp (°C) for a period of 0:00:09
                70.00  ┤
                66.67  ┤
                63.33  ┤
                60.00  ┤
                56.67  ┼───╮
                53.33  ┤   ╰─────
                50.00  ┤
                46.67  ┤
                43.33  ┤
                40.00  ┤
        
                /tmp/tmon-YYYYMMDD@HHhMMmSS-XXXXXXXX.txt
                ===================
        
            copyright:
                Copyright © 2020 Gonçalo Magno <goncalo@gmagno.dev>
                This software is licensed under the MIT License.
        
        
        =======
        History
        =======
        
        0.1.0 (2020-01-28)
        ------------------
        
        * First release on PyPI.
        
Keywords: tmon
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.5
Provides-Extra: dev
