दस्तावेज़फुलस्टैक फ्रेमवर्क
रूबी ऑन रेल्स से लेकर नेक्सी तक
नेक्सी में एक रेल मार्ग और उसकी नियंत्रक कार्रवाई src/routes/ के अंतर्गत एक फ़ाइल बन जाती है: ईआरबी दृश्य Jinja2 के साथ .nexy पृष्ठ बन जाते हैं, मजबूत पैरामीटर Pydantic मॉडल बन जाते हैं, और before_action एक dependencies.py बन जाते हैं।
नीचे प्रत्येक अनुभाग एक रेल आदत दिखाता है, फिर नेक्सी में भी वही चीज़।
एक मार्ग और उसकी क्रिया
get "/api/hello", to: "hello#show"class HelloController < ApplicationController def show render json: { message: "Hello" } endendकोई routes.rb नहीं है: फ़ाइल पथ यूआरएल है, फ़ंक्शन नाम HTTP विधि है।
async def GET(): return {"message": "Hello"}resources
resources :notes, only: [:index, :create, :show, :destroy]सात REST क्रियाएँ दो फ़ाइलों में फैली हुई हैं, प्रति URL एक:
from pydantic import BaseModel NOTES: dict[int, str] = {} class NewNote(BaseModel): title: str async def GET(): return [{"id": id, "title": title} for id, title in NOTES.items()] async def POST(note: NewNote): id = max(NOTES, default=0) + 1 NOTES[id] = note.title return {"id": id, "title": note.title}from nexy.http import HTTPException from .index import NOTES async def GET(id: int): if id not in NOTES: raise HTTPException(status_code=404, detail="No such note") return {"id": id, "title": NOTES[id]} async def DELETE(id: int): NOTES.pop(id, None) return {"deleted": id}| रेल कार्रवाई | नेक्सी |
|---|---|
index, create |
GET, POST में notes/index.py |
show, update, destroy |
GET, PATCH, DELETE में notes/[id].py |
new, edit |
.nexy पेज, notes/new.nexy और notes/[id]/edit.nexy |
params और मजबूत पैरामीटर
def create item = params.require(:item).permit(:name, :price) render json: item, status: :createdendमॉडल परमिट सूची और सत्यापन है: अज्ञात फ़ील्ड हटा दिए जाते हैं, गलत उत्तर देते हैं 422।
from pydantic import BaseModel, Field from nexy.http import JSONResponse class NewItem(BaseModel): name: str price: float = Field(gt=0) async def POST(item: NewItem): return JSONResponse(item.model_dump(), status_code=201)एक क्वेरी स्ट्रिंग पैरामीटर, params[:q], एक फ़ंक्शन पैरामीटर है:
async def GET(q: str = "", page: int = 1): return {"q": q, "page": page}namespace और before_action
namespace :admin do get "stats", to: "stats#show"endclass Admin::BaseController < ApplicationController before_action :require_admin private def require_admin head :forbidden unless request.headers["X-Role"] == "admin" endendनेमस्पेस फ़ोल्डर है, और इसका dependencies.py इसमें प्रत्येक रूट का before_action है:
async def GET(): return {"users": 3}from nexy.http import Header, HTTPException def require_admin(x_role: str = Header("")) -> None: if x_role != "admin": raise HTTPException(status_code=403, detail="Admins only") dependencies = [require_admin]after_action और रैक मिडलवेयर
after_action { response.set_header("X-App", "demo") }from nexy.http import Request async def middleware(request: Request, call_next): response = await call_next(request) response.headers["x-app"] = "demo" return responseईआरबी विचार
def index @users = [{ name: "Ada" }, { name: "Alan" }]end<ul> <% @users.each do |user| %> <li><%= user[:name] %></li> <% end %></ul>क्रिया और दृश्य एक .nexy फ़ाइल हैं; उदाहरण चर सादे नाम बन जाते हैं:
users = [{"name": "Ada"}, {"name": "Alan"}]<ul> {% for user in users %} <li>{{ user.name }}</li> {% endfor %}</ul><%= %> बच जाता है और {{ }} नहीं बचता: विज़िटर ने {{ value | e }} से जो टाइप किया है वह बच जाता है। <%== %> और raw | safe हैं।
लेआउट और yield
<!DOCTYPE html><html> <body><%= yield %></body></html>children: prop[NexyElement]<!DOCTYPE html><html> <body>{{ children | safe }}</body></html>एक सबफ़ोल्डर में एक layout.nexy इसके अंदर घोंसला बनाता है, जैसा कि प्रति नियंत्रक एक लेआउट करता है।
आंशिक
<article><h2><%= title %></h2><%= yield %></article><%= render "shared/card", title: "Latest" do %><p>This week</p><% end %>
title: prop[str]<article> <h2>{{ title }}</h2> <Slot /></article>from "@/components/Card.nexy" import Card<Card title="Latest"> <p>This week</p></Card>@ है src/: nx new nexyconfig.py में useAliases = {"@": "src"} लिखता है।
form_with और redirect_to
<%= form_with url: notes_path do |form| %> <%= form.text_field :title %> <%= form.submit "Add" %><% end %>def create Note.create!(title: params[:title]) redirect_to notes_pathendएक क्रिया वह है create प्रपत्र जिस पर पोस्ट किया जाता है। इसके पैरामीटर फ़ील्ड हैं, और विज़िटर को 303 के साथ पृष्ठ पर वापस भेज दिया जाता है:
from nexy.decorators import Action TITLES: list[str] = [] @Actionasync def add_note(title: str) -> None: TITLES.append(title)from src.actions.notes import TITLES<form method="post" action="{{ __actions_path['add_note'] }}"> <input name="title"> <button type="submit">Add</button></form><ul> {% for title in TITLES %} <li>{{ title }}</li> {% endfor %}</ul>सक्रिय रिकॉर्ड और माइग्रेशन
class Post < ApplicationRecord scope :published, -> { where(published: true) }endनेक्सी का अपना कोई ORM नहीं है; nx new मचान SQLModel, SQLAlchemy या कछुआ-ओआरएम कर सकता है। SQLModel के साथ:
from sqlmodel import Field, SQLModel class Post(SQLModel, table=True): id: int | None = Field(default=None, primary_key=True) title: str published: bool = Falsefrom sqlmodel import Session, select from src.configs.db import enginefrom src.models.post_model import Post async def GET(): with Session(engine) as session: posts = session.exec(select(Post).where(Post.published)).all() return {"titles": [post.title for post in posts]}| रेल | नेक्सी |
|---|---|
rails generate migration AddPosts |
nx migrate -m "add posts" |
rails db:migrate |
nx migrate --upgrade |
ActiveRecord::RecordNotFound और public/404.html
def show @post = POSTS.fetch(params[:slug]) { raise ActiveRecord::RecordNotFound }endfrom nexy import notFound POSTS = {"hello": "Hello, world"} slug: prop[str]if slug not in POSTS: notFound()<h1>{{ POSTS[slug] }}</h1>notfound.nexy रूट रूट पर public/404.html है, जिसे किसी भी पेज की तरह प्रस्तुत किया गया है:
<h1>Not found</h1>सत्र
def create session[:user] = params[:name] render json: { user: session[:user] }endfrom nexy.core.models import NexyConfigModel class NexyConfig(NexyConfigModel): useAliases = {"@": "src"} useSession = {"secret_key": "change-me"}from pydantic import BaseModel from nexy.http import Request class Login(BaseModel): name: str async def POST(request: Request, body: Login): request.session["user"] = body.name return {"user": body.name}एक पृष्ठ इसे useSession() के साथ पढ़ता है।
कैशिंग
def index expires_in 1.minute, public: trueendrevalidate = 60<h1>Blog</h1>सक्रिय कार्य
WelcomeMailerJob.perform_later(params[:email])head :acceptedfrom nexy.http import BackgroundTasks, JSONResponse def send_welcome(email: str) -> None: ... async def POST(email: str, tasks: BackgroundTasks): tasks.add_task(send_welcome, email) return JSONResponse({"queued": True}, status_code=202)पुनर्प्रयासों और अलग-अलग श्रमिकों के लिए, जैसे कि साइडकीक के साथ, सेलेरी, आरक्यू या आर्क का उपयोग करें।
एक्शन केबल
class EchoChannel < ApplicationCable::Channel def receive(data) transmit(data) endendfrom fastapi import WebSocket async def SOCKET(websocket: WebSocket): await websocket.accept() await websocket.send_text(await websocket.receive_text())हॉटवायर
टर्बो ड्राइव का पेज स्वैप क्लाइंट-मोड प्रोजेक्ट के क्लाइंट राउटर से मेल खाता है, और स्टिमुलस नियंत्रक द्वीपों से मेल खाते हैं: एक छोटा घटक जो सर्वर पेज के अंदर हाइड्रेट होता है। द्वीप और सीएसआर देखें।
परीक्षण
RSpec.describe "Hello", type: :request do it "says hello" do get "/api/hello" expect(response.parsed_body).to eq("message" => "Hello") endendfrom fastapi.testclient import TestClient from nexy.app import app def test_hello(): assert TestClient(app).get("/api/hello").json() == {"message": "Hello"}चल रहा है
| रेल | नेक्सी |
|---|---|
rails new |
nx new |
bin/rails server |
nx dev |
bin/rails routes |
/docs |
RAILS_ENV=production bin/rails server |
nx build, फिर nx start |
bin/rails test / rspec |
nx test |