topgrade

مقدمة

لاحظ أن هذا شوكة من Topgrade بواسطة R-darwish للحفاظ عليها.

عادةً ما يتضمن الحفاظ على نظامك محدثًا في التنازل عن مديري الحزم المتعددين. ينتج عن هذا من قذيفة كبيرة غير قابلة للحمل أنقذت في قشرة الخاص بك. لعلاج هذا ، يكتشف Topgrade الأدوات التي تستخدمها وتشغيل الأوامر المناسبة لتحديثها.

تثبيت

• Arch Linux: Aur
• Nixos: Nixpkgs
• Linux باطلة: XBPS
• MacOS: Homebrew أو Macports
• النوافذ: الشوكولاتة ، مغرفة أو وينج
• PYPI: PIP
• فيدورا: Copr

يمكن لمستخدمي الأنظمة الأخرى إما استخدام cargo install أو الثنائيات المترجمة من صفحة الإصدار. تحتوي الثنائيات المترجمة على ميزة الترقية الذاتي.

الاستخدام

فقط قم بتشغيل topgrade .

إعدادات

راجع config.example.toml للحصول على مثال على ملف التكوين.

التغيرات والهجرة

كلما كان هناك تغيير في كسر ، سيتم ارتطام رقم الإصدار الرئيسي ، وسنقوم بتوثيق هذه التغييرات في ملاحظة الإصدار ، يرجى إلقاء نظرة عليه عند تحديثه إلى إصدار رئيسي.

هل لديك سؤال؟ لا تتردد في فتح مشكلة أو مناقشة!

مسار التكوين

CONFIG_DIR على كل منصة

• Windows : %APPDATA%
• MacOS وأنظمة UNIX الأخرى : ${XDG_CONFIG_HOME:-~/.config}

سيبحث topgrade عن ملف التكوين في الأماكن التالية ، بترتيب الأولوية:

1. CONFIG_DIR/topgrade.toml
2. CONFIG_DIR/topgrade/topgrade.toml

في حالة وجود الملف ذي أولوية أعلى ، بغض النظر عن أنه صالح أم لا ، سيتم تجاهل ملفات التكوين الأخرى.

في التشغيل الأول (لا يوجد ملف تكوين) ، سيقوم topgrade بإنشاء ملف تكوين على CONFIG_DIR/topgrade.toml بالنسبة لك.

الأوامر المخصصة

يمكن تعريف الأوامر المخصصة في ملف التكوين الذي يمكن تشغيله قبل أو أثناء أو بعد الأوامر في ثناياه عوامل ، كما هو مطلوب. بشكل افتراضي ، يتم تشغيل الأوامر المخصصة باستخدام قذيفة جديدة وفقًا لمتغير البيئة $SHELL على UNIX (تعود إلى sh ) أو pwsh على Windows (تعود إلى powershell ).

على UNIX ، إذا كنت ترغب في تشغيل أمرك باستخدام قذيفة تفاعلية ، على سبيل المثال ، لمصدر ملفات RC الخاصة بك ، يمكنك إضافة -i في بداية الأمر المخصص. لكن لاحظ أن هذا يتطلب من الأمر الخروج من القشرة بشكل صحيح وإلا فإن القشرة سوف يتم تعليقها إلى أجل غير مسمى.

التنفيذ عن بُعد

يمكنك تحديد مفتاح يسمى remote_topgrades في ملف التكوين. يجب أن يحتوي هذا المفتاح على قائمة بأسماء المضيف التي تم تثبيتها عليها. سوف يستخدم Topgrade ssh لتشغيل topgrade على المضيفين عن بُعد قبل التمثيل محليًا. للحد من التنفيذ فقط على مضيفين محددين ، استخدم المعلمة-- --remote-host-limit .

مساهمة

مشاكل أو ميزات مفقودة؟

افتح مشكلة جديدة تصف مشكلتك وإذا كان ذلك ممكنًا ، قم بتوفير حل.

في عداد المفقودين ميزة أو العثور على أداة/توزيعة غير مدعومة؟

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

تريد المساهمة في الكود؟

فقط مفترق المستودع وابدأ الترميز.

إرشادات المساهمة

انظر المساهمة

خريطة الطريق

• إضافة إطار اختبار مناسب إلى قاعدة الكود.
• إضافة اختبارات الوحدة لمديري الحزم.
• تقسيم رمز إلى أجزاء أكثر قابلية للصيانة ، على سبيل المثال. وضع كل مدير حزمة Linux في وحدة فرعية خاصة من Linux.rs.