Skip to main content

BoursoBank library.

Project description

Parseur de relevés BoursoBank

⚠ Cette bibliothèque a été développée indémendament de BoursoBank.

Installation

pip install boursobank

Sécurité

Mot de passe

Cette bibliothèque ne se connecte pas à internet (dans le doute, lis le code) elle ne fait que lire des relevés au format PDF déjà téléchargés, tous les traitements sont effectés en local.

Dans le doute il doit être possible de faire tourner l’application dans firejail ou similaire.

Il n’est donc pas nécessaire de s’inquiéter pour son mot de passe : il n’est pas demandé (là, pas besoin de relire le code : si la lib ne demande pas le mot de passe… elle ne l’a pas).

Erreurs du parseur

Lire des PDF n’est pas simple.

Pour s’assurer de ne pas introduire d’erreur dans vos analyses, cette bibliothèque fournit une méthode validate() qui valide que le montant initial + toutes les lignes donne bien le montant final, sans quoi une ValueError est levée.

Cet exemple ne lévera donc une exception qu’en cas d’erreur d’analyse (ou de la banque, comme au monopoly) :

for file in args.files:
    statement = Statement.from_pdf(file)
    statement.pretty_print()
    statement.validate()

Interface en ligne de commande

Cette lib est utilisable en ligne de commande :

boursobank *.pdf

vous affichera vos relevés (CB ou compte), exemple :

$ boursobank 2024-01.pdf
            2024-01.pdf
┏━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Date       ┃ RIB                        ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 2024-01-01 │ 12345 12345 00000000000 99 │
└────────────┴────────────────────────────┘
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃                                    Label ┃ Value    ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│                            VIR SEPA Truc │ 42.42    │
│                     VIR SEPA Machin truc │ 99.00    │
│    Relevé différé Carte 4810********0000 │ -123.45  │
└──────────────────────────────────────────┴──────────┘

API

Tout l’intérêt est de pouvoir consulter ses relevés en Python, par exemple un export en CSV :

import argparse
import csv
import sys
from pathlib import Path

from boursobank import Statement


def main():
    args = parse_args()
    statement = Statement.from_pdf(args.ifile)
    writer = csv.writer(sys.stdout)
    for line in statement.lines:
        writer.writerow((line.label, line.value))


def parse_args():
    parser = argparse.ArgumentParser()
    parser.add_argument("ifile", type=Path, help="PDF file")
    return parser.parse_args()


if __name__ == "__main__":
    main()

La bibliothèque ne fournit qu’un point d’entrée : la classe Statement

Depuis cette classe il est possible de parser des PDF :

relevé_bancaire = Statement.from_pdf("test.pdf")

ou du texte :

relevé_bancaire = Statement.from_text("blah blah")

Cette classe fournit principalement deux attributs, un dictionnaire headers contenant :

  • date : le 1° jour du mois couvert par ce relevé.
  • emit_date : la date à laquelle le relevé a été rédigé.
  • RIB : le RIB/IBAN du relevé.
  • devise : probablement "EUR".
  • card_number : le numéro de carte bleu si c’est un relevé de carte.
  • card_owner : le nom du possesseur de la carte bleu si c’est un relevé de carte.

et un attribut lines contenant des instances de la classe Line dont les attributs principaux sont :

  • label : la description courte de la ligne.
  • description : la suite de la description de la ligne si elle est sur plusieurs lignes.
  • value : le montant de la ligne (positif pour un crédit, négatif pour un débit).

Project details


Download files

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

Source Distribution

boursobank-0.5.tar.gz (7.7 kB view details)

Uploaded Source

Built Distribution

boursobank-0.5-py2.py3-none-any.whl (8.7 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: boursobank-0.5.tar.gz
  • Upload date:
  • Size: 7.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for boursobank-0.5.tar.gz
Algorithm Hash digest
SHA256 9eaf6d084bec442e1bed0f94abfd0ca1be137a85d39669ceefe36ecdccb39273
MD5 3938ba694126746e6e7f1077107752d1
BLAKE2b-256 6f8a10865111a7d3a49e18e66570aa640a1c6d8773d4231143517952cea017ab

See more details on using hashes here.

Provenance

File details

Details for the file boursobank-0.5-py2.py3-none-any.whl.

File metadata

  • Download URL: boursobank-0.5-py2.py3-none-any.whl
  • Upload date:
  • Size: 8.7 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for boursobank-0.5-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 4ae0a9fffc63c302ddf6af432c41c65d16c24650cf42a313864025552533146c
MD5 c86dcb61c861897b80f97e0d1de74078
BLAKE2b-256 29091349fdcda5a329a1f3309f37ca77588d303851af8ea413e11c2d036b59aa

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page