The recommended way to write tests is to use YAML tests.
Each formula should be tested at least with one test, and better with specific boundary values (thresholds for example).
Terminology: Python dictionnary are called associative arrays in YAML.
In irpp.yaml
we see:
- name: "IRPP - Célibataire ayant des revenus salariaux (1AJ) de 20 000 €"
period: 2012
absolute_error_margin: 0.5
input_variables:
salaire_imposable: 20000
output_variables:
irpp: -1181
name
(string)period
(string with period syntax)keywords
(list of strings, optional)description
(string, optional, multiline)absolute_error_margin
(number, optional)relative_error_margin
(number, optional)input_variables
(associative array, keys are variable names, values are numbers)output_variables
(associative array, keys are variable names, values are numbers)This is the simplest way to test formulas when you only need to give input values for only one individual.
-
, which is the YAML list separator, followed by a space, the field name
, and the test name as a string.- name: "IRPP - Célibataire ayant des revenus salariaux (1AJ) de 20 000 €"
period
, keywords
, description
, absolute_error_margin
(or relative_error_margin
) and their associated chosen values as follows:- name: "IRPP - Célibataire ayant des revenus salariaux (1AJ) de 20 000 €"
period: 2012
absolute_error_margin: 0.5
input_variables
and output_variables
,
which keys are variable names and values are numbers, respectively input and expected values.
For instance:- name: "IRPP - Célibataire ayant des revenus salariaux (1AJ) de 20 000 €"
period: 2012
absolute_error_margin: 0.5
input_variables:
salaire_imposable: 20000
salaire_brut: 20000
output_variables:
irpp: -1181
This is the simplest way to test formulas when you need to give input values for many individuals which are dispatched into entities.
See the last test of cotisations_sociales_simulateur_IPP.yaml
In this case, there is another convention:
do not include the field input_variables
but instead define new keys corresponding to the entities:
- name: "IRPP - Famille ayant des revenus salariaux de 20 000 €"
period: 2012
absolute_error_margin: 0.5
familles:
menages:
foyers_fiscaux:
define the individuals with their id
and their variables:
individus:
- id: "parent1"
date_naissance: 1972-01-01
depcom_entreprise: "69381"
primes_fonction_publique: 500
- id: "parent2"
date_naissance: 1972-01-01
depcom_entreprise: "69381"
primes_fonction_publique: 500
traitement_indiciaire_brut: 2000
- id: "enfant1"
date_naissance: 2000-01-01
- id: "enfant2"
date_naissance: 2009-01-01
specify the relations between individuals and their entity:
familles:
parents: ["parent1", "parent2"]
enfants: ["enfant1", "enfant2"]
menages:
personne_de_reference: "parent1"
conjoint: "parent2"
enfants: ["enfant1", "enfant2"]
foyers_fiscaux:
declarants: ["parent1", "parent2"]
personnes_a_charge: ["enfant1", "enfant2"]
finally, define a dictionnary of the expected values of the output variables. Each output variable takes a list of length equal to the number of individuals defined in the test. E.g, for a family of four individuals with two working parents and two unemployed children, the output variable salaire_super_brut is defined as follows:
output_variables:
salaire_super_brut: [3500, 2500, 0, 0]
Input or output variables can be defined for multiple periods by giving an associated array which keys are a period expression and values are the value for that period.
Values can be arithmetic expressions too.
individus:
salaire_de_base:
2013-01: 35 * 52 / 12 * 9
2013-02: 35 * 52 / 12 * 9
2013-03: 35 * 52 / 12 * 9
To run YAML tests, use the command line tool openfisca-run-test
, documented here:
openfisca-run-test path/to/file.yaml
You can also run tests programatically using thetest_runner
module.
Other kinds of tests exist, see contribute/tests.