Comment suivre votre temps sous Linux avec Bartib

En tant que professionnels de l'informatique, nous devons souvent suivre le temps que nous consacrons à nos missions - que ce soit pour le reporting interne dans notre entreprise ou pour facturer nos clients. Bien que de nombreux outils existent pour répondre à différents besoins, beaucoup d'entre eux sont destinés à de plus grandes équipes ou à des besoins spécifiques et manquent de la simplicité que nous apprécions lorsque nous utilisons des outils en ligne de commande. Un outil simple, qui nous permet de suivre le temps directement depuis la ligne de commande, est Bartib.

Qu'est-ce que Bartib ?

Bartib fournit plusieurs commandes pour suivre quand nous commençons et arrêtons des activités ou pour créer des rapports sur le temps que nous avons passé sur certaines tâches et projets. Il enregistre un journal de toutes les activités suivies sous forme de fichier texte simple, dans un format lisible par l'homme.

Bartib est une application gratuite et open source écrite en Rust.

Installer Bartib sur Linux

Bartib peut être installé via Homebrew, le gestionnaire de paquets Cargo, ou en téléchargeant des binaires précompilés depuis la page de release.

Méthode 1 : Installation via Homebrew

Installer Homebrew

Si vous n'avez pas encore installé Homebrew sur votre ordinateur, veuillez le faire avant de continuer :

• Instructions d'installation pour homebrew

Installer Bartib

Une fois Homebrew installé, Bartib peut être installé en utilisant la commande suivante :

$ brew install bartib

Méthode 2 : Installation via Cargo

Installer Rust

Si Rust n'est pas installé sur votre machine Linux, il doit être installé avant de continuer :

• Comment installer le langage de programmation Rust sur Linux

Mettre à jour Rust (si déjà installé) :

Assurez-vous d'avoir la dernière version de Rust en exécutant la commande suivante :

$ rustup update

Installer Bartib

Une fois que Rust a été mis à jour, vous pouvez procéder à l'installation de Bartib en utilisant le gestionnaire de paquets Cargo. Exécutez la commande suivante :

$ cargo install --locked bartib

Méthode 3 : Installation via des binaires précompilés

