SprintMigrationsTrait.

Author: ProklUng

composer.json

@@ -23,6 +23,12 @@
     "require": {
         "proklung/phpunit-testing-tools": "^1.0",
         "sheerockoff/bitrix-ci": "^20.5",
+        "andreyryabin/sprint.migration": "^3.28.4",
         "ext-mysqli": "*"
+    },
+    "extra": {
+        "installer-paths": {
+            "vendor/sheerockoff/bitrix-ci/files/bitrix/modules/{$name}/": ["type:bitrix-module"]
+        }
     }
 }

readme.MD

@@ -53,6 +53,27 @@
 При использовании дампов с боя обычно возникают проблемы с просроченностью лицензии. В таком случае приходится вручную
 заменить файл `include.php` в `vendor/sheerockoff/bitrix-ci/files/bitrix/modules/main`.
 
+#### Трэйт SprintMigrationsTrait
+
+Использование миграций модуля [sprint.option](https://github.com/andreyryabin/sprint.migration).
+
+Путь к директории с миграциями указывается в методе `getPathSprintMigrations` теста:
+
+```php
+    protected function getPathSprintMigrations() : string
+    {
+        return __DIR__ . '../../../../../../Tests/sprint_migrations/';
+    }
+```
+
+##### Нюансы
+
+В силу особенностей использования сборки [Bitrix CI](https://github.com/sheerockoff/bitrix-ci) приходится устанавливать модуль хитро - прямо внутрь пакета сборки
+(в папку `vendor/sheerockoff/bitrix-ci/files/bitrix/modules/sprint.option`) на стадии работы композера. Побочный эффект - если обновится сама сборка, 
+то модуль миграций улетит в трубу. 
+
+Пока так. 
+
 #### Трэйт UseMigrationsTrait
 
 Указание запускать миграции перед каждым тестом. 

src/Base/BitrixableTestCase.php

@@ -2,13 +2,15 @@
 
 namespace Prokl\BitrixTestingTools\Base;
 
+use Bitrix\Catalog\Model\Price;
 use Exception;
 use Prokl\BitrixTestingTools\Migrations\ArrilotMigratorProcessor;
 use Prokl\BitrixTestingTools\Migrator;
 use Prokl\BitrixTestingTools\Helpers\ClassUtils;
 use Prokl\BitrixTestingTools\Helpers\Database;
 use Prokl\BitrixTestingTools\Traits\CustomDumpTrait;
 use Prokl\BitrixTestingTools\Traits\ResetDatabaseTrait;
+use Prokl\BitrixTestingTools\Traits\SprintMigrationsTrait;
 use Prokl\BitrixTestingTools\Traits\UseMigrationsTrait;
 use Prokl\TestingTools\Base\BaseTestCase;
 use Sheerockoff\BitrixCi\Bootstrap;
@@ -55,13 +57,19 @@ protected function setUp(): void
         // Миграции
         if ($this->useMigrations()) {
             $migrator = new ArrilotMigratorProcessor();
-
+            /** @noinspection PhpUndefinedMethodInspection */
             $migrator->setMigrationsDir($this->getMigrationsDir())
                       ->init();
 
             $migrator->createMigrationsTable();
             $migrator->migrate();
         }
+
+        // Миграции модуля sprint.option.
+        if ($this->useSprintMigrations()) {
+            /** @noinspection PhpUndefinedMethodInspection */
+            $this->sprintMigration();
+        }
     }
 
     /**
@@ -158,6 +166,16 @@ private function useMigrations() : bool
         return $this->hasTrait(UseMigrationsTrait::class);
     }
 
+    /**
+     * Использовать ли миграции модуля sprint.option. Признак - трэйт SprintMigrationsTrait.
+     *
+     * @return boolean
+     */
+    private function useSprintMigrations() : bool
+    {
+        return $this->hasTrait(SprintMigrationsTrait::class);
+    }
+
     /**
      * Имеет ли экземпляр класса тот или иной трэйт.
      *

src/Traits/SprintMigrationsTrait.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace Prokl\BitrixTestingTools\Traits;
+
+use Bitrix\Main\ModuleManager;
+use CModule;
+use Sprint\Migration\Exceptions\MigrationException;
+use Sprint\Migration\Installer;
+
+/**
+ * Trait SprintMigrationsTrait
+ * Трэйт запуска миграций модуля sprint.migration.
+ * @package Prokl\BitrixTestingTools\Traits
+ */
+trait SprintMigrationsTrait
+{
+    /**
+     * Запуск миграций модуля sprint.option (@see https://github.com/andreyryabin/sprint.migration).
+     *
+     * @return boolean
+     * @throws MigrationException
+     */
+    protected function sprintMigration() : bool
+    {
+        if (!ModuleManager::isModuleInstalled('sprint.migration')) {
+            RegisterModule('sprint.migration');
+        }
+
+        if (CModule::IncludeModule('sprint.migration')) {
+            (new Installer(
+                [
+                    'migration_dir'          => $this->getPathSprintMigrations(),
+                    'migration_dir_absolute' => true,
+                ]
+            ))->up();
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Путь к миграциям.
+     *
+     * @return string
+     */
+    protected function getPathSprintMigrations() : string
+    {
+        return  __DIR__ . '../../../../../../Tests/sprint_migrations/';
+    }
+
+}