दस्तावेज़सिंहावलोकन

दूसरे ढाँचे से आ रहा है

नेक्सी FastAPI प्लस फ़ाइल-आधारित रूटिंग, सर्वर-रेंडर किए गए पेज और वैकल्पिक React, Vue, Svelte, Solid या Preact द्वीप हैं। यह पृष्ठ वही दर्शाता है जो आप पहले से जानते हैं।

नीचे दिए गए प्रत्येक ढाँचे का अपना एक पृष्ठ भी है, कार्य दर कार्य, आपके द्वारा ज्ञात कोड और फिर नेक्सी कोड के साथ:

Python	बैकएंड	फुलस्टैक JavaScript
FastAPI	एक्सप्रेस, फास्टिफाइ	Next.js, Remix
Flask	एलिसिया, होनो	अगला
Django	NestJS, स्प्रिंग बूट	स्वेलटेकिट
	लारवेल, रूबी ऑन रेल्स	Astro

से FastAPI

FastAPI	नेक्सी
`@app.get("/users")` आपके द्वारा आयातित मॉड्यूल में	`GET` में फ़ंक्शन `src/routes/users.py`
`app.include_router(router)`	फ़ाइल पथ URL है; रजिस्टर करने के लिए कुछ भी नहीं
पथ परम `/users/{id}`	`src/routes/users/[id].py`
`Depends(...)`	अभी भी `Depends(...)`: हैंडलर FastAPI हैंडलर हैं
Jinja2 `TemplateResponse`	समापन बिंदु के बगल में एक `.nexy` पृष्ठ
`uvicorn main:app` के साथ चलाएँ	`nx dev`, फिर `nx build && nx start`

