
Inietta codice nei processi Python in esecuzione
.. 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/
Strumenti per iniettare codice arbitrario in processi Python in esecuzione.
: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
Requisiti
* `gdb <https://www.gnu.org/s/gdb>`_ (versione 7.3+)
* Un sistema Linux la cui politica ptrace consenta l'aggancio al processo
di destinazione. Vedere `ptrace_scope` di seguito.
Installazione
::
pipx install pyrasite
oppure, per il visualizzatore di memoria opzionale::
pip install "pyrasite[memory-viewer]"
Compatibilità
Pyrasite funziona su CPython dalla 3.9 alla 3.15. L'iniezione funziona anche
tra versioni diverse, quindi è possibile eseguire Pyrasite con una versione di
Python e iniettare in un processo che ne esegue un'altra. Sia il client
pyrasite sia il processo di destinazione devono essere CPython.
ptrace_scope
~~~~~~~~~~~~
Le distribuzioni Linux recenti limitano ptrace in modo che un processo possa
essere agganciato solo dai suoi antenati. Se
``/proc/sys/kernel/yama/ptrace_scope`` è diverso da zero verrà mostrato un
avviso. È possibile consentire l'aggancio a livello globale::
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope
oppure lasciare che il processo di destinazione dia il proprio consenso
chiamando ``prctl(PR_SET_PTRACER, PR_SET_PTRACER_ANY)``. Su Fedora, SELinux
potrebbe inoltre richiedere::
sudo setsebool -P deny_ptrace=off
Per i programmi multi-thread pyrasite accoda il payload con
``Py_AddPendingCall`` in modo che venga eseguito su un thread che possiede già
il GIL. Se il processo di destinazione è bloccato in codice C e non esegue mai
bytecode Python, usare invece ``--inject-method direct``.
Utilizzo
~~~~~~~~
::
pyrasite <pid> hello.py
pyrasite <pid> - <<'EOF'
import sys
print(sys.version)
EOF
pyrasite <pid> <(echo 'print("hello")')
Il payload viene letto dal processo pyrasite e incorporato nel comando gdb,
quindi il processo di destinazione non necessita di accesso in lettura al file
del payload. Questo significa anche che pipe e process substitution
funzionano. I payload standard possono essere selezionati per nome (vedere
``pyrasite --list-payloads``).
Test
~~~~
::
pip install -e ".[dev]"
pytest
ruff check .
ruff format --check .
Per eseguire la suite su ogni interprete supportato 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
Per testare l'iniezione da un interprete in tutti gli altri, impostare
``PYRASITE_TEST_INTERPRETERS`` su un elenco di percorsi di interpreti separati
da due punti prima di eseguire pytest.
pyrasite-gui
~~~~~~~~~~~~
L'interfaccia grafica è mantenuta separatamente su
https://github.com/lmacken/pyrasite-gui.
Autori
~~~~~~
Creato da `Luke Macken <https://twitter.com/lmacken>`_ con l'aiuto di
`David Malcolm <https://dmalcolm.livejournal.com>`_ e molti altri
`contributori <https://github.com/lmacken/pyrasite/contributors>`_.
Logo di `Adam Saunders <https://fedorahosted.org/design-team/ticket/214>`_.
Licenze
~~~~~~~
Codice
^^^^^^
.. 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/