تنزيل snext - تنزيل كود المصدر snext

snext

شفرة المصدر الأخرى

1.0.0

تنزيل

الشروع في العمل مع سنيكست

Snext هو تطبيق Next.js الذي يتيح لك إنشاء مسارات API في Python.

Snext، لأنه يبدو وكأنه "ثعبان"؟. كما تعلمون، مثل بايثون.

/! /! /! هذه تجربة مبكرة

ابدأ مع بايثون؟

مرحبًا، إذا انتهى بك الأمر هناك، فمن المحتمل أنك مطور JavaScript وPython هي لغتك الثانية فقط.

إليك كيفية إعداد بيئة بايثون فعالة.

تثبيت بايثون

أقترح استخدام Pyenv لتثبيت Python. اعتبره مكافئًا لـ Node Version Manager أو Volta ولكن بالنسبة لـ Python.

وهذا يعادل استخدام Volta أو NVM في النظام البيئي للعقدة.

التشغيل الأول: إعداد بيئة افتراضية.

لا تحتوي لغة Python على مجلد node_modules . ربما يكون هذا هو الأفضل، لكنه يجعل من الصعب جدًا التعامل مع التبعيات عندما يكون لديك الكثير من المشاريع على جهازك.

البيئة الافتراضية متشابهة بعض الشيء: ستطلب من Python تثبيت الحزم محليًا لمشروعك الحالي، وليس عالميًا.

الفرق مع Node هو أنه يجب عليك تمكينها بشكل منهجي.

قم بإعداد بيئة افتراضية وتثبيت حزم Python:

python3 -m venv ./venv
source ./venv/bin/activate
pip install -r requirements.txt

أشواط لاحقة

تحتاج إلى تفعيل البيئة الافتراضية عند بدء العمل:

 source ./venv/bin/activate

هذا الأمر لا يعمل في البرامج النصية NPM، للأسف. عليك أن تكتبه في كل مرة.

ابدأ

الموارد والإلهام المختلفة

مناقشة حول Vercel Github: vercel/vercel#4023
Plotly Dash: واحدة من أكثر المحاولات إثارة للإعجاب في برمجة الويب المتماثلة. يتيح لك Dash استخدام مكونات React في Python لإنشاء لوحات معلومات تفاعلية https://plotly.com/dash/
المستند الرسمي حول Python في Vercel: https://vercel.com/docs/runtimes#official-runtimes/python
https://stackoverflow.com/questions/63190114/call-a-python-script-from-react-with-next-routing-and-a-node-js-server
https://medium.com/swlh/build-a-twitter-login-component-using-nextjs-and-python-flask-44c17f057096
فيرسل/next.js#15846

المهام

تحقق من مقدار قدرة vercel CLI على حل مشكلاتنا (راجع https://vercel.com/docs/cli#commands/dev) => تم ذلك، لقد تم ذلك!
اختبار البناء المحلي
اختبار نشر vercel
تحسين تجربة التطوير باستخدام Python، وهو أمر ممل بعض الشيء من استخدام JS (البيئة الافتراضية)؟
البناء باستخدام "pkg"
حاول استخدام "Pipfile" الذي يشبه package.json: https://github.com/pypa/pipfile

الحاصرات الرئيسية

1) تشغيل خادمين (أو أكثر) على نفس المنفذ لـ Python وNode تم الحل

حل:

استخدم Vercel CLI بدلاً من next dev .

أمر Vercel CLI، vercel dev قادر على محاكاة بيئة بدون خادم محليًا، حتى تتمكن من اختبار مسارات API الخاصة بك.

إذا قمت بوضع جميع مسارات واجهة برمجة التطبيقات في ./api/ ، واستخدمت vercel dev ، فيمكنك الحصول على مسارات واجهة برمجة تطبيقات Python وNode.js (وبالطبع لا تزال الواجهة الأمامية لـ Next.js تعمل بشكل جيد).

اقرأ فيرسيل/فيرسيل#6197

العقدة + بايثون

عند تشغيل Next، ستحتاج إلى تشغيل كل شيء على localhost:3000 ، ولكن سيكون لديك خادمين: واحد لـ Node، والآخر لـ Python. وهذا يتطلب بعض إعادة كتابة المنطق للعمل.

الحلول الممكنة

تحقق مما إذا كانت إعادة كتابة Next.js في next.config.js تسمح بذلك بالفعل
قم بتشغيل خادم ثالث يتعامل مع إعادة التوجيه

أسئلة

