OpenFisca-France-Local 6.14.0__tar.gz → 6.14.1__tar.gz

{openfisca_france_local-6.14.0 → openfisca_france_local-6.14.1}/OpenFisca_France_Local.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: OpenFisca-France-Local
-Version: 6.14.0
+Version: 6.14.1
 Summary: Extension OpenFisca pour nos partenariats avec les collectivités territoriales
 Home-page: https://github.com/openfisca/openfisca-france-local
 Author: OpenFisca Team

{openfisca_france_local-6.14.0 → openfisca_france_local-6.14.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: OpenFisca-France-Local
-Version: 6.14.0
+Version: 6.14.1
 Summary: Extension OpenFisca pour nos partenariats avec les collectivités territoriales
 Home-page: https://github.com/openfisca/openfisca-france-local
 Author: OpenFisca Team

{openfisca_france_local-6.14.0 → openfisca_france_local-6.14.1}/openfisca_france_local/aides_jeunes_reform.py

@@ -284,6 +284,9 @@ ProfileEvaluator = collections.namedtuple(
 
 
 def build_condition_evaluator_list(conditions: 'list[dict]') -> 'list[ConditionEvaluator]':
+    """
+        Établit une correspondance entre les conditions et les fonctions qui évaluent ces conditions.
+    """
     try:
         evaluators: 'list[ConditionEvaluator]' = [
             ConditionEvaluator(condition, condition_table[condition['type']])
@@ -296,6 +299,9 @@ def build_condition_evaluator_list(conditions: 'list[dict]') -> 'list[ConditionE
 
 
 def build_profil_evaluator(profil: dict) -> ProfileEvaluator:
+    """
+        Associe un test d'éligibilité au profil et pour chacune de ses conditions.
+    """
     try:
         predicate = profil_table[profil['type']]
     except KeyError:
@@ -334,6 +340,12 @@ def eval_profil(profil_evaluator: ProfileEvaluator,
 
 
 def generate_variable(benefit: dict):
+    """
+        Créé la variable qui va être intégrée dans le TaxAndBenefitSystem.
+
+        Génère une `Variable` Openfisca dont le type est la formule correspondent
+        aux données du dictionaire source issue d'un fichier `YAML`.
+    """
     variable_name: str = benefit['slug']
     amount = benefit.get('montant')
 
@@ -379,6 +391,21 @@ default_institutions_path = 'test_data/institutions'
 
 
 class aides_jeunes_reform_dynamic(reforms.Reform):
+    """
+        Cette réforme n'est pas une réforme au sens légal du terme.
+
+        La réforme ici présente est utilisée pour lire des fichiers `YAML`
+        qui modélisent des dispositifs d'aides sociales avec des conditions simples
+        de manière à les intégrer dans une instance Openfisca.
+
+        Pour utiliser la réforme, il faut :
+            - Définir le chemin des dossiers qui contiennent
+            les aides et les institutions avec les variables d'environement
+            `DYNAMIC_BENEFIT_FOLDER` et `DYNAMIC_INSTITUTION_FOLDER`
+            - Lancer Openfisca en appelant la réforme :
+                `--reform openfisca_france_local.aides_jeunes_reform.aides_jeunes_reform_dynamic`
+    """
+
     def __init__(self, baseline, benefits_folder_path=default_benefit_path, institutions_folder_path=default_institutions_path):
         self.benefits_folder_path = getenv('DYNAMIC_BENEFIT_FOLDER', benefits_folder_path)
         self.institutions_folder_path = getenv('DYNAMIC_INSTITUTION_FOLDER', institutions_folder_path)
@@ -403,12 +430,30 @@ class aides_jeunes_reform_dynamic(reforms.Reform):
 
     def _extract_benefit_file_content(self, benefit_path: str):
         def _convert_institution_to_condition(benefit: dict) -> dict:
+            """
+                Si le fichier `YAML` traité contient une condition de type `attached_to_institution`,
+                un traitement est nécessaire car les modalités de cette condition ne sont pas précisées
+                dans le fichier en question.
+
+                Cette condition est une condition géographique.
+
+                Il faut aller récupérer les informations liées à l'institution en question
+                dans un fichier qui modélise l'institution correspondante pour ensuite ajouter
+                une condition géographique équivalente.
+
+                Il existe 4 type de condition géographique :
+                `msa`, `caf`, `epci`, `regions`, `departements` et `communes`.
+            """
             if {'type': 'attached_to_institution'} in benefit['conditions_generales']:
                 conditions_generales_without_attached_institution = [
                     condition for condition
                     in benefit['conditions_generales']
                     if condition != {'type': 'attached_to_institution'}]
 
+                # /!\ Pas de mise en cache faite ici. Si deux fichiers font appel à la même institution,
+                # le fichier de l'institution en question sera ouvert 2 fois.
+                # Si un jour la condition `attached_to_institution` venait à être utilisée de manière
+                # intensive, il pourrait être intéressant d'implanter un cache ici
                 with open(f'{self.institutions_folder_path}/{benefit["institution"]}.yml') as file:
                     institution: dict = yaml.safe_load(file)
 
@@ -429,6 +474,13 @@ class aides_jeunes_reform_dynamic(reforms.Reform):
             return benefit
 
         def _slug_from_path(path: str):
+            """
+                Pour créer une nouvelle variable Openfisca, il est necessaire
+                de lui donner un nom qui respecte la syntaxe d'une variable Python.
+
+                Cette méthode utilise le nom du fichier pour déterminer
+                un nom de variable compatible.
+            """
             return path.split('/')[-1].replace('-', '_').split('.')[0]
 
         with open(benefit_path) as file:

{openfisca_france_local-6.14.0 → openfisca_france_local-6.14.1}/setup.py

@@ -3,7 +3,7 @@ from setuptools import setup, find_namespace_packages
 
 setup(
     name='OpenFisca-France-Local',
-    version='6.14.0',
+    version='6.14.1',
     author='OpenFisca Team',
     author_email='contact@openfisca.fr',
     classifiers=[