https://github.com/webarchitect609/bitrix-taxidermist
Создание имитаций(mocking) классов Битрикс для Unit-тестов и статического анализа кода.
https://github.com/webarchitect609/bitrix-taxidermist
bitrix composer composer-library mock mocking mocks mocks-generator mockup php
Last synced: about 1 year ago
JSON representation
Создание имитаций(mocking) классов Битрикс для Unit-тестов и статического анализа кода.
- Host: GitHub
- URL: https://github.com/webarchitect609/bitrix-taxidermist
- Owner: webarchitect609
- License: bsd-3-clause
- Created: 2020-05-17T18:38:38.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-05-12T21:12:46.000Z (almost 3 years ago)
- Last Synced: 2024-09-19T21:09:29.652Z (over 1 year ago)
- Topics: bitrix, composer, composer-library, mock, mocking, mocks, mocks-generator, mockup, php
- Language: PHP
- Homepage:
- Size: 108 KB
- Stars: 6
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
Битрикс таксидермист
====================
[](https://travis-ci.com/webarchitect609/bitrix-taxidermist)
[](https://codecov.io/gh/webarchitect609/bitrix-taxidermist)
[](https://www.php.net/supported-versions.php)
[](https://github.com/webarchitect609/bitrix-taxidermist/releases)
[](https://packagist.org/packages/webarchitect609/bitrix-taxidermist)
[](LICENSE.md)
**Пожалуйста, будьте внимательны:** это пока нестабильная альфа-версия!
Для разработки Unit-тестов библиотек, зависимых от Битрикс, требуется сам Битрикс. Однако его установка является долгим
процессом, который контролируется через визуальный интерфейс в браузере и очень сложно поддаётся автоматизации. Данная
библиотека предоставляет возможность автоматического создания имитаций(mocking) классов Битрикс без установки
последнего. Одновременно решается проблема `Multiple definitions exist for class '%bitrixClassName%'` в IDE при
разработке.
Возможности
-----------
- Автоматическое создание mock-классов Битрикс для использование в Unit-тестах
Установка
---------
`composer require --dev webarchitect609/bitrix-taxidermist`
Использование
-------------
### Unit-тесты
При написании Unit-теста в переопределении метода `\PHPUnit\Framework\TestCase::setUp()` или
`\PHPUnit\Framework\TestCase::setUpBeforeClass()` следует запустить изготовление имитаций всех классов:
```php
use WebArch\BitrixTaxidermist\Taxidermist;
(new Taxidermist)->taxidermizeAll();
```
Будут автоматически созданы алиасы. Например,
```php
/** @noinspection ALL */
class_alias('\WebArch\BitrixTaxidermist\Mock\Bitrix\Main\Data\Cache', '\Bitrix\Main\Data\Cache');
```
, и таким образом Unit-тест может пользоваться этими классами точно также, как если бы в его распоряжении был
установленный Битрикс.
### Статический анализ кода
Следует указать файл `~/resources/autoload-dist.php` в качестве дополнительного файла автозагрузчика.
Известные особенности
---------------------
### Ошибка при вызове `\Bitrix\Main\Application::getInstance()`
Если необходимо работать с `\Bitrix\Main\Application::getInstance()`, он будет вызывать ошибку:
```
Error: Cannot instantiate abstract class WebArch\BitrixTaxidermist\Mock\Bitrix\Main\Application
```
Чтобы этого избежать, следует создать требуемый объект приложения. Например, так:
```php
use WebArch\BitrixTaxidermist\Mock\Bitrix\Main\HttpApplication;
HttpApplication::getInstance();
```
Лицензия и информация об авторе
-------------------------------
[BSD-3-Clause](LICENSE.md)