mirror of
https://github.com/anthonyaxenov/atol-online.git
synced 2024-11-24 17:09:37 +00:00
AnthonyAxenov
557c76fefa
- коллекция `Items` с покрытием - вынос коллекций из `AtolOnline\Entities` в `AtolOnline\Collections` - фикс ] в `AtolException` - финализирован `CorrectionInfo` - фиксы по тестам коллекций - прочие мелочи по phpdoc
347 lines
12 KiB
PHP
347 lines
12 KiB
PHP
<?php
|
||
/*
|
||
* Copyright (c) 2020-2021 Антон Аксенов (Anthony Axenov)
|
||
*
|
||
* This code is licensed under MIT.
|
||
* Этот код распространяется по лицензии MIT.
|
||
* https://github.com/anthonyaxenov/atol-online/blob/master/LICENSE
|
||
*/
|
||
|
||
namespace AtolOnline\Tests\Api;
|
||
|
||
use AtolOnline\Api\AtolClient;
|
||
use AtolOnline\Api\KktMonitor;
|
||
use AtolOnline\Api\KktResponse;
|
||
use AtolOnline\Entities\Kkt;
|
||
use AtolOnline\Exceptions\AuthFailedException;
|
||
use AtolOnline\Exceptions\EmptyLoginException;
|
||
use AtolOnline\Exceptions\EmptyMonitorDataException;
|
||
use AtolOnline\Exceptions\EmptyPasswordException;
|
||
use AtolOnline\Exceptions\NotEnoughMonitorDataException;
|
||
use AtolOnline\Exceptions\TooLongLoginException;
|
||
use AtolOnline\Exceptions\TooLongPasswordException;
|
||
use AtolOnline\Helpers;
|
||
use AtolOnline\TestEnvParams;
|
||
use AtolOnline\Tests\BasicTestCase;
|
||
use Exception;
|
||
use GuzzleHttp\Exception\GuzzleException;
|
||
|
||
/**
|
||
* Набор тестов для проверки работы API-клиента на примере монитора ККТ
|
||
*/
|
||
class KktMonitorTest extends BasicTestCase
|
||
{
|
||
/**
|
||
* Возвращает объект клиента для тестирования с тестовым API АТОЛ
|
||
*
|
||
* @return KktMonitor
|
||
* @throws EmptyLoginException
|
||
* @throws EmptyPasswordException
|
||
* @throws TooLongLoginException
|
||
* @throws TooLongPasswordException
|
||
*/
|
||
private function newTestClient(): KktMonitor
|
||
{
|
||
$credentials = TestEnvParams::FFD105();
|
||
return (new KktMonitor(true))
|
||
->setLogin($credentials['login'])
|
||
->setPassword($credentials['password']);
|
||
}
|
||
|
||
/**
|
||
* Тестирует успешное создание объекта монитора без аргументов конструктора
|
||
*
|
||
* @covers \AtolOnline\Api\KktMonitor::__construct
|
||
*/
|
||
public function testConstructorWithoutArgs(): void
|
||
{
|
||
$client = new KktMonitor();
|
||
$this->assertIsObject($client);
|
||
$this->assertIsSameClass(KktMonitor::class, $client);
|
||
$this->assertExtendsClasses([AtolClient::class], $client);
|
||
}
|
||
|
||
/**
|
||
* Тестирует успешное создание объекта монитора с аргументами конструктора
|
||
*
|
||
* @covers \AtolOnline\Api\KktMonitor::__construct
|
||
* @covers \AtolOnline\Api\KktMonitor::setLogin
|
||
* @covers \AtolOnline\Api\KktMonitor::getLogin
|
||
* @covers \AtolOnline\Api\KktMonitor::setPassword
|
||
* @covers \AtolOnline\Api\KktMonitor::getPassword
|
||
* @throws EmptyLoginException
|
||
* @throws EmptyPasswordException
|
||
* @throws TooLongLoginException
|
||
* @throws TooLongPasswordException
|
||
*/
|
||
public function testConstructorWithArgs(): void
|
||
{
|
||
$client = new KktMonitor(false, 'login', 'password', []);
|
||
$this->assertIsObject($client);
|
||
$this->assertIsSameClass($client, KktMonitor::class);
|
||
$this->assertExtendsClasses([AtolClient::class], $client);
|
||
}
|
||
|
||
/**
|
||
* Тестирует установку и возврат логина
|
||
*
|
||
* @covers \AtolOnline\Api\KktMonitor::__construct
|
||
* @covers \AtolOnline\Api\KktMonitor::getLogin
|
||
* @covers \AtolOnline\Api\KktMonitor::setLogin
|
||
* @throws EmptyLoginException
|
||
* @throws TooLongLoginException
|
||
*/
|
||
public function testLogin(): void
|
||
{
|
||
$client = new KktMonitor(login: 'login');
|
||
$this->assertEquals('login', $client->getLogin());
|
||
|
||
$client = new KktMonitor();
|
||
$this->assertNull($client->getLogin());
|
||
|
||
$client->setLogin('login');
|
||
$this->assertEquals('login', $client->getLogin());
|
||
}
|
||
|
||
/**
|
||
* Тестирует исключение при попытке передать пустой логин в конструктор
|
||
*
|
||
* @covers \AtolOnline\Api\KktMonitor::__construct
|
||
* @covers \AtolOnline\Api\KktMonitor::setLogin
|
||
* @covers \AtolOnline\Exceptions\EmptyLoginException
|
||
*/
|
||
public function testEmptyLoginException(): void
|
||
{
|
||
$this->expectException(EmptyLoginException::class);
|
||
new KktMonitor(login: '');
|
||
}
|
||
|
||
/**
|
||
* Тестирует исключение при попытке передать слишком длинный логин в конструктор
|
||
*
|
||
* @covers \AtolOnline\Api\KktMonitor::__construct
|
||
* @covers \AtolOnline\Api\KktMonitor::setLogin
|
||
* @covers \AtolOnline\Exceptions\TooLongLoginException
|
||
* @throws EmptyLoginException
|
||
* @throws EmptyPasswordException
|
||
* @throws TooLongLoginException
|
||
* @throws TooLongPasswordException
|
||
*/
|
||
public function testTooLongLoginException(): void
|
||
{
|
||
$this->expectException(TooLongLoginException::class);
|
||
new KktMonitor(login: Helpers::randomStr(101));
|
||
}
|
||
|
||
/**
|
||
* Тестирует установку и возврат пароля
|
||
*
|
||
* @covers \AtolOnline\Api\KktMonitor::__construct
|
||
* @covers \AtolOnline\Api\KktMonitor::getPassword
|
||
* @covers \AtolOnline\Api\KktMonitor::setPassword
|
||
* @throws EmptyPasswordException
|
||
* @throws TooLongPasswordException
|
||
*/
|
||
public function testPassword(): void
|
||
{
|
||
$client = new KktMonitor(password: 'password');
|
||
$this->assertEquals('password', $client->getPassword());
|
||
|
||
$client = new KktMonitor();
|
||
$this->assertNull($client->getPassword());
|
||
|
||
$client->setPassword('password');
|
||
$this->assertEquals('password', $client->getPassword());
|
||
}
|
||
|
||
/**
|
||
* Тестирует исключение при попытке передать пустой пароль в конструктор
|
||
*
|
||
* @covers \AtolOnline\Api\KktMonitor::__construct
|
||
* @covers \AtolOnline\Api\KktMonitor::setPassword
|
||
* @covers \AtolOnline\Exceptions\EmptyPasswordException
|
||
*/
|
||
public function testEmptyPasswordException(): void
|
||
{
|
||
$this->expectException(EmptyPasswordException::class);
|
||
new KktMonitor(password: '');
|
||
}
|
||
|
||
/**
|
||
* Тестирует исключение при попытке передать слишком длинный пароль в конструктор
|
||
*
|
||
* @covers \AtolOnline\Api\KktMonitor::__construct
|
||
* @covers \AtolOnline\Api\KktMonitor::setPassword
|
||
* @throws EmptyLoginException
|
||
* @throws EmptyPasswordException
|
||
* @throws TooLongLoginException
|
||
* @throws TooLongPasswordException
|
||
*/
|
||
public function testConstructorWithLongPassword(): void
|
||
{
|
||
$this->expectException(TooLongPasswordException::class);
|
||
new KktMonitor(password: Helpers::randomStr(101));
|
||
}
|
||
|
||
/**
|
||
* Тестирует установку тестового режима
|
||
*
|
||
* @covers \AtolOnline\Api\KktMonitor::__construct
|
||
* @covers \AtolOnline\Api\KktMonitor::isTestMode
|
||
* @covers \AtolOnline\Api\KktMonitor::setTestMode
|
||
*/
|
||
public function testTestMode(): void
|
||
{
|
||
$client = new KktMonitor();
|
||
$this->assertTrue($client->isTestMode());
|
||
|
||
$client = new KktMonitor(true);
|
||
$this->assertTrue($client->isTestMode());
|
||
|
||
$client = new KktMonitor(false);
|
||
$this->assertFalse($client->isTestMode());
|
||
|
||
$client = (new KktMonitor())->setTestMode();
|
||
$this->assertTrue($client->isTestMode());
|
||
|
||
$client = (new KktMonitor())->setTestMode(true);
|
||
$this->assertTrue($client->isTestMode());
|
||
|
||
$client = (new KktMonitor())->setTestMode(false);
|
||
$this->assertFalse($client->isTestMode());
|
||
}
|
||
|
||
/**
|
||
* Тестирует авторизацию
|
||
*
|
||
* @covers \AtolOnline\Api\AtolClient::getHeaders
|
||
* @covers \AtolOnline\Api\KktMonitor::sendRequest
|
||
* @covers \AtolOnline\Api\KktMonitor::getAuthEndpoint
|
||
* @covers \AtolOnline\Api\KktMonitor::doAuth
|
||
* @covers \AtolOnline\Api\KktMonitor::auth
|
||
* @covers \AtolOnline\Exceptions\AuthFailedException
|
||
* @throws EmptyLoginException
|
||
* @throws EmptyPasswordException
|
||
* @throws TooLongLoginException
|
||
* @throws TooLongPasswordException
|
||
* @throws AuthFailedException
|
||
* @throws GuzzleException
|
||
*/
|
||
public function testAuth(): void
|
||
{
|
||
$this->skipIfMonitoringIsOffline();
|
||
$result = $this->newTestClient()->auth();
|
||
$this->assertTrue($result);
|
||
}
|
||
|
||
/**
|
||
* Тестирует возврат токена после авторизации
|
||
*
|
||
* @depends testAuth
|
||
* @covers \AtolOnline\Api\KktMonitor::setToken
|
||
* @covers \AtolOnline\Api\KktMonitor::getToken
|
||
* @covers \AtolOnline\Exceptions\AuthFailedException
|
||
* @throws AuthFailedException
|
||
* @throws EmptyLoginException
|
||
* @throws EmptyPasswordException
|
||
* @throws GuzzleException
|
||
* @throws TooLongLoginException
|
||
* @throws TooLongPasswordException
|
||
*/
|
||
public function testGetToken(): void
|
||
{
|
||
$client = new KktMonitor();
|
||
$this->assertNull($client->getToken());
|
||
|
||
$this->skipIfMonitoringIsOffline();
|
||
$client = $this->newTestClient();
|
||
$client->auth();
|
||
$this->assertIsString($client->getToken());
|
||
}
|
||
|
||
/**
|
||
* Тестирует возврат объекта последнего ответа от API
|
||
*
|
||
* @depends testAuth
|
||
* @covers \AtolOnline\Api\KktMonitor::getResponse
|
||
* @covers \AtolOnline\Exceptions\AuthFailedException
|
||
* @throws AuthFailedException
|
||
* @throws EmptyLoginException
|
||
* @throws EmptyPasswordException
|
||
* @throws GuzzleException
|
||
* @throws TooLongLoginException
|
||
* @throws TooLongPasswordException
|
||
*/
|
||
public function testGetResponse(): void
|
||
{
|
||
$this->skipIfMonitoringIsOffline();
|
||
$client = $this->newTestClient();
|
||
$client->auth();
|
||
$this->assertIsSameClass(KktResponse::class, $client->getResponse());
|
||
}
|
||
|
||
/**
|
||
* [Мониторинг] Тестирует получение данных о всех ККТ
|
||
*
|
||
* @depends testAuth
|
||
* @covers \AtolOnline\Api\KktMonitor::getMainEndpoint
|
||
* @covers \AtolOnline\Api\AtolClient::getUrlToMethod
|
||
* @covers \AtolOnline\Api\KktMonitor::fetchAll
|
||
* @covers \AtolOnline\Api\KktMonitor::getAll
|
||
* @covers \AtolOnline\Exceptions\AuthFailedException
|
||
* @throws AuthFailedException
|
||
* @throws EmptyLoginException
|
||
* @throws EmptyPasswordException
|
||
* @throws GuzzleException
|
||
* @throws TooLongLoginException
|
||
* @throws TooLongPasswordException
|
||
*/
|
||
public function testMonitorGetAll(): void
|
||
{
|
||
$this->skipIfMonitoringIsOffline();
|
||
$client = $this->newTestClient();
|
||
$client->auth();
|
||
$kkts = $client->getAll();
|
||
$this->assertNotEmpty($client->getResponse()->getContent());
|
||
$this->assertIsCollection($kkts);
|
||
$this->assertTrue($kkts->count() > 0);
|
||
$this->assertIsSameClass(Kkt::class, $kkts->random());
|
||
}
|
||
|
||
/**
|
||
* [Мониторинг] Тестирует получение данных о конкретной ККТ
|
||
*
|
||
* @depends testAuth
|
||
* @covers \AtolOnline\Api\KktMonitor::getMainEndpoint
|
||
* @covers \AtolOnline\Api\AtolClient::getUrlToMethod
|
||
* @covers \AtolOnline\Api\KktMonitor::fetchOne
|
||
* @covers \AtolOnline\Api\KktMonitor::getOne
|
||
* @covers \AtolOnline\Entities\Kkt::__construct
|
||
* @covers \AtolOnline\Entities\Kkt::__get
|
||
* @covers \AtolOnline\Entities\Kkt::jsonSerialize
|
||
* @covers \AtolOnline\Entities\Kkt::__toString
|
||
* @throws AuthFailedException
|
||
* @throws EmptyLoginException
|
||
* @throws EmptyPasswordException
|
||
* @throws GuzzleException
|
||
* @throws TooLongLoginException
|
||
* @throws TooLongPasswordException
|
||
* @throws EmptyMonitorDataException
|
||
* @throws NotEnoughMonitorDataException
|
||
* @throws Exception
|
||
*/
|
||
public function testMonitorGetOne(): void
|
||
{
|
||
$this->skipIfMonitoringIsOffline();
|
||
$client = $this->newTestClient();
|
||
$client->auth();
|
||
$serial_number = $client->getAll()->first()->serialNumber;
|
||
$kkt = $client->getOne($serial_number);
|
||
$this->assertNotEmpty($client->getResponse());
|
||
$this->assertIsSameClass(Kkt::class, $kkt);
|
||
$this->assertAtolable($kkt);
|
||
$this->assertNotNull($kkt->serialNumber);
|
||
$this->assertEquals($serial_number, $kkt->serialNumber);
|
||
}
|
||
}
|