Taskwarrior

Taskwarrior Descrição da imagem Taskwarrior-logo.png. Descrição da imagem Taskwarrior screenshot.png. Em formação
Desenvolvido por Paul Beckingham,
Federico Hernandez,
David J Patrick,
John Florian ...
Primeira versão 29 de novembro de 2006
Última versão 2.1.1 (25 de julho de 2012)
Depósito github.com/GothenburgBitFactory/taskwarrior
Escrito em C ++
Sistema operacional Linux , Berkeley Software Distribution , macOS e Cygwin
Meio Ambiente Multi plataforma
línguas inglês
Modelo Gerenciador de tarefas
Licença Licença MIT
Local na rede Internet http://taskwarrior.org/

Taskwarrior é um software de código aberto na linha de comando para gerenciar tarefas . Ele foi lançado sob a licença do MIT e é multiplataforma .

Permite criar, modificar, deletar tarefas; atribua a eles um ou mais projetos, prioridades e tags e visualize-os por meio de vários relatórios.

usar

Os comandos que permitem o uso do Taskwarrior seguem a seguinte sintaxe genérica:

task <filtre> <commande> <modifications>

Gestão de tarefas

Os comandos add, modifye donerespectivamente permitem adicionar, modificar e marcar uma tarefa como concluída.

Cada tarefa tem uma descrição que deve ser especificada assim que for adicionada, bem como vários atributos (como um projeto, uma prioridade, tags, uma data de vencimento, uma dependência ...). Alguns ou todos os atributos podem ter valores atribuídos e seus valores podem ser alterados a qualquer momento.

No entanto, alguns desses atributos possuem algumas especificidades. A prioridade de uma tarefa só pode ser definida para um de três valores: H para alta , M para média ou L para baixa . A data de vencimento deve ser definida de acordo com certas regras, embora haja muitas maneiras diferentes de defini-la, incluindo:

  • o equivalente em inglês de qualquer dia da semana: por exemplo, friday indica a próxima sexta-feira
  • Abreviações em inglês para designar o início ( início ) ou o final ( final ) da semana ( semana ), do mês ( mês ), do ano ( ano ). por exemplo, som designa o início do mês ; eoysignifica o final do ano ( final do ano ). Observe, entretanto, que a semana se refere à semana de trabalho (que começa na segunda-feira e termina na sexta - feira ). No entanto, é suficiente usar eocwpara designar a semana do calendário que começa no domingo ou segunda-feira e termina no sábado ou domingo. Assim, eowdesigna o final da semana de trabalho (sexta-feira) e eocwo final da semana do calendário.
  • uma data no formato MM / DD / AAAA ou no formato determinado pela norma ISO 8601 .
Exemplo$ task add Une tâche... Created task 1. $ task add Une autre tâche Created task 2. $ task add Une troisième tâche priority:L depend:1,2 +unTag Created task 3.

Primeiro, você cria várias tarefas especificando uma descrição e, às vezes, um ou mais atributos. Aqui, a tarefa 3 tem uma prioridade baixa, depende das tarefas 1 e 2 e possui uma tag "unTag".

$ task 1-3 modify priority:M - Priority will be set to 'M'. Modify task 1 'Une tâche...'? (yes/no/all/quit) a Modifying task 1 'Une tâche...'. Modifying task 2 'Une autre tâche'. Modifying task 3 'Une troisième tâche'. Modified 3 tasks. $ task modify project:DécouverteDeTaskwarrior due:eocw This command has no filter, and will modify all tasks. Are you sure? (yes/no) y - Due will be set to '8/11/2012'. - Project will be set to 'DécouverteDeTaskwarrior'. Modify task 1 'Une tâche...'? (yes/no/all/quit) y Modifying task 1 'Une tâche...'. - Due will be set to '8/11/2012'. - Project will be set to 'DécouverteDeTaskwarrior'. Modify task 2 'Une autre tâche'? (yes/no/all/quit) a Modifying task 2 'Une autre tâche'. Modifying task 3 'Une troisième tâche'. Modified 3 tasks. The project 'DécouverteDeTaskwarrior' has changed. Project 'DécouverteDeTaskwarrior' is 0% complete (3 of 3 tasks remaining).

