ScoreAnalysis.summary() for debugging purposes

[ge0ffrey]

During POC work it's very handy to be able to drop a score analysis in System.out.print().

ScoreExplanation has this, with the getSummary() method. It shows all constraints and the top 3 constraint matches per constraint.

Why only top 3 matches? In practice during debugging you need to know the first match often, to be able to prove the constraint is there with one match. But the other 297 matches are verbosity that kills the usefulness of getSummary() for debugging purposes. So top 3 is ideal.

If matches weren't fetched, no matches are shown in summary().

• [x] ScoreAnalysis summary() and/or toString()
• [x] ConstraintAnalysis toString()
• [x] Docs showing a score analysis summary like for ScoreExplenation

[ge0ffrey]

ScoreAnalysis should probably also get a toString() method.

Separate issue for @Christopher-Chianelli : enable this in python land too (if it doesn't happen automatically :)

print(score_analysis) <timefold.solver.score._score_analysis.ScoreAnalysis object at 0x3614cba10>