number-generator

Минималистичный генератор псевдослучайных чисел, полностью написанный на чистом Python без зависимостей. Использует time_ns() как источник энтропии и простую XOR-логику для создания уникальных цифровых последовательностей.

🎲 Random Nums — Pure Python RNG

Генератор псевдослучайных чисел без модулей и библиотек.

Минималистичный, быстрый и полностью написан на чистом Python 🐍

Использует time_ns() как источник энтропии и простую логику для получения уникальных цифровых последовательностей.

---

⚡️ Особенности

✅ Без зависимостей
✅ Чистый Python
✅ Можно использовать для тестов, симуляций, мини-игр и т.п.

---

🚀 Быстрый старт

Файл проекта: random_nums.py
Зависимости: отсутствуют
Совместимость: Python 3.8+

---

💻 Пример использования в коде

from random_nums import ruler_nums
print(ruler_nums(16))

# Пример вывода: 7084370222110734

---

💻 Пример использования

🖥️ В терминале:

>>> from random_nums import ruler_nums
>>> ruler_nums(16)

📌 Или можно просто запустить файл напрямую, если добавить в конец random_nums.py:

if __name__ == "__main__":
    print(ruler_nums(16))

---

⚙️ Описание функции

ruler_nums(len_ruler: int)

🧩 Параметр	🔢 Тип	📖 Описание
len_ruler	int	Количество цифр, которое нужно сгенерировать.

Функция возвращает строку из случайных цифр длиной len_ruler.

Если длина превышает возможную для текущего seed — возвращается сообщение об ошибке.

---

🧠 Как это работает

1. ⏱️ Берётся seed через time_ns()
2. ➗ Вычисляется fifty_percent_from_seed — половина значения seed
3. 🔒 Создаётся переменная one, усложняющая итог
4. ⚔️ Выполняется XOR-операция int(one) ^ seed
5. ✂️ Результат обрезается до указанной длины len_ruler

---

💡 Где пригодится

🎯 Генерация тестовых данных
🔢 Создание уникальных ID
🎮 Игры и симуляции (рандомные события, лут, спавн, шансы и т.д.)

⚠️ Важно: генератор не подходит для криптографии.
Он предсказуем и не использует криптостойкие источники энтропии.

---

👨‍💻 Автор

Автор: python-soul