Запустіть код один раз до і після ВСІХ тестів у xUnit.net

TL; DR - Я шукаю еквівалент xUnit MSTest AssemblyInitialize(він же ОДНА функція, яка мені подобається).

Зокрема, я шукаю його, тому що у мене є кілька тестів диму на селен, які я хотів би мати можливість проводити без інших залежностей. У мене є пристрій, який запустить для мене IisExpress і вб’є його при утилізації. Але це робить перед кожним тестом, що надзвичайно зменшує час роботи.

Я хотів би запустити цей код один раз на початку тестування та утилізувати його (завершуючи процес) наприкінці. Як я міг займатися цим?

Навіть якщо я можу отримати програмний доступ до чогось на кшталт "скільки тестів виконується в даний час", я можу щось зрозуміти.

Станом на листопад 2015 р. XUnit 2 вийшов, тому існує канонічний спосіб обміну функціями між тестами. Це задокументовано тут .

В основному вам потрібно буде створити клас, який виконує пристрій:

    public class DatabaseFixture : IDisposable
    {
        public DatabaseFixture()
        {
            Db = new SqlConnection("MyConnectionString");

            // ... initialize data in the test database ...
        }

        public void Dispose()
        {
            // ... clean up test data from the database ...
        }

        public SqlConnection Db { get; private set; }
    }

Фіктивний клас із CollectionDefinitionатрибутом. Цей клас дозволяє Xunit створювати тестову колекцію і використовуватиме дане кріплення для всіх тестових класів колекції.

    [CollectionDefinition("Database collection")]
    public class DatabaseCollection : ICollectionFixture<DatabaseFixture>
    {
        // This class has no code, and is never created. Its purpose is simply
        // to be the place to apply [CollectionDefinition] and all the
        // ICollectionFixture<> interfaces.
    }

Потім вам потрібно додати назву колекції до всіх ваших тестових класів. Тестові класи можуть отримати кріплення через конструктор.

    [Collection("Database collection")]
    public class DatabaseTestClass1
    {
        DatabaseFixture fixture;

        public DatabaseTestClass1(DatabaseFixture fixture)
        {
            this.fixture = fixture;
        }
    }

Це трохи детальніше, ніж MsTests, AssemblyInitializeоскільки вам потрібно оголосити на кожному тестовому класі, до якої колекції тестів він належить, але це також більш модульно (і з MsTests вам все одно потрібно поставити TestClass на свої класи)

Примітка: зразки взяті з документації .

Створіть статичне поле та застосуйте фіналізатор.

Ви можете використовувати той факт, що xUnit створює AppDomain для запуску тестової збірки та вивантажує її після її закінчення. Вивантаження домену програми призведе до запуску фіналізатора.

Я використовую цей метод для запуску та зупинки IISExpress.

public sealed class ExampleFixture
{
    public static ExampleFixture Current = new ExampleFixture();

    private ExampleFixture()
    {
        // Run at start
    }

    ~ExampleFixture()
    {
        Dispose();
    }

    public void Dispose()
    {
        GC.SuppressFinalize(this);

        // Run at end
    }        
}

Редагувати: отримати доступ до приладу за допомогою ExampleFixture.Currentваших тестів.

Для виконання коду при ініціалізації збірки можна це зробити (перевірено за допомогою xUnit 2.3.1)

using Xunit.Abstractions;
using Xunit.Sdk;

[assembly: Xunit.TestFramework("MyNamespace.MyClassName", "MyAssemblyName")]

namespace MyNamespace
{   
   public class MyClassName : XunitTestFramework
   {
      public MyClassName(IMessageSink messageSink)
        :base(messageSink)
      {
        // Place initialization code here
      }

      public new void Dispose()
      {
        // Place tear down code here
        base.Dispose();
      }
   }
}

Див. Також https://github.com/xunit/samples.xunit/tree/master/AssemblyFixtureExample

Сьогодні це неможливо зробити в рамках. Ця функція запланована для версії 2.0.

Для того, щоб зробити цю роботу до версії 2.0, вам знадобиться виконати значну реструктуризацію фреймворку або написати власні бігуни, які розпізнають ваші власні спеціальні атрибути.

Я використовую AssemblyFixture ( NuGet ).

Що він робить, це забезпечує IAssemblyFixture<T>інтерфейс, який замінює будь-яке місце, IClassFixture<T>де ви хочете, щоб час життя об’єкта був тестовим вузлом.

Приклад:

public class Singleton { }

public class TestClass1 : IAssemblyFixture<Singleton>
{
  readonly Singletone _Singletone;
  public TestClass1(Singleton singleton)
  {
    _Singleton = singleton;
  }

  [Fact]
  public void Test1()
  {
     //use singleton  
  }
}

public class TestClass2 : IAssemblyFixture<Singleton>
{
  readonly Singletone _Singletone;
  public TestClass2(Singleton singleton)
  {
    //same singleton instance of TestClass1
    _Singleton = singleton;
  }

  [Fact]
  public void Test2()
  {
     //use singleton  
  }
}

Мене дуже дратувало те, що я не мав можливості виконувати щось наприкінці всіх тестів xUnit. Деякі варіанти тут не такі чудові, оскільки вони передбачають зміну всіх ваших тестів або розміщення їх під однією колекцією (тобто вони виконуються синхронно). Але відповідь Рольфа Крістенсена дала мені необхідну інформацію, щоб дістатися до цього коду. Це трохи довго, але вам потрібно лише додати його у свій тестовий проект, інші зміни коду не потрібні:

