OR and AND documentation incomplete

[harelGrinzaid]

Documentation

It is not explained that the operators OR and AND can be used for conditional assignment of variables and stuff like that.

If someone is not aware of that behaviour, it might cause bugs in their code when they try to use them thinking that the operators work similarly to MULTIPLICATION and ADDITION in BOOLEAN ALGEBRA.

[harelGrinzaid]

Just to explain what I mean:

Thinking OR works like ADDITION in BOOLEAN ALGEBRA, you would expect for X in this expression to equal True:

X = 5 or True

Because 5 is truefy, but X is equal to 5.

And similarly with AND, you would expect for X in this expression to equal False:

X = False and 5

[harelGrinzaid]

In addition to that, I don't know if the behaviour that I described is intentional. but if it is intentional, maybe there should be two more logical operators; BOOLEAN_OR and BOOLEAN_AND that work exactly like they should according to BOOLEAN ALGEBRA.

[StanFromIreland]

This is documented in the Boolean operations section.

[skirpichev]

Thinking OR works like ADDITION in BOOLEAN ALGEBRA

Sorry, sometimes you must read documentation.

you would expect for X in this expression to equal True:
X = 5 or True

From referenced docs:

The expression x or y first evaluates x; if x is true, its value is returned [...]

And similarly with AND, you would expect for X in this expression to equal False:
X = False and 5

It is False. From docs, again:

The expression x and y first evaluates x; if x is false, its value is returned [...]

I don't know if the behaviour that I described is intentional.

Sure, it is.

maybe there should be two more logical operators; BOOLEAN_OR and BOOLEAN_AND that work exactly like they should according to BOOLEAN ALGEBRA.

They already works in this way, please just learn:

In the context of Boolean operations, and also when expressions are used by control flow statements, the following values are interpreted as false: False, None, numeric zero of all types, and empty strings and containers (including strings, tuples, lists, dictionaries, sets and frozensets). All other values are interpreted as true.