[yul-phaser] Extract the code that controls execution of algorithm rounds from GeneticAlgorithm into AlgorithmRunner

tools/yulPhaser/AlgorithmRunner.h

@@ -0,0 +1,58 @@
+/*
+	This file is part of solidity.
+
+	solidity is free software: you can redistribute it and/or modify
+	it under the terms of the GNU General Public License as published by
+	the Free Software Foundation, either version 3 of the License, or
+	(at your option) any later version.
+
+	solidity is distributed in the hope that it will be useful,
+	but WITHOUT ANY WARRANTY; without even the implied warranty of
+	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+	GNU General Public License for more details.
+
+	You should have received a copy of the GNU General Public License
+	along with solidity.  If not, see <http://www.gnu.org/licenses/>.
+*/
+/**
+ * Contains the implementation of a class that manages the execution of a genetic algorithm.
+ */
+
+#pragma once
+
+#include <tools/yulPhaser/GeneticAlgorithms.h>
+#include <tools/yulPhaser/Population.h>
+
+#include <optional>
+#include <ostream>
+
+namespace solidity::phaser
+{
+
+/**
+ * Manages a population and executes a genetic algorithm on it. It's independent of the
+ * implementation details of a specific algorithm which is pluggable via @a GeneticAlgorithm class.
+ *
+ * The class is also responsible for providing text feedback on the execution of the algorithm
+ * to the associated output stream.
+ */
+class AlgorithmRunner
+{
+public:
+	AlgorithmRunner(
+		Population _initialPopulation,
+		std::ostream& _outputStream
+	):
+		m_population(std::move(_initialPopulation)),
+		m_outputStream(_outputStream) {}
+
+	void run(GeneticAlgorithm& _algorithm, std::optional<size_t> _numRounds = std::nullopt);
+
+	Population const& population() const { return m_population; }
+
+private:
+	Population m_population;
+	std::ostream& m_outputStream;
+};
+
+}