using Siderite.Tests;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Reflection;
using System.Text;
using Xunit;
using Xunit.Abstractions;
using Xunit.Sdk;

[assembly: TestFramework(
    SideriteTestFramework.TypeName,
    SideriteTestFramework.AssemblyName)]

namespace Siderite.Tests
{
    public class SideriteTestFramework : ITestFramework
    {
        public const string TypeName = "Siderite.Tests.SideriteTestFramework";
        public const string AssemblyName = "Siderite.Tests";
        private readonly XunitTestFramework _innerFramework;

        public SideriteTestFramework(IMessageSink messageSink)
        {
            _innerFramework = new XunitTestFramework(messageSink);
        }

        public ISourceInformationProvider SourceInformationProvider
        {
            set
            {
                _innerFramework.SourceInformationProvider = value;
            }
        }

        public void Dispose()
        {
            _innerFramework.Dispose();
        }

        public ITestFrameworkDiscoverer GetDiscoverer(IAssemblyInfo assembly)
        {
            return _innerFramework.GetDiscoverer(assembly);
        }

        public ITestFrameworkExecutor GetExecutor(AssemblyName assemblyName)
        {
            var executor = _innerFramework.GetExecutor(assemblyName);
            return new SideriteTestExecutor(executor);
        }

        private class SideriteTestExecutor : ITestFrameworkExecutor
        {
            private readonly ITestFrameworkExecutor _executor;
            private IEnumerable<ITestCase> _testCases;

            public SideriteTestExecutor(ITestFrameworkExecutor executor)
            {
                this._executor = executor;
            }

            public ITestCase Deserialize(string value)
            {
                return _executor.Deserialize(value);
            }

            public void Dispose()
            {
                _executor.Dispose();
            }

            public void RunAll(IMessageSink executionMessageSink, ITestFrameworkDiscoveryOptions discoveryOptions, ITestFrameworkExecutionOptions executionOptions)
            {
                _executor.RunAll(executionMessageSink, discoveryOptions, executionOptions);
            }

            public void RunTests(IEnumerable<ITestCase> testCases, IMessageSink executionMessageSink, ITestFrameworkExecutionOptions executionOptions)
            {
                _testCases = testCases;
                _executor.RunTests(testCases, new SpySink(executionMessageSink, this), executionOptions);
            }

            internal void Finished(TestAssemblyFinished executionFinished)
            {
                // do something with the run test cases in _testcases and the number of failed and skipped tests in executionFinished
            }
        }


        private class SpySink : IMessageSink
        {
            private readonly IMessageSink _executionMessageSink;
            private readonly SideriteTestExecutor _testExecutor;

            public SpySink(IMessageSink executionMessageSink, SideriteTestExecutor testExecutor)
            {
                this._executionMessageSink = executionMessageSink;
                _testExecutor = testExecutor;
            }

            public bool OnMessage(IMessageSinkMessage message)
            {
                var result = _executionMessageSink.OnMessage(message);
                if (message is TestAssemblyFinished executionFinished)
                {
                    _testExecutor.Finished(executionFinished);
                }
                return result;
            }
        }
    }
}

Основні моменти:

• складання: TestFramework доручає xUnit використовувати ваш фреймворк, який є проксі-сервером для типового
• SideriteTestFramework також обертає виконавця у власний клас, який потім обгортає раковину повідомлень
• врешті-решт, виконується метод Finished, зі списком запущених тестів та результатом повідомлення xUnit

Тут можна було б зробити більше роботи. Якщо ви хочете виконувати речі, не дбаючи про запущені тести, ви можете успадкувати від XunitTestFramework і просто обернути раковину повідомлень.

Ви можете використовувати інтерфейс IUseFixture, щоб це сталося. Також весь ваш тест повинен успадкувати клас TestBase. Ви також можете використовувати OneTimeFixture безпосередньо з тесту.

public class TestBase : IUseFixture<OneTimeFixture<ApplicationFixture>>
{
    protected ApplicationFixture Application;

    public void SetFixture(OneTimeFixture<ApplicationFixture> data)
    {
        this.Application = data.Fixture;
    }
}

public class ApplicationFixture : IDisposable
{
    public ApplicationFixture()
    {
        // This code run only one time
    }

    public void Dispose()
    {
        // Here is run only one time too
    }
}

public class OneTimeFixture<TFixture> where TFixture : new()
{
    // This value does not share between each generic type
    private static readonly TFixture sharedFixture;

    static OneTimeFixture()
    {
        // Constructor will call one time for each generic type
        sharedFixture = new TFixture();
        var disposable = sharedFixture as IDisposable;
        if (disposable != null)
        {
            AppDomain.CurrentDomain.DomainUnload += (sender, args) => disposable.Dispose();
        }
    }

    public OneTimeFixture()
    {
        this.Fixture = sharedFixture;
    }

    public TFixture Fixture { get; private set; }
}

EDIT: Вирішіть проблему, яку створюють нові кріплення для кожного тестового класу.

Чи надає ваш інструмент побудови таку функцію?

У світі Java, використовуючи Maven як інструмент побудови, ми використовуємо відповідні фази життєвого циклу побудови . Наприклад, у вашому випадку (приймальні тести з інструментами, подібними до селену), ви можете ефективно використовувати фази pre-integration-testта і post-integration-testдля запуску / зупинки веб-додатка до / після свого integration-test.

Я майже впевнений, що такий самий механізм можна встановити у вашому середовищі.