add class Random

Author: MartkCz

src/Random.php

@@ -0,0 +1,29 @@
+<?php declare(strict_types = 1);
+
+namespace Utilitte\Php;
+
+use InvalidArgumentException;
+
+final class Random
+{
+
+	public static function chance(int $percentage, bool $strict = true): bool
+	{
+		if ($percentage <= 0) {
+			if ($strict && $percentage < 0) {
+				throw new InvalidArgumentException('Percentage must be greater than or equal to 0');
+			}
+
+			return false;
+		} elseif ($percentage >= 100) {
+			if ($strict && $percentage > 100) {
+				throw new InvalidArgumentException('Percentage must be less than or equal to 100');
+			}
+
+			return true;
+		}
+
+		return mt_rand(1, 100) <= $percentage;
+	}
+
+}

tests/cases/arrays.columnAsKey.phpt

@@ -0,0 +1,16 @@
+<?php declare(strict_types = 1);
+
+// phpcs:ignoreFile
+
+use Tester\Assert;
+use Utilitte\Php\Random;
+
+require __DIR__ . '/../bootstrap.php';
+
+Assert::true(Random::chance(100));
+Assert::true(Random::chance(101, false));
+Assert::false(Random::chance(0));
+Assert::false(Random::chance(-1, false));
+
+Assert::exception(fn () => Random::chance(-1), InvalidArgumentException::class);
+Assert::exception(fn () => Random::chance(101), InvalidArgumentException::class);