atol-online/tests/KktMonitorTest.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 AtolOnlineTests;

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 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($client, [AtolClient::class]);
    }

    /**
     * Тестирует успешное создание объекта монитора с аргументами конструктора
     *
     * @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($client, [AtolClient::class]);
    }

    /**
     * Тестирует установку и возврат логина
     *
     * @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
     */
    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);
    }
}