الوثائق/بناء واختبار

اختبار

nx test يُجري اختبارات الخادم باستخدام pytest، ويختبر العميل باستخدام vitest عندما تطلبها.

nx test                       # pytestnx test -k create_user        # extra arguments go to pytestnx test --client              # pytest, then vitestnx test --no-server --client  # vitest only

ما يدير

لا يوجد عداء مدمج من النهاية إلى النهاية. قم بقيادة الخادم باستخدام TestClient وأضف Playwright أو Cypress بنفسك لسلوك المتصفح.

اختبر الخادم

يتحدث عميل الاختبار إلى تطبيق ASGI قيد التشغيل: لا يوجد خادم لبدء التشغيل، ولا يوجد منفذ للاختيار.

from fastapi.testclient import TestClient from nexy.app import app  def test_home_renders():    client = TestClient(app)    response = client.get("/")    assert response.status_code == 200

nexy.app.app هو التطبيق المجمع، الذي بني عند قراءته لأول مرة. يقرأ nexyconfig.py من دليل العمل، لذا قم بتشغيل pytest من جذر المشروع.

عندما يغير الاختبار التكوين أو المسارات، أنشئ تطبيقًا جديدًا بدلاً من إعادة استخدام مستوى الوحدة النمطية:

from fastapi.testclient import TestClientfrom nexy.modules.routers.app import AppServer  def test_api_hello():    with TestClient(AppServer().run()) as client:        response = client.get("/api/hello")    assert response.json() == {"message": "Hello"}

AppServer().run() يعيد تجميع المسارات والبرامج الوسيطة والجلسات والترجمات، بحيث يبدأ كل استدعاء من الحالة الحالية لدليل المشروع.

ما يجب التأكيد عليه

صفحة ترجع HTML. قم بتأكيد الحالة، ثم المحتوى الذي يهمك:

def test_blog_page_renders_slug(client):    response = client.get("/blog/post-1")    assert "post-1" in response.text

يقوم معالج API بإرجاع JSON. فشل التحقق من الصحة هو 422، والمسار المفقود هو 404 تمت الإجابة عليه بواسطة notfound.nexy عند وجود هذا الملف:

def test_create_item_validates_body(client):    assert client.post("/api/items", json={}).status_code == 422

بالنسبة لإجراء ما، اختبر الوظيفة مباشرة - فهي وظيفة عادية - واختبر نقطة نهاية HTTP من خلال قراءة المسار الذي تم إنشاؤه من الصفحة التي تعرضها:

from src.actions.user import create_user  async def test_create_user_returns_name():    assert await create_user("Ada") == {"name": "Ada"}

def test_form_posts_to_action(client):    html = client.get("/").text    action = html.split('action="')[1].split('"')[0]    response = client.post(action, data={"name": "Ada"}, follow_redirects=False)    assert response.status_code == 303

مكالمة مع JSON تجيب بالنتيجة، و 422 بالحقول غير الصالحة.

اختبار مكون .nexy

nexy.testing.render يقوم بتجميع مكون، مع المكونات التي يستوردها، وإرجاع HTML الخاص به. الدعائم هي وسيطات للكلمات الرئيسية و children= تملأ الفتحة:

from nexy.testing import render  def test_button_shows_its_label():    assert "Save" in render("src/components/button.nexy", label="Save")

قم بتشغيل pytest من جذر المشروع: تذهب الملفات المترجمة إلى __nexy__/، كما هو الحال مع nx dev. يحتاج المكون الذي يقرأ الطلب (usePathname، useSession) إلى اختبار الصفحة باستخدام TestClient بدلاً من ذلك.

اختبر العميل

nx test --client يتوقع الإعداد الأكثر قوة الخاص بك. اختبار الحد الأدنى من المكونات:

import { render } from "@testing-library/react";import { describe, expect, it } from "vitest"; import Counter from "./counter"; describe("Counter", () => {  it("starts at zero", () => {    const { getByText } = render(<Counter start={0} />);    expect(getByText("0")).toBeTruthy();  });});

vitest ومكتبة الاختبار هي تبعيات للمشروع: nexy new لا يقوم بتثبيت مكدس اختبار. أضف vitest.config.ts مع البيئة التي تحتاجها (jsdom أو Happy-dom للمكونات).

التكامل المستمر

هناك أمران يكفيان لخط أنابيب المشروع:

nx buildnx test

nx build فشل بسبب خطأ في الترجمة؛ nx test يفشل في التأكيد الفاشل ويخرج من الصفر. nx check يضيف mypy و tsc إلى التشغيل.

يستخدم العمل على Nexy نفسه أوامر مختلفة: راجع المساهمة.

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

• CLI: كل علم nx test
• API: ما ترجعه نقطة النهاية
• نشر: قم بالإنشاء قبل الاختبار في CI

انسخ الصفحة بصيغة Markdown حرِّر على GitHub