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

{openfisca_france_local-6.13.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.13.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.13.0 → openfisca_france_local-6.14.1}/OpenFisca_France_Local.egg-info/SOURCES.txt

@@ -31,6 +31,8 @@ openfisca_france_local/communes/illkirch_graffenstaden/base.py
 openfisca_france_local/communes/iwuy/aide_permis.py
 openfisca_france_local/communes/le_cateau/aide_permis.py
 openfisca_france_local/communes/les_rues_des_vignes/aide_permis.py
+openfisca_france_local/communes/montpellier/eligibilite.py
+openfisca_france_local/communes/montpellier/montpellier_mutuelle_communale.py
 openfisca_france_local/communes/nantes/aide_carte_blanche.py
 openfisca_france_local/communes/saint_louis/eligibilite.py
 openfisca_france_local/departements/cotes_d_armor/eligibilite.py
@@ -200,6 +202,7 @@ tests/communes/carcassonne/aide_permis.yaml
 tests/communes/iwuy/aide_permis.yml
 tests/communes/le_cateau/aide_permis.yml
 tests/communes/les_rues_des_vignes/aide_permis.yml
+tests/communes/montpellier/montpellier_mutuelle_communale.yml
 tests/communes/nantes/aide_carte_blanche.yml
 tests/departements/cotes_d_armor/base_ressource.yml
 tests/departements/cotes_d_armor/eligibilite.yml

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: OpenFisca-France-Local
-Version: 6.13.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.13.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.1/openfisca_france_local/communes/montpellier/eligibilite.py

@@ -0,0 +1,10 @@
+from openfisca_france.model.base import Menage, MONTH, Variable
+
+class montpellier_eligibilite_residence(Variable):
+    value_type = bool
+    entity = Menage
+    definition_period = MONTH
+    label = "Éligibilité résidentielle d'un ménage aux dipositifs de Montpellier"
+
+    def formula(menage, period):
+        return menage('depcom', period) == b'34172'

openfisca_france_local-6.14.1/openfisca_france_local/communes/montpellier/montpellier_mutuelle_communale.py

@@ -0,0 +1,17 @@
+from openfisca_france.model.base import Variable, MONTH, not_, Famille
+
+class montpellier_mutuelle_communale(Variable):
+    value_type = bool
+    entity = Famille
+    definition_period = MONTH
+    label = "Mutuelle communale de la ville de Montpellier"
+    reference = [
+        "https://www.montpellier.fr/4884-mutuelle-communale.htm"
+        ]
+
+    def formula(famille, period):
+        eligibilite_residentielle = famille.demandeur.menage('montpellier_eligibilite_residence', period)
+        css_participation_forfaitaire = famille('css_participation_forfaitaire', period)
+        cmu_c = famille('cmu_c', period)
+        eligibilite_css_cmu_c = (css_participation_forfaitaire > 0) | cmu_c
+        return eligibilite_residentielle * not_(eligibilite_css_cmu_c)

{openfisca_france_local-6.13.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.13.0',
+    version='6.14.1',
     author='OpenFisca Team',
     author_email='contact@openfisca.fr',
     classifiers=[

openfisca_france_local-6.14.1/tests/communes/montpellier/montpellier_mutuelle_communale.yml

@@ -0,0 +1,8 @@
+- name: "Égibilité à la mutuelle communale de Montpellier"
+  period: 2024-10
+  input:
+    depcom: ["34172","34172", "34172", "68400", "68400"]
+    css_participation_forfaitaire_montant: [0, 0, 20, 25, 30]
+    cmu_c: [False, True, False, False, False]
+  output:
+    montpellier_mutuelle_communale: [True, False, False, False, False]