Skip to content

Latest commit

 

History

History
258 lines (174 loc) · 18.1 KB

README-fr.md

File metadata and controls

258 lines (174 loc) · 18.1 KB

Arch-Update

lang-en

Table des matières

Description

Un notificateur/applicateur de mises à jour pour Arch Linux qui vous assiste dans les tâches importantes d'avant/après mise à jour et qui inclut une icône cliquable (.desktop) qui peut facilement être intégrée à n'importe quel environnement de bureau/gestionnaire de fenêtres, dock, barre d'état, barre de lancement ou menu d'application.
Prise en charge optionnelle des mises à jour des paquets AUR/Flatpak et des notifications de bureau.

Fonctionnalités :

  • Inclut une icône cliquable (.desktop) qui change automatiquement pour agir comme un notificateur/applicateur de mise à jour. Facile à intégrer avec n'importe quel DE/WM, dock, barre d'état/lancement, menu d'application, etc...
  • Vérification et listing automatiques de tous les paquets disponibles pour la mise à jour (via checkupdates).
  • Propose d'afficher les news récentes d'Arch Linux avant d'appliquer les mises à jour (via curl et htmlq).
  • Vérification et listing automatiques des paquets orphelins et propose de les supprimer.
  • Vérification automatique de la présence d'anciens paquets et/ou paquets désinstallés dans le cache de pacman et propose de les supprimer (via paccache).
  • Vous aide à traiter les fichiers pacnew/pacsave (via pacdiff, nécessite optionnellement vim comme programme de fusion par défaut).
  • Vérification automatique des mises à jour du noyau en attente nécessitant un redémarrage et propose de redémarrer s'il y en a une.
  • Fonctionne avec sudo et doas.
  • Prise en charge optionnelle de la mise à jour des paquets AUR (via yay ou paru).
  • Prise en charge optionnelle de la mise à jour des paquets Flatpak (via flatpak).
  • Prise en charge optionnelle des notifications de bureau (via libnotify, voir https://wiki.archlinux.org/title/Desktop_notifications).

Installation

AUR

Installez le paquet AUR arch-update.

Depuis la source

Installer les dépendances :

sudo pacman -S --needed pacman-contrib curl htmlq diffutils hicolor-icon-theme

Téléchargez l'archive de la dernière version stable et extrayez-la (vous pouvez également cloner ce référentiel via git).

Pour installer arch-update, allez dans le répertoire extrait/cloné et exécutez la commande suivante :

sudo make install

Pour désinstaller arch-update, allez dans le répertoire extrait/cloné et exécutez la commande suivante :

sudo make uninstall

Utilisation

L'utilisation consiste à intégrer le fichier .desktop quelque part (cela peut être votre bureau, votre dock, votre barre d'état/de lancement ou votre menu d'application) et à activer le timer systemd.

Voici une petite présentation/revue YouTube de arch-update que Cardiac et moi-même avons réalisée sur sa chaîne YouTube :

Attention : les fonctionnalités et le comportement par défaut d'Arch-Update peuvent avoir changé/évolué depuis !

youtube_presentation

Le fichier .desktop

Le fichier .desktop se trouve dans /usr/share/applications/arch-update.desktop (ou /usr/local/share/applications/arch-update.desktop si vous avez installé arch-update depuis la source).
Son icône changera automatiquement en fonction des différents états (vérification des mises à jour, mises à jour disponibles, installation des mises à jour, à jour).
Il lancera la série de fonctions adéquates pour effectuer une mise à jour complète et correcte lorsque vous cliquez dessus (voir le chapitre Documentation). Il est facile à intégrer à n’importe quel DE/WM, dock, barre d’état/lancement ou menu d’application.

Le timer systemd

Il existe un service systemd dans /usr/lib/systemd/user/arch-update.service (ou dans /usr/local/lib/systemd/user/arch-update.service si vous avez installé arch-update depuis la source) qui exécute la fonction check quand il est démarré (voir le chapitre Documentation).
Pour le démarrer automatiquement au démarrage du système puis une fois toutes les heures, activez le timer systemd associé (vous pouvez modifier le cycle de vérification automatique à votre guise, voir les Trucs et astuces - Modifier le cycle de vérification automatique) :

systemctl --user enable --now arch-update.timer

Captures d'écran

Les captures d'écran montrent le retour du script en anglais, mais Arch-Update possède désormais une traduction française !

Personnellement, j'ai intégré l'icône .desktop dans ma barre supérieure.
C'est la première icône en partant de la gauche.

icon

Lorsque arch-update vérifie les mises à jour, l'icône change en conséquence (la fonction check est automatiquement déclenchée au démarrage du système puis une fois toutes les heures si vous avez activé le timer systemd et peut être déclenchée manuellement en exécutant la commande arch-update -c) :

icon-checking

Si de nouvelles mises à jour sont disponibles, l'icône affichera une cloche et une notification de bureau indiquant le nombre de mises à jour disponibles sera envoyée (nécessite libnotify/notify-send) :

icon-update-available notification

Lorsque l'on clique sur l'icône, cela lance la série de fonctions adéquates pour effectuer une mise à jour complète et correcte, en commençant par actualiser la liste des paquets disponibles pour la mise à jour, en l'affichant dans un terminal et en demandant la confirmation de l'utilisateur pour procéder à l'installation (elle peut également être lancée en exécutant la commande arch-update, nécessite yay ou paru pour la prise en charge de la mise à jour des paquets AUR et flatpak pour la prise en charge de la mise à jour des paquets Flatpak) :

La sortie colorée peut être désactivée avec l'option NoColor dans le fichier de configuration arch-update.conf.
La liste des mises à jour en attente peut être affichées à tout moment en exécutant arch-update -l ou arch-update --list.
Vous pouvez inclure les mises à jour des paquets de développements AUR en exécutant arch-update -d ou arch-update --devel.
Les changements de versions dans la listing des paquets peuvent être masqués avec l'option NoVersion dans le fichier de configuration arch-update.conf.
Voir le chapitre de documentation arch-update.conf pour plus de détails.

listing-packages

Une fois que vous avez donné la confirmation pour procéder, arch-update propose d'afficher les dernières Arch news.
Par défaut, les Arch news sont seulement affichées si au moins une nouvelle news a été publiée depuis la dernière exécution. Les Arch news publiées depuis la dernière exécution ou à la même date sont étiquetées comme [NOUVEAU].
Sélectionnez la news à lire en tapant le numéro associé.
Après avoir lu une news, arch-update vous proposera à nouveau d'afficher les dernières Arch news, afin que vous puissiez lire plusieurs news à la fois.
Appuyez simplement sur « Entrée » sans saisir de chiffre pour procéder à la mise à jour :

Les Arch news peuvent être affichées à tout moment en exécutant la commande arch-update --news.
Le nombre par défaut de Arch news à afficher avant la mise à jour et avec l'option -n/--news est de 5 mais il peut être modifié avec l'option NewsNum=[Num] dans le fichier de configuration arch-update.conf.
Les Arch news peuvent être systématiquement affichées avant la mise à jour, peu importe s'il y en a une nouvelle depuis la dernière exécution ou non, en paramétrant l'option AlwaysShowNews dans le fichier de configuration arch-update.conf
Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les Arch news.
Voir le chapitre de documentation pour plus de détails.

list-news

Pendant que arch-update effectue des mises à jour, l'icône change en conséquence :

icon-installing

Une fois la mise à jour terminée, l'icône change en conséquence :

icon-up-to-date

arch-update recherchera ensuite les paquets orphelins/paquets Flatpak inutilisés et proposera de les supprimer (s'il y en a) :

paquets-orphelins

flatpak-unused-packages

arch-update recherchera également les anciens paquets et/ou paquets désinstallés mis en cache et proposera de les supprimer (s'il y en a) :

Le comportement par défaut consiste à conserver les 3 dernières versions en cache des paquets installés et à supprimer toutes les versions en cache des paquets désinstallés.
Vous pouvez modifier le nombre d'anciennes versions de paquets et de versions de paquets désinstallés à conserver respectivement dans le cache de pacman avec les options KeepOldPackages=[Num] et KeepUninstalledPackages=[Num] dans le fichier de configuration arch-update.conf.
Voir le chapitre de documentation arch-update.conf pour plus de détails.

cached-packages

De plus, arch-update recherchera les fichiers pacnew/pacsave et proposera de les traiter via pacdiff (s'il y en a) :

pacnew-files

Enfin, arch-update vérifiera s'il y a une mise à jour du noyau en attente nécessitant un redémarrage et vous proposera de le faire (s'il y en a une) :

kernel-pending-update

Documentation

arch-update

Un notificateur/applicateur de mises à jour pour Arch Linux qui vous assiste dans les
tâches importantes d'avant/après mise à jour.

Lancez arch-update pour exécuter la fonction principale « update » :
Afficher la liste des paquets disponibles pour mise à jour, puis demander la confirmation de l'utilisateur
pour procéder à l'installation.
Avant d'effectuer la mise à jour, propose d'afficher les dernières Arch news.
Après la mise à jour, vérification de la présence de paquets orphelins/inutilisés, d'anciens paquets mis en cache,
de fichiers pacnew/pacsave et de mise à jour du noyau en attente et, s'il y en a, propose de les traiter.

Options :
-c, --check       Vérifier les mises à jour disponibles, envoyer une notification de bureau contenant le nombre de mises à jour disponibles (si libnotify est installé)
-l, --list        Afficher la liste des mises à jour en attente
-d, --devel       Inclure les mises à jour des paquets de développement AUR
-n, --news [Num]  Afficher les dernieres Arch News, vous pouvez optionellement spécifier le nombre de Arch news à afficher avec `--news [Num]` (e.g. `--news 10`)
-D, --debug       Afficher les traces de débogage
--gen-config      Générer un fichier de configuration par défaut/exemple (voir la page de manuel arch-update.conf(5) pour plus de détails)
-h, --help        Afficher ce message d'aide et quitter
-V, --version     Afficher les informations de version et quitter

Codes de sortie :
0  OK
1  Option invalide
2  Aucune méthode d'élévation de privilège (sudo ou doas) n'est installée
3  Erreur lors du changement d'icône
4  L'utilisateur n'a pas donné la confirmation de procéder
5  Erreur lors de la mise à jour des paquets
6  Erreur lors de l'appel de la commande reboot pour appliquer une mise à jour du noyau en attente
7  Aucune mise à jour en attente durant l'utilisation de l'option `-l/--list`
8  Erreur lors de la génération d'un fichier de configuration avec l'option `--gen-config`

Pour plus d'informations, consultez la page de manuel arch-update(1).
Certaines options peuvent être activées/désactivées ou modifiées via le fichier de configuration arch-update.conf, voir la page de manuel arch-update.conf(5).

Fichier de configuration arch-update

Le fichier arch-update.conf est un fichier de configuration facultatif pour arch-update permettant
d'activer/désactiver ou modifier certaines options dans le script.

Ce fichier de configuration doit se trouver dans "${XDG_CONFIG_HOME}/arch-update/arch-update.conf"
ou "${HOME}/.config/arch-update/arch-update.conf".
Un fichier de configuration par défaut/exemple peut être généré en exécutant : `arch-update --gen-config`

Les options prises en charge sont :

- NoColor # Ne pas coloriser la sortie.
- NoVersion # Ne pas afficher les modifications de versions des paquets lors du listing des mises à jour en attente (y compris lors de l'utilisation de l'option `-l/--list`).
- AlwaysShowNews # Toujours afficher les Arch news avant de mettre à jour, peu importe s'il y en a une nouvelle depuis la dernière exécution ou non.
- NewsNum=[Num] # Nombre de Arch news à affcher avant la mise à jour et avec l'option `-n/--news` (voir la page de manuel arch-update(1) pour plus de details). La valeur par défaut est 5.
- KeepOldPackages=[Num] # Nombre d'anciennes versions de paquets à conserver dans le cache de pacman. La valeur par défaut est 3.
- KeepUninstalledPackages=[Num] # Nombre de versions de paquets désinstallés à conserver dans le cache de pacman. La valeur par défaut est 0.

Les options sont sensibles à la casse, les majuscules doivent donc être respectées.

Pour plus d'informations, consultez la page de manuel arch-update.conf(5).

Trucs et astuces

Prise en charge du AUR

Arch-Update prend en charge la mise à jour des paquets AUR lors de la vérification et de l'installation des mises à jour si yay ou paru est installé :
Voir https://github.com/Jguer/yay et https://aur.archlinux.org/packages/yay
Voir https://github.com/morganamilo/paru et https://aur.archlinux.org/packages/paru

Prise en charge de Flatpak

Arch-Update prend en charge la mise à jour des paquets Flatpak lors de la vérification et de l'installation des mises à jour (ainsi que de la suppression des packages Flatpak inutilisés) si flatpak est installé :
Voir https://www.flatpak.org/ et https://archlinux.org/packages/extra/x86_64/flatpak/

Notifications de bureau

Arch-Update prend en charge les notifications de bureau lors de l'exécution de la fonction --check si libnotify (notify-send) est installé :
Voir https://wiki.archlinux.org/title/Desktop_notifications

Modifier le cycle de vérification automatique

Si vous avez activé le timer systemd, l'option --check est automatiquement lancée au démarrage du système puis une fois par heure.

Si vous souhaitez modifier le cycle de vérification, exécutez la commande systemctl --user edit arch-update.timer pour créer une configuration de remplacement pour le timer et saisissez ce qui suit :

[Timer]
OnUnitActiveSec=
OnUnitActiveSec=10m

Les unités de temps sont s pour secondes, m pour minutes, h pour heures, d pour jours...
Voir https://www.freedesktop.org/software/systemd/man/latest/systemd.time.html#Parsing%20Time%20Spans pour plus de détails.

Contribuer

Vous pouvez soulever vos problèmes, commentaires et suggestions dans l'onglet Issues.
Les Pull requests sont également les bienvenues !