
Code in laufende Python-Prozesse injizieren
.. 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/
Werkzeuge zum Injizieren von beliebigem Code in laufende Python-Prozesse.
: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
Voraussetzungen
* `gdb <https://www.gnu.org/s/gdb>`_ (Version 7.3+)
* Ein Linux-System, dessen ptrace-Richtlinie das Anhängen an den
Zielprozess erlaubt. Siehe `ptrace_scope` unten.
Installation
~~~~~~~~~~~~
::
pipx install pyrasite
oder, für den optionalen Speicherbetrachter::
pip install "pyrasite[memory-viewer]"
Kompatibilität
~~~~~~~~~~~~~~
Pyrasite läuft auf CPython 3.9 bis 3.15. Die Injektion funktioniert auch
zwischen verschiedenen Versionen, sodass du Pyrasite unter einer Python-Version
ausführen und in einen Prozess injizieren kannst, der unter einer anderen läuft.
Sowohl der pyrasite-Client als auch der Zielprozess müssen CPython sein.
ptrace_scope
~~~~~~~~~~~~
Neuere Linux-Distributionen schränken ptrace so ein, dass ein Prozess nur von
seinen Vorfahren angehängt werden darf. Wenn ``/proc/sys/kernel/yama/ptrace_scope``
ungleich null ist, wird eine Warnung angezeigt. Du kannst das Anhängen entweder
global erlauben::
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope
oder den Zielprozess durch Aufruf von ``prctl(PR_SET_PTRACER,
PR_SET_PTRACER_ANY)`` zustimmen lassen. Unter Fedora kann SELinux außerdem
Folgendes erfordern::
sudo setsebool -P deny_ptrace=off
Bei Multithread-Programmen stellt pyrasite die Nutzlast mit
``Py_AddPendingCall`` in eine Warteschlange, damit sie auf einem Thread
ausgeführt wird, der bereits den GIL hält. Wenn das Ziel in C blockiert ist und
niemals Python-Bytecode ausführt, verwende stattdessen
``--inject-method direct``.
Verwendung
~~~~~~~~~~
::
pyrasite <pid> hello.py
pyrasite <pid> - <<'EOF'
import sys
print(sys.version)
EOF
pyrasite <pid> <(echo 'print("hello")')
Die Nutzlast wird vom pyrasite-Prozess gelesen und in den gdb-Befehl
eingebettet, sodass der Zielprozess keinen Lesezugriff auf die Nutzlastdatei
benötigt. Das bedeutet auch, dass Pipes und Prozesssubstitution funktionieren.
Standard-Nutzlasten können über ihren Namen ausgewählt werden (siehe
``pyrasite --list-payloads``).
Tests
~~~~~
::
pip install -e ".[dev]"
pytest
ruff check .
ruff format --check .
Um die Testsuite mit jedem unterstützten Interpreter mit `uv
<https://docs.astral.sh/uv/>`_ auszuführen::
uv python install 3.9 3.10 3.11 3.12 3.13 3.14 3.15
tox
Um das Injizieren von einem Interpreter in alle anderen zu testen, setze
``PYRASITE_TEST_INTERPRETERS`` auf eine doppelpunktgetrennte Liste von
Interpreter-Pfaden, bevor du pytest ausführst.
pyrasite-gui
~~~~~~~~~~~~
Die grafische Oberfläche wird separat gepflegt unter
https://github.com/lmacken/pyrasite-gui.
Autoren
~~~~~~~
Erstellt von `Luke Macken <https://twitter.com/lmacken>`_ mit Hilfe von
`David Malcolm <https://dmalcolm.livejournal.com>`_ und vielen weiteren
`Mitwirkenden <https://github.com/lmacken/pyrasite/contributors>`_.
Logo von `Adam Saunders <https://fedorahosted.org/design-team/ticket/214>`_.
Lizenzen
~~~~~~~~
Code
^^^^
.. image:: https://www.gnu.org/graphics/gplv3-127x51.png
:target: https://www.gnu.org/licenses/gpl.txt
Logo
^^^^
.. image:: https://creativecommons.org/images/deed/nolaw.png
:target: https://creativecommons.org/publicdomain/zero/1.0/
Entdecken Sie die meistgenutzten Tools unserer Community.
Noch keine Beliebtheitsdaten.