Depois de criadas, as tarefas podem ser modificadas especificando-se um filtro que determina quais tarefas devem ser modificadas. Um filtro pode ser o ID de uma tarefa ( por exemplo, 1 designará a tarefa 1: 'Uma tarefa ...'), uma enumeração de IDs ( por exemplo, 1,3 designará as tarefas 1, 'Uma tarefa ...' e 3, 'Um terceiro tarefa '), uma faixa de IDs, como aqui, onde 1-3significa tarefas 1 e 2 e 3 (equivalente a 1,2,3; mas é muito útil se designarmos uma faixa grande: por exemplo 9-34 ). Um filtro também pode ser qualquer atributo: por exemplo, irá priority:H filtrar apenas tarefas com alta prioridade. Nós também pode combinar os filtros com os operadores lógicos and, ore xor.

Na ausência de um filtro, como na segunda modificação, a ação afeta todas as tarefas. Aqui, todas as tarefas agora fazem parte do projeto DiscoverTaskwarrior e devem ser feitas no final da semana do calendário.

$ task 1 done Completed task 1 'Une tâche...'. Completed 1 task. Project 'DécouverteDeTaskwarrior' is 33% complete (2 of 3 tasks remaining).

Terminamos marcando a tarefa 1 como concluída.

Relatórios de tarefas

Dentre os relatórios predefinidos, observaremos:

  • list (liste todas as tarefas com algumas informações adicionais para cada tarefa, como seu projeto, sua prioridade e seu prazo),
  • long (como lista, mas com mais detalhes como dependências, tags),
  • next (liste as tarefas mais urgentes, determinadas pelo software calculando a "urgência" de uma tarefa usando sua prioridade, seu prazo ...),
  • summary (lista todos os projetos e indica para cada um o número de tarefas que faltam realizar, bem como a evolução do projeto que corresponde à percentagem de tarefas do projeto realizadas).

task <nom-du-rapport>permite que você visualize um relatório. Por exemplo, task listpermite que você visualize o relatório list. Porém, é possível visualizar um relatório usando um filtro, por exemplo task priority:H list.

Além dos vinte relatórios predefinidos, também é possível definir seus próprios relatórios editando o arquivo de configuração .taskrc .

Exemplo

Continuando o exemplo da parte anterior, aqui está o que os poucos relatórios mencionados acima podem fornecer:

$ task long ID Project Pri Added Started Due Recur Countdown Age Deps Tags Description 1 DécouverteDeTaskwarrior M 8/4/2012 8/11/2012 - -5 days 1d Une autre tâche 2 DécouverteDeTaskwarrior M 8/4/2012 8/11/2012 - -5 days 1d 1 unTag Une troisième tâche 2 tasks

Todos os quatro relatórios citados listam apenas tarefas não concluídas, portanto, "Uma tarefa ..." não é listada. Além disso, os IDs exibidos aqui não são constantes e podem mudar quando uma tarefa é marcada como concluída. Um identificador que designa exclusivamente uma tarefa, no entanto, existe sob o nome UUID e tem um valor em hexadecimal .

$ task summary Project Remaining Avg age Complete 0% 100% DécouverteDeTaskwarrior 2 19 hrs 33% |||||||||| 1 projects

No relatório summary, uma barra de progresso (na verdade, mais estética do que a do exemplo) permite que você avalie o andamento de cada projeto.

$ task next ID Project Pri Due A Age Urgency Description 1 DécouverteDeTaskwarrior M 8/11/2012 1d 19.1 Une autre tâche 2 DécouverteDeTaskwarrior M 8/11/2012 1d 6.95 Une troisième tâche 2 tasks

Aqui, as tarefas são classificadas por “urgência”, parâmetro calculado, entre outras coisas, a partir da prioridade e do prazo.

Nota: Na verdade, o comando tasksozinho exibe o relatório nexte, portanto, é equivalente a task next .

Notas e referências

  1. Créditos para Taskwarrior
  2. (pt) Funcionamento do relatório nexte cálculo da urgência de uma tarefa.
  3. (in) Lista de relatórios predefinidos no software
  4. (in) Informações sobre a criação de relatórios personalizados

Bibliografia

Apêndices

Artigo relacionado

links externos