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

# saad-s

حزمة Python خفيفة باسم **saad_s** تعيد تصدير واجهة وحدة `os` القياسية باسم جديد. لا توجد اعتماديات خارجية، وتعمل على Pydroid 3 وTermux والبيئات المتوافقة مع Python.

## التثبيت

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

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

## الاستخدام

```python
import saad_s

print(saad_s.getcwd())
print(saad_s.listdir("."))
print(saad_s.path.join("SAAD", "data.txt"))
print(saad_s.environ.get("HOME"))
```

## أمثلة الملفات والمجلدات

```python
import saad_s

folder = "saad_demo"
saad_s.makedirs(folder, exist_ok=True)

file_path = saad_s.path.join(folder, "hello.txt")
with open(file_path, "w", encoding="utf-8") as file:
    file.write("Hello from SAAD")

print(saad_s.path.exists(file_path))
print(saad_s.path.getsize(file_path))
saad_s.remove(file_path)
saad_s.rmdir(folder)
```

## الواجهة

تتوفر الدوال والسمات العامة في `os` تقريبًا، بما فيها `getcwd` و`listdir` و`makedirs` و`mkdir` و`remove` و`rename` و`walk` و`environ` و`path` و`stat` و`system`. السمات غير المعرّفة مباشرة تُمرّر إلى وحدة `os` القياسية.

> تنبيه: مثل `os` تمامًا، تمنح هذه الحزمة برنامجك قدرة مباشرة على التعامل مع الملفات والبيئة والنظام. استخدم `system` بحذر، ولا تمرر إليها أوامر مبنية من إدخال مستخدم غير موثوق.

## الترخيص

MIT.
