
حقن الكود في عمليات بايثون الجارية
.. 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،
لذا لا تحتاج العملية الهدف إلى صلاحية قراءة ملف الحمولة. يعني هذا أيضًا
أن الأنابيب واستبدال العمليات (process substitution) تعمل. يمكن اختيار الحمولات القياسية
بالاسم (راجع ``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/