Skip to main content

Humble automatisations for treasury using spreadsheets.

Project description

Tresoryx, humble paquet pour la trésorerie d'association

Fonctionnalités:

  • automatiser le remplissage du fichier d'exercice à partir d'un relevé de compte au format .csv ;
  • calculer (et représenter sur un graphique) les dettes des adhérents ;
  • automatiquement compiler le bilan de fin d'année ;

Installation

  1. Installer Python 3

  2. Installer pip ;

  3. Lancer

     pip install --user git+https://gitlab.com/GullumLuvl/tresoryx.git
    
  4. C'est bon, les exécutables treso-exercice, treso-dette, treso-bilan, treso-datajoueur sont disponibles en ligne de commande.

Exemple d'usage dans un notebook Google Colab

# Commencer par installer le package:
!pip install Tresoryx

# Importer le dernier fichier de relevé, et éventuellement les fichiers
# noms.csv et config.yaml:
from google.colab import files
uploaded = files.upload()  # Choisir les fichiers manuellement

from tresoryx.auto_exercice import met_a_jour_exercice

# Affiche l'aide
met_a_jour_exercice?

met_a_jour_exercice('<fichier-releve>',  # le fichier relevé téléchargé dans colab
                'Exercice2019',  # le nom de la googlesheet
                source='googlesheets',
                fichier_noms='noms.csv')

Exemple d'usage local, en ligne de commande

  1. Lancer un terminal (sous linux, Ctrl-Alt-T)

  2. Afficher l'aide du programme : treso-exercice -h.

  3. Dans le répertoire où se trouvent Exercice.xlsx et le dernier_releve.csv (et optionnellement noms.csv), exécuter:

     treso-exercice dernier_releve.csv Exercice.xlsx -n noms.csv
    

Formats de fichiers attendus

Exercice

.xlsx ou .xls.

Le nom ou numéro de la feuille sur laquelle se trouve l'exercice en cours peut être précisé avec l'option -f/--feuille. Les lignes et colonnes de début du tableau doivent être modifiées si besoin dans le code de la classe ChargeurDonnees.

Les noms de colonne attendus sont fixés (mais insensibles à la casse):

['Date', 'Catégorie', 'Nom', 'Crédit', 'Débit', 'Solde', 'Mode', 'Classe', 'Intitulé']

Les colonnes additionnelles ne sont pas vérifiées, mais en sortie par défaut, treso-exercice rajoute 'Commentaire' et 'Info_supp.

relevé

Fichier .csv téléchargé depuis l'onglet "Téléchargements" de la banque. Uniquement implémenté pour Société Générale pour l'instant.

noms.csv

Colonnes "Relevé", "Complet", "Surnom".

"Relevé" ne doit pas contenir de duplicats.

exemple_config.yaml

Contient différentes variables de configuration :

  • "expressions régulières" permettant de détecter la classe d'opération;
  • lignes et colonnes de début des tableaux dans les fichier Excel.

TODO

  • Charger depuis Google Sheets. Utiliser Google Colab pour exécuter les fonctions. Attention, cela stocke les données sur Google SDK Cloud.
  • Une dette combinant toutes les catégories + treso-exercice utilise les dettes précédentes pour classer les virements par catégories (éventuellement diviser les lignes)

Comment contribuer

  1. Via l'interface web Gitlab (plus facile) :

    • aller à un fichier particulier.
    • cliquer sur "Edit" ou "Web IDE"
    • modifier
    • sélectionner/créer une branche autre que "master".
    • Entrer un "commit message" (description des changements effectués. Préciser le Pourquoi plutôt que le Comment.)
  2. En local avec Git et votre éditeur de texte préféré.

License

Ce code est licensé sous la license publique générale GNU version 3.

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

Tresoryx-0.2.0.tar.gz (36.4 kB view details)

Uploaded Source

Built Distribution

Tresoryx-0.2.0-py3-none-any.whl (36.7 kB view details)

Uploaded Python 3

File details

Details for the file Tresoryx-0.2.0.tar.gz.

File metadata

  • Download URL: Tresoryx-0.2.0.tar.gz
  • Upload date:
  • Size: 36.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.6.9

File hashes

Hashes for Tresoryx-0.2.0.tar.gz
Algorithm Hash digest
SHA256 a62a85ef19c59e6f25d1edfc35194007bc76bf08c53d3b0e6960d6bfb33c5c3d
MD5 1ebb7351e49ccd94f49447d938e01dc5
BLAKE2b-256 6b2fbc4aa8629b7aee034d4b77e54343c47770ba7723ef73df69abe844a62385

See more details on using hashes here.

File details

Details for the file Tresoryx-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: Tresoryx-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 36.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.6.9

File hashes

Hashes for Tresoryx-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d701bc9cbaeb4088a3130cb4c4c325bc781dab4af45504bc736d4d508c56b83a
MD5 c25c5667bfad47d3e3c0d6498a7c839a
BLAKE2b-256 3ffe28b797e88f5c2dfb5528179646894c19da06861776853075a1bc1f26d5ac

See more details on using hashes here.

Supported by

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