Habash

###

**Bash**

###

#### **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!

## Nota de Tradução

Não é garantido que a página contenha a mesma informação da original em Inglês. Pode estar desatualizada ou conter links para conteúdos não existentes. Quer ajudar nas traduções? Acesse **Começando Suas Traduções**.