Metadata-Version: 2.4
Name: ramlib-samjamsh
Version: 1.1
Summary: A random number generator library, it generates time-based pseudo-random numbers.
Author-email: "Yassir Mangassanja aka Sam Jamsh (cyb3rguy)" <thecyb3rguy@protonmail.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/samjamsh/randomlib
Project-URL: Bug_Tracker, https://github.com/samjamsh/randomlib/issues
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Dynamic: license-file

# randomlib (module: ramlib)

A simple random library with a Python prototype and a main C version that you can use in your projects for simple random tasks.

## Overview

`randomlib` (module: `ramlib`) is a simple, independent, and deterministic library for generating pseudo-random numbers based on time.  
It uses multiple layers of temporal granularity (milliseconds, microseconds, nanoseconds, and timestamp) combined with bitwise operations and dynamic multipliers.

Ideal for pseudo-randomness experiments, simulations, seed generation, and environments without complex external dependencies.

## Installation

```bash
pip install ramlib-samjamsh

```

## Usage
```
from ramlib import genrandom

# Get & Print a random value
start = 1
end = 10

random_value = genrandom(start, end)
print("\nRandom Value:", random_value.getnew())      # get a random value once
print()

for i in range(5):
    newrandom = random_value.generate(start, end)    # get a random value multiple times
    print("New Random:", newrandom)
print()
```
