From 0c3bef6df74c6381ad7e9b6c4478e31421fad43a Mon Sep 17 00:00:00 2001
From: Tim Holy <tim.holy@gmail.com>
Date: Wed, 30 Apr 2025 08:06:46 -0500
Subject: [PATCH 1/2] Add `Never <: ConvergenceMetric`

This is designed to make it easy to ensure that the algorithm always
performs the stated number of iterations. Because the various tolerance
options use `<=`, even setting them to 0 does not guarantee lack of
termination.
---
 docs/src/convergence.md |  1 +
 src/api/termination.jl  | 12 +++++++++++-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/docs/src/convergence.md b/docs/src/convergence.md
index 032e20e..066cc95 100644
--- a/docs/src/convergence.md
+++ b/docs/src/convergence.md
@@ -21,6 +21,7 @@ calculations.
 Evolutionary.AbsDiff
 Evolutionary.RelDiff
 Evolutionary.GD
+Evolutionary.Never
 ```
 
 ## Auxiliary Functions
diff --git a/src/api/termination.jl b/src/api/termination.jl
index 94674ce..24aa6e4 100644
--- a/src/api/termination.jl
+++ b/src/api/termination.jl
@@ -121,7 +121,7 @@ end
 GD(tol::T, inv=false) where {T<:AbstractFloat} = GD(tol, Inf, zeros(T,0,0), inv)
 GD(inv=false) = GD(1e-5, inv)
 function description(m::GD)
-    prefix = m.inverted ? "I" : "" 
+    prefix = m.inverted ? "I" : ""
     "|$(prefix)GD(P) - $(prefix)GD(P')|"
 end
 function assess!(m::GD, state::AbstractOptimizerState)
@@ -131,6 +131,16 @@ function assess!(m::GD, state::AbstractOptimizerState)
     converged(m)
 end
 
+"""
+"Never converges" metric for single objective optimization.
+
+This allows one to force the optimization algorithm to run for a given number of iterations.
+"""
+mutable struct Never <: ConvergenceMetric
+end
+description(m::Never) = "never converges"
+assess!(m::Never, state::AbstractOptimizerState) = false
+
 
 """
     spread(S,R)

From a3ffc3a35f8cef096e2a922d8bc55368682a9e1b Mon Sep 17 00:00:00 2001
From: Tim Holy <tim.holy@gmail.com>
Date: Thu, 1 May 2025 07:43:50 -0500
Subject: [PATCH 2/2] Add missing methods

---
 src/api/results.jl     | 2 +-
 src/api/termination.jl | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/api/results.jl b/src/api/results.jl
index c9df406..ff3be19 100644
--- a/src/api/results.jl
+++ b/src/api/results.jl
@@ -138,7 +138,7 @@ function show(io::IO, r::EvolutionaryOptimizationResults)
             sgn = converged(cm) ? "≤" : "≰"
             dsc = description(cm)
             lpd = " "^(maxdsclen + 1 - length(dsc))
-            print(io, "$rpd$dsc$lpd= $(diff(cm)) $sgn $(tolerance(cm))\n" )
+            !isa(cm, Never) && print(io, "$rpd$dsc$lpd= $(diff(cm)) $sgn $(tolerance(cm))\n" )
         end
         print(io, "\n")
     end
diff --git a/src/api/termination.jl b/src/api/termination.jl
index 24aa6e4..10d3e17 100644
--- a/src/api/termination.jl
+++ b/src/api/termination.jl
@@ -138,9 +138,9 @@ This allows one to force the optimization algorithm to run for a given number of
 """
 mutable struct Never <: ConvergenceMetric
 end
-description(m::Never) = "never converges"
+description(m::Never) = "never converges (fixed number of iterations)"
 assess!(m::Never, state::AbstractOptimizerState) = false
-
+converged(m::Never) = false
 
 """
     spread(S,R)