Metadata-Version: 2.1
Name: hypno
Version: 0.1.2
Summary: A tool/library allowing to inject python code into a running python process.
Home-page: https://github.com/kmaork/hypno
Author: Maor Kleinberger
Author-email: kmaork@gmail.com
License: UNKNOWN
Description: # Hypno
        
        [![PyPI version](https://badge.fury.io/py/hypno.svg)](https://badge.fury.io/py/hypno)
        [![PyPI Supported Python Versions](https://img.shields.io/pypi/pyversions/hypno.svg)](https://pypi.python.org/pypi/hypno/)
        [![GitHub license](https://img.shields.io/github/license/kmaork/hypno)](https://github.com/kmaork/hypno/blob/master/LICENSE.txt)
        [![Tests (GitHub Actions)](https://github.com/kmaork/hypno/workflows/Tests/badge.svg)](https://github.com/kmaork/hypno)
        
        A tool/library allowing to inject python code into a running python process.
        
        ### Installation
        ```shell script
        pip install hypno
        ```
        Both source distributions and `manylinux1` wheels are upoloaded to pypi for every release.
        
        ### Usage
        #### CLI
        ```shell script
        hypno <pid> <python_code>
        ```
        
        #### API
        ```python
        from hypno import inject_py
        
        inject_py(pid, python_code)
        ```
        
        #### Example
        This example runs a python program that prints its pid, and then attaches to the newly created process and
        injects it with another print statement using hypno.
        ```shell script
        python -c "import os, time; print('Hello from', os.getpid()); time.sleep(0.5)" &\
        hypno $! "import os; print('Hello again from', os.getpid())"
        ```
        
        ### How it works
        We use the [pyinjector](https://github.com/kmaork/pyinjector) library as a primitive allowing us to inject arbitrary
        code into processes, because it is simple to use and can be installed easily and on most linux machines.
         
         [pyinjector](https://github.com/kmaork/pyinjector) needs an `.so` to inject, so we compile a minimal library
        as a C-extension. That library calls `PyRun_SimpleString` upon initialization.
        
        In order to allow injecting a process multiple times, the injected library must have a unique path for each injection.
        We do that by copying the library for every call.
        
        As we don't want to recompile the library for every injection to replace the executed string,
        and we already control the path from which our library is injected, we encode the injected python code
        into the the injected libraries' paths. When the injected library is loaded, it finds its own name
        using `dladdr` and parses the python code from it.
Keywords: injection library
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown; charset=UTF-8
