start_backtracking suggestion

src/resolvelib/reporters.py

@@ -30,8 +30,9 @@ def adding_requirement(self, requirement, parent):
             requirements passed in from ``Resolver.resolve()``.
         """
 
-    def start_backtracking(self, causes):
-        """Called when backtracking started because of collision in requirements
+    def resolving_conflicts(self, causes):
+        """Called when a collision in requirements was detected and
+        an attempt to resolve them was started
 
         :param causes: The information on the collision that caused the backtracking.
         """

src/resolvelib/reporters.pyi

@@ -7,5 +7,5 @@ class BaseReporter:
     def ending(self, state: Any) -> Any: ...
     def adding_requirement(self, requirement: Any, parent: Any) -> Any: ...
     def backtracking(self, candidate: Any) -> Any: ...
-    def start_backtracking(self, causes: Any) -> Any: ...
+    def resolving_conflicts(self, causes: Any) -> Any: ...
     def pinning(self, candidate: Any) -> Any: ...

src/resolvelib/resolvers.py

@@ -369,7 +369,7 @@ def resolve(self, requirements, max_rounds):
                 causes = [i for c in failure_causes for i in c.information]
                 # Backtrack if pinning fails. The backtrack process puts us in
                 # an unpinned state, so we can work on it in the next round.
-                self._r.start_backtracking(causes)
+                self._r.resolving_conflicts(causes)
                 success = self._backtrack()
 
                 # Dead ends everywhere. Give up.

tests/test_resolvers.py

@@ -94,7 +94,7 @@ def is_satisfied_by(self, requirement, candidate):
     assert result.mapping["child"] == ("child", "1", [])
 
 
-def test_start_backtracking():
+def test_resolving_conflicts():
     all_candidates = {
         "a": [("a", 1, [("q", {1})]), ("a", 2, [("q", {2})])],
         "b": [("b", 1, [("q", {1})])],
@@ -105,7 +105,7 @@ class Reporter(BaseReporter):
         def __init__(self):
             self.backtracking_causes = None
 
-        def start_backtracking(self, failure_causes):
+        def resolving_conflicts(self, failure_causes):
             self.backtracking_causes = failure_causes
 
     class Provider(AbstractProvider):