DokuDateibasiert

Vererbung

Mehrere Dateien in src/routes/ gelten für alles unterhalb ihres Verzeichnisses. Sie lösen sich alle auf die gleiche Weise auf: Nexy beginnt beim Routenverzeichnis und geht bis zu src/routes/.

src/routes/

layout.nexy1. outermost

dependencies.py1. runs first

middleware.py1. wraps first

notfound.nexyfallback for every URL

(shop)/a group is a directory: it takes part, it is not in the URL

layout.nexy2.

dependencies.py2.

cart/

layout.nexy3. innermost

dependencies.py3. runs last

index.nexythe page

Datei	Regel
`layout.nexy`, `layout.tsx`, `layout.vue`, `layout.svelte`	Jedes Layout vom Stamm bis zur Seite umschließt es, äußerstes zuerst
`middleware.py`	Jede Datei vom Stammverzeichnis bis zur Route umschließt die Anfrage äußerst zuerst vor Abhängigkeiten
`dependencies.py`	Jede Datei vom Stammverzeichnis bis zur Route wird ausgeführt, die äußerste zuerst, dann die eigenen Wachen des Handlers
`notfound.nexy`, `errors.nexy`	Der Nächste gewinnt, je Statuscode

Für die Seite oben werden die Layouts als root layout > (shop) layout > cart layout > page verschachtelt und die Abhängigkeiten werden als root > (shop) > cart > handler guards ausgeführt.

Warum das Äußerste zuerst?

Ein äußeres Layout bildet den Rahmen und eine äußere Abhängigkeit entscheidet darüber, wer überhaupt reinkommen darf. Wenn man sie an die erste Stelle setzt, können sich die inneren auf sie verlassen: Ein Verzeichnis, das eine Authentifizierung erfordert, wird vor einem Handler ausgeführt, der den Benutzer liest.

Die (shop)-Abhängigkeit des Baums überprüft das Warenkorb-Cookie, sodass die darunter liegende Warenkorb-Abhängigkeit den Warenkorb lesen kann, ohne eine erneute Überprüfung durchzuführen:

src/routes/(shop)/dependencies.py

from nexy.http import HTTPException, Request  def require_cart(request: Request) -> None:    if "cart" not in request.cookies:        raise HTTPException(status_code=400, detail="No cart")  dependencies = [require_cart]

Layouts

Alle Layoutdateien eines Ordnerfamilienstapels: siehe Layouts. Verschiedene Familien vermischen sich nicht: Ein layout.vue umschließt niemals eine .tsx-Seite, und ein Projekt hat entweder layout.nexy oder Client-Layouts, niemals beides (Modi).

Das innerste Layout des Baums fügt nur seinen eigenen Rahmen hinzu: Das Root-Layout um ihn herum zeichnet weiterhin das Dokument.

src/routes/(shop)/cart/layout.nexy

---children: prop[NexyElement]---<section class="cart">  <h2>Your cart</h2>  {{ children | safe }}</section>

Middleware-Dateien

Siehe Middleware-Dateien: Sie werden vor Abhängigkeiten ausgeführt und können antworten, ohne die Route zu erreichen.

Eine Wurzel middleware.py umschließt jede Route des Baums, der Wagen enthält:

src/routes/middleware.py

import time from nexy.http import Request  async def middleware(request: Request, call_next):    start = time.perf_counter()    response = await call_next(request)    response.headers["x-time-ms"] = f"{(time.perf_counter() - start) * 1000:.1f}"    return response

Abhängigkeiten

Siehe Abhängigkeiten für die Reihenfolge in einer Handlerdatei, einschließlich @UseGuard und @Middleware.

Fehlerseiten

notfound.nexy und errors.nexy werden einmal im Routenstamm installiert; Eine Kopie in einem Unterverzeichnis verfeinert die Seite für dieses Präfix. Siehe Fehlerseiten.

Eine Kopie in cart/ beantwortet die 404er unter /cart, und die Wurzelkopie behält den Rest:

src/routes/(shop)/cart/notfound.nexy

<h1>This product is gone</h1><p><a href="/cart">Back to your cart</a></p>

Nächste Schritte

Auf GitHub bearbeiten