Metadata-Version: 2.4
Name: saad-dev
Version: 0.1.0
Summary: A saad_dev facade for Python's standard random module
Author: SAAD
License: MIT
Project-URL: Homepage, https://pypi.org/project/saad-dev/
Keywords: saad,random,development,utility
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# saad-dev

حزمة Python صغيرة باسم **saad_dev** تعيد تصدير واجهة مكتبة `random` القياسية بأسلوب مألوف:

```python
import saad_dev

print(saad_dev.randint(1, 10))
print(saad_dev.choice(["SAAD", "DEV", "TOOLS"]))
```

تعتمد الحزمة على تنفيذ Python القياسي نفسه، ولا تضيف اعتماديات خارجية.

## التثبيت

بعد نشرها على PyPI:

```bash
python -m pip install saad-dev
```

يقبل pip أيضًا الاسم بالشرطة السفلية في بعض الأوامر لأن PyPI يطبع أسماء المشاريع بصيغة موحّدة، لكن الاسم الموصى به هو `saad-dev`.

## أمثلة

```python
import saad_dev

saad_dev.seed(2026)
print(saad_dev.random())
print(saad_dev.randint(1, 100))
print(saad_dev.randrange(0, 100, 5))
print(saad_dev.uniform(1.5, 9.5))
print(saad_dev.choice(["red", "green", "blue"]))
print(saad_dev.choices(["A", "B", "C"], k=5))
print(saad_dev.sample(range(100), k=5))

items = ["SAAD", "DEV", "PYTHON"]
saad_dev.shuffle(items)
print(items)
```

## الكائن Random

```python
from saad_dev import Random

rng = Random(1234)
print(rng.randint(1, 10))
```

## تنبيه أمني

`random` مناسبة للاستخدامات العامة والمحاكاة والألعاب، لكنها ليست مولّدًا عشوائيًا تشفيريًا. للرموز أو كلمات المرور أو أي قرار أمني استخدم مكتبة Python القياسية `secrets`.

## الترخيص

MIT.