Vous pouvez obtenir un binaire précompilé depuis la page de téléchargement des versions du projet à la Page des Versions de Bartib. Téléchargez le fichier tar correspondant à votre architecture, extrayez-le, et déplacez l’exécutable vers un répertoire dans votre ` PATH.

Si vous prévoyez d'utiliser Bartib uniquement avec votre compte utilisateur individuel, le répertoire pourrait être ~/bin. Cependant, si vous avez l'intention de rendre Bartib disponible pour tous les utilisateurs de votre appareil, le répertoire serait /usr/local/bin.

Après avoir installé Bartib, assurez-vous qu'il est exécutable en définissant les permissions de fichier correctes avec la commande suivante :

$ chmod 755 bartib

Alternativement, vous avez la possibilité d'installer les binaires précompilés en utilisant un script shell que vous trouverez sur la page des versions de Bartib. Il vous suffit d'exécuter la commande suivante, et le script shell installera Bartib directement sur votre système :

$ curl --proto '=https' --tlsv1.2 -LsSf https://github.com/nikolassv/bartib/releases/download/v1.1.0/bartib-installer.sh | sh

Installez Bartib depuis l'AUR

Si vous utilisez Arch Linux et ses variantes comme EndeavourOS et Manjaro Linux, vous pouvez installer Bartib depuis l'Arch User Repository (AUR) en utilisant Paru :

$ paru -S bartib

Ou Yay assistant AUR :

$ yay -S bartib

Installer Bartib sur Alpine Linux

Bartib est disponible dans les dépôts par défaut d'Alpine Linux. Vous pouvez l'installer en utilisant la commande apk comme ci-dessous :

$ sudo apk add bartib

Vérifiez si Bartib a été installé avec succès

Après avoir installé Bartib, vous voulez confirmer que l'installation a réussi. Il vous suffit de saisir cette commande dans votre terminal, et elle devrait afficher la version installée de Bartib :

$ bartib --version

Comment suivre votre temps sous Linux en utilisant Bartib

Indiquez à Bartib où enregistrer le journal de vos activités

Comme mentionné ci-dessus, Bartib enregistre un journal de toutes vos activités dans un fichier texte brut. Pour pouvoir enregistrer toute activité, Bartib doit savoir où se trouve ce fichier. Vous désignez le fichier explicitement dans chaque commande en utilisant l'option -f ou --file, comme suit :

$ bartib -f ~/activities.bartib report

Alternativement, Bartib permet de spécifier le fichier via la variable d'environnement BARTIB_FILE. Vous devriez idéalement définir cette variable dans un fichier comme .bashrc, qui est exécuté dans chaque shell que vous ouvrez, comme suit :

export BARTIB_FILE=activities.bartib

Lorsque la variable d'environnement BARTIB_FILE est présente, il n'est pas nécessaire d'utiliser le paramètre -f. Comme cette méthode est le moyen préféré de spécifier le fichier, le paramètre -f est ignoré dans tous les exemples suivants.

Suivi du temps simple : démarrage et arrêt des activités

Vous utilisez Bartib en exécutant la commande bartib avec un sous-commande et des paramètres optionnels. À cet égard, elle fonctionne de la même manière que d'autres outils en ligne de commande comme git.

Les sous-commandes dont vous aurez le plus besoin dans votre travail quotidien sont les commandes start et stop. Comme chaque activité dans Bartib consiste en une description et un projet, vous devez définir ceux-ci comme paramètres avec la sous-commande start :

$ bartib start -d 'Fix javascript bug #345' -p 'Application Front End'

Le paramètre -d ou --description définit la description, le paramètre -p ou --project définit le projet.

Après avoir terminé votre tâche, vous pouvez arrêter de suivre le temps avec :

$ bartib stop

Vous pouvez également simplement commencer l'activité suivante. Bartib arrêtera automatiquement toutes les activités en cours lorsqu'une nouvelle activité commence.

Si vous travaillez depuis un certain temps et n'êtes pas sûr d'avoir correctement commencé à suivre votre temps, utilisez la commande bartib current pour vérifier si bartib suit une activité et, le cas échéant, laquelle. Si vous avez oublié de démarrer l'activité, vous pouvez toujours la lancer plus tard et définir son heure de début en utilisant le paramètre -t au format 24 heures :

$ bartib start -d 'Improve Database Performance' -p 'Housekeeping' -t 15:30

Deux autres commandes pour démarrer des activités sont utiles si vous changez fréquemment de tâche. La première est bartib last qui affiche une liste des combinaisons récentes de descriptions et de projets utilisées. La deuxième est bartib continue qui vous permet de continuer n'importe laquelle de ces activités récentes.

La sortie de bartib last affiche un index pour chaque activité dans sa première colonne :

Vous utilisez cet index avec bartib continue pour spécifier quelle activité continuer :

$ bartib continue 5
Started activity: "Team meeting" (Internal project) at 2024-05-17 18:03

Vous pouvez également écraser la description ou le projet en le redéfinissant par le paramètre respectif ainsi que définir l'heure de début avec le paramètre -t :

$ bartib continue 5 -d 'Fix Bug #56' -t 10:45

Lister les activités et créer des rapports

Pour lister les activités que vous avez suivies jusqu'à présent, utilisez la sous-commande list :

$ bartib list

Il est souvent souhaitable de ne lister que les tâches d'une certaine période. Vous pouvez définir une telle période avec les paramètres --from et --to :

$ bartib list --from 2024-05-13 --to 2024-05-17

Si les deux dates sont les mêmes, vous les définissez avec un seul argument --date :

$ bartib list --date 2024-05-15

Bartib fournit plusieurs paramètres pour définir des périodes de temps souvent utilisées :

$ bartib list --today         # list todays' activities
$ bartib list --yesterday     # list yesterdays' activities
$ bartib list --current_week  # list activities of the current week (since monday)
$ bartib list --last_week     # list activities of the last week

Il est souvent souhaitable de lister toutes les activités que vous avez suivies pour un projet spécifique. Dans ce cas, vous pouvez utiliser le filtre --project avec bartib list :

$ bartib list --project 'Development of the Application Backend'

Bien qu'il soit utile de pouvoir lister toutes les activités suivies, ce qui rend Bartib vraiment utile, c'est sa capacité à créer des rapports significatifs.

Utilisez la sous-commande bartib report pour créer un rapport comprenant toutes les activités que vous avez jamais suivies :

$ bartib report

Comme vous le voyez dans la sortie ci-dessus, Bartib liste tous les projets et sous chaque projet, il fournit une liste de toutes les activités appartenant à ce projet. Il affiche le temps que vous avez passé sur chaque tâche et le temps total que vous avez passé sur chaque projet. Il calcule également la somme de toutes les activités que vous avez jamais suivies.

La commande bartib report accepte les mêmes paramètres que bartib list pour filtrer les tâches qu'elle inclut. Tout comme avec bartib list, vous utilisez les paramètres --from et --to pour définir une période pour laquelle vous souhaitez générer le rapport, ou vous pouvez utiliser l'une des périodes prédéfinies : --today, --yesterday, --current_week et --last_week.

Modification des entrées de suivi du temps

Parfois, vous pourriez avoir besoin de modifier les activités que vous avez suivies. Pour modifier l'activité en cours, Bartib propose la commande bartib change. Il suffit de l'utiliser avec le paramètre -p, -d ou -t pour changer son projet, sa description ou son heure de début.

Par exemple, la commande suivante modifie l'heure de début de l'activité en cours à 10:15 :

$ bartib change -t 10:15

Si vous avez déjà commencé à suivre une activité mais avez changé d'avis et ne souhaitez suivre aucune activité du tout, vous pouvez utiliser la sous-commande bartib cancel. Elle supprime définitivement toute activité actuellement suivie, tout en n'affectant aucune autre activité dans votre journal.

Si vous devez modifier des activités qui se sont déjà arrêtées, vous pouvez toujours modifier leur enregistrement dans le journal des activités. Il vous suffit d'ouvrir le fichier dans votre éditeur préféré ou d'utiliser la commande bartib edit pour démarrer l'éditeur défini dans votre variable d'environnement $EDITOR.

Le format d'un enregistrement est explicite :

2024-05-13 10:15 - 2024-05-13 14:00 | Development of the Application Back end | Fixing the Logging endpoint

Chaque enregistrement se compose de parties séparées par le signe barre verticale « | ». La première partie contient les heures de début et de fin, la deuxième partie le projet et la troisième partie la description de la tâche.

Après avoir modifié manuellement les activités, vous pourriez vouloir utiliser la commande bartib check et la commande bartib sanity.

Le premier vérifie si le journal contient des lignes invalides que bartib ne pourra pas analyser, tandis que le second vérifie si le journal contient des activités comportant des erreurs logiques, comme une activité avec une durée négative.

Pour une utilisation détaillée, consultez le dépôt GitHub de Bartib :

• Répertoire GitHub de Bartib

Conclusion

Aussi simple que Bartib soit à utiliser, c'est un outil remarquablement polyvalent pour suivre les activités sur la ligne de commande. Bien qu'il n'offre pas toutes les fonctionnalités que d'autres outils proposent, il est vraiment utile pour quiconque souhaite suivre les temps en tant qu'utilisateur unique de manière simple et sans tracas.

Connexe : Moro – Un outil de productivité en ligne de commande pour suivre les heures de travail