Metadata-Version: 2.4
Name: navax
Version: 1.0.0
Summary: Python-native messaging client with an embedded runtime
Author: navax contributors
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# navax for Python — Termux

مكتبة Python للتعامل مع WhatsApp عبر Baileys. هذه النسخة مناسبة لـ **Termux على Android**: لا تستخدم Node.js المضمّن الخاص بسطح المكتب، بل تعتمد على Node.js الذي يثبّته Termux.

> غير تابعة لـ WhatsApp أو Meta. استخدمها وفق القوانين وشروط الخدمة، ولا تستخدمها للسبام.

## التثبيت على Termux

```bash
pkg update -y
pkg install -y python nodejs-lts unzip
unzip navax-1.0.0-termux.zip
cd navax-1.0.0-termux
python -m pip install --upgrade pip
python -m pip install .
```

في أول تشغيل ستثبت المكتبة تلقائياً اعتماد Baileys داخل `~/.navax_runtime`. للتثبيت اليدوي:

```bash
cd ~/.navax_runtime
npm install --no-audit --no-fund --save-exact
```

## مثال سريع

```python
import asyncio
from navax import MoXstarClient

async def main():
    client = MoXstarClient(auth_dir='./auth')
    client.on('qr', lambda code: print('QR:', code))
    client.on('ready', lambda _: print('navax جاهزة'))
    await client.start()
    await client.wait_until_ready()
    await client.wait_closed()

asyncio.run(main())
```

يمكن تحديد مسار Node يدوياً عبر متغير البيئة `NAVAPRO_NODE`، لكن الوضع الافتراضي يستخدم `node` الموجود في Termux.

## ملاحظات Android/Termux

- استخدم `nodejs-lts` وليس نسخة Node مكتبية مضمّنة.
- يفضّل تعطيل تحسين البطارية لتطبيق Termux حتى لا ينقطع الاتصال في الخلفية.
- الاتصال الحي يحتاج QR أو Pairing Code ورقم WhatsApp حقيقي.
- اختبارات Python المحلية لا تتصل بواتساب.
