feat: add binomialvariate func (simpliest realisation) with its own section

Author: n1xsi

pycustomrand/random_generator.py

@@ -134,7 +134,6 @@ def random_float(start: int | float, end: int | float, digits: int = None) -> fl
             return true_round(result, digits)
         return result
 
-
     # -------------------- Байтовые функции --------------------
 
     @staticmethod
@@ -210,3 +209,22 @@ def sample(array: list[Any], k: int, counts: list[int] = None) -> list[Any]:
                 result.append(choice)
 
         return result
+
+
+    # -------------------- Дискретные функции --------------------
+
+    @staticmethod
+    def binomialvariate(n: int = 1, p: float = 0.5) -> int:
+        """
+        Возвращает случайное число, распределённое по биномиальному закону.
+        Простейшая реализация, неоптимизированная.
+
+        n - количество испытаний (целое число >= 0).
+        p - вероятность успеха в каждом испытании (0.0 <= p <= 1.0).
+        """
+        if n < 0:
+            raise ValueError("Количество испытаний n не может быть отрицательным")
+        if not (0.0 <= p <= 1.0):
+            raise ValueError("Вероятность p должна быть в диапазоне [0, 1]")
+
+        return sum([PseudoRandom.random() < p for _ in range(n)])