Metadata-Version: 2.1
Name: pgtree
Version: 1.0.9
Summary: Unix process tree search
Home-page: https://github.com/joknarf/pgtree
Author: joknarf
Author-email: joknarf@gmail.com
License: MIT
Description: [![Travis CI](https://travis-ci.com/joknarf/pgtree.svg?branch=master)](https://travis-ci.com/github/joknarf/pgtree)
        [![Codecov](https://codecov.io/github/joknarf/pgtree/coverage.svg?branch=master)](https://codecov.io/gh/joknarf/pgtree)
        [![Pypi version](https://img.shields.io/pypi/v/pgtree.svg)](https://pypi.org/project/pgtree/)
        [![Downloads](https://pepy.tech/badge/pgtree)](https://pepy.tech/project/pgtree)
        [![Python versions](https://img.shields.io/badge/python-2.3+%20|%203.x-blue.svg)](https://shields.io/)
        [![Licence](https://img.shields.io/badge/licence-MIT-blue.svg)](https://shields.io/)
        
        
        # pgtree
        Unix process hierachy tree display for specific processes (kind of mixed pgrep + pstree)
        
        pgtree is also able to send signal to found processes and all their children
        
        The purpose is to have the tool working out of the box on any Unix box, using the default OS python installed, without installing anything else.
        The code must be compatible with python 2.x + 3.x
        
        Should work on any Unix that can execute :
        ```
        # /usr/bin/pgrep 
        # /usr/bin/ps -e -o pid,ppid,stime,user,comm,args
        ```
        ## Installation
        FYI, the `pgtree/pgtree.py` is standalone and can be directly copied/used anywhere without any installation.
        
        installation using pip:
        ```
        # pip install pgtree
        ```
        installation using setup.py, root install in `/usr/local/bin`:
        ```
        # ./setup.py install
        ```
        installation using setup.py, user install in `~/.local/bin`:
        ```
        # ./setup.py install --prefix=~/.local
        ```
        ## Usage
        ```
        # pgtree -h
            usage: pgtree.py [-ICya] [-c|-k|-K] [-p <pid1>,...|<pgrep args>]
        
            -I : use -o uid instead of -o user for ps command
                 (if uid/user mapping is broken ps command can be stuck)
            -c : display processes and children only
            -k : kill -TERM processes and children
            -K : kill -KILL processes and children
            -y : do not ask for confirmation to kill
            -C : no color (default colored output on tty)
            -a : use ascii characters
        
            by default display full process hierarchy (parents + children of selected processes)
        
            -p <pids> : select processes pids to display hierarchy (default 1)
            <pgrep args> : use pgrep to select processes (see pgrep -h)
        
            found pids are prefixed with ▶
        ```
        ## Examples
        show all parents and children of processes matching `bash`
        
        <img alt="# pgtree bash" src="https://user-images.githubusercontent.com/10117818/91555007-7d69a900-e930-11ea-98a2-8d81b7fdf0d3.png" width="850px">
        
        show processes matching `bash` and their children
        
        <img alt="# pgtree -c bash" src="https://user-images.githubusercontent.com/10117818/91555156-c15cae00-e930-11ea-9479-7c9b2c7b249e.png" width="850px">
        
        kill all `sh` processes of user joknarf and their children
        
        <img alt="#pgtree -k -u joknarf -x sh" src="https://user-images.githubusercontent.com/10117818/91555424-48aa2180-e931-11ea-8f19-6054458aa79c.png" width="850px">
        
        ## Demo
        
        <img alt="output" src="https://user-images.githubusercontent.com/10117818/91558307-64fc8d00-e936-11ea-85bc-08eae29a58ce.gif" width="850px">
        
        
Keywords: shell pstree pgrep process tree
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
