Contents
Sobre
TagCash é um programa escrito em Ruby para controle financeiro. Foi feito para pessoas que precisam de algo além de uma planilha e mais prático que softwares mais completos e complexos como GnuCash. Seu funcionamento é baseado em tags (palavras-chave).
Básico
Antes de começar
Tags
Para cada conta que possui, associe uma tag . Exemplo:
conta corrente = cc;
poupança = poup;
- Quantas mais você precisar, sem incluir espaço.
Sinais
Defina uma regra para sinais. A que eu acho mais simples é usar o sinal de menos (-) toda vez que perder dinheiro. Deste modo, sempre que aparecer um saldo negativo, você estará devendo dinheiro.
Transações
Depósitos, saques, etc. são transações. Cada transação é uma linha no arquivo transactions.tc do mesmo diretório. Como exemplo, suponha que recebemos R$ 1.000,00 de salário na conta corrente e transferiremos R$ 200,00 para a poupança. Seguindo o modelo:
dd/mm/aa Descrição da transação__________________ valor tags
Temos (utilize fonte monoespaçada para efeito estético):
05/01/09 Salário_________________________________ 1000.00 cc 06/01/09 Retirada para a poupança________________ -200.00 cc 06/01/09 Depósito da conta corrente______________ 200.00 poup
Usando o programa
Chame o programa seguido da tag desejada. Exemplos:
$ ./tagcash cc 05/01/09 Salário_________________________________ 1000.00 1000.00 06/01/09 Retirada para a poupança________________ -200.00 800.00 PayDay EventDay Description Amount Balance $ ./tagcash poup 06/01/09 Depósito da conta corrente______________ 200.00 200.00 PayDay EventDay Description Amount Balance
Vemos que na última coluna o programa gera o subtotal e, no final, temos os saldos positivos de R$ 800,00 na conta corrente e R$ 200,00 na poupança.
Intermediário
Menos linhas
As tags facilitam, mas há uma certa duplicação que poderíamos deixar de digitar. No exemplo acima podemos reduzir a transferência para a poupança em apenas 1 linha ao invés de 2. O arquivo transactions.tc ficaria (com o mesmo efeito):
05/01/09 Salário_________________________________ 1000.00 cc 06/01/09 Tranferência cc p/ poup_________________ 200.00 poup -cc
Ou seja, podemos usar mais de uma tag, separando-as por 1 espaço. O sinal de menos à esquerda de cc indica que o valor a ser usado na conta corrente será R$ -200,00 (negativo, pois cc está perdendo dinheiro, lembra?).
Avançado
Equivalências
As seguintes linhas são equivalentes:
06/01/09 Tranferência cc p/ poup_________________ 200.00 poup -cc 06/01/09 Tranferência cc p/ poup_________________ 200.00 -cc poup 06/01/09 Tranferência cc p/ poup_________________ -200.00 cc -poup
Adiamento
Vamos supor que você emprestou R$ 30,00 para seu amigo João. Como você usou seu cartão de crédito, João poderá pagar-lhe no vencimento da fatura que, neste exemplo, ocorre no dia 10.
Com as informações do básico e intermediário você consegue fazer isso em duas linhas:
15/01/09 Happy Hour - Paguei para João___________ -30.00 cartão 10/02/09 Happy Hour - Receber de João____________ 30.00 joão
Mas é possível fazer isso em uma só linha:
15/01/09 Happy Hour - João_______________________ -30.00 cartão 10/02/09-joão
O que é equivalente à:
15/01/09 Happy Hour - João_______________________ 30.00 -cartão 10/02/09joão
Alterando caminho do arquivo de transações
Altere o valor da variável file, logo no início do código.
Syntax Highlighting no vim
Se você usa o vim como editor, baixe o tagcash.vim na seção #Downloads e coloque-o em ~/.vim/syntax/. Depois acrescente no transactions.tc a seguinte linha, em qualquer lugar:
# vim: set syntax=tagcash:
As cores foram selecionadas para um fundo escuro. Veja o resultado:
