Openfisca-core

New features

Add tracing to get details about all the intermediate calculations of a simulation

- Introduce new Web API route `/trace` to get a simulation's detailed calculation steps
- See the [swagger documentation for OpenFisca-France](https://legislation.openfisca.fr/swagger)

- Introduce `simulation.tracer.print_computation_log` to print a simulation's detailed calculation steps
- This is available if the `trace` argument has been set to `True` in the `Simulation` constructor.
- See the [reference documentation](https://openfisca.readthedocs.io/en/latest/tracer.html) about the tracer.

_Warning: Both of these features are still currently under experimentation. You are very welcome to use them and send us precious feedback, but keep in mind that the way they are used and the results they give might change without any major version bump._

Breaking changes

- Deprecate and remove:
- `simulation.traceback`
- `simulation.stack_trace`
- `simulation.find_traceback_step`
- `simulation.stringify_input_variables_infos`
- `simulation.stringify_variable_for_period_with_array`

- Remove argument `debug_all` from:
- `Scenario.new_simulation` method
- `Simulation` constructor

- Add the possibility to track API visitor's IP

- Enable to calculate parameters according to a variable

For instance, if a parameter `rate` depends on a variable `zone` that can take the values `z1` or `z2`:

In `rate.yaml`:


z1:
values:
'2015-01-01':
value: 100
z2:
values:
'2015-01-01':
value: 200


Then it is now possible to use:


zone = household('zone', period)
rate = parameters(period).rate[zone]



For more information, check the [documentation](https://openfisca.org/doc/coding-the-legislation/legislation_parameters.html#computing-a-parameter-that-depends-on-a-variable-fancy-indexing)

- Fix migration script `xml_to_yaml.py`
- The attributes `reference` of nodes `END`, `VALUE`, `PLACEHOLDER`, `BAREME`, `TRANCHE`, `ASSIETTE`, `TAUX`, `MONTANT`, `SEUIL` were not parsed. Now they are parsed to YAML.

- Reference the new address of the documentation

- Allow to document entities and entities roles
- Add attribute `Entity.doc` (e.g. `Household.doc`)
- Add attribute `Role.doc` (e.g. `Household.CHILD.doc`)