Metadata-Version: 2.1
Name: pylane
Version: 0.0.8
Summary: UNKNOWN
Home-page: https://github.com/NtesEyes/pylane
Author: valensc, Wu Xiao
Author-email: weidong1312@gmail.com, notgiven@gmail.com
License: UNKNOWN
Download-URL: https://github.com/NtesEyes/pylane/archive/0.0.2.tar.gz
Keywords: debug,attach,gdb,shell
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: ipython (==5.7)
Requires-Dist: Click (==7.0)

# pylane

[![PyPI version](https://badge.fury.io/py/pylane.svg)](https://badge.fury.io/py/pylane)


[简体中文](README.zh-cn.md)

Pylane is a python vm injector with debug tools, based on gdb and ptrace.
Pylane uses gdb to trace python process, inject and run some code in its python vm.

## Usage

![pylane_show](misc/pylane_show.gif)

use inject command to inject a python script in an process:

```
pylane inject <PID> <YOUR_PYTHON_FILE>
```

use shell command to inject an interactive shell:

```
pylane shell <PID>
```

Pylane shell features:

* use IPython as its interactive interface, support magic functions like ? and %
* support remote automatic completion
* provide debug toolkit functions, such as:
  * lookup class or instance by name
  * get source code of an object
  * print all threads' stack and locals

## Install

```
pip install pylane
```

pylane should be installed in virtualenv the target process uses or in os python lib.

## Compatibility

Support Linux and BSD


