chess engine analysis more human readable

[sugizo]

generated by python-chess module

generated by stockfish python module

nice to make the chess engine analysis more human readable like stockfish python module

also, not sure about :
cp = centipawn ??

povscore (is it point of view ? )
and
pv (is it pricinipal variation or predicted variation)

ref
https://www.chessprogramming.org/Principal_Variation
https://www.chessprogramming.org/Extended_Position_Description#Opcode_mnemonics

thanks and best regards

[niklasf]

PovScore(Cp(+18), WHITE) is a debug representation for developers, showing exactly the composition of the given object. The purpose of PovScore is indeed to encourage correctly handling the point of view. When trying to access the inner Score, a concusious choice about the point of view has to be made.

For example, you could use pov_score.white() to always take White's point of view.

>>> import chess.engine

>>> pov_score = chess.engine.PovScore(chess.engine.Cp(+18), chess.WHITE)
>>> pov_score
PovScore(Cp(+18), WHITE)
>>> pov_score.white()
Cp(+18)
>>> str(pov_score.white())  # Get a nice string representation for humans
'+18'

>>> pov_score = chess.engine.PovScore(chess.engine.Mate(3), chess.BLACK)
>>> pov_score
PovScore(Mate(+3), BLACK)
>>> pov_score.white()
Mate(-3)
>>> str(pov_score.white())
'#-3'