
Injecter du code dans des processus Python en cours d'exécution
.. 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/
Outils pour injecter du code arbitraire dans des processus Python en cours d'exécution.
: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
Prérequis
* `gdb <https://www.gnu.org/s/gdb>`_ (version 7.3+)
* Un système Linux dont la politique ptrace autorise l'attachement au
processus cible. Voir `ptrace_scope` ci-dessous.
Installation
::
pipx install pyrasite
ou, pour le visualiseur de mémoire optionnel ::
pip install "pyrasite[memory-viewer]"
Compatibilité
Pyrasite fonctionne sur CPython 3.9 à 3.15. L'injection fonctionne également
entre versions, vous pouvez donc exécuter Pyrasite sous un Python et injecter
dans un processus exécutant un autre. Le client pyrasite et le processus cible
doivent tous deux être CPython.
ptrace_scope
~~~~~~~~~~~~
Les distributions Linux récentes restreignent ptrace afin qu'un processus ne
puisse être attaché que par ses ancêtres. Si
``/proc/sys/kernel/yama/ptrace_scope`` est non nul, un avertissement
s'affichera. Vous pouvez soit autoriser l'attachement globalement ::
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope
soit laisser le processus cible s'y inscrire en appelant ``prctl(PR_SET_PTRACER,
PR_SET_PTRACER_ANY)``. Sur Fedora, SELinux peut également nécessiter ::
sudo setsebool -P deny_ptrace=off
Pour les programmes multi-threadés, pyrasite met la charge utile en file
d'attente avec ``Py_AddPendingCall`` afin qu'elle s'exécute sur un thread qui
détient déjà le GIL. Si la cible est bloquée en C et n'exécute jamais de
bytecode Python, utilisez plutôt ``--inject-method direct``.
Utilisation
~~~~~~~~~~~
::
pyrasite <pid> hello.py
pyrasite <pid> - <<'EOF'
import sys
print(sys.version)
EOF
pyrasite <pid> <(echo 'print("hello")')
La charge utile est lue par le processus pyrasite et intégrée dans la commande
gdb, le processus cible n'a donc pas besoin d'un accès en lecture au fichier de
charge utile. Cela signifie également que les pipes et la substitution de
processus fonctionnent. Les charges utiles standard peuvent être sélectionnées
par nom (voir ``pyrasite --list-payloads``).
Tests
~~~~~
::
pip install -e ".[dev]"
pytest
ruff check .
ruff format --check .
Pour exécuter la suite avec chaque interpréteur pris en charge à l'aide de `uv
<https://docs.astral.sh/uv/>`_ ::
uv python install 3.9 3.10 3.11 3.12 3.13 3.14 3.15
tox
Pour tester l'injection depuis un interpréteur vers tous les autres, définissez
``PYRASITE_TEST_INTERPRETERS`` sur une liste de chemins d'interpréteurs séparés
par des deux-points avant d'exécuter pytest.
pyrasite-gui
~~~~~~~~~~~~
L'interface graphique est maintenue séparément à l'adresse
https://github.com/lmacken/pyrasite-gui.
Auteurs
~~~~~~~
Créé par `Luke Macken <https://twitter.com/lmacken>`_ avec l'aide de
`David Malcolm <https://dmalcolm.livejournal.com>`_ et de nombreux autres
`contributeurs <https://github.com/lmacken/pyrasite/contributors>`_.
Logo par `Adam Saunders <https://fedorahosted.org/design-team/ticket/214>`_.
Licences
~~~~~~~~
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/