דלג לתוכן העיקרי

פלאג אין עבור VSCode

תוסף הקוד Roost GPT VS מאפשר לך ליצור בדיקות לקוד שלך באמצעות RoostGPT בלחיצה אחת, ישירות מסביבת העבודה של VS Code.

הורדה:

https://marketplace.visualstudio.com/items?itemName=RoostGPT.roostgpt

הַתקָנָה:

כדי להשתמש בפלאג אין של RoostGPT VS Code, נדרש להתקין VS Code בעמדה שלך, כמו גם את כל התלויות הנדרשות להרצת הקוד שלך, מכיוון ש-RoostGPT יריץ לעתים קרובות את קוד הבדיקה שנוצר כדי לשפר אותו.

ניתן להוריד ולהתקין את VS Code עבור מערכת ההפעלה שלך כאן.

לאחר התקנת VS Code , ניתן להוריד את סיומת Roost GPT VS Code ממארקט של VS Code, על ידי חיפוש קל Roost GPT בחנות התוספים. לחלופין, תוכל להוריד ולהתקין את סיומת VS Code מכאן .

לאחר התקנת ההרחבה, אתה מוכן ליצור בדיקות עבור הקוד שתרצה.

תצורה:

לאחר שההרחבה הותקנה בהצלחה במערכת שלך, תוכל להמשיך בהגדרת ההרחבה כדי להתחיל ליצור בדיקות. פעולה זו כוללת מתן מידע הנדרש ליצירת בדיקות.
כדי להגדיר את ההרחבה לשימוש בה, פשוט פתח את הגדרות ההרחבה עבור Roost GPT, תוכל לחפש אותה בחנות ההרחבות, או שתוכל למצוא אותה ברשימת ההרחבות המותקנות שלך.

לאחר מכן תוכל להגדיר את הערכים הנדרשים בהתאם לסביבת העבודה ולצרכים שלך. להלן השדות הנדרשים שתצטרך להגדיר בכל מקרה:

