Skip to main content

GuiaBolso2csv é um simples programa em Python cuja finalidade é baixar os dados de transação do GuiaBolso em formato csv.

O GuiaBolso é um app criado para agregar transações de diversas contas e classificá-las de forma quase automática. A agregação e a classificação são bastante úteis no auxílio do controle dos gastos. O problema é que a análise dos dados é limitada ao que é oferecido pela plataforma. Além disso, os clientes não têm posse de seus dados, caso a empresa deixe de existir ou ocorra alguma mudança na política, os dados podem ser perdidos para sempre. O GuiaBolso2csv permite que os dados sejam baixados e então usados (e guardados) da forma que for mais conveniente. Além do formato csv há a opção de gerar um arquivo xlsx (formato do Excel).

Funcionalidades

  • Baixe suas transações categorizadas do GuiaBolso.

  • Exporte facilmente para uma planilha do Excel.

Obtendo

O jeito mais fácil de instalar é usando o pip (pode ser necessário usar sudo). Basta fazer

pip install guiabolso2csv

Uso Básico

O guiabolso2csv pode ser usado com opções de linha de comando ou de forma interativa. Assim, se você rodar o programa sem opções, vai funcionar como a seguir:

guiabolso2csv
docs/simple.gif

Observe como foi perguntado os dados de login além do ano e mês das transações de interesse. Finalmente um arquivo csv é baixado para o diretório atual.

Alternativamente, o mesmo poderia ser feito usando opções por linha de comando:

guiabolso2csv --email example@example.com --year 2016 --month 12
docs/options.gif

O único dado não especificado foi a senha, que é requisitada pelo programa.

Qualquer dúvida no uso das opções basta fazer:

guiabolso2csv --help
docs/help.png

Outras Opções

Algumas funcionalidades não são disponíveis de forma interativa. A seguir será mostrado como obter um intervalo com vários meses e como obter os arquivos de saída direto no formato do Excel (xlsx).

Intervalo de Meses

Para obter um intervalo de meses basta usar as opções --last-year e --last-month. O programa baixa automaticamente arquivos para todos os meses desde MONTH/YEAR até LAST_MONTH/LAST_YEAR, por exemplo:

guiabolso2csv --email example@example.com --year 2016 --month 12 --last-year 2017 --last-month 6
docs/range.gif

Baixando em Formato do Excel

Além de csv, você pode baixar os dados de transação diretamente no formato xlsx. Para isso basta usar a flag --excel, por exemplo:

guiabolso2csv --email example@example.com --year 2016 --month 12 --excel
docs/xlsx.gif

Baixando o repositório

Caso deseje contribuir para este reprositório ou simplesmente prefere baixar diretamente (sem usar o PyPI). Siga as instruções a seguir.

Você deve ter git e pip instalados para, respectivamente, baixar o repositório e instalar as dependências.

Clone o repositório:

git clone git@github.com:hsadok/guiabolso2csv.git

Vá para o repositório que você acabou de clonar e instale as dependências com pip:

cd guiabolso2csv
pip install -r requirements.txt

Pronto, você já pode usar o GuiaBolso2csv a partir do código baixado fazendo:

python guiabolso2csv

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

guiabolso2csv-0.4.tar.gz (18.2 kB view details)

Uploaded Source

File details

Details for the file guiabolso2csv-0.4.tar.gz.

File metadata

  • Download URL: guiabolso2csv-0.4.tar.gz
  • Upload date:
  • Size: 18.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.2

File hashes

Hashes for guiabolso2csv-0.4.tar.gz
Algorithm Hash digest
SHA256 27af6d45a511fc291f0949ae6c28bccf0d1aa9d6fe2e99a88e092066f21c37e0
MD5 b0682696c565b6c8c5ad986a5698b4fd
BLAKE2b-256 eea0fc783bb8227d763b616cd4bd11771d203a36a89710926688f316624b949e

See more details on using hashes here.

Release history Release notifications | RSS feed

0.6

1 file

0.5

2 files

This release

0.4 This release

1 file

0.3

1 file

0.2

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page