topgrade

Introdução

Observe que este é um garfo de Topgrade de R-Darwish para mantê-lo mantido.

Manter seu sistema atualizado geralmente envolve a invocação de vários gerentes de pacotes. Isso resulta em grandes e não-liners de shell não portáveis ​​salvos em seu shell. Para remediar isso, o TopGrade detecta quais ferramentas você usa e executa os comandos apropriados para atualizá -los.

Instalação

• Arch Linux: AUR
• Nixos: nixpkgs
• Void Linux: XBPS
• MacOS: Homebrew ou Macports
• Janelas: chocolate, colher ou winget
• Pypi: Pip
• Fedora: Copr

Outros sistemas Os usuários podem usar cargo install ou os binários compilados na página de liberação. Os binários compilados contêm um recurso de auto-graduação.

Uso

Basta executar topgrade .

Configuração

Consulte config.example.toml para obter um exemplo de arquivo de configuração.

Migração e interrupção de mudanças

Sempre que houver uma alteração de quebra , o número principal da versão será esbarrado e documentaremos essas alterações na nota de lançamento, dê uma olhada quando atualizada para uma grande versão.

Tem uma pergunta? Sinta -se à vontade para abrir um problema ou discussão!

Caminho de configuração

CONFIG_DIR em cada plataforma

• Windows : %APPDATA%
• MacOS e outros sistemas Unix : ${XDG_CONFIG_HOME:-~/.config}

topgrade procurará o arquivo de configuração nos seguintes locais, em ordem de prioridade:

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

Se o arquivo com maior prioridade estiver presente, independentemente de ser válido ou não, os outros arquivos de configuração serão ignorados.

Na primeira execução (não existe arquivo de configuração), topgrade criará um arquivo de configuração em CONFIG_DIR/topgrade.toml para você.

Comandos personalizados

Os comandos personalizados podem ser definidos no arquivo de configuração que pode ser executado antes, durante ou após os comandos embutidos, conforme necessário. Por padrão, os comandos personalizados são executados usando um novo shell de acordo com a variável de ambiente $SHELL no Unix (volta a sh ) ou pwsh no Windows (volta ao powershell ).

No Unix, se você deseja executar seu comando usando um shell interativo, por exemplo, para obter os arquivos RC do seu shell, você pode adicionar -i no início do seu comando personalizado. Mas observe que isso exige que o comando saia corretamente o shell ou o shell pendurará indefinidamente.

Execução remota

Você pode especificar uma chave chamada remote_topgrades no arquivo de configuração. Essa chave deve conter uma lista de nomes de host que possuem o TopGrade instalados neles. O TopGrade usará ssh para executar topgrade em hosts remotos antes de agir localmente. Para limitar a execução apenas a hosts específicos, use o parâmetro --remote-host-limit .

Contribuição

Problemas ou recursos ausentes?

Abra um novo problema descrevendo seu problema e, se possível, forneça uma solução.

Faltando um recurso ou encontrou uma ferramenta/distração não suportada?

Apenas vamos agora o que você está perdendo abrindo um problema. Para ferramentas, abra um problema descrevendo a ferramenta, cujas plataformas ele suporta e, se possível, dê -nos um exemplo de seu uso.

Quer contribuir para o código?

Apenas bifurque o repositório e comece a codificar.

Diretrizes de contribuição

Consulte Contribuindo.md

Roteiro

• Adicione uma estrutura de teste adequada à base de código.
• Adicione testes de unidade para gerentes de pacotes.
• Divida o código em peças mais sustentáveis, por exemplo. Colocando todos os gerenciadores de pacotes Linux em um próprio submódulo de Linux.rs.