AR

الوثائقالمعالجات والأخطاء

صفحات الخطأ لكل مجلد

يمكن للمجلد أن يجيب على أخطائه: مدونة تحتوي على 404 بكلماتها الخاصة، ومنطقة خاصة تقدم نموذج تسجيل الدخول بدلاً من 401 مجردة. يحتفظ باقي الموقع بالصفحة الموجودة به بالفعل.

تضيف هذه الصفحة أحد هذه الملفات وتظهر الإجابة عليها.

القاعدة

أعمق ملف يطابق إجابات عنوان URL. يبقى كل شيء آخر كما هو: نفس رموز الحالة، وJSON لعميل API، والصفحة المضمنة بمجرد عدم احتواء أي مجلد من السلسلة على ملف.

A request for /blog/2024/hello is answered by the deepest error page GET /blog/2024/hello 404 src/routes/notfound.nexy scope / MATCHES src/routes/blog/notfound.nexy scope /blog MATCHES src/routes/blog/2024/notfound.nexy scope /blog/2024 ANSWERS Delete the last file and /blog answers. Delete that one and the built-in page answers.
نطاقات صفحة الخطأ

ل /blog/2024/hello نكسي يمشي فوق الشجرة: /blog/2024، ثم /blog، ثم /. المجلد الأول الذي يحمل إجابات الملف. المجلد مطابق بالكامل: /blogger/hello ليس ضمن /blog، لذا فإن النسخة الموجودة في blog/ لا تجيب عليه أبدًا.

الملفات الاربعة

الملف الإجابات ما يصل إليه
notfound.nexy 404 عنوان URL لا يتطابق مع المسار، notFound()
errors.nexy 500 استثناء لم تتم معالجة أي شيء
forbidden.nexy 403 forbidden()، raise HTTPException(403)
unauthorized.nexy 401 unauthorized()، raise HTTPException(401)

loading.nexy يبقى محجوزًا: ليس له تأثير وقت التشغيل بعد.

يكفي ملف واحد في مكان ما في src/routes/ لكي يجيب Nexy على هذه الحالة: نسخة في الجذر تجيب على المشروع بأكمله، ونسخة في مجلد تجيب على هذا المجلد، وعنوان URL خارج كل نسخة يحصل على الصفحة المضمنة. وحجز امتداداً آخر لهذه الأسماء في nexyconfig.py مع useNotFoundExtensions و useErrorsExtensions و useForbiddenExtensions و useUnauthorizedExtensions.

صفحة المجلد الأول الخاص بك

src/routes/blog/notfound.nexy
---title: Nothing here yet---<h1>That post is gone</h1><p>The <a href="/blog">blog</a> still has the others.</p>

قم بتشغيل المشروع واطلب مشاركة غير موجودة:

curl -i -H "Accept: text/html" http://localhost:3000/blog/old# HTTP/1.1 404 Not Found

يحتفظ عنوان URL الموجود خارج المجلد بالصفحة التي لديك بالفعل:

curl -i -H "Accept: text/html" http://localhost:3000/about# HTTP/1.1 404 Not Found    (the root page, or the built-in one)

401 الذي يقود إلى مكان ما

يجيب مجلد المنطقة المحمية 401 بالصفحة التي تعرض الطريق في:

src/routes/private/unauthorized.nexy
---title: Sign in to continue---<h1>Sign in to see your notes</h1><a href="/sign-in" class="button">Sign in</a>
src/routes/private/dependeency.py
from nexy import unauthorizedfrom nexy.http import Request  def require_login(request: Request) -> None:    if not request.session.get("user"):        unauthorized(scheme="Bearer")  dependencies = [require_login]

كل مكالمة وكل حالة تحتفظ بإجابتين:

من يسأل 401 بملف 401 بغير واحد
المتصفح (Accept: text/html) صفحة المجلد الصفحة المضمنة
العميل (Accept: application/json) {"detail": "..."} {"detail": "..."}

unauthorized(scheme="Bearer") يضيف WWW-Authenticate: Bearer إلى كلا الإجابتين. التفاصيل التي تم إنشاؤها من إدخال المستخدم يتم تخطيها بتنسيق HTML في الصفحة.

التحقق من ذلك

الاختبارات/test_private.py
from fastapi.testclient import TestClient from nexy.app import app  def test_a_private_url_asks_for_sign_in():    answer = TestClient(app).get("/private/notes")    assert answer.status_code == 401    assert "Sign in" in answer.text  def test_an_api_client_gets_json():    answer = TestClient(app).get(        "/private/notes", headers={"accept": "application/json"}    )    assert answer.json() == {"detail": "Unauthorized"}

الخطوات التالية

حرِّر على GitHub

Enter يفتح النتيجة، وEsc يغلق.