Python Splitter

Python Splitter أداة موجهة للمطورين تحوّل سكريبتات بايثون الكبيرة إلى وحدات معيارية مناسبة للتعبئة والتعاون. تستهدف مهندسي البرمجيات والعلماء والمهندسين المؤتمتة الذين يديرون قواعد كود تتوسع إلى ما وراء ملف واحد. من خلال وضع حدود وحدة متماسكة، يقلل من الحمل المعرفي أثناء مراجعات الكود ويبسّط إدارة الاعتماديات والاختبارات وعمليات النشر.
يقوم بتحليل الشفرة المصدرية لبايثون باستخدام AST، محدداً التعريفات على المستوى الأعلى والاستيرادات ومنطق __main__؛ يدعم التقسيم حسب الدالة أو الفئة، أو حسب المناطق المميزة، أو حسب قواعد تجميع مخصصة. يحافظ على الاستيرادات والمرجعيات النسبية، وينشئ ملفات وحدة منفصلة، واختياريًا يولّد __init__.py لتكوين حزمة.
بالمقارنة مع التقسيم اليدوي، يوفر الأداة نتائج حتمية، يتعامل مع تعارضات الأسماء بإعادة تسمية قابلة للتكوين، ويمكنه تصدير حزمة جاهزة للتوزيع. هو مفيد بشكل خاص لإعادة هيكلة مكتبات قديمة، إنشاء حزم ميكرو، أو عزل كود التجارب في مشاريع البيانات. كما يدعم سير العمل التعليمية من خلال عرض كيفية تقسيم سكريبتات كبيرة إلى مكونات قابلة لإعادة الاستخدام.
تشمل الميزات الأساسية التقسيم المعتمد على AST، الحدود القابلة للتكوين، الحفاظ على الاستيرادات والاعتماديات، خيار استخراج docstring وبنية إخراج تتوافق مع اتفاقيات تعبئة بايثون. تُعلَم الحالات الحديّة مثل الاستيرادات الديناميكية واستخدام eval/exec والاعتماديات الدائرية، مع حلول رجوع آمنة إلى التقسيم بحسب السطر. الأداة لا تشغّل الكود ولا الاختبارات وتفترض أن المدخل يتوافق مع بناء بايثون بعد المعالجة الأولية.