Skip to content

Latest commit

 

History

History
116 lines (82 loc) · 4.38 KB

README.md

File metadata and controls

116 lines (82 loc) · 4.38 KB

Reform Simulator

Reform Simulator démo

[EN] Introduction

Reform simulator is a UI to simply and quickly simulate the impact of tax-benefit reforms on indivuduals.

This proof-of-concept is the resulting team's work during the #datafin hackathon. The challenge was called "Simule ta reforme" There is a [live demo] of the application.

[FR] Introduction

Reform simulator est une interface graphique simple et rapide qui permet d’évaluer l’impact des réformes au système socio-fiscal

This proof-of-concept is the resulting team's work during the #datafin hackathon. The challenge was called "Simule ta reforme" There is a [live demo] of the application.

Installation

Ce paquet requiert Python 2.7 et pip.

Plateformes supportées :

  • distributions GNU/Linux (en particulier Debian and Ubuntu) ;
  • Mac OS X ;
  • Windows (nous recommandons d'utiliser ConEmu à la place de la console par défaut) ;

Pour les autres OS : si vous pouvez exécuter Python et Numpy, cela devrait fonctionner.

Installez un environnement virtuel avec Pew

Nous recommandons l'utilisation d'un environnement virtuel (virtualenv) avec un gestionnaire de virtualenv tel que Pew.

  • Un virtualenv crée un environnement pour les besoins spécifiques du projet sur lequel vous travaillez.
  • Un gestionnaire de virtualenv, tel que Pew, vous permet de facilement créer, supprimer et naviguer entre différents projets.

Pour installer Pew, lancez une fenêtre de terminal et suivez ces instructions :

python --version # Python 2.7.9 ou plus récent devrait être installé sur votre ordinateur.
# Si non, téléchargez-le sur http://www.python.org et téléchargez pip.
pip install --upgrade pip
pip install pew

Créez un nouveau virtualenv nommé reform-simulator et configurez-le avec python2.7 :

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

Le  virtualenv  openfisca sera alors activé, c'est-à-dire que les commandes suivantes s'exécuteront directement dans l'environnement virtuel. Vous verrez dans votre terminal :

Installing setuptools, pip, wheel...done.
Launching subshell in virtual environment. Type 'exit' or 'Ctrl+D' to return.

Informations complémentaires :

  • sortez du virtualenv en tapant exit (or Ctrl-D) ;
  • re-rentrez en tapant pew workon openfisca dans votre terminal.

🎉 Vous êtes prêt·e à installer Reform Simulator !

Installez Reform Simulator

Premièrement, assurez-vous que Git est bien installé sur votre machine.

Dans votre virtualenv, assurez-vous que vous êtes dans le répertoire où vous souhaitez cloner Reform Simulator.

Vérifiez les pré-requis :

python --version  # Devrait afficher "Python 2.7.xx".
#Si non, vérifiez que vous passez --python=python2.7 lors de la création de votre environnement virtuel.
pip --version  # Devrait afficher au moins 9.0.
#Si non, exécutez "pip install --upgrade pip".

Clonez Reform Simulator sur votre machine :

git clone https://github.com/openfisca/reform-simulator.git
cd reform-simulator
make install

🎉 Reform Simulator est prêt à être utilisé !

Utilisation

Pour faire tourner l'application :

make

Et visitez http://localhost:8000 à l'aide de votre navigateur.

Contributeurs

Voir la liste des contributeurs.

Un gros remerciement à l'équipe du hackathon :