ดาวน์โหลด snext - ดาวน์โหลดซอร์สโค้ด snext

snext

ซอร์สโค้ดอื่น ๆ

1.0.0

ดาวน์โหลด

เริ่มต้นใช้งาน Snext

Snext เป็นแอปพลิเคชัน Next.js ที่ให้คุณสร้างเส้นทาง API ใน Python

เน็กซ์เพราะเสียงเหมือน "งู" เหรอ?. คุณก็รู้เหมือนงูหลาม

/! /! /! นี่เป็นการทดลองเบื้องต้น

เริ่มต้นด้วยหลาม ?

เฮ้ ถ้าคุณอยู่ตรงนั้น คุณอาจเป็นนักพัฒนา JavaScript และ Python เป็นเพียงภาษาที่สองของคุณ

ต่อไปนี้เป็นวิธีการตั้งค่าสภาพแวดล้อม Python ที่มีประสิทธิภาพ

ติดตั้งหลาม

ฉันแนะนำให้ใช้ Pyenv เพื่อติดตั้ง Python พิจารณาว่าเทียบเท่ากับ Node Version Manager หรือ Volta แต่สำหรับ Python

ซึ่งเทียบเท่ากับการใช้ Volta หรือ NVM ในระบบนิเวศของ Node

การทำงานครั้งแรก: ตั้งค่าสภาพแวดล้อมเสมือน

Python ไม่มีโฟลเดอร์ node_modules นั่นอาจเป็นสิ่งที่ดีที่สุด แต่ก็ทำให้การจัดการการขึ้นต่อกันค่อนข้างยากเมื่อคุณมีโปรเจ็กต์จำนวนมากในเครื่องของคุณ

สภาพแวดล้อมเสมือนจริงจะคล้ายกันเล็กน้อย โดยมันจะบอกให้ Python ติดตั้งแพ็คเกจภายในโปรเจ็กต์ปัจจุบันของคุณ ไม่ใช่แบบโกลบอล

ความแตกต่างกับ Node คือคุณต้องเปิดใช้งานอย่างเป็นระบบ

ตั้งค่าสภาพแวดล้อมเสมือนและติดตั้งแพ็คเกจ Python:

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

การวิ่งครั้งต่อไป

คุณต้องเปิดใช้งาน env เสมือนเมื่อคุณเริ่มทำงาน:

 source ./venv/bin/activate

คำสั่งนี้ใช้ไม่ได้กับสคริปต์ NPM น่าเศร้า คุณต้องพิมพ์มันทุกครั้ง

เริ่มต้นเลย

แหล่งข้อมูลและแรงบันดาลใจต่างๆ

การสนทนาเกี่ยวกับ Vercel Github: vercel/vercel#4023
Plotly Dash: หนึ่งในความพยายามที่น่าประทับใจที่สุดในการเขียนโปรแกรมเว็บแบบ isomorphic 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
vercel/next.js#15846

สิ่งที่ต้องทำ

ตรวจสอบว่า vercel CLI สามารถแก้ไขปัญหาของเราได้มากเพียงใด (ดู https://vercel.com/docs/cli#commands/dev) => เสร็จแล้ว ทำได้!
ทดสอบบิลด์ท้องถิ่น
ทดสอบการใช้งาน Vercel
ปรับปรุงประสบการณ์การพัฒนาด้วย Python ซึ่งน่าเบื่อกว่าการใช้ JS (env เสมือน) เล็กน้อย
สร้างด้วย "pkg"
ลองใช้ "Pipfile" ที่คล้ายกับ package.json มากขึ้น: https://github.com/pypa/pipfile

บล็อคเกอร์หลัก

1) ใช้งานเซิร์ฟเวอร์ 2 ตัว (หรือมากกว่า) บนพอร์ตเดียวกันสำหรับ Python และ Node SOLVED

สารละลาย:

ใช้ Vercel CLI แทน next dev

คำสั่ง Vercel CLI vercel dev สามารถจำลองสภาพแวดล้อมแบบไร้เซิร์ฟเวอร์ในเครื่องได้ คุณจึงสามารถทดสอบเส้นทาง API ของคุณได้

หากคุณใส่เส้นทาง API ทั้งหมดไว้ใน ./api/ และใช้ vercel dev คุณสามารถมีทั้งเส้นทาง Python และ Node.js API (และแน่นอนว่าส่วนหน้า Next.js ยังคงทำงานได้ดี)

อ่าน vercel/vercel#6197

โหนด + หลาม

เมื่อเรียกใช้ Next คุณจะต้องให้ทุกอย่างทำงานบน localhost:3000 แต่คุณจะมีเซิร์ฟเวอร์ 2 เครื่อง: หนึ่งเครื่องสำหรับ Node และอีกเครื่องหนึ่งสำหรับ Python ซึ่งต้องใช้ตรรกะในการเขียนใหม่จึงจะทำงานได้

แนวทางแก้ไขที่เป็นไปได้

ตรวจสอบว่า Next.js เขียนซ้ำใน next.config.js อนุญาตสิ่งนี้แล้วหรือไม่
เรียกใช้เซิร์ฟเวอร์เครื่องที่ 3 ที่จัดการการเปลี่ยนเส้นทาง

คำถาม

จะแก้ไขได้อย่างไรใน Next สำหรับเส้นทาง API และส่วนหน้า

หลาม + หลาม

นอกจากนี้ เราอาจมีหลายเส้นทาง 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/
ผู้มอบหมายงานสำหรับ Sanic: 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

สคริปต์ต้องตั้งชื่อว่า smth มิฉะนั้นสำหรับอินสแตนซ์ dev:vercel มิฉะนั้นจะสร้างการวนซ้ำไม่สิ้นสุด

ขีดเส้นใต้ในชื่อโฟลเดอร์ Python

ไม่ - ในชื่อโฟลเดอร์ใน Python ไม่เช่นนั้นคุณจะประสบปัญหาในการนำเข้าไฟล์... ใช้ขีดล่าง _ สิ่งนี้อาจทำให้เกิด URL ที่ยุ่งเหยิงเนื่องจากชื่อโฟลเดอร์เชื่อมโยงกับชื่อเส้นทางใน Next

แนวทางแก้ไขที่เป็นไปได้

สร้างแผนที่ของเส้นทางที่เป็นไปได้โดยอัตโนมัติ หรือใช้การเขียน 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 คุณต้องมี Virtual Environment เพื่อแยกแพ็คเกจของคุณระหว่างแอพต่างๆ ในขณะที่ JS node_modules มีบทบาทนี้ ปัญหาคือคุณต้องเปิดใช้งานสภาพแวดล้อมเสมือนเมื่อคุณเริ่มทำงาน ดังนั้นนั่นจึงเป็นขั้นตอนเพิ่มเติมสำหรับนักพัฒนา ที่แย่ไปกว่านั้นคือ ไม่สามารถใส่คำสั่ง source ที่เปิดใช้งานสภาพแวดล้อมได้ (ครั้งสุดท้ายที่ฉันตรวจสอบ) ใน package.json ดังนั้นคุณต้องจำคำสั่งที่ถูกต้องทุกครั้ง