שדות חובה

  • אסימון Roost: ניתן לקבל את אסימון ה-roost שלכם מדף הפרופיל שלי ב-  app.roost.ai . אם אין לכם אסימון Roost, תוכלו להירשם לתקופת ניסיון בחינם ולנסות את RoostGPT בחינם, באמצעות כתובת האימייל של הארגון שלכם  מכאן .

  • דומיין רוסט: הזן את הדומיין שבו אסימון הרוסט שסופק פעיל, ערך ברירת המחדל הוא app.roost.ai.

  • פסק זמן: הגדר את פסק הזמן ליצירת בדיקה (בשעות), ערך ברירת המחדל הוא 1.

  • שפה: בחר את השפה שבה כתוב סביבת העבודה/קוד המקור שלך, תומך כעת ב-Java, Python, Go, NodeJS, C# ו-C++.

  • סוג לוח: בחר את סוג לוח הסקראם/קנבאן, נדרש לבדיקות פונקציונליות. הגדר כלא סוגי בדיקות אחרים, תומך בלוחות ללא, ג'ירה ו-Azure. ערך ברירת המחדל הוא ללא.

  • איטרציות: הגדר את מספר האיטרציות ליצירת בדיקות. אם תספק ערך איטרציה גדול מ-0, הבדיקה תפעיל את מקרי הבדיקה שנוצרו ותעביר את השגיאה שאירעה (אם קיימת) למודל הבינה המלאכותית. לאחר מכן, מקרה הבדיקה יעודכן באותו קובץ ויפעל שוב עד למספר האיטרציות ויעצור אם הוא רץ בהצלחה בין לבין. ערך ברירת המחדל הוא 1.

  • טלמטריה: הגדר כ-False אם אינך רוצה לשלוח נתוני טלמטריה ל-roost. ערך ברירת המחדל הוא true.

  • מודל בינה מלאכותית גנרטיבי: בחר באיזה מודל להשתמש ליצירת קוד בדיקה, התומך ב-OpenAI, Google Vertex, Azure Open AI, Claude AI , DeepSeek, AWS Bedrock, ו-DBRX Hosted Models כולל OpenSource Hosted Models (LLAMA2 ו-starchat).

  • ספק קלט: הגדר כ-true אם ברצונך לספק קלט משלך לפני יצירת הבדיקה, תתבקש להזין קלט לפני תחילת יצירת הבדיקה. ערך ברירת המחדל הוא false.
  • MaxDepth: משמש לציון כמה עמוק בתוך סביבת העבודה ההרחבה תעבור כדי לסרוק קבצים ליצירת בדיקות. ערך ברירת המחדל הוא מעבר לכל תת-הספריות.
  • EnvFile: ניתן להשתמש בשדה זה כדי לספק את הנתיב לקובץ env, אשר יספק ל-RoostGPT קובץ env עם משתני סביבת משתמש אשר יילקחו בחשבון בהתקדמות יצירת הבדיקה. ניתן להשאיר שדה זה ריק.

  • פרטי מודל בינה מלאכותית:

    • אם מודל הבינה המלאכותית הגנרטיבית הוא בינה מלאכותית פתוחה:
      • מפתח API של OpenAI: ספקו את מפתח ה-API של OpenAI שלכם אם אתם מתכננים להשתמש ב-OpenAI כמודל הבינה המלאכותית הגנרית ליצירת מקרי הבדיקה שלכם.
      • מודל API של OpenAI: ספק את מודל הבינה המלאכותית שאליו מפתח ה-API שסופק יש גישה, תומך ב-gpt-4o, gpt-4, gpt-3.5-turbo.
    • אם מודל הבינה המלאכותית הגנרטיבית הוא Google Vertex:
      • אסימון נושא קודקוד: ספקו את אסימון נושא הקודקוד שלכם אם אתם מתכננים להשתמש ב-Google Vertex כמודל בינה מלאכותית גנרטיבי ליצירת מקרי הבדיקה שלכם.
      • מזהה פרויקט ורטקס: ספק את המזהה של פרויקט ורטקס בגוגל שלך.
      • אזור קודקוד: הזן את האזור שבו נמצא אזור הקודקוד שלך
      • מודל קודקוד: בחר את מודל הקודקוד שישמש ליצירת קוד; תומך ב-text-bison, code-bison ו-codechat-bison. ערך ברירת המחדל הוא text-bison.
    • אם מודל הבינה המלאכותית הגנרטיבית הוא קלוד בינה מלאכותית:
      • מודל בינה מלאכותית: בחר את מודל הבינה המלאכותית שישמש מהתפריט הנפתח.
      • מפתח API : ספק את מפתח ה-API של קלוד AI שלך .
    • אם מודל הבינה המלאכותית הגנרטיבית הוא Azure Open AI:
      • מפתח API: ספק את מפתח ה-API עבור מודל Azure Open AI שלך.
      • נקודת קצה של API: ציין את נקודת הקצה של ה-API שבה מתארח מודל Azure Open AI שלך.
      • שם פריסה: הזן את שם הפריסה עבור מודל Azure Open AI API שלך.
    • אם מודל הבינה המלאכותית הגנרטיבית הוא קוד פתוח:
      • נקודת קצה של מודל קוד פתוח: ספקו את נקודת הקצה עבור מודל הקוד הפתוח. אם אתם מתכננים להשתמש באחד ממודלי הקוד הפתוח המסופקים על ידי roost, עליכם לספק אותה בפורמט 'http://MODEL_IP:5000/generate' כאשר MODEL_IP היא כתובת ה-IP של המופע שבו פועל המכולה של המודל.
      • מודל בינה מלאכותית בקוד פתוח: בחר את מודל הבינה המלאכותית שישמש ליצירת בדיקות, תומך ב- meta-llama/Llama-2-13b-chat וב- HuggingFaceH4/starchat-beta. ערך ברירת המחדל הוא meta-llama/Llama-2-13b-chat.

שדות מתקדמים (אופציונלי):

  • שדות אופציונליים זמינים לשימוש יעיל בתואר LLM כמו
    • ניתן להגדיר advanced.UseAssistant ל-True עבור דגמי gpt turbo,
    • ניתן להגדיר את AiTemperature לערכים שונים מברירת המחדל (0.2) כדי לשלוט באיכות הבדיקה,
  • ניתן להגדיר את VerifyTest לערך בוליאני True. ערך ברירת המחדל הוא False,
  • ניתן להגדיר את UseDocker כ-True כדי ליצור את הבדיקות בתוך docker. זה ידרוש גישה מקומית לשרת Docker Engine.

