avto-dev/dev-tools

PHP developer tools

, _(*1)

PHP developers tools

![PHP Version][badge_php_version] ![Coverage][badge_coverage] ![License][badge_license], _(*2)

Install

Require this package with composer using the following command:, _(*3)

$ composer require --dev avto-dev/dev-tools "^2.0"

Installed composer is required (how to install composer)., _(*4)

You need to fix the major version of package., _(*5)

Использование

Данный пакет позволяет легко интегрировать в ваше приложение вспомогательные инструменты, позволяющие более эффективно вести разработку. Разделить их можно на следующие группы:, _(*6)

Вспомогательные сервисы для Laravel

Для Laravel-приложений вы можете подключать следующие сервис-провайдеры:, _(*7)

Unit-тестирование приложения

В контексте фреймворка PHPUnit, _(*8)

Bootstrap

Bootstrap - это файл, который выполняется перед запуском всех тестов, единожды. Основная его задача - произвести подготовку среды - создать директории для временных файлов (удалив предыдущие), подготовить схему БД и так далее., _(*9)

Вы можете указать путь до своего собственного bootstrap-файла в конфигурации PHPUnit (./phpunit.xml):, _(*10)

<?xml version="1.0" encoding="UTF-8"?>
<phpunit bootstrap="./tests/bootstrap.php">
    <!-- configuration -->
</phpunit>

Для Laravel-приложений

Написание кода по рекурсивному созданию директорий, соединению с БД может показаться вам довольно утомительным. Для того, чтобы упростить данную задачу вы можете создать свой класс bootsrapper-а, который умеет поочередное выполнение всех методов внутри себя, начинающихся с префикса boot* при создании собственного экземпляра. Более того - $this->app уже хранит инстанс вашего приложения (достаточно подключить нужный трейт). Взгляните на пример:, _(*11)

<?php

class MyBootstrap extends \AvtoDev\DevTools\Tests\Bootstrap\AbstractLaravelTestsBootstrapper
{
    use AvtoDev\DevTools\Tests\PHPUnit\Traits\CreatesApplicationTrait;

    public function bootPrepareDatabase()
    {
        $this->app->make(Illuminate\Contracts\Console\Kernel::class)->call('migrate:refresh');
    }
}

И вы всегда имеете "свежую" схему БД перед запуском тестов., _(*12)

Прочие приложения

Более простая реализация:, _(*13)

<?php

class MyBootstrap extends \AvtoDev\DevTools\Tests\Bootstrap\AbstractTestsBootstrapper
{
    public function bootMakeSome()
    {
        // Put your code here
    }

    public function bootMakeSomethingElse()
    {
        // Put your code here
    }
}

В обоих случаях не забудьте создать файл ./tests/bootstrap.php, написав в нём <?php new MyBootstrap();, указав <phpunit bootstrap="./tests/bootstrap.php"> в конфигурации PHPUnit., _(*14)

Абстрактные классы Unit-тестов

Для более удобного тестирования вашего приложения вы можете использовать абстрактные классы Unit-тестов, поставляемых с данным пакетом (имеются версии как для Laravel-приложений, так и без данной зависимости)., _(*15)

Их отличительная особенность заключается в том, что они содержат дополнительные assert-методы, которые позволят вам писать писать более лаконичные и выразительные тесты. Данный функционал подключается с помощью трейтов, так что вы сможете при необходимости составить свой собственный абстрактный класс (не наследованный от поставляемого) с необходимым набором "фишек"., _(*16)

Рекомендация использовать абстрактные классы обусловлена тем, что их функционал с течением времени будет расширяться, и вы сможете получать их новые возможности при помощи одной лишь команды composer update avto-dev/dev-tools., _(*17)

Для Laravel-приложений

Наследуйте классы своих тестов от AvtoDev\DevTools\Tests\PHPUnit\AbstractLaravelTestCase., _(*18)

Прочие приложения

Наследуйте классы своих тестов от AvtoDev\DevTools\Tests\PHPUnit\AbstractTestCase., _(*19)

PHPUnit-трейты

Ниже в виде сводной таблицы представлены имена трейтов и поставляемый с ними функционал. Все трейты расположены в AvtoDev\DevTools\Tests\PHPUnit\Traits:, _(*20)

Testing

For package testing we use phpunit framework and docker-ce + docker-compose as develop environment. So, just write into your terminal after repository cloning:, _(*21)

$ make build
$ make latest # or 'make lowest'
$ make test

Changes log

![Commits since latest release][badge_commits_since_release], _(*22)

Changes log can be found here., _(*23)

Support

![Issues][badge_pulls], _(*24)

If you will find any package errors, please, make an issue in current repository., _(*25)

License

This is open-sourced software licensed under the MIT License., _(*26)