كيف يتم حلها في Next لمسارات API والواجهة الأمامية؟

بايثون + بايثون

أيضًا، قد يكون لدينا مسارات متعددة لواجهة برمجة التطبيقات، والتي ستكون بمثابة وظائف بدون خادم عند نشرها. لكن محليا يجب أن نجعلهم خادما واحدا.

الحلول الممكنة

لدينا حل جزئي مع Sanic Dispatcher، راجع "python-server.py". يعتمد على خادم رئيسي، يرسل الطلب إلى تطبيقات Sanic، بحيث يكون لديك خادم واحد فقط ويمكنك تشغيل مسارات API متعددة
ما زلنا بحاجة إلى أتمتة استيراد المسارات ذات الصلة. باستخدام نوع من السحر الشبيه بـ Webpack، ولكن في Python.
https://peterhaas-me.medium.com/how-to-run-multiple-flask-applications-from-the-same-server-9ca2c0ad7bb3
https://werkzeug.palletsprojects.com/en/1.0.x/middleware/dispatcher/
مرسل سانيك: https://github.com/ashleysommer/sanic-dispatcher/blob/master/sanic_dispatcher/extension.py#L131

2) الحصول على بيانات ثابتة

النمط الموصى به للحصول على بيانات ثابتة من مسارات واجهة برمجة التطبيقات (API) في Next، هو إعادة استخدام المنطق الأساسي للمسار مباشرةً في getStaticProps . ولكن هذا ممكن فقط لأن كلاهما يستخدم JS. مع Python، سنحتاج إلى إنشاء مسارات واجهة برمجة التطبيقات (API) أولاً، وتشغيلها، ثم بناء الواجهة الأمامية فقط.

يجب اختباره باستخدام Vercel CLI.

3) فشل وقت التشغيل

لدينا هذا الخطأ https://github.com/vercel/community/discussions/103 في الإصدار الأخير، ويبدو أن وقت تشغيل Python كبير جدًا. راجع vercel/community#103 (تعليق) راجع vercel/vercel#2830

القضايا الثانوية

لا يمكن الحصول على vercel dev كأمر dev

راجع https://github.com/vercel/vercel/blob/main/errors/now-dev-as-dev-script.md

يجب تسمية البرنامج النصي بشيء آخر على سبيل المثال dev:vercel وإلا فإنه ينشئ حلقة لا نهائية.

تسطير أسفل السطر في أسماء مجلدات بايثون

لا - في أسماء المجلدات في بايثون، وإلا ستواجه صعوبة في استيراد الملفات... استخدم الشرطة السفلية _ . قد يؤدي هذا إلى عناوين URL فوضوية لأن اسم المجلد مرتبط باسم المسار في التالي.

الحلول الممكنة

قم بإنشاء خريطة للطرق المحتملة تلقائيًا، أو استخدم إعادة كتابة عنوان URL

ما الخادم لاختيار

(من تجربتي المحدودة مع Python) كنت أميل إلى مقارنة Flask أو Falcon بـ Express: استخدم كثيرًا، وبحد أدنى بما فيه الكفاية. لكن سلوك الحظر في Python يمكن أن يكون مربكًا جدًا لمطور JavaScript. لذا سأختار Sanic، لأنه يعتمد على async/await مثل Node.js وقد يكون الأقل إرباكًا.

على أية حال، كل المعرفة التي تم جمعها لإطار واحد يجب أن تكون قابلة لإعادة الاستخدام لأي إطار عمل آخر.

إعداد وقت التشغيل للاستضافة

للتبسيط، سنفترض الاستضافة على Vercel. قد نحتاج إلى vercel.json لإخبار Vercel بوقت التشغيل الذي يجب استخدامه: https://vercel.com/docs/runtimes#advanced-usage/community-runtimes

نظرًا لأن Vercel dev يعمل، فيجب أن نتوقع أن يتم نشر Vercel خارج الصندوق. ليتم اختبارها.

البيئة الافتراضية

في Python، تحتاج إلى بيئة افتراضية لعزل الحزم الخاصة بك بين التطبيقات، بينما في node_modules في JS تلعب هذا الدور. المشكلة هي أنه يجب تفعيل البيئة الافتراضية عند بدء العمل، وهذه خطوة إضافية للمطور. ولجعل الأمر أسوأ، لا يمكن وضع الأمر source الذي ينشط البيئة (آخر مرة قمت فيها بالتحقق) في package.json ، لذلك عليك أن تتذكر الأمر الصحيح في كل مرة.