https://github.com/openfisca/openfisca-france-local
Extension OpenFisca pour nos partenariats avec les collectivités territoriales
https://github.com/openfisca/openfisca-france-local
Last synced: 5 months ago
JSON representation
Extension OpenFisca pour nos partenariats avec les collectivités territoriales
- Host: GitHub
- URL: https://github.com/openfisca/openfisca-france-local
- Owner: openfisca
- License: agpl-3.0
- Created: 2018-09-12T12:48:04.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2026-01-21T10:29:00.000Z (5 months ago)
- Last Synced: 2026-01-21T21:27:01.366Z (5 months ago)
- Language: Python
- Homepage:
- Size: 4.39 MB
- Stars: 3
- Watchers: 14
- Forks: 10
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Extension OpenFisca pour nos partenariats avec les collectivités territoriales
[](https://gitpod-referer.now.sh/api/gitpod-referer-redirect)
## Introduction
[OpenFisca](https://www.openfisca.fr/) est un logiciel libre de micro-simulation. Ce dépôt contient la modélisation des aides locales françaises. Celles-ci enrichissent le modèle national de la France, [openfisca-france](https://github.com/openfisca/openfisca-france#openfisca-france).
Pour plus d'information sur les fonctionnalités et la manière d'utiliser OpenFisca, vous pouvez consulter la [documentation générale](https://openfisca.org/doc/).
## Installation
Ce paquet requiert [Python 3.9 ou supérieur](https://www.python.org/downloads/) et [pip](https://pip.pypa.io/en/stable/installation/).
Afin d'installer l'extension `openfisca-france-local`, lancez une fenêtre de terminal et suivez les instructions suivantes pour en récupérer le code source :
```shell
git clone git@github.com:openfisca/openfisca-france-local.git
```
Puis, pour se rendre dans ce dossier `openfisca-france-local`
```shell
cd openfisca-france-local
```
Il y a plusieurs moyens de gérer ses environements (venv, docker, etc...) pour ne pas polluer son environement ou celui d'autres projets, voici une proposition avec `venv` :
```shell
python -m venv .venv # Creation de l'environement
source .venv/bin/activate # Activation de l'environement
```
Installation d'`openfisca-france-local` :
```shell
make install
```
### Lancement des tests
#### Tester le bon fonctionnement d'OpenFisca
Une fois l'installation terminée, vous devriez pouvoir la tester avec les commandes suivantes :
```shell
openfisca test tests/test_dispositif.yml --country-package openfisca_france --extension openfisca_france_local
```
Ou plus simplement :
```shell
openfisca_local_test tests/test_dispositif.yml
```
Ceci exécute un test `test_dispositif.yml` faisant appel au module `openfisca_france_local`. Vous devriez obtenir un résultat se terminant par `1 passed in 0.0xs` tel que dans cet exemple :
```shell
=================== test session starts ===================
platform linux -- Python 3.9.5, pytest-7.4.0, pluggy-1.2.0
rootdir: /home/user/dev/Aides-Jeunes/repos/openfisca-france-local
collected 2 items
tests/test_dispositif.yml ..
==================== 1 passed in 0.01s ====================
```
:tada: openfisca-france-local est prêt à être utilisé !
#### Lancer les tests :
Pour lancer tous les tests, vous pouvez utiliser :
```shell
make test
```
Pour lancer un dossier ou fichier de test spécifique : |
```shell
openfisca_local_test tests/Chemin/Vers/Dossier-fichier/cible
```
### Rédaction des formules et tests
Vous trouverez un exemple d'aide dans le fichier [communes/alfortville/noel_enfants.py](https://github.com/betagouv/openfisca-france-local/blob/master/openfisca_france_local/communes/alfortville/noel_enfants.py#L57-L71), ainsi que le fichier de tests associé, [tests/communes/alfortville/noel_enfants.yml](https://github.com/betagouv/openfisca-france-local/blob/master/tests/communes/alfortville/noel_enfants.yml#L50-L56). Les paramètres nécessaires au calcul se trouvent quant à eux dans le fichier [openfisca_france_local/parameters/communes/alfortville.yml](https://github.com/betagouv/openfisca-france-local/blob/master/openfisca_france_local/parameters/communes/alfortville.yml).
Pour ajouter des formules et tests, créez simplement des fichiers .py et .yml à l'intérieur du répertoire.