src/routes/*.py के अंतर्गत सब कुछ सामान्य है FastAPI: निर्भरताएं, Pydantic मॉडल, मिडलवेयर और /docs काम करते रहते हैं।

पहले और बाद में वही समापन बिंदु:

main.py

from fastapi import FastAPI app = FastAPI()  @app.get("/users/{id}")async def get_user(id: int):    return {"id": id}

src/routes/users/[id].py

async def GET(id: int):    return {"id": id}

FastAPI	नेक्सी
`@app.get("/users")` आपके द्वारा आयातित मॉड्यूल में	`async def get(self)` एक `@Controller("/users")` कक्षा में
`app.include_router(router)`	`@Module` के `controllers` में सूचीबद्ध नियंत्रक
पथ परम `/users/{id}`	`@Controller("/users/{id}")`, `async def get(self, id: int)` के साथ
`Depends(...)`	अभी भी `Depends(...)`: एक नियंत्रक विधि एक FastAPI समापन बिंदु है
Jinja2 `TemplateResponse`	`useViews("src/apps/....nexy")`, विधि द्वारा लौटाया गया
`uvicorn main:app` के साथ चलाएँ	`nx dev`, फिर `nx build && nx start`

निर्भरताएँ, Pydantic मॉडल, मिडलवेयर और /docs काम करते रहते हैं।

पहले और बाद में वही समापन बिंदु:

main.py

from fastapi import FastAPI app = FastAPI()  @app.get("/users/{id}")async def get_user(id: int):    return {"id": id}

src/apps/users/user_controller.py

from nexy.decorators import Controller  @Controller("/users/{id}")class UserController:    async def get(self, id: int):        return {"id": id}

से Next.js

Next.js	नेक्सी
`app/page.tsx`	`src/routes/index.tsx` या `index.nexy`
`app/blog/[slug]/page.tsx`	`src/routes/blog/[slug].tsx`
`app/layout.tsx` (`<html>` का मालिक है)	`src/routes/layout.tsx` के साथ `useCSR = True` (React), या `src/routes/layout.nexy` सर्वर मोड में
नेस्टेड `layout.tsx`	नेस्टेड `layout.tsx` / `layout.vue` / `layout.svelte` क्लाइंट मोड में, नेस्टेड `layout.nexy` सर्वर मोड में
`use client` सर्वर पेज में घटक	द्वीप सर्वर मोड में
मार्ग संचालक `route.ts`	`src/routes/api/x.py`, Python में लिखा गया
`(group)` फ़ोल्डर	वही: `(group)/`
सर्वर क्रियाएँ	`@Action` फ़ंक्शंस को किसी फ़ॉर्म से या टाइप किए गए क्लाइंट फ़ंक्शंस के रूप में बुलाया जाता है
`next dev` / `next build` / `next start`	`nx dev` / `nx build` / `nx start`

बैकएंड Python है, इसलिए आपका एपीआई आपके डेटा और एमएल कार्य के साथ कोड साझा करता है। क्लाइंट घटक पूरे पृष्ठ React पेड़ के बजाय द्वीपों के रूप में हाइड्रेट होते हैं।

एक Next.js पेज लगभग वैसे ही चलता रहता है, और इसका "use client" घटक एक सर्वर पेज का एक द्वीप बन जाता है:

src/routes/blog/[slug].tsx

import { useParams } from "@nexy/client"; export default function Post() {  const { slug } = useParams<{ slug: string }>();  return <h1>{slug}</h1>;}

src/routes/blog/[slug].nexy

---from "@/components/Comments.tsx" import Comments slug: prop[str]---<h1>{{ slug }}</h1><Comments post="{{ slug }}" directive="client:visible" />

Next.js	नेक्सी
`app/page.tsx`	एक नियंत्रक जो लौटाता है `useViews("src/apps/home_view.nexy")`
`app/blog/[slug]/page.tsx`	`@Controller("/blog/{slug}")`, `async def get(self, slug: str)` के साथ
`app/layout.tsx` (`<html>` का मालिक है)	एक लेआउट दृश्य जिसे नियंत्रक अपने दृश्य के चारों ओर लपेटता है, `children` के माध्यम से
`use client` सर्वर पेज में घटक	द्वीप एक दृश्य में
मार्ग संचालक `route.ts`	एक नियंत्रक जो Python में लिखा गया एक आदेश लौटाता है
सर्वर क्रियाएँ	`@Action` फ़ंक्शंस को किसी फ़ॉर्म से या टाइप किए गए क्लाइंट फ़ंक्शंस के रूप में बुलाया जाता है
`next dev` / `next build` / `next start`	`nx dev` / `nx build` / `nx start`

एक Next.js पृष्ठ एक नियंत्रक और उसका दृश्य बन जाता है, और उसका "use client" घटक दृश्य का एक द्वीप बन जाता है:

src/apps/blog/post_controller.py

from nexy.decorators import Controllerfrom nexy.hooks import useViews  @Controller("/blog/{slug}")class PostController:    async def get(self, slug: str):        return useViews("src/apps/blog/post_view.nexy", context={"slug": slug})

src/apps/blog/post_view.nexy

---from "@/components/Comments.tsx" import Comments slug: prop[str]---<h1>{{ slug }}</h1><Comments post="{{ slug }}" directive="client:visible" />

एक्सप्रेस या नोड बैकएंड से

एक्सप्रेस	नेक्सी
`app.get("/users/:id", handler)`	`src/routes/users/[id].py` के साथ `async def GET(id)`
`app.use(middleware)`	FastAPI मिडलवेयर, `nexyconfig.py` से पंजीकृत
`res.json(obj)`	एक आदेश या एक Pydantic मॉडल लौटाएँ
ईजेएस/पग दृश्य	`.nexy` (Jinja2) पृष्ठ
`npm run dev`	`nx dev`

app.use(...) nexyconfig.py का एक क्षेत्र बन जाता है, और res.json(...) एक रिटर्न मान बन जाता है:

nexyconfig.py

from nexy.core.models import NexyConfigModel  class NexyConfig(NexyConfigModel):    useCORS = {"allow_origins": ["https://example.com"]}    useGZip = {"minimum_size": 1000}

src/routes/users/[id].py

async def GET(id: int):    return {"id": id, "name": "Ada"}  # res.json({ id, name })

एक्सप्रेस	नेक्सी
`app.get("/users/:id", handler)`	`@Controller("/users/{id}")`, `async def get(self, id: int)` के साथ
`app.use(middleware)`	FastAPI मिडलवेयर, `nexyconfig.py` से पंजीकृत
`res.json(obj)`	एक आदेश या एक Pydantic मॉडल लौटाएँ
ईजेएस/पग दृश्य	`.nexy` (Jinja2) दृश्य, `useViews` द्वारा लौटाए गए
`npm run dev`	`nx dev`

app.use(...) nexyconfig.py का एक क्षेत्र बन जाता है, और res.json(...) एक रिटर्न मान बन जाता है:

nexyconfig.py

from nexy.core.models import NexyConfigModel  class NexyConfig(NexyConfigModel):    useCORS = {"allow_origins": ["https://example.com"]}    useGZip = {"minimum_size": 1000}

src/apps/users/user_controller.py

from nexy.decorators import Controller  @Controller("/users/{id}")class UserController:    async def get(self, id: int):        return {"id": id, "name": "Ada"}  # res.json({ id, name })

राउटर चुनना

उपयोग करें	कब
फ़ाइल-आधारित राउटर	फ़ाइलों से मैप किए गए पृष्ठ और समापन बिंदु; डिफ़ॉल्ट
मॉड्यूलर राउटर	नियंत्रक, मॉड्यूल और निर्भरता इंजेक्शन, NestJS-शैली

दो फाइलों में मॉड्यूलर राउटर: एक नियंत्रक, और मॉड्यूल nexyconfig.py useRouter = AppModule के साथ इंगित करता है:

src/apps/app_controller.py

from nexy.decorators import Controller  @Controller()class AppController:    async def get(self):        return {"message": "Hello"}

src/apps/app_module.py

from nexy.decorators import Modulefrom .app_controller import AppController  @Module()class AppModule:    controllers = [AppController]

दोनों को nx new द्वारा तैयार किया गया है और एक ही एंड-टू-एंड परीक्षणों द्वारा कवर किया गया है। रूटिंग और मॉड्यूलर रूटिंग देखें।

आगे कहाँ

त्वरित शुरुआत: एक प्रोजेक्ट बनाएं और उसे चलाएं
परियोजना संरचना: जहां प्रत्येक फ़ाइल संबंधित है
रूटिंग: राउटर चुनें

GitHub पर संपादित करें