Tunisian tax and benefit system for OpenFisca
Clone or download
sandcha Supprime la configuration travis
Merge pull request #79 from openfisca/remove-travis
Latest commit ee80097 Nov 30, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Exclut la configuration travis des changements fonctionnels Nov 29, 2018
notebooks
openfisca_tunisia Fix some threshold units Nov 11, 2018
tests Adapt print usage to python 3.6 Aug 18, 2018
.gitignore Fix date and reference for enfant boursier Jan 10, 2018
CHANGELOG.md Bump version to 0.21.1 Nov 13, 2018
CONTRIBUTING.md
LICENSE.AGPL.txt Fix setup.py Mar 15, 2018
MANIFEST.in Update MANIFEST.in Mar 24, 2018
Makefile Add full install target to Makefile Oct 28, 2018
README.md Remplace le statut travis par le statut circleci Nov 29, 2018
requirements.txt Explain extra-requirement in requirements.txt Jan 21, 2018
setup.cfg Suppression de résidus d'internationalisation i18n Sep 4, 2017
setup.py Bump version to 0.21.1 Nov 13, 2018

README.md

OpenFisca Tunisia - الجباية المفتوحة تونس

CircleCI

Presentation - التقديم

OpenFisca est un logiciel libre de micro-simulation. Ceci est le code source du module dédié à la Tunisie.

الجباية المفتوحة برنامج حر لمحاكاة النظام الجبائي. هذا مصدر البرنامج للوحدة الخاصة بتونس

OpenFisca is a versatile microsimulation free software. This is the source code of the Tunisia module.

Demo - لعبة تجريبية

Un démonstrateur vous est proposé sous la forme d'un Notebook Jupyter.
Vous serez redirigé vers celui-ci en cliquant sur le lien suivant (le chargement prendra quelques secondes) :

Binder

Vous accédez ainsi à un démonstrateur modifiable où il vous est possible de tester openfisca-tunisia.

ستجدون لعبة تجريبية في شكل دفتر جوبيتر على الرابط التالي

Binder

يسمح هذا الدفتر بتجريب الجباية المفتوحة لتونس

A demo is available in a Jupyter Notebook.
You will be redirected to it by clicking on the following link (wait a few seconds to load it):

Binder

Then you will be in an interactive demo where you will be able to play with openfisca-tunisia.

This demo is available thanks to Binder and Jupyter projects.

Contribution & Contact - المساهمة والاتصال بنا

OpenFisca est un projet de logiciel libre.

Son code source est distribué sous la licence GNU Affero General Public Licence version 3 ou ultérieure (cf. LICENSE).

N'hésitez pas à rejoindre l'équipe de développement OpenFisca ! Pour en savoir plus, une documentation est à votre disposition.

الجباية المفتوحة برنامج حر

تم توزيع مصدر هذا البرنامج تحت رخصة أفيرو العامة الثالثة أو ما أعلى

تعالوا انضموا إلى فريق الجباية المفتوحة و ساهموا في تطوير البرنامج! للمزيد من المعلومات، يرجى زيارة الموقع الإلكتروني الرسمي

OpenFisca is a free software project.

Its source code is distributed under the GNU Affero General Public Licence version 3 or later (see LICENSE file).

Feel free to join the OpenFisca development team! See the documentation for more information.

Documentation

Par ailleurs, chaque module de la famille OpenFisca sur GitHub dispose d'une documentation propre (voir README.md respectifs).

Installation

Sous Unix/macOS/Linux, appliquez les étapes qui suivent dans votre Terminal.

Sous Windows, installez un émulateur de terminal avant de poursuivre.
Nous vous conseillons en particulier l'émulateur BASH fourni avec le gestionnaire de version GIT.
En l'intégrant à un outil tel que Visual Studio Code, vous aurez un environnement fonctionnel pour travailler sur le code source. Néanmoins, vous aurez à effectuer des vérifications complémentaires à ce qui est décrit ci-dessous (telles que vérifier la configuration de votre variable d'environnement %PATH%).

Langage Python & Environnement virtuel

Ce projet nécessite l'installation préalable des éléments suivants :

La rétro-compatibilité à Python 2.7 est temporairement maintenue.
Elle sera dépréciée au 1er janvier 2019.

Vérifiez alors que la version de python appelée par défaut débute bien par 3.7 :

python --version

Et installez les éventuelles mises à jour pour la gestion de paquets python avec :

sudo pip install --upgrade pip wheel

