
Внедрение кода в запущенные процессы Python
.. 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/
Инструменты для внедрения произвольного кода в работающие процессы Python.
: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
Требования
* `gdb <https://www.gnu.org/s/gdb>`_ (версия 7.3+)
* Система Linux, политика ptrace которой разрешает подключение к целевому
процессу. См. `ptrace_scope` ниже.
Установка
~~~~~~~~~
::
pipx install pyrasite
или, для дополнительного просмотрщика памяти::
pip install "pyrasite[memory-viewer]"
Совместимость
Pyrasite работает на CPython 3.9–3.15. Внедрение также работает между версиями, поэтому вы можете запускать Pyrasite под одним Python и внедрять код в процесс, работающий под другим. И клиент pyrasite, и целевой процесс должны быть CPython.
ptrace_scope
Современные дистрибутивы Linux ограничивают ptrace так, что к процессу могут
подключаться только его предки. Если ``/proc/sys/kernel/yama/ptrace_scope``
не равен нулю, вы увидите предупреждение. Вы можете либо разрешить подключение
глобально::
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope
либо позволить целевому процессу дать согласие, вызвав ``prctl(PR_SET_PTRACER,
PR_SET_PTRACER_ANY)``. В Fedora также может потребоваться SELinux::
sudo setsebool -P deny_ptrace=off
Для многопоточных программ pyrasite ставит полезную нагрузку в очередь через
``Py_AddPendingCall``, чтобы она выполнялась в потоке, уже владеющем GIL.
Если целевой процесс заблокирован в C и никогда не выполняет байт-код Python,
используйте вместо этого ``--inject-method direct``.
Использование
::
pyrasite <pid> hello.py
pyrasite <pid> - <<'EOF'
import sys
print(sys.version)
EOF
pyrasite <pid> <(echo 'print("hello")')
Полезная нагрузка читается процессом pyrasite и встраивается в команду gdb,
поэтому целевому процессу не нужен доступ на чтение к файлу полезной нагрузки.
Это также означает, что работают каналы и подстановка процессов. Стандартные
полезные нагрузки можно выбирать по имени (см. pyrasite --list-payloads).
Тестирование
::
pip install -e ".[dev]"
pytest
ruff check .
ruff format --check .
Чтобы запустить набор тестов для каждого поддерживаемого интерпретатора с
помощью `uv <https://docs.astral.sh/uv/>`_::
uv python install 3.9 3.10 3.11 3.12 3.13 3.14 3.15
tox
Чтобы проверить внедрение из одного интерпретатора во все остальные, задайте
``PYRASITE_TEST_INTERPRETERS`` как список путей к интерпретаторам, разделённых
двоеточием, перед запуском pytest.
pyrasite-gui
Графический интерфейс поддерживается отдельно по адресу https://github.com/lmacken/pyrasite-gui.
Авторы
Создано `Luke Macken <https://twitter.com/lmacken>`_ при помощи
`David Malcolm <https://dmalcolm.livejournal.com>`_ и многих других
`участников <https://github.com/lmacken/pyrasite/contributors>`_.
Логотип от `Adam Saunders <https://fedorahosted.org/design-team/ticket/214>`_.
Лицензии
Код ^^^
.. image:: https://www.gnu.org/graphics/gplv3-127x51.png :target: https://www.gnu.org/licenses/gpl.txt
Логотип ^^^^^^^
.. image:: https://creativecommons.org/images/deed/nolaw.png :target: https://creativecommons.org/publicdomain/zero/1.0/