profile
مرجع واجهة سطر الأوامر لمجموعة أوامر apothem profile.
يُدير الملف الشخصي المشترك لـ Apothem.
profile هي مجموعة أوامر تضم أربعة أوامر فرعية: init وshow وset وedit.
الملف الشخصي المشترك هو المصدر الوحيد للحقيقة الذي يُجسِّده كل مُحَوِّل مساعد برمجي
في تهيئته الأصلية.
الموجز
apothem profile init [--profile PATH] [--force]
[--quiet|-q] [--verbose|-v]
[--format plain|json] [--json] [--no-color]
apothem profile show [--profile PATH] [--quiet|-q] [--verbose|-v]
[--format plain|json] [--json] [--no-color]
apothem profile set KEY VALUE
[--profile PATH] [--quiet|-q] [--verbose|-v]
[--format plain|json] [--json] [--no-color]
apothem profile edit [--profile PATH] [--quiet|-q] [--verbose|-v]
[--format plain|json] [--json] [--no-color]الخيارات المشتركة
يقبل كل أمر فرعي الخيارات المشتركة أدناه.
| الخيار | الوصف |
|---|---|
--profile PATH | مسار YAML للملف الشخصي المشترك (القيمة الافتراضية هي الموقع القياسي للملف الشخصي). |
--quiet, -q | يُخمِد المخرجات المعلوماتية؛ تُصدَر الأخطاء فقط. |
--verbose, -v | يُصدِر مخرجات تشخيصية إضافية. |
--format plain|json | تنسيق المخرجات (الافتراضي: plain). |
--json | اختصار لـ --format json. |
--no-color | يُعطِّل رموز ألوان ANSI في المخرجات. |
-h, --help | يعرض المساعدة ويخرج. |
الأوامر الفرعية
profile init
يُنشئ هيكلًا أوّليًّا أدنى صالحًا وفق المخطّط في
~/.config/apothem/profile.yaml أو --profile PATH. تُحفَظ الملفات الموجودة
ما لم يُقدَّم --force.
| الخيار | الوصف |
|---|---|
--force | يكتب فوق هيكل ملف شخصي أوّلي موجود. |
profile show
يعرض الملف الشخصي المشترك بعد التحقّق منه وتوسيع القيم الافتراضية.
profile set KEY VALUE
يُعيِّن مفتاحًا في الملف الشخصي المشترك. KEY هو مسار منقوط ينزل عبر
الملف الشخصي المتداخل (identity.name، preferences.style، enforcement.sprints،
harnesses.<harness>.preferences.style)؛ ويُعيِّن مفتاح وحيد دون نقطة
عقدةً على المستوى الأعلى. تُخزَّن VALUE كسلسلة حرفية — لا تُحوَّل الكلمات المجرّدة
قسرًا (no يبقى "no"، ويبقى 2024-01-01 و1.0 سلاسل) — باستثناء
true/false (أعلام الفرض المنطقية) والإدخال الصريح [...]/{...}
بصيغة قائمة/خريطة. ويُتحقَّق من الملف الشخصي المُجمَّع بالكامل مقابل المخطّط
قبل الكتابة؛ ويُرفَض أي set غير صالح ويبقى الملف الشخصي على القرص دون تغيير.
| المعامل | الوصف |
|---|---|
KEY | مسار منقوط داخل الملف الشخصي المراد تعيينه (مطلوب). |
VALUE | قيمة حرفية للإسناد؛ يُتحقَّق منها قبل الكتابة (مطلوب). |
profile edit
يفتح الملف الشخصي المشترك في محرّر النظام.
أمثلة
apothem profile init
apothem profile init --profile ./profile.yaml --force --json
apothem profile show
apothem profile show --json
apothem profile set seriousness SHARED
apothem profile set rules '["Use fake placeholders in examples."]'
apothem profile editرموز الخروج
| الرمز | المعنى |
|---|---|
| 0 | نجاح (أو، بالنسبة لـ edit، خرج المحرّر بشكل طبيعي) |
| 1 | الملف الشخصي مفقود أو غير صالح أو موجود مسبقًا دون --force أو تعذّرت كتابته |
انظر أيضًا
- apothem install — يُجسِّد الملف الشخصي داخل مساعد برمجي
- apothem doctor — يُشغِّل تشخيصات التثبيت على مستوى النظام بأكمله