Tresoryx 0.1

Humble automatisations for treasury using spreadsheets.

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 en ligne de commande

1. Sous linux, lancer un terminal (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.