יצירת בדיקות:

לאחר השלמת הגדרת התוסף, תוכלו להתחיל להשתמש בתוסף VS Code כדי ליצור בדיקות עבור סביבת העבודה שלכם. כדי ליצור בדיקות, פשוט לחצו לחיצה ימנית על קובץ בתפריט Explorer ובחרו את סוג הבדיקה שברצונכם ליצור מתפריט ההקשר שמופיע. שימו לב שלכל סוג בדיקה יש דרישות מסוימות כדי להתחיל ביצירת בדיקות.
סוגי הבדיקות הנתמכים כעת הם כדלקמן:

  • בדיקות יחידה.
  • בדיקות API.
  • בדיקות פונקציונליות.
  • הִשׁתַלְבוּת.

דרישות הבדיקה

להלן שדות חובה והוראות נוספות ליצירת בדיקה בהתאם לכל סוג בדיקה נתמך:

  • מבחני יחידה: כדי ליצור מבחני יחידה, פשוט בחרו את הספרייה שבה נמצא הקובץ שלכם, לחצו לחיצה ימנית על קובץ ובחרו "יצירת מבחני יחידה", ולאחר מכן בחרו את מסגרת הבדיקות שברצונכם להשתמש בה מהחלון הקופץ. פעולה זו תיצור מבחני יחידה עבור כל הקבצים הנמצאים בספריית האב של קובץ זה. אין צורך בשדות נוספים מלבד השדות הנדרשים שהוזכרו לעיל ליצירת מבחני יחידה. ודאו שהשפה שהוגדרה בהגדרות ההרחבה תואמת את השפה שבה נמצא קוד המקור שלכם.

    • אם ברצונך שהבדיקות ייווצרו עבור מספר מצומצם של פונקציות ספציפיות בלבד ולא עבור כל בסיס הקוד, ציין את שמות הפונקציות שעבורן ברצונך שהבדיקות ייווצרו בתיבת הקלט FunctionsToTest במקטע המתקדם של הגדרות ההרחבה, באופן מופרד בפסיקים (למשל, Func1, Func2,...). פעולה זו תבטיח שהבדיקות ייווצרו רק עבור הפונקציות שצוינו.
    • עבור בדיקות יחידה של Java, אנא ודא שהפעלת הבדיקה ממודול חוקי המכיל pom.xml חוקי, או צור בדיקות עבור הפרויקט כולו אם pom.xml קיים בתיקיית סביבת העבודה.
    • עבור בדיקות React Unit, עליך להשתמש במודל GPT-4 turbo ולהגדיר את use assistant כ-true בחלק המתקדם של הגדרות ההרחבה vs-code.

  • בדיקות API: כדי ליצור בדיקות API, עליך ללחוץ לחיצה ימנית על קובץ ה-json של אוסף Postman או על קובץ המפרט של ה-API של swagger ולאחר מכן לבחור באפשרות "Generate API tests". אם תבחר קובץ אחר שאינו קובץ המפרט של ה-API שלך, יצירת הבדיקה תיכשל. לאחר מכן עליך לבחור את מסגרת הבדיקה שתשמש ליצירת הבדיקה (artillery, postman או rest-assured) מהחלון הקופץ שסופק. אין צורך בשדות נוספים מלבד השדות הנדרשים שהוזכרו לעיל עבור בדיקות API. עבור בדיקות API, תוכל גם לסנן אילו פעלים של HTTP (כגון post, get וכו') ייבדקו על ידי שינוי הגדרת HttpFilters מהקטע המתקדם. שימו לב שאם תבחר ב-postman כמסגרת הבדיקה, תצטרך להתקין את newman cli במערכת שלך על מנת להריץ בדיקות שנוצרו מהרחבת RoostGPT. תוכל להתקין את newman cli באמצעות הפקודה: npm install -g newman.

    • אם ברצונך ליצור בדיקות API עבור פעלים ספציפיים של HTTP (get, post, put, patch, delete וכו'), תוכל לבחור אילו פעלים ספציפיים יש לבדוק בחלק המתקדם של הגדרות ההרחבה תחת התכונה של מסנני HTTP.
    • אם ברצונך ליצור בדיקות API עבור נקודות קצה ספציפיות של API התואמות לתבנית רגולציה נתונה, תוכל להגדיר את תבנית הרגולציה בכרטיסייה מתקדמת של הגדרות ההרחבה תחת התכונה נקודות קצה של HTTP לבדיקה.
    • עבור מבחני קראטה ומבחני Rest - Assured , ודאו שיצירת הבדיקה מופעלת מתוך מאגר Java/maven תקף, כלומר, שימו את קובץ spec ה-API במאגר Java והתחלו את יצירת הבדיקה משם .

  • בדיקות אינטגרציה: בעת יצירת בדיקות אינטגרציה, עליך ללחוץ לחיצה ימנית על קובץ ה-json של אוסף Postman או על קובץ המפרט של ה-API של swagger ולאחר מכן לבחור באפשרות בדיקות אינטגרציה. אם תבחר קובץ אחר שאינו קובץ המפרט של ה-API, יצירת הבדיקה תיכשל. לאחר בחירת האפשרות, עליך לבחור את מסגרת הבדיקה שתשמש ליצירת הבדיקה (artillery, postman או rest-assured). לאחר מכן עליך לבחור את סוג תבנית gherkin שלך. תוכל לבחור קובץ ולעיין בקובץ תבנית gherkin שלך, או שתוכל לבחור כתובת URL ולספק את כתובת ה-URL לתבנית Gherkin שלך. אין צורך בשדות נוספים מלבד השדות הנדרשים שהוזכרו לעיל עבור בדיקות אינטגרציה. שימו לב שאם תבחרו ב-Postman כמסגרת הבדיקה, תצטרכו להתקין את newman cli במערכת שלכם כדי להריץ בדיקות שנוצרו מהרחבת RoostGPT. ניתן להתקין את newman cli באמצעות הפקודה: npm install -g newman.  עבור מבחני קראטה ומבחני Rest - Assured , ודאו שיצירת הבדיקה מופעלת מתוך מאגר Java/maven תקף, כלומר, שימו את קובץ spec ה-API במאגר Java והתחלו את יצירת הבדיקה משם .

  • בדיקות פונקציונליות: כדי ליצור בדיקות פונקציונליות, עליך לבחור את סוג הלוח שלך כ-JIRA או Azure ולאחר מכן נדרשים גם הפרטים הבאים:
    • אם סוג הלוח הוא Jira: 
      • אימייל של ג'ירה.
      • ג'ירה אסימון.
      • שם מארח של ג'ירה. 
    • אם סוג הלוח הוא Azure:
      • ארגון Azure
      • אסימון תכלת. 
      • פרויקט Azure.

שיפור וניתוח של בדיקות שנוצרו

לאחר השלמת תהליך יצירת הבדיקה, ייפתח פאנל צדדי שיציג את כל קבצי הבדיקה שנוצרו. באפשרותך לבחור את הקובץ שברצונך להציג באמצעות התפריט הנפתח שסופק. אם תרצה, תוכל גם לערוך את הקבצים בפאנל עצמו ולשמור את השינויים שלך באמצעות כפתור השמירה שסופק.
אם ברצונך להפעיל את הבדיקות שנוצרו, תוכל לעשות זאת באמצעות כפתור ההפעלה שסופק בפאנל הצדדי. פעולה זו תפעיל את קובץ הבדיקה שנבחר. שים לב כי תצטרך שכל התלויות הנדרשות להפעלת הבדיקות יהיו מותקנות במערכת המקומית שלך כדי שיצירת הבדיקה תתרחש. עבור בדיקות ארטילריה, לאחר שתלחץ על כפתור ההפעלה, תתבקש להזין את כתובת האתר של היעד עבור הבדיקות. אם ברצונך לספק כתובת אתר, אנא ספק אותה בתיבת הקלט, ולאחר מכן תישאל אם ברצונך להעלות קובץ .env כדי לספק משתני סביבה. אם כן, תוכל להעלות את קובץ ה-env עבור אותו הדבר.
אם אינך מרוצה מהבדיקות שנוצרו ומעוניינת בשיפורים או שינויים בבדיקה, בתחתית הפאנל הצדדי תמצא בקשת משוב, הזן את בקשת המשוב שברצונך לתת למודל הבינה המלאכותית ולאחר מכן לחץ על כפתור השיפור. פעולה זו תפעיל את שיפור הבדיקה.

בחזרה ללמעלה