Testavior

testavior

Testavior هو حل خفيف الوزن لمساعدتك في تطوير اختبارات السلوك لـ ASP.NET Core .

اختبارات السلوك هي وسيلة لاختبار ميزات التطبيق الخاصة بك لتطبيق أنواع مختلفة من السلوكيات لتغطية سيناريو وظيفي .

يوفر نهجًا بسيطًا وفعالًا لكتابة الاختبارات الآلية لتطبيق ASP.NET Core الخاص بك.
لمزيد من المعلومات حول اختبار السلوك مع ASP.NET Core ، يرجى إلقاء نظرة هنا http://geeklearning.io/a-different-approach-test-your-app-net-ed-application

سمات

يوفر Testavior مكتبتين:

• testavior.configuration : يساعدك على تكوين تطبيقك لدمج اختبارات السلوك بسهولة لسيناريوهاتك.
• Testavior : يوفر بيئة اختبار مميزة وقابلة للتكوين لاختبارات سلوكك:
  • تكوين اختبار الويب
  • سياق المصادقة المكون
    • اختبار المصادقة الوسيطة
    • هوية الاختبار القابلة للتكوين
    • مطالبات الهوية المساعد
  • CONTITION CONTITY Framework Core Context باستخدام مزود SQLITE
  • مساعد التسلسل للتعامل مع المحتوى المشفر عن عنوان URL
  • مجموعة من أدوات HTTP للتعامل مع حماية CSRF (مفيدة للغاية لاختبار سيناريوهات الإصدار)
  • مساعد التأكيد

تثبيت

في مشروع ASP.NET Core الخاص بك

• قم بتثبيت حزمة nuget geeklearning.testavior.configuration

   > dotnet add package GeekLearning.Testavior.Configuration
  

في مشروع اختبار الوحدة الأساسية .NET

• تثبيت حزمة nuget geeklearning.testavior

   > dotnet add package GeekLearning.Testavior
  

• أضف مشروع الويب الخاص بـ ASP.NET Core كمرجع للمشروع

إعدادات

تعتمد بيئة الاختبار التي توفرها Testavior على خدمة تكوين بدء التشغيل تتيح لك فصل تكوين بيئة الإنتاج عن تكوين بيئة الاختبار . يتم تمثيل خدمة التكوين هذه بعقد IStartupConfigurationService الذي يحدد 3 طرق: Configure - ConfigureEnvironment - ConfigureService التي يجب استدعاؤها ضمن روتين بدء التشغيل لحقن التكوين المعتمد على البيئة.

1 - في مشروع ASP.NET الأساسي :

• أضف فئة StartupConfigurationService (تغيير الاسم إذا كنت ترغب في ذلك) إلى مشروع الويب الخاص بك.
• قم بتنفيذ واجهة IStartupConfigurationService (اختياريًا ، ويرث من DefaultStartupConfigurationService لاستخدام التنفيذ الفارغ الافتراضي)
• قم بتنفيذ التكوين الخاص ببيئة الإنتاج والذي يجب عدم تنفيذه في بيئة الاختبار:
  • ConfigureServices : قم بتنفيذ خيارات التكوين المخصصة لبيئة الإنتاج
  • Configure : قم بتنفيذ تكوين البرامج الوسيطة الخاصة ببيئة الإنتاج
  • ConfigureEnvironment : تنفيذ ما يجب تنفيذه قبل أي شيء

عينة:

 public class StartupConfigurationService : DefaultStartupConfigurationService
{
   public override void ConfigureServices ( IServiceCollection services , IConfigurationRoot configuration )
   {
       base . ConfigureServices ( services , configuration ) ;

       var connection = "CONNECTION_STRING" ;
           
       services . AddDbContext < [ EF_DB_CONTEXT ] > ( options =>
           options . UseSqlServer ( connection ) ) ;
   }
}

2 - في فصل البرنامج :
حقن StartupConfigurationService عن طريق استدعاء طريقة ConfigureStartup على WebHostBuilder الخاص بك:

 new WebHostBuilder ( )
   .. .
   . UseStartup < Startup > ( )
   . ConfigureStartup < StartupConfigurationService > ( )

3 - في فصل Startup الخاص بك:

• حقن واجهة IStartupConfigurationService في فئة Startup
• استدعاء طريقة ConfigureEnvironment في نهاية مُنشئ Startup
• استدعاء طريقة ConfigureServices في نهاية طريقة Startup.ConfigureServices الأصلي.
• اتصل بالطريقة Configure في بداية طريقة Startup.Configure الأصلية

عينة:

 public class Startup
{
   private IStartupConfigurationService externalStartupConfiguration ;

   public Startup ( IHostingEnvironment env , IStartupConfigurationService externalStartupConfiguration = null )
   {
       this . externalStartupConfiguration = externalStartupConfiguration ;
       this . externalStartupConfiguration . ConfigureEnvironment ( env ) ;
   }

   public void ConfigureServices ( IServiceCollection services )
   {
       services . AddMvc ( )

       // Pass configuration (IConfigurationRoot) to the configuration service if needed
       this . externalStartupConfiguration . ConfigureServices ( services , null ) ;
   }

