https://github.com/dellis23/ispy

Monitor the output of terminals and processes.
https://github.com/dellis23/ispy

Last synced: 3 days ago
JSON representation

Monitor the output of terminals and processes.

• Host: GitHub
• URL: https://github.com/dellis23/ispy
• Owner: dellis23
• License: gpl-2.0
• Created: 2015-12-20T22:02:40.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2015-12-22T17:19:12.000Z (almost 9 years ago)
• Last Synced: 2024-11-21T22:28:18.587Z (20 days ago)
• Language: Python
• Homepage:
• Size: 2.68 MB
• Stars: 1,013
• Watchers: 40
• Forks: 44
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• starred-awesome - ispy - Monitor the output of terminals and processes. (Python)

README

        
# ispy

`ispy` is a python tool for monitoring the output of terminals and processes.

## Demo

`ispy` watching a `bash` session that lists some files and opens `vim`:

![ispy demo](https://github.com/dellis23/ispy/blob/master/img/ispydemo.gif)

The same thing, using `strace`:

![strace watching writes demo](https://github.com/dellis23/ispy/blob/master/img/ispydemo-strace.gif)

## Installation

    pip install ispy

    

Alternatively, if you aren't a Python person or don't want to install it

(since it must be run as root), you can download a fully packaged 

[`pex`](https://pex.readthedocs.org/en/latest/) file and run without 

installing:

    wget https://github.com/dellis23/ispy/blob/master/bin/pex/ispy.pex?raw=true -O ispy; chmod +x ispy

## Usage

    # ispy 

## Use Cases

 * Watching someone else's terminal

 * Watching the output of a backgrounded process

## Notes

### **Not** intended for production!

It's probably buggy.

This was mainly an exercise in learning about `ptrace` for myself.  I

haven't done anything more than smoke testing on a couple of 

operating systems.

This uses the same system call as `strace` (`ptrace`), which is heavy-handed

and has a performance impact.  It is not recommended to use in production or

against mission-critical applications.  It's also written in Python, so it's even slower.

### Supported OSs

This has been tested as working on:

 * Ubuntu

 * CentOS

This has been tested as **not** working on:

 * OSX

## Thanks

Thanks to the creator and maintainers of [python-ptrace](https://bitbucket.org/haypo/python-ptrace/); this project depends on it.