jedi

Jedi - مكتبة رائعة للإكمال التلقائي والتحليل الثابت وإعادة البناء لـ Python

Jedi هي أداة تحليل ثابتة لـ Python تُستخدم عادةً في المكونات الإضافية لـ IDEs/المحررين. يركز Jedi على الإكمال التلقائي ووظيفة الانتقال. وتشمل الميزات الأخرى إعادة البناء والبحث عن التعليمات البرمجية والعثور على المراجع.

لدى Jedi واجهة برمجة تطبيقات بسيطة للعمل معها. يوجد تطبيق مرجعي باعتباره VIM-Plugin. من الممكن أيضًا الإكمال التلقائي في REPL الخاص بك، ويستخدمه IPython محليًا وبالنسبة لـ CPython REPL يمكنك تثبيته. تم اختبار Jedi جيدًا ويجب أن تكون الأخطاء نادرة.

يمكن استخدام Jedi حاليًا مع المحررين/المشاريع التالية:

• فيم (jedi-vim، YouCompleteMe، deoplete-jedi، completor.vim)
• كود Visual Studio (عبر ملحق Python)
• Emacs (Jedi.el، وضع الشركة، elpy، وضع anaconda، ycmd)
• نص سامية (SublimeJEDI [ST2 + ST3]، اناكوندا [ST3 فقط])
• TextMate (لست متأكدًا مما إذا كان يعمل بالفعل)
• الإصدار 4.13+ من Kate يدعمه محليًا، لكن يجب عليك تمكينه. [يرى]
• الذرة (الإكمال التلقائي-بيثون-جيدي)
• GNOME Builder (مع دعم GObject Introspection)
• جيديت (جيدي)
• WDB - مصحح أخطاء الويب
• إريك إيد
• آي بايثون 6.0.0+
• تحتوي قذيفة xonsh على امتداد jedi

وغيرها الكثير!

هناك عدد قليل من خوادم اللغات التي تستخدم Jedi:

• خادم لغة جيدي
• خادم لغة بايثون (لا تتم صيانته حاليًا)
• python-lsp-server (شوكة من خادم لغة python)
• خادم لغة anakin

إليكم بعض الصور المأخوذة من jedi-vim:

الانتهاء من أي شيء تقريبا:

التوثيق:

احصل على أحدث إصدار من github (يجب أن يكون الفرع الرئيسي دائمًا مستقرًا/عاملًا).

المستندات متاحة على https://jedi.readthedocs.org/en/latest/. طلبات السحب مع التحسينات و/أو الإصلاحات رائعة ومرحب بها للغاية. يستخدم Jedi الإصدارات الدلالية.

إذا كنت ترغب في البقاء على اطلاع دائم بالإصدارات، يرجى الاشتراك في القائمة البريدية هذه: https://groups.google.com/g/jedi-announce. للاشتراك يمكنك ببساطة إرسال بريد إلكتروني فارغ إلى [email protected] .

القضايا والأسئلة

يمكنك تقديم المشكلات والأسئلة في أداة تعقب المشكلات <https://github.com/davidhalter/jedi/>. وبدلاً من ذلك، يمكنك أيضًا السؤال عن Stack Overflow بالتسمية python-jedi .

تثبيت

تحقق من المستندات.

الميزات والقيود

ميزات Jedi مدرجة هنا: الميزات.

يمكنك تشغيل Jedi على Python 3.6+ ولكن يجب أيضًا أن يفهم التعليمات البرمجية الأقدم من تلك الإصدارات. بالإضافة إلى ذلك، يجب أن تكون قادرًا على استخدام Virtualenvs بشكل جيد جدًا.

يمكن العثور على نصائح حول كيفية استخدام Jedi بكفاءة هنا.

واجهة برمجة التطبيقات

يمكنك العثور على وثائق شاملة لواجهة برمجة التطبيقات (API) هنا.

الإكمال التلقائي / الانتقال إلى / التوثيق

هناك الأوامر التالية:

• jedi.Script.goto
• jedi.Script.infer
• jedi.Script.help
• jedi.Script.complete
• jedi.Script.get_references
• jedi.Script.get_signatures
• jedi.Script.get_context

الكائنات التي تم إرجاعها قوية جدًا وهي حقًا كل ما قد تحتاجه.

الإكمال التلقائي في REPL (IPython، وما إلى ذلك)

Jedi هو تبعية لـ IPython. وبالتالي فإن الإكمال التلقائي في IPython مع Jedi ممكن بدون تكوين إضافي.

فيما يلي مثال على مقطع فيديو حول الشكل الذي يمكن أن يبدو عليه إكمال REPL. بالنسبة لـ python Shell، يمكنك تمكين إكمال علامة التبويب في REPL.

التحليل الساكن

بالنسبة للعديد من أشكال التحليل الثابت، يمكنك محاولة استخدام jedi.Script(...).get_names . سيُرجع قائمة بالأسماء التي يمكنك بعد ذلك تصفيتها والعمل معها. هناك أيضًا طريقة لسرد الأخطاء النحوية في ملف: jedi.Script.get_syntax_errors .

إعادة البناء

يدعم Jedi عمليات إعادة البناء التالية:

• jedi.Script.inline
• jedi.Script.rename
• jedi.Script.extract_function
• jedi.Script.extract_variable

البحث عن الكود

يوجد دعم للبحث عن الوحدة باستخدام jedi.Script.search والبحث عن المشروع لـ jedi.Project.search . طريقة البحث هي إما عن طريق تقديم اسم مثل foo أو باستخدام بناء جملة منقط مثل foo.bar . بالإضافة إلى ذلك، يمكنك توفير نوع واجهة برمجة التطبيقات (API) مثل class foo.bar.Bar . هناك أيضًا الوظائف jedi.Script.complete_search و jedi.Project.complete_search .

تطوير

هناك وثائق تطوير جيدة وشاملة.

اختبار

يستخدم جناح الاختبار pytest :

 نقطة تثبيت pytest

إذا كنت تريد اختبار إصدار محدد فقط من Python (مثل Python 3.8)، فالأمر سهل كما يلي:

 python3.8 -m pytest

لمزيد من المعلومات التفصيلية، قم بزيارة وثائق الاختبار.

شكر وتقدير

شكرا جزيلا لجميع المساهمين!