Ensuite, afin de créer un environnement de travail propre et pour vous permettre de faire cohabiter plusieurs contextes de travail en python, nous vous conseillons l'utilisation d'environnements virtuels, dits virtualenv. Il vous faut alors installer un gestionnaire de virtualenv python (tel que pew).

sudo pip install pew

Il vous est désormais possible de créer votre premier environnement dédié à OpenFisca-Tunisia. Nommons-le openfisca :

pew new openfisca --python=python3.7
# Si demandé, répondez "Y" à la question sur la modification du fichier de configuration de votre shell

Usage :

  • Vous pouvez sortir du virtualenv en tapant exit (ou Ctrl-D)
  • Vous pouvez le réactiver grâce à pew workon openfisca

Installation du module OpenFisca-Tunisia

Deux options s'offrent à vous :

  • Installer le module python pré-compilé dit wheel python
  • Ou, installer le code source

Installer la wheel

Installer le module pré-compilé d'OpenFisca-Tunisia vous permet d'interroger le modèle socio-fiscal tunisien.

Nous supposons que vous avez activé votre environnement virtuel.
Appliquez alors la commande suivante pour récupérer la wheel OpenFisca-Tunisia depuis la librairie de paquets Python pypi :

pip install openfisca-tunisia

🎉 Félicitations, vous avez désormais terminé l'installation d'OpenFisca Tunisia !

Vous pouvez vérifier sa présence dans votre environnement courant avec :

pip list
# Résultat attendu : Liste contenant OpenFisca-Tunisia et ses dépendances.

Installer le code source

Installer le code source d'OpenFisca-Tunisia sur votre ordinateur vous permet d'interroger ou de modifier le modèle socio-fiscal tunisien.

Nous supposons que vous avez activé votre environnement virtuel et que vous vous situez dans le répertoire où vous souhaitez placer le projet. Appliquez alors les commandes suivantes pour récupérer les sources d'OpenFisca-Tunisia et configurer le projet (sans omettre le point en fin de ligne 🙂) :

git clone https://github.com/openfisca/openfisca-tunisia.git
cd openfisca-tunisia
pip install -e .

🎉 Félicitations, vous avez désormais terminé l'installation d'OpenFisca Tunisia !

Vous pouvez vérifier que votre environnement fonctionne bien en démarrant les tests tel que décrit dans le paragraphe suivant.

Test

Nous supposons que vous êtes dans le répertoire openfisca-tunisia et que votre environnement virtuel est activé. Commencez par installer les outils de test avec :

pip install -e .[tests]

Différents formats de tests sont alors à votre disposition : la rédaction de tests est possible en python ou en yaml.

Test nose

Un test rédigé en python peut être exécuté avec l'outil nose. Celui-ci déroulera les fonctions python dont le nom commence par le mot test.

Ainsi, pour exécuter le test python tests/test_simple.py, utilisez la commande suivante :

nosetests tests/test_simple.py

Il vous est également possible de n'exécuter qu'un seul test d'un fichier. Dans l'exemple suivant, test_1_parent sera l'unique test déroulé du fichier tests/core_tests.py :

nosetests tests/core_tests.py:test_1_parent

Test yaml

Le format d'un test yaml est décrit dans la section YAML tests de la documentation officielle. Ainsi, si vous souhaitez exécuter le test yaml tests/formulas/irpp.yaml, utilisez la commande :

openfisca-run-test -c openfisca_tunisia tests/formulas/irpp.yaml

Afin de le tester avec un debugger, ajoutez un point d'arrêt dans le code python appelé par le test avec :

import nose.tools; nose.tools.set_trace(); import ipdb; ipdb.set_trace()

Et exécutez à nouveau le test yaml.

Tout tester

L'ensemble des tests et exemples définis dans OpenFisca-Tunisia peut être exécuté avec une commande. Néanmoins, cela nécessite l'installation de librairies complémentaires pour les exemples rédigés sous forme de notebooks Jupyter :

pip install -e .[notebook]

Le tout peut ensuite être démarré grâce à la commande suivante :

make test

Pour en savoir plus, voir la section Tests de la documentation officielle.

Web API

L'API est issue du dépôt GitHub du module central OpenFisca-Core.

Pour consulter sa version v0.13.0, il suffit d'interroger l'un de ses points d'entrée.
La liste des paramètres est par exemple consultable à l'adresse suivante :

www.openfisca.tn/api/v0.13.0/parameters

Pour en savoir plus, nous vous conseillons la lecture de sa documentation officielle.