البناء والتشغيل

ثنائيات جاهزة (موصى بها)

حمّل آخر إصدار من GitHub:

• https://github.com/mustafamohsen/safeparts/releases

كل إصدار يتضمن:

• safeparts (CLI)
• safeparts-tui (واجهة طرفية)

تحقق سريع:

1. ضع الملفات التنفيذية على PATH.
2. شغّل safeparts —help.
3. شغّل safeparts-tui —help.

Gatekeeper في macOS

إذا حمّلت الملفات التنفيذية من المتصفح، قد يضع macOS عليها علامة quarantine ويظهر التحذير “لا يمكن فتحه لأن المطور غير موثّق”.

إذا بنيت من المصدر، غالباً لن ترى هذا التحذير.

إذا كنت تثق بالمصدر وتريد إزالة علامة quarantine:

# عدّل هذا المسار إلى مجلد الإصدار بعد فك الضغط
xattr -dr com.apple.quarantine /path/to/safeparts-release/

# أو أزلها لكل ملف تنفيذي
xattr -d com.apple.quarantine /path/to/safeparts
xattr -d com.apple.quarantine /path/to/safeparts-tui

بناء من المصدر (Rust)

المتطلبات:

• Rust stable + rustfmt و clippy

البناء والاختبارات:

cargo build
cargo test --all-features

فحص بنمط CI:

cargo fmt --all -- --check
cargo clippy --all-targets --all-features -- -D warnings

تطبيق الويب (Vite + React + WASM)

تطبيق الويب موجود في web/. عمليات التقسيم/الاسترداد تتم داخل المتصفح عبر WASM.

المتطلبات:

• Bun
• wasm-pack (أو اترك سكربت البناء يثبته)

التشغيل محلياً:

cd web
bun install
bun run build:wasm
bun run dev

افتح http://localhost:5173.

تطبيق الويب + موقع المساعدة (Docker)

إذا كنت تريد أمراً واحداً يبني WASM + تطبيق الويب + موقع المساعدة ثم يخدمها لك، استخدم Dockerfile الموجود في المستودع. لا يوجد خادم خلفي: كل شيء يتم داخل المتصفح.

docker build -t safeparts-webui -f web/Dockerfile .
docker run --rm -p 8080:8080 safeparts-webui

افتح http://localhost:8080.

المساعدة: http://localhost:8080/help/

موقع المساعدة (Astro + Starlight)

الموقع موجود في web/help/ ويُخدم تحت /help/.

cd web/help
bun install
bun run dev

افتح http://localhost:4321/help/.