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.5.tar.gz (18.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

guiabolso2csv-0.5-py3-none-any.whl (19.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: guiabolso2csv-0.5.tar.gz
  • Upload date:
  • Size: 18.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.7

File hashes

Hashes for guiabolso2csv-0.5.tar.gz
Algorithm Hash digest
SHA256 eff20cdf798ccb85fd658c93457a62815574541839c8836d2cefec8adafb9b3a
MD5 fde949f6e8f9e7478dbac2d65cf70c4e
BLAKE2b-256 d29d7ef8bfeb0c147c11d2b6e2e75f9e11cfdf4212edf727760b391c2bbac2ae

See more details on using hashes here.

File details

Details for the file guiabolso2csv-0.5-py3-none-any.whl.

File metadata

  • Download URL: guiabolso2csv-0.5-py3-none-any.whl
  • Upload date:
  • Size: 19.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for guiabolso2csv-0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 f1811da57f9dafeaaee4a55f04df974c5a662737537f58f111fdceeae733694b
MD5 71d218f3063e01afa07e15d008291edd
BLAKE2b-256 2df55d8fa93d77a3b08260918b376a695276f22e1a570fba2ea9cf2e121938a5

See more details on using hashes here.

Release history Release notifications | RSS feed

0.6

1 file

This release

0.5 This release

2 files

0.4

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