
Injetar código em processos Python em execução
.. 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/
Ferramentas para injetar código arbitrário em processos Python em execução.
: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>`_ (versão 7.3+)
* Um sistema Linux cuja política de ptrace permita anexar ao processo
alvo. Veja `ptrace_scope` abaixo.
Instalação
::
pipx install pyrasite
ou, para o visualizador de memória opcional::
pip install "pyrasite[memory-viewer]"
Compatibilidade
O Pyrasite é executado em CPython 3.9 até 3.15. A injeção também funciona
entre versões, então você pode executar o Pyrasite em um Python e injetar em
um processo executando outro. Tanto o cliente pyrasite quanto o processo alvo
devem ser CPython.
ptrace_scope
~~~~~~~~~~~~
Distribuições Linux recentes restringem o ptrace de modo que um processo só
pode ser anexado por seus ancestrais. Se ``/proc/sys/kernel/yama/ptrace_scope``
for diferente de zero, você verá um aviso. Você pode permitir a anexação
globalmente::
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope
ou deixar o processo alvo optar por isso chamando ``prctl(PR_SET_PTRACER,
PR_SET_PTRACER_ANY)``. No Fedora, o SELinux também pode precisar de::
sudo setsebool -P deny_ptrace=off
Para programas multi-thread, o pyrasite enfileira o payload com
``Py_AddPendingCall`` para que ele seja executado em uma thread que já
possui o GIL. Se o alvo estiver bloqueado em C e nunca executar bytecode
Python, use ``--inject-method direct`` em vez disso.
Uso
~~~
::
pyrasite <pid> hello.py
pyrasite <pid> - <<'EOF'
import sys
print(sys.version)
EOF
pyrasite <pid> <(echo 'print("hello")')
O payload é lido pelo processo pyrasite e embutido no comando gdb, então o
alvo não precisa de acesso de leitura ao arquivo de payload. Isso também
significa que pipes e substituição de processo funcionam. Payloads padrão
podem ser selecionados por nome (veja ``pyrasite --list-payloads``).
Testes
~~~~~~
::
pip install -e ".[dev]"
pytest
ruff check .
ruff format --check .
Para executar a suíte em todos os interpretadores suportados com `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 testar a injeção de um interpretador em todos os outros, defina
``PYRASITE_TEST_INTERPRETERS`` como uma lista de caminhos de interpretadores
separados por dois-pontos antes de executar o pytest.
pyrasite-gui
~~~~~~~~~~~~
A interface gráfica é mantida separadamente em
https://github.com/lmacken/pyrasite-gui.
Autores
~~~~~~~
Criado por `Luke Macken <https://twitter.com/lmacken>`_ com a ajuda de
`David Malcolm <https://dmalcolm.livejournal.com>`_ e muitos outros
`colaboradores <https://github.com/lmacken/pyrasite/contributors>`_.
Logo por `Adam Saunders <https://fedorahosted.org/design-team/ticket/214>`_.
Licenças
~~~~~~~~
Código
^^^^^^
.. 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/