topgrade

Введение

Обратите внимание, что это вилка Topgrade от R-Darwish, чтобы сохранить ее.

Поддержание вашей системы обычно включает в себя вызов нескольких менеджеров пакетов. Это приводит к тому, что в вашей оболочке сохранились большие, не портируемые оболочки. Чтобы исправить это, Topgrade обнаруживает, какие инструменты вы используете, и запускает соответствующие команды для их обновления.

Установка

• Arch Linux: Aur
• Никсос: Никспкгс
• Void linux: xbps
• macOS: домашнее пиво или макпорты
• Окна: шоколад, совок или вингет
• PYPI: Pip
• Fedora: 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 .

Вклад

Проблемы или отсутствующие функции?

Откройте новую проблему, описывающую вашу проблему и, если возможно, предоставьте решение.

Отсутствует функция или обнаружил неподдерживаемый инструмент/дистрибуцию?

Просто дайте нам то, что вам не хватает, открыв проблему. Для инструментов, пожалуйста, откройте проблему, описывающую инструмент, какие платформы он поддерживает и, если возможно, приведите нам пример его использования.

Хотите внести свой вклад в код?

Просто раскошечка и начните кодировать.

Руководящие принципы вклада

См. Appling.md

Дорожная карта

• Добавьте правильную структуру тестирования в базу кода.
• Добавить модульные тесты для менеджеров пакетов.
• Разделите код на более обслуживаемые детали, например. Помещение каждого диспетчера пакетов Linux в собственный подмодуль Linux.rs.