logo3

bochscpu-python

روابط Python لمشروع BochsCPU الخاص بـ @yrp باستخدام FFI لمحاكاة كود x86 بسهولة ودقة.

التثبيت

يتطلب bochscpu-python بيئة Python بإصدار 3.8 أو أحدث فقط.

عبر PyPI (الطريقة المفضلة)

بلا شك، الطريقة الأبسط لبدء التشغيل هي استخدام الإصدار المستقر المعبأ على PyPI

python -m pip install bochscpu-python

عبر البناءات المولّدة

حمّل آخر قطعة عمل متاحة من تبويب GitHub Actions للمستودع. فك ضغط ملف ZIP، ثم ثبّت ملف .whl الذي ستجده داخل مجلد wheel.

python -m pip install wheel/bochscpu-$version-$os-$arch.whl

من مستودع المصدر

أمر مباشر إلى حد ما:

python -m pip install .

أو دون استنساخ:

python -m pip install git+https://github.com/hugsy/bochscpu-python.git#egg=bochscpu-python

لاحظ أن هذا الأسلوب سيتطلب منك تثبيت جميع أدوات البناء اللازمة (كما هو موضح أدناه)

البناء

المتطلبات

Python 3.8+ (مع حزمة التطوير)
cmake
pip
مترجم متوافق مع C++20 (تم اختباره باستخدام cl لنظام Windows وclang++ لنظام MacOS وg++ لنظام Linux)

الخطوات

قم ببناء BochsCPU وBochsCPU-FFI وBochsCPU-Build باتباع التعليمات الموجودة في صفحاتها الخاصة
... بدلاً من ذلك، يمكن تنزيل ملفات كائنات المكتبات الخاصة بـ BochsCPU-FFI لأنظمة Windows وLinux من build GitHub Actions
انقل ملفات *.lib إلى bochscpu/lib/<BuildType> (حيث يمكن أن يكون BuildType هو Debug أو Release أو RelWithDebInfo أو غير ذلك)
ثبّت المتطلبات: python -m pip install -r requirements.txt
قم بالبناء باستخدام cmake سيؤدي هذا إلى إنشاء ملف bochscpu pyd (وملف PDB الخاص به) والذي يمكنك استيراده من جلسة Python باستخدام import bochscpu.
... بدلاً من ذلك، يمكنك أيضاً توليد ملف .whl من جذر المشروع:

الاستخدام

فقط قم باستيراد وحدة bochscpu ودع المتعة تبدأ! ستعمل حزمة التثبيت أيضاً على تثبيت ملفات الواجهة، مما يسمح لبيئات التطوير الحديثة (VSCode وPyCharm وغيرها) بتقديم إكمال مفيد.

يمكن إنشاء قالب أولي بسيط على النحو التالي:

import bochscpu, bochscpu.utils, bochscpu.cpu

sess = bochscpu.Session()
sess.missing_page_handler = bochscpu.utils.callbacks.missing_page_cb
state = bochscpu.State()
bochscpu.cpu.set_real_mode(state)
hook = bochscpu.Hook()
bochscpu.utils.callbacks.install_default_callbacks(hook)
sess.run([hook,])

سيؤدي هذا إلى إنشاء جلسة bochscpu، وتعيين حالة وحدة المعالجة المركزية (CPU) للوضع الحقيقي، وتعبئة الخطافات (hooks) مسبقاً باستدعاءات أساسية (لا تقوم إلا بـ print عند التنفيذ). لاحظ أن هذا المثال لن يفعل شيئاً في الواقع لأننا لم نخصص صفحات كود ولم نضبط السجلات بشكل صحيح للإشارة إليها.

يمكن العثور على قالب أكثر اكتمالاً في مجلد examples/