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
-
Installer Python 3
-
Installer pip ;
-
Lancer
pip install --user git+https://gitlab.com/GullumLuvl/tresoryx.git
-
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
-
Lancer un terminal (sous linux, Ctrl-Alt-T)
-
Afficher l'aide du programme :
treso-exercice -h
. -
Dans le répertoire où se trouvent
Exercice.xlsx
et ledernier_releve.csv
(et optionnellementnoms.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
-
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.)
-
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 |
a62a85ef19c59e6f25d1edfc35194007bc76bf08c53d3b0e6960d6bfb33c5c3d
|
|
MD5 |
1ebb7351e49ccd94f49447d938e01dc5
|
|
BLAKE2b-256 |
6b2fbc4aa8629b7aee034d4b77e54343c47770ba7723ef73df69abe844a62385
|
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
Algorithm | Hash digest | |
---|---|---|
SHA256 |
d701bc9cbaeb4088a3130cb4c4c325bc781dab4af45504bc736d4d508c56b83a
|
|
MD5 |
c25c5667bfad47d3e3c0d6498a7c839a
|
|
BLAKE2b-256 |
3ffe28b797e88f5c2dfb5528179646894c19da06861776853075a1bc1f26d5ac
|