Habash

Habash
	Bash
Mantido por:	nasfarley88
Lançado em:	1.1.0 / 31 de Agosto de 2018
Site:	GitHub: Habash

Descrição

Hasbash é um terminal (muito pequeno) para Habitica, escrito inteiramente em Bash. Ele foi criado para ser um componente reutilizável em um workflow de qualquer GNU/Linux moderno, ou sistema Unix com dependências mínimas (e.g. MacOS).

Recursos atuais inclusos:

• habash ls # Lista todas as tarefas
• habash cast <SPELL NAME> <(optional) TARGET ID> # Joga um fentiço (SPELL_NAME é da API)
• habash id <TASK TEXT> # Consegue o id de uma tarefa
• habash up|done <TASK_TEXT> # (Use com Afazeres & Diárias para completá-los. Para Hábitos funciona como uma ação positiva (+) )
• habash down <TASK_TEXT> # (Use com Afazeres & Diárias para desfazer. Para Hábitos funciona como uma ação negativa (-) )
• habash delete <TASK_TEXT> # Exclui uma tarefa
• habash create-todo <TASK_TEXT> # Cria um Afazer
• habash create-habit <TASK_TEXT> # Cria um Hábito

Ele pode ser usado via linha de comando e também pode ser integrado com ferramentas como Taskwarrior ou Git.

ATENÇÃO! Use esse script como se fosse o Curl (i.e. evitando caracteres especiais, etc). A maior parte dos argumentos passa sem tratamento especial ao final de um comando curl. (Se você não entende o significado disso, veja Curl.)

Note que o script atual não lida bem com tarefas que possuem check-lists.

Instalação

Componentes necessários (eles usualmente já vem instalados em qualquer novo sistema Linux/Unix):

• Bash
• Curl
• Grep

Em seguida, clone o repositório do git com
git clone https://github.com/nasfarley88/habash.git
Configure as environment variables (variáveis de ambiente), HABITICA_TOKEN e HABITICA_UUID (abaixo), e comece a usar o script ./habash!

As variáveis de ambiente, HABITICA_TOKEN e HABITICA_UUID, são necessárias no ambiente atual (e.g. no .bashrc, .bash_profile, etc..) Como alternativa, configure-os com os comandos a seguir antes de executar o script:
declare -x HABITICA_UUID=[USER ID]
declare -x HABITICA_TOKEN=[API TOKEN]
O seu e o seu TOKEN API podem ser encontrados no site, em Configurações => Site, ou no seu aparelho mobile em Configurações => API

No entanto, esteja ciente que, conforme mencionado na página de configurações da API, o seu token API é uma senha, então tenha o devido cuidado com ele. Por exemplo, se você configurar as variáveis HABITICA_UUID e HABITICA_TOKEN no seu arquivo .bashrc, certifique-se de que as permissões do arquivo estão configuradas para que apenas você tenha acesso de leitura. Isso pode ser feito a partir dos seguintes comandos no console:
cd ~
chmod 600 .bashrc
O primeiro comando muda o console para o seu diretório home, e o segundo evita que outros usuários acessem o seu arquivo .bashrc. Mas se você está usando Habash é provável que já saiba disso.

Se você está rodando uma instância local do Habitica, talvez precise de um script alternativo para adicionar o parâmetro -k para as linhas de comando Curl, permitindo conexões não seguras, ou seja, conexões sem garantia com sites SSL.

Uso

Comandos disponíveis:

• 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

ATENÇÃO:

Você deve tratar esse script como se estivesse usando o próprio Curl (i.e. você deve evitar caracteres especiais, etc.. Como de costume, nunca copie e cole um comando que você não entende!