
Inyectar código en procesos de Python en ejecución
.. image:: https://raw.githubusercontent.com/lmacken/pyrasite/develop/docs/logo.png
.. image:: https://github.com/lmacken/pyrasite/actions/workflows/ci.yml/badge.svg?branch=develop :target: https://github.com/lmacken/pyrasite/actions/workflows/ci.yml .. image:: https://img.shields.io/pypi/v/pyrasite?style=flat :target: https://pypi.org/project/pyrasite/
Herramientas para inyectar código arbitrario en procesos de Python en ejecución.
:homepage: https://github.com/lmacken/pyrasite :documentation: https://pyrasite.readthedocs.io/ :download: https://pypi.org/project/pyrasite/ :source: https://github.com/lmacken/pyrasite :issues: https://github.com/lmacken/pyrasite/issues
Requisitos
* `gdb <https://www.gnu.org/s/gdb>`_ (versión 7.3+)
* Un sistema Linux cuya política de ptrace permita adjuntarse al proceso
objetivo. Consulte `ptrace_scope` más abajo.
Instalación
::
pipx install pyrasite
o, para el visor de memoria opcional::
pip install "pyrasite[memory-viewer]"
Compatibilidad
Pyrasite se ejecuta en CPython 3.9 hasta 3.15. La inyección también funciona
entre versiones, por lo que puede ejecutar Pyrasite con un Python e inyectar en
un proceso que ejecute otro. Tanto el cliente pyrasite como el proceso objetivo
deben ser CPython.
ptrace_scope
~~~~~~~~~~~~
Las distribuciones Linux recientes restringen ptrace de modo que un proceso
solo puede ser adjuntado por sus ancestros. Si
``/proc/sys/kernel/yama/ptrace_scope`` no es cero, verá una advertencia. Puede
permitir la adjunción de forma global::
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope
o dejar que el proceso objetivo lo habilite llamando a ``prctl(PR_SET_PTRACER,
PR_SET_PTRACER_ANY)``. En Fedora, SELinux también puede necesitar::
sudo setsebool -P deny_ptrace=off
Para programas multihilo, pyrasite encola el payload con
``Py_AddPendingCall`` para que se ejecute en un hilo que ya posee el GIL.
Si el objetivo está bloqueado en C y nunca ejecuta bytecode de Python, use
``--inject-method direct`` en su lugar.
Uso
~~~
::
pyrasite <pid> hello.py
pyrasite <pid> - <<'EOF'
import sys
print(sys.version)
EOF
pyrasite <pid> <(echo 'print("hello")')
El payload es leído por el proceso pyrasite e incrustado en el comando de gdb,
por lo que el objetivo no necesita acceso de lectura al archivo del payload.
Esto también significa que las tuberías y la sustitución de procesos funcionan.
Los payloads estándar se pueden seleccionar por nombre (consulte
``pyrasite --list-payloads``).
Pruebas
~~~~~~~
::
pip install -e ".[dev]"
pytest
ruff check .
ruff format --check .
Para ejecutar la suite contra todos los intérpretes compatibles con `uv
<https://docs.astral.sh/uv/>`_::
uv python install 3.9 3.10 3.11 3.12 3.13 3.14 3.15
tox
Para probar la inyección desde un intérprete hacia todos los demás, establezca
``PYRASITE_TEST_INTERPRETERS`` en una lista de rutas de intérpretes separadas
por dos puntos antes de ejecutar pytest.
pyrasite-gui
~~~~~~~~~~~~
La interfaz gráfica se mantiene por separado en
https://github.com/lmacken/pyrasite-gui.
Autores
~~~~~~~
Creado por `Luke Macken <https://twitter.com/lmacken>`_ con la ayuda de
`David Malcolm <https://dmalcolm.livejournal.com>`_ y muchos otros
`colaboradores <https://github.com/lmacken/pyrasite/contributors>`_.
Logotipo por `Adam Saunders <https://fedorahosted.org/design-team/ticket/214>`_.
Licencias
~~~~~~~~~
Código
^^^^^^
.. image:: https://www.gnu.org/graphics/gplv3-127x51.png
:target: https://www.gnu.org/licenses/gpl.txt
Logotipo
^^^^^^^^
.. image:: https://creativecommons.org/images/deed/nolaw.png
:target: https://creativecommons.org/publicdomain/zero/1.0/