feat: Support custom indictments and fully implement the ScoreExplana…

…tion and ScoreAnalysis API (#38)

- Choose to use properties for the ScoreExplanation and ScoreAnalysis
  API, to make its usage more Pythonic (as `a.b.c` is more Pythonic
  then `a.get_b().get_c()`

- Include missing methods in the AssertionError for the API check test

tests/test_collectors.py

@@ -60,15 +60,15 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(1)
+    assert score_manager.explain(problem).score == SimpleScore.of(1)
 
     entity_a.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(1)
+    assert score_manager.explain(problem).score == SimpleScore.of(1)
 
     entity_b.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
 
 def test_max():
@@ -93,15 +93,15 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(1)
+    assert score_manager.explain(problem).score == SimpleScore.of(1)
 
     entity_a.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
     entity_b.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
 
 def test_sum():
@@ -126,15 +126,15 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
     entity_a.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(3)
+    assert score_manager.explain(problem).score == SimpleScore.of(3)
 
     entity_b.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(4)
+    assert score_manager.explain(problem).score == SimpleScore.of(4)
 
 
 def test_average():
@@ -159,15 +159,15 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(10)
+    assert score_manager.explain(problem).score == SimpleScore.of(10)
 
     entity_a.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(15)
+    assert score_manager.explain(problem).score == SimpleScore.of(15)
 
     entity_b.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(20)
+    assert score_manager.explain(problem).score == SimpleScore.of(20)
 
 
 def test_count():
@@ -195,7 +195,7 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a2.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
 
 def test_count_distinct():
@@ -220,15 +220,15 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(1)
+    assert score_manager.explain(problem).score == SimpleScore.of(1)
 
     entity_b.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
     entity_a.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(1)
+    assert score_manager.explain(problem).score == SimpleScore.of(1)
 
 
 def test_to_consecutive_sequences():
@@ -271,23 +271,23 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_d.value = value_7
     entity_e.value = value_9
 
-    assert score_manager.explain(problem).get_score().score() == 5
+    assert score_manager.explain(problem).score.score() == 5
 
     entity_a.value = value_1
     entity_b.value = value_2
     entity_c.value = value_3
     entity_d.value = value_4
     entity_e.value = value_5
 
-    assert score_manager.explain(problem).get_score().score() == 25
+    assert score_manager.explain(problem).score.score() == 25
 
     entity_a.value = value_1
     entity_b.value = value_2
     entity_c.value = value_3
     entity_d.value = value_5
     entity_e.value = value_6
 
-    assert score_manager.explain(problem).get_score().score() == 13
+    assert score_manager.explain(problem).score.score() == 13
 
 
 def test_to_list():
@@ -312,15 +312,15 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
     entity_b.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
     entity_a.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
 
 def test_to_set():
@@ -345,15 +345,15 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(1)
+    assert score_manager.explain(problem).score == SimpleScore.of(1)
 
     entity_b.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
     entity_a.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(1)
+    assert score_manager.explain(problem).score == SimpleScore.of(1)
 
 
 def test_to_map():
@@ -379,15 +379,15 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(1)
+    assert score_manager.explain(problem).score == SimpleScore.of(1)
 
     entity_b.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
     entity_a.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(0)
+    assert score_manager.explain(problem).score == SimpleScore.of(0)
 
 
 def test_to_sorted_set():
@@ -412,15 +412,15 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(1)
+    assert score_manager.explain(problem).score == SimpleScore.of(1)
 
     entity_b.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(1)
+    assert score_manager.explain(problem).score == SimpleScore.of(1)
 
     entity_a.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
 
 def test_to_sorted_map():
@@ -447,19 +447,19 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(1)
+    assert score_manager.explain(problem).score == SimpleScore.of(1)
 
     entity_b.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(0)
+    assert score_manager.explain(problem).score == SimpleScore.of(0)
 
     entity_a.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(0)
+    assert score_manager.explain(problem).score == SimpleScore.of(0)
 
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
 
 def test_conditionally():
@@ -487,7 +487,7 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a2.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
 
 def test_compose():
@@ -517,15 +517,15 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(11)
+    assert score_manager.explain(problem).score == SimpleScore.of(11)
 
     entity_a.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(21)
+    assert score_manager.explain(problem).score == SimpleScore.of(21)
 
     entity_b.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(22)
+    assert score_manager.explain(problem).score == SimpleScore.of(22)
 
 
 def test_collect_and_then():
@@ -553,15 +553,15 @@ def define_constraints(constraint_factory: ConstraintFactory):
     entity_a.value = value_1
     entity_b.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
     entity_a.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(2)
+    assert score_manager.explain(problem).score == SimpleScore.of(2)
 
     entity_b.value = value_2
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(4)
+    assert score_manager.explain(problem).score == SimpleScore.of(4)
 
 
 def test_flatten_last():
@@ -584,4 +584,4 @@ def define_constraints(constraint_factory: ConstraintFactory):
     problem = Solution([entity_a], [value_1])
     entity_a.value = value_1
 
-    assert score_manager.explain(problem).get_score() == SimpleScore.of(3)
+    assert score_manager.explain(problem).score == SimpleScore.of(3)