Documentation for functions and operations?

[lianyu]

I’m reading a lot about the changes in functions such as ‘float’ that now require a default be specified for returning when that function cannot convert a value.
In previous versions of Home Assistant, float (for example) would default to 0 (zero) if it could not convert an input to floating point. Now the default must be specified as a parameter of float:
float(0) # default to 0 if cannot convert

My question is: Where is this documented?
The pages I find within Home Assistant like this one (templating), refer to the JinJa2 templating engine:

Templating

However, in that web sites documentation, it clearly states that float automatically default to 0 if the value cannot be converted:
https://jinja.palletsprojects.com/en/3.0.x/templates/#jinja-filters.float

Note the current version of JinJa is 3.0. The HomeAssistant page above mentions JenJa2 but points to ‘JinJa’ documentation (not JinJa2).
Is there a difference between JinJa and JinJa2? If so:
Where is JinJa2 documented?
Why does home assistant point to JinJa?
Why does the JinJa documentation contradict Home Assistant forum threads that state functions like float now required a specified default?
Where is the correct documentation for the version of JinJa/JinJa2 that Home Assistant is using which requires defaults for these functions?

Thank you.

Template warning: 'float' got invalid input 'unknown' when rendering template

hi, I have a sensor that monitors the consumption of two pzem: consumo_totale_watts: friendly_name: "Consumo totale Watts" value_template: "{{ states('sensor.pzem_016_energy_power') | float + states('sensor.pzem_016_2_energy_power') | float }}" unit_of_measurement: 'W' in the logs i can see: **Template warning: 'float' got invalid input 'unknown' when rendering template '{{ states('sensor.pzem_016_energy_power') | float + states('sensor.pzem_016_2_energy_power') | float…

P.S. The documentation that Home Asstant Templating web page points to is for a Development version of Jina (not the 3.0 stable version), yet it still states that functions like float will default to 0 and do not require a default be specified, if the value cannot be converted:
https://jinja.palletsprojects.com/en/latest/templates/#jinja-filters.float

[123 (Taras)]

@lianyu

the default must be specified as a parameter of float:
float(0) # default to 0 if cannot convert

My question is: Where is this documented?

Here:

[lianyu]

No. You didn’t read my post.
It now DOES NOT return 0 if no default given and it cannot convert. You MUST specify a Default value.

Sorry, but you fell into the same document abyss that I did: The documentation does not match the new functionality.

[123 (Taras)]

@lianyu

The documentation does not match the new functionality.

Home Assistant is a collaborative open-source project and its documentation is maintained by users. If you believe it needs correction, you are free to make them.

At the bottom of every page in the documentation is a Edit link. For more information, here’s a helpful guide:

Editing the Documentation and Creating a Pull Request on Github

I have seen a number of people complain about the documentation at https://home-assistant.io/ (HA site). Great news! Everyone can edit it and provide improvements to the documentation. Next thing I likely see is that people don’t know how to create a pull request on Github. Great news! Here is a tutorial on how to do it. First go to https://github.com/ and sign up for an account. Its quick free and easy. If there is a need for a tutorial for this too, please post that feedback below. O…

[tom_l]

Home assistant uses jinja for templating but has modified it to better suit our needs. This is one of those instances. There are others, like some filters and functions that differ. The Home Assistant documentation should be followed in these cases.

[finity]

@tom_l

The Home Assistant documentation should be followed in these cases.

I think the point was that the HA documentation is wrong.

it hasn’t been updated to include the new default requirements.

[DvdNwk]

@tom_l

Home assistant uses jinja for templating but has modified it to better suit our needs.

Good to know

@tom_l

There are others, like some filters and functions that differ.

Can you give more examples of differences? I’d like to expand the docs to include that information.

[DvdNwk]

@lianyu

Note the current version of JinJa is 3.0. The HomeAssistant page above mentions JenJa2 but points to ‘JinJa’ documentation (not JinJa2).

Yep, it is confusing, IMHO needs to be fixed.