====== td ======

Gestion de todo-list dans le terminal, comme [[t]] ou [[Taskwarrior]].

===== Installation =====
==== Depuis le binaire ====
Il faut télécharger le dernier binaire pour Linux sur la page [[https://github.com/Swatto/td/releases|releases]].
<code bash>
$ wget https://github.com/Swatto/td/releases/download/pre-release/linux_amd64_td
</code>

On le rend exécutable et on le déplace dans le dossier ''/usr/bin'' tout en le renommant :
<code bash>
$ chmod +x linux_amd64_td
$ su
# mv linux_amd64_td /usr/bin/td
# chown root:root /usr/bin/td
</code>

==== Compilation ====
<WRAP center round important 60%>
Je n'ai pas réussi à comprendre comment récupérer, compiler et installer le programme... Il faudra que je regarde à nouveau plus tard.
</WRAP>

<code bash>
# go get github.com/Swatto/td
</code>

===== Configuration =====
Si on ne configure rien, il ne sait pas où mettre le fichier qui contient les données. 
<code bash>
$ td

Error
-----
A store for your todos is missing. You have 2 possibilities:
  1. create a ".todos" file in your local folder.
  2. the environment variable "TODO_DB_PATH" could be set.
    (example: "export TODO_DB_PATH=$HOME/Dropbox/todo.json" in your .bashrc or .bash_profile)

open : no such file or directory
</code>

<code bash>
$ nvim /home/$USER/.bashrc
$ cat /home/$USER/.bashrc
(...)
  #SLF: td Path
  export TODO_DB_PATH=/home/$USER/cequetuveux/todo/todo.json
</code>

===== Utilisation =====
==== Voir la liste des choses à faire ====
<code bash>
$ td

     1 | ✕ Tâche à réaliser
     2 | ✕ Autre tâche à réaliser
     3 | x ...
</code>

Pour voir les tâches en cours et celles déjà terminées :
<code bash>
$ td --all

     1 | ✕ Tâche à faire
     2 | ✓ Tâche terminée
</code>

Voir uniquement les tâches terminées :
<code bash>
$ td --done

     3 | ✓ Tâche terminée 1
     7 | ✓ Tâche terminée 2
</code>

==== Ajouter une tâche ====
Il faut mettre la description de la tâche entre guillemets.
<code bash>
$ td add "Nouvelle tâche"
#8 "Nouvelle tâche" is now added to your todos.
</code>

==== Modifier une tâche ====
Il faut donner l'ID de la tâche en argument ainsi que sa nouvelle description :
<code bash>
$ td modify 8 "Modifier une tâche"
"8" has now a new description: Modifier une tâche
</code>

==== Valider une tâche ====
<code bash>
$ td toggle 8
Your todo is now done.
</code>

==== Supprimer une tâche ====
J'ai l'impression qu'on ne peut pas supprimer une seule tâche. Il n'y a pas d'option "remove". (Peut-être intéressant de regarder pour faire une issue sur le Github de td...

Ce qu'on peut faire actuellement, c'est modifier une tâche pour la remplacer par une nouvelle.

==== Supprimer toutes les tâches terminées ====
<code bash>
$ td clean
Your list is now flushed of finished todos.
</code>

==== Aide de td ====
<code bash>
$ td --help
</code>
<hidden>
<code bash>
NAME:
   td - Your todos manager

USAGE:
   td [global options] command [command options] [arguments...]

VERSION:
   1.4.0

AUTHOR:
   Gaël Gillard <gael@gaelgillard.com>

COMMANDS:
     init, i     Initialize a collection of todos
     add, a      Add a new todo
     modify, m   Modify the text of an existing todo
     toggle, t   Toggle the status of a todo by giving his id
     clean, c    Remove finished todos from the list
     reorder, r  Reset ids of todo (no arguments) or swap the position of two todos
     search, s   Search a string in all todos
     help, h     Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --done, -d     print done todos
   --all, -a      print all todos
   --help, -h     show help
   --version, -v  print the version
</code>
</hidden>