Description
hasbash est un client terminal (très minimal) écrit entièrement en Bash. Il est prévu comme composant réutilisable dans un workflow sur n'importe quel système GNU/Linux ou Unix (par exemple MacOS) moderne avec des dépendences minimales.
Fonctionnalités actuelles :
- habash ls # Lister toutes les tâches
- habash cast <SPELL NAME> <(optional) TARGET ID> # Lancer une compétence (SPELL_NAME est de l'API)
- habash id <TASK TEXT> # Obtenir l'id d'une tâche
- habash up|done <TASK_TEXT> # (Utiliser avec tâches À Faire & Quotidiennes pour marquer comme accomplies. Pour les Habitudes, comme action positive)
- habash down <TASK_TEXT> # (Utiliser avec tâches À Faire & Quotidiennes pour marquer comme non-accomplies. Pour les Habitudes, comme action négative)
- habash delete <TASK_TEXT> # Supprimer une tâche
- habash create-todo <TASK_TEXT> # Créer une tâche À Faire
- habash create-habit <TASK_TEXT> # Créer une Habitude
Habash peut être utilisé via la ligne de commande et intégré avec des outils comme Taskwarrior ou git hooks.
ATTENTION! Traitez ce script comme si c'était du curl. C'est-à-dire, évitez d'utiliser des caractères spéciaux, etc. La plupart des arguments passent sans traitement sp´pecial à la fin d'une commande curl. (Si vous ne comprenez pas ce que cela signifie, lisez curl.)
A noter que le script actuel ne peut pas gérer les tâches avec des listes de vérification correctement.
Installation
Composants requis (normalement ces composants sont déjà installés sur tous les nouveaux systèmes Linux/Unix) :
- Bash
- curl
- grep
Puis clonez le git repo avec
git clone https://github.com/nasfarley88/habash.git
fixez les variables d'environnement HABITICA_TOKEN et HABITICA_UUID (ci-dessous) et commencez à utiliser le script ./habash
!
Les variable d'environnement HABITICA_TOKEN et HABITICA_UUID doivent être fixées dans l'environnement actuel, par exemple dans .bashrc
, .bash_profile
etc.
Vous pouvez également les fixer à l'aide de la commande suivante avant d'exécuter le script
declare -x HABITICA_UUID=[USER ID]
declare -x HABITICA_TOKEN=[API TOKEN]
Votre [USER ID] et [API TOKEN] peuvent être trouvés sur le site web, sous Paramètres=>Site ou sur les applications mobiles sous Paramètres => Détails du Compte
Toutefois n'oubliez pas que, comme mentionné sur la page d'options API, votre jeton d'API est un mot de passe. Traitez-le comme tel. Par exemple, si vous fixez les variables HABITICA_UUID
et HABITICA_TOKEN
dans votre fichier .bashrc file, assurez-vous que les permissions du fichier soient fixées afin que vous seul•e puissiez les lire. Cela peut être fait avec les commandes de console suivantes:
cd ~
chmod 600 .bashrc
La première commande change votre home directory et la seconde empêche d'autres utilisateurs et utilisatrices d'accéder à votre .bashrc file. Mais si vous utilisez habash, vous probablement savez déjà cela.
Si vous utilisez une instance locale d'Habitica, vous devrez peut-être modifier le script pour ajouter le paramètre -k pour les lignes de commande curl pour permettre les connexion non-sécurisées, c'est-à-dire les connextions aux sites SSL sans certs.
Utilisation
Commandes disponibles:
- habash ls
- habash cast SPELL_NAME (optional)TARGET_ID
- habash id TASK_TEXT
- habash up TASK_TEXT
- habash down TASK_TEXT
- habash create-todo TASK_TEXT
- habash create-habit TASK_TEXT
- habash help
Attention:
Cet article est une traduction de Habitica Wikia
Il n'est pas garanti que le contenu soit identique à son équivalent anglais. |