   public void Configure ( IApplicationBuilder app , IHostingEnvironment env , ILoggerFactory loggerFactory )
   {
       this . externalStartupConfiguration . Configure ( app , env , loggerFactory ) ;

       app . UseMvc ( ) ;
   }
}

4 - في ملف مشروع الاختبار الخاص بك:
يستخدم محرك Razor ملفات التبعية (.deps.json) لحل بعض المراجع في وقت التشغيل. لذلك من أجل اختبار جزء MVC من التطبيق ، من الضروري استيراد هذه الملفات. للقيام بذلك ، أضف القسم التالي إلى .csproj :

< Target Name = " CopyDepsFiles " AfterTargets = " Build " Condition = " '$(TargetFramework)'!='' " >
    < ItemGroup >
      < DepsFilePaths Include = " $([System.IO.Path]::ChangeExtension('%(_ResolvedProjectReferencePaths.FullPath)', '.deps.json')) " />
    </ ItemGroup >

    < Copy SourceFiles = " %(DepsFilePaths.FullPath) " DestinationFolder = " $(OutputPath) " Condition = " Exists('%(DepsFilePaths.FullPath)') " />
</ Target >

5 - لمستخدمي Xunit
إذا كنت تنوي استخدام Xunit ، فابع أولاً الوثائق الرسمية ، ثم أضف ملف xunit.runner.json إلى مشروع الاختبار الخاص بك:

{
  "shadowCopy" : false
}

وأضف القسم التالي إلى .csproj :

< ItemGroup >
  < None Include = " xunit.runner.json " CopyToOutputDirectory = " PreserveNewest " />
</ ItemGroup >

اختبارات الكتابة

مطلوب IStartupConfigurationService المحدد لبيئة الاختبار إذا كنت ترغب في تنفيذ تكوين محدد اختبار .
يأتي Testavior مع تطبيق IStartupConfigurationService الخاص بالاختبار: TestStartupConfigurationService الذي يوفر بيئة اختبار مليئة بالميزات المفيدة (انظر قسم الميزات ).
بالطبع يمكنك تنفيذ خدمة تكوين بدء التشغيل الخاصة بك (باستخدام onboard TestStartupConfigurationService أم لا).

لإنشاء بيئة اختبار ، ما عليك سوى تشغيل فئة TestEnvironment من خلال تمريرها Startup ASP.NET Core Application ، وتطبيق IStartupConfigurationService ، ونوع EF Core ObjectContext والمسار النسبي لمشروع ASP.NET الأساسي (المطلوب حل طرق عرض MVC).

 var testEnvironment = new TestEnvironment < Startup , TestStartupConfigurationService < [ EF_DB_CONTEXT ] > > (
    Path . Combine ( System . AppContext . BaseDirectory , @"[PATH_TO_WEB_APP]" ) ) ; 

اختبار API

اكتب اختبار API الخاص بك بمجرد إرسال طلبات الويب باستخدام بيئة الاختبار :

 [ TestMethod ]
public void ScenarioShouldBeOk ( )
{
    var testEnvironment = new TestEnvironment < Startup , TestStartupConfigurationService < [ EF_DB_CONTEXT ] > > (
       Path . Combine ( System . AppContext . BaseDirectory , @"[PATH_TO_WEB_APP]" ) ) ;

    var response = testEnvironment . Client . GetAsync ( "/api/data" ) . Result ;
    response . EnsureSuccessStatusCode ( ) ;

    // Test result content
    var result = JsonConvert . DeserializeObject < Data [ ] > ( response . Content . ReadAsStringAsync ( ) . Result ) ;

    Assert . AreEqual ( "data" , result . Data ) ;
} 

اختبار MVC

اكتب اختبار MVC سهلًا تقريبًا مثل اختبار واجهة برمجة التطبيقات باستثناء أنك قد ترغب في اختبار النموذج الذي تم إرجاعه بواسطة الخادم وليس العرض .
للقيام بذلك ، يوفر Testavior مستودع ViewModel الذي سيعترض وتخزين نماذج العرض التي يتم إرجاعها بواسطة الخادم.

يمكنك الوصول إلى هذا المستودع باستخدام آلية حقن التبعية Core ASP.NET:

 [ TestMethod ]
public void ScenarioShouldBeOk ( )
{
    var testEnvironment = new TestEnvironment < Startup , TestStartupConfigurationService < [ EF_DB_CONTEXT ] > > (
       Path . Combine ( System . AppContext . BaseDirectory , @"[PATH_TO_WEB_APP]" ) ) ;

    testEnvironment . Client . GetAsync ( "/" ) . Result . EnsureSuccessStatusCode ( ) ;

    var viewModel = testEnvironment
                        . ServiceProvider
                        . GetRequiredService < ViewModelRepository > ( )
                        . Get < [ VIEWMODEL_TYPE ] > ( ) ;

    Assert . AreEqual ( "data" , viewModel . Data ) ;
}

لا تتردد في إلقاء نظرة على قسم العينات ؛)

اختبار سعيد! سائدا