
चल रहे 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
एक इंटरप्रेटर से अन्य सभी में इंजेक्ट करने का परीक्षण करने के लिए, pytest चलाने से पहले PYRASITE_TEST_INTERPRETERS को इंटरप्रेटर पथों की कोलन-पृथक सूची पर सेट करें।
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/