babaev-an/php_components_pack
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 27 Wiki Activity

20250524

Browse Source 
- Добавлено перечисление VarNotBoolAction, для определения действий в классе BoolExtensions (методы AnyTrue и TrueCount), если передана часть не булевого типа.

- В расширении BoolExtensions в методах AnyTrue и TrueCount убрано выброс исключение, если какой-то аргумент из массива expressions не является булевым типом. Вместо него в обоих методах введён необязательный параметр $ifNotBool (тип VarNotBoolAction), который определяет действие: игнорирование (этот аргумент просто исключается из проверки), считать правдивым (вместо него ставится true) и считать ложным (вместо него ставится false).
This commit is contained in:
Александр Бабаев 2025-05-24 14:30:34 +03:00
parent 10ec8df983
commit 6a4df8373c
5 changed files with 105 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
composer.json
View File

@ -20,7 +20,7 @@
"ext-mbstring": "*" "ext-mbstring": "*"
}, },
"require-dev": { "require-dev": {
"phpunit/phpunit": "^12.1.5" "phpunit/phpunit": "^12.1.6"
}, },
"autoload": { "autoload": {
"psr-4": { "psr-4": {

52
composer.lock generated
View File

@ -245,16 +245,16 @@
}, },
{ {
"name": "phpunit/php-code-coverage", "name": "phpunit/php-code-coverage",
"version": "12.2.1", "version": "12.3.0",
"source": { "source": {
"type": "git", "type": "git",
"url": "https://github.com/sebastianbergmann/php-code-coverage.git", "url": "https://github.com/sebastianbergmann/php-code-coverage.git",
"reference": "448f2c504d86dbff3949dcd02c95aa85db2c7617" "reference": "9075a8efc66e11bc55c319062e147bdb06777267"
}, },
"dist": { "dist": {
"type": "zip", "type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/php-code-coverage/zipball/448f2c504d86dbff3949dcd02c95aa85db2c7617", "url": "https://api.github.com/repos/sebastianbergmann/php-code-coverage/zipball/9075a8efc66e11bc55c319062e147bdb06777267",
"reference": "448f2c504d86dbff3949dcd02c95aa85db2c7617", "reference": "9075a8efc66e11bc55c319062e147bdb06777267",
"shasum": "" "shasum": ""
}, },
"require": { "require": {
@ -281,7 +281,7 @@
"type": "library", "type": "library",
"extra": { "extra": {
"branch-alias": { "branch-alias": {
"dev-main": "12.2.x-dev" "dev-main": "12.3.x-dev"
} }
}, },
"autoload": { "autoload": {
@ -310,7 +310,7 @@
"support": { "support": {
"issues": "https://github.com/sebastianbergmann/php-code-coverage/issues", "issues": "https://github.com/sebastianbergmann/php-code-coverage/issues",
"security": "https://github.com/sebastianbergmann/php-code-coverage/security/policy", "security": "https://github.com/sebastianbergmann/php-code-coverage/security/policy",
"source": "https://github.com/sebastianbergmann/php-code-coverage/tree/12.2.1" "source": "https://github.com/sebastianbergmann/php-code-coverage/tree/12.3.0"
}, },
"funding": [ "funding": [
{ {
@ -330,7 +330,7 @@
"type": "tidelift" "type": "tidelift"
} }
], ],
"time": "2025-05-04T05:25:05+00:00" "time": "2025-05-23T15:49:03+00:00"
}, },
{ {
"name": "phpunit/php-file-iterator", "name": "phpunit/php-file-iterator",
@ -579,16 +579,16 @@
}, },
{ {
"name": "phpunit/phpunit", "name": "phpunit/phpunit",
"version": "12.1.5", "version": "12.1.6",
"source": { "source": {
"type": "git", "type": "git",
"url": "https://github.com/sebastianbergmann/phpunit.git", "url": "https://github.com/sebastianbergmann/phpunit.git",
"reference": "f93ef2198df8d54b3195bcee381a33be51d8705e" "reference": "2fdf0056c673c8f0f1eed00030be5f8243c1e6e0"
}, },
"dist": { "dist": {
"type": "zip", "type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/phpunit/zipball/f93ef2198df8d54b3195bcee381a33be51d8705e", "url": "https://api.github.com/repos/sebastianbergmann/phpunit/zipball/2fdf0056c673c8f0f1eed00030be5f8243c1e6e0",
"reference": "f93ef2198df8d54b3195bcee381a33be51d8705e", "reference": "2fdf0056c673c8f0f1eed00030be5f8243c1e6e0",
"shasum": "" "shasum": ""
}, },
"require": { "require": {
@ -610,7 +610,7 @@
"sebastian/cli-parser": "^4.0.0", "sebastian/cli-parser": "^4.0.0",
"sebastian/comparator": "^7.0.1", "sebastian/comparator": "^7.0.1",
"sebastian/diff": "^7.0.0", "sebastian/diff": "^7.0.0",
"sebastian/environment": "^8.0.0", "sebastian/environment": "^8.0.1",
"sebastian/exporter": "^7.0.0", "sebastian/exporter": "^7.0.0",
"sebastian/global-state": "^8.0.0", "sebastian/global-state": "^8.0.0",
"sebastian/object-enumerator": "^7.0.0", "sebastian/object-enumerator": "^7.0.0",
@ -656,7 +656,7 @@
"support": { "support": {
"issues": "https://github.com/sebastianbergmann/phpunit/issues", "issues": "https://github.com/sebastianbergmann/phpunit/issues",
"security": "https://github.com/sebastianbergmann/phpunit/security/policy", "security": "https://github.com/sebastianbergmann/phpunit/security/policy",
"source": "https://github.com/sebastianbergmann/phpunit/tree/12.1.5" "source": "https://github.com/sebastianbergmann/phpunit/tree/12.1.6"
}, },
"funding": [ "funding": [
{ {
@ -680,7 +680,7 @@
"type": "tidelift" "type": "tidelift"
} }
], ],
"time": "2025-05-11T06:44:52+00:00" "time": "2025-05-21T12:36:31+00:00"
}, },
{ {
"name": "sebastian/cli-parser", "name": "sebastian/cli-parser",
@ -946,16 +946,16 @@
}, },
{ {
"name": "sebastian/environment", "name": "sebastian/environment",
"version": "8.0.0", "version": "8.0.2",
"source": { "source": {
"type": "git", "type": "git",
"url": "https://github.com/sebastianbergmann/environment.git", "url": "https://github.com/sebastianbergmann/environment.git",
"reference": "8afe311eca49171bf95405cc0078be9a3821f9f2" "reference": "d364b9e5d0d3b18a2573351a1786fbf96b7e0792"
}, },
"dist": { "dist": {
"type": "zip", "type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/environment/zipball/8afe311eca49171bf95405cc0078be9a3821f9f2", "url": "https://api.github.com/repos/sebastianbergmann/environment/zipball/d364b9e5d0d3b18a2573351a1786fbf96b7e0792",
"reference": "8afe311eca49171bf95405cc0078be9a3821f9f2", "reference": "d364b9e5d0d3b18a2573351a1786fbf96b7e0792",
"shasum": "" "shasum": ""
}, },
"require": { "require": {
@ -998,15 +998,27 @@
"support": { "support": {
"issues": "https://github.com/sebastianbergmann/environment/issues", "issues": "https://github.com/sebastianbergmann/environment/issues",
"security": "https://github.com/sebastianbergmann/environment/security/policy", "security": "https://github.com/sebastianbergmann/environment/security/policy",
"source": "https://github.com/sebastianbergmann/environment/tree/8.0.0" "source": "https://github.com/sebastianbergmann/environment/tree/8.0.2"
}, },
"funding": [ "funding": [
{ {
"url": "https://github.com/sebastianbergmann", "url": "https://github.com/sebastianbergmann",
"type": "github" "type": "github"
},
{
"url": "https://liberapay.com/sebastianbergmann",
"type": "liberapay"
},
{
"url": "https://thanks.dev/u/gh/sebastianbergmann",
"type": "thanks_dev"
},
{
"url": "https://tidelift.com/funding/github/packagist/sebastian/environment",
"type": "tidelift"
} }
], ],
"time": "2025-02-07T04:56:08+00:00" "time": "2025-05-21T15:05:44+00:00"
}, },
{ {
"name": "sebastian/exporter", "name": "sebastian/exporter",

34
sources/enums/VarNotBoolAction.php Normal file
View File

@ -0,0 +1,34 @@
<?php
namespace goodboyalex\php_components_pack\enums;
use goodboyalex\php_components_pack\traits\EnumExtensionsTrait;
/**
* Перечисление типов действий, которые необходимо выполнить, если переменная не является булевым типом.
*
* @author Александр Бабаев
* @package php_components_pack
* @version 1.0
* @since 1.0.19
*/
enum VarNotBoolAction: int
{
// Подключаю расширение для Enum
use EnumExtensionsTrait;
/**
* Игнорировать это утверждение.
*/
case Ignore = 0;
/**
* Считать это утверждение истинным.
*/
case ConsiderItTrue = 1;
/**
* Считать это утверждение ложным.
*/
case ConsiderItFalse = 2;
}

45
sources/extensions/BoolExtensions.php
View File

@ -2,14 +2,14 @@
namespace goodboyalex\php_components_pack\extensions; namespace goodboyalex\php_components_pack\extensions;
use Exception; use goodboyalex\php_components_pack\enums\VarNotBoolAction;
/** /**
* Расширение типа "правда/ложь". * Расширение типа "правда/ложь".
* *
* @author Александр Бабаев * @author Александр Бабаев
* @package php_components_pack * @package php_components_pack
* @version 1.0 * @version 1.1
* @since 1.0.7 * @since 1.0.7
*/ */
final class BoolExtensions final class BoolExtensions
@ -34,38 +34,55 @@ final class BoolExtensions
* <code>true</code>. * <code>true</code>.
* *
* @param array $expressions Переменные формата правда/ложь. * @param array $expressions Переменные формата правда/ложь.
* @param VarNotBoolAction $ifNotBool Действие, если какой-то аргумент <code>expressions</code> не является булевым
* типом. По умолчанию игнорировать.
* *
* @return bool Есть ли хотя бы одно в значении true. * @return bool Есть ли хотя бы одно в значении true.
* *
* @throws Exception Выбрасывается, если хотя бы один аргумент <code>expressions</code> не являются типом
* правда/ложь.
*/ */
public static function AnyTrue (array $expressions): bool public static function AnyTrue (array $expressions, VarNotBoolAction $ifNotBool = VarNotBoolAction::Ignore): bool
{ {
return self::TrueCount($expressions) > 0; return self::TrueCount($expressions, $ifNotBool) > 0;
} }
/** /**
* Вычисляет количество переменных формата правда/ложь <code>expressions</code> в значении <code>true</code>. * Вычисляет количество переменных формата правда/ложь <code>expressions</code> в значении <code>true</code>.
* *
* @param array $expressions Переменные формата правда/ложь. * @param array $expressions Переменные формата правда/ложь.
* @param VarNotBoolAction $ifNotBool Действие, если какой-то аргумент <code>expressions</code> не является булевым
* типом. По умолчанию игнорировать.
* *
* @return int Количество переменных в значении true. * @return int Количество переменных в значении true.
*
* @throws Exception Выбрасывается, если хотя бы один аргумент <code>expressions</code> не являются типом
* правда/ложь.
*/ */
public static function TrueCount (array $expressions): int public static function TrueCount (array $expressions, VarNotBoolAction $ifNotBool = VarNotBoolAction::Ignore): int
{ {
// Проверяем все аргументы // Создаем пустой массив для хранения проверяемых аргументов
$checkArray = [];
// Проверяем все входящие аргументы
foreach ($expressions as $expression) foreach ($expressions as $expression)
// - если аргумент не является типом правда/ложь // - если аргумент не является типом правда/ложь
if (!is_bool($expression)) if (!is_bool($expression))
// -- то выбрасываем исключение // -- то делаем следующее в зависимости от настроек:
throw new Exception('All arguments must be bool. / Все аргументы должны быть типа «правда/ложь».'); switch ($ifNotBool) {
case VarNotBoolAction::Ignore:
// --- игнорируем аргумент
break;
case VarNotBoolAction::ConsiderItTrue:
// --- считаем аргумент как истинное значение
$checkArray[] = true;
break;
case VarNotBoolAction::ConsiderItFalse:
// --- считаем аргумент как ложное значение
$checkArray[] = false;
break;
}
else
// - иначе добавляем аргумент в массив проверяемых аргументов
$checkArray[] = $expression;
// Используем array_filter для фильтрации всех истинных значений // Используем array_filter для фильтрации всех истинных значений
$filtered = array_filter($expressions); $filtered = array_filter($checkArray, fn ($value) => $value === true);
// Возвращаем количество элементов в отфильтрованном массиве // Возвращаем количество элементов в отфильтрованном массиве
return count($filtered); return count($filtered);

17
tests/extensions/BoolExtensionsTest.php
View File

@ -2,7 +2,7 @@
namespace goodboyalex\php_components_pack\tests\extensions; namespace goodboyalex\php_components_pack\tests\extensions;
use Exception; use goodboyalex\php_components_pack\enums\VarNotBoolAction;
use goodboyalex\php_components_pack\extensions\BoolExtensions; use goodboyalex\php_components_pack\extensions\BoolExtensions;
use PHPUnit\Framework\TestCase; use PHPUnit\Framework\TestCase;
@ -30,6 +30,7 @@ class BoolExtensionsTest extends TestCase
private function PrepareForTest (): void private function PrepareForTest (): void
{ {
require_once __DIR__ . '/../../sources/enums/VarNotBoolAction.php';
require_once __DIR__ . '/../../sources/extensions/BoolExtensions.php'; require_once __DIR__ . '/../../sources/extensions/BoolExtensions.php';
} }
@ -46,23 +47,19 @@ class BoolExtensionsTest extends TestCase
$this->assertEquals(14, $this->assertEquals(14,
BoolExtensions::TrueCount($array)); BoolExtensions::TrueCount($array));
$this->expectException(Exception::class);
$array[] = "ПРЕДАТЕЛЬ!"; $array[] = "ПРЕДАТЕЛЬ!";
BoolExtensions::TrueCount($array); $this->assertEquals(14, BoolExtensions::TrueCount($array));
$this->assertEquals(14, BoolExtensions::TrueCount($array, VarNotBoolAction::ConsiderItFalse));
$this->assertEquals(15, BoolExtensions::TrueCount($array, VarNotBoolAction::ConsiderItTrue));
} }
public function testExportToString () public function testExportToString ()
{ {
$this->PrepareForTest(); $this->PrepareForTest();
$b = true; $this->assertEquals('О, да!', BoolExtensions::ExportToString(true, 'О, да!', 'О, нет!'));
$this->assertEquals('О, да!', BoolExtensions::ExportToString($b, 'О, да!', 'О, нет!')); $this->assertEquals('О, нет!', BoolExtensions::ExportToString(false, 'О, да!', 'О, нет!'));
$b = false;
$this->assertEquals('О, нет!', BoolExtensions::ExportToString($b, 'О, да!', 'О, нет!'));
} }
} }