chr
2026-04-05 fe750b791d5b517cc4e9bc8e99a9a75139a0cfba
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Globalization;
using System.Linq;
using System.Reflection;
using System.Text;
using System.Threading;
 
namespace OpenTap.Plugins.BasicSteps
{
    [Browsable(false)]
    [AllowAnyChild]
    [Display("Sweep Parameter", "Table based loop that sweeps the value of its parameters based on a set of values.", "Flow Control")]
    public class SweepParameterStep : SweepParameterStepBase
    {
        public bool SweepValuesEnabled => SelectedParameters.Count > 0;
 
        
        [DeserializeOrder(1)] // this should be deserialized as the last thing.
        [Display("Sweep Values", "A table of values to be swept for the selected parameters.", "Sweep")]
        [HideOnMultiSelect] // todo: In the future support multi-selecting this.
        [EnabledIf(nameof(SweepValuesEnabled), true)]
        [Unsweepable, Unmergable]
        [ElementFactory(nameof(NewElement))]
        [Factory(nameof(NewSweepRowCollection))]
        public SweepRowCollection SweepValues { get; set; } 
 
        /// <summary>
        /// This property declares to the Resource Manager which resources are declared by this test step. 
        /// </summary>
        [AnnotationIgnore]
        [EditorBrowsable(EditorBrowsableState.Never)]
        [Browsable(false)]
        public IEnumerable<IResource> Resources
        {
            get
            {
                foreach (var row in SweepValues)
                {
                    if (row.Enabled == false) continue;
                    foreach (var value in row.Values.Values)
                    {
                        if (value is IResource res)
                            yield return res;
                    }
                }
            }
        }
            
        public SweepParameterStep()
        {
            SweepValues = new SweepRowCollection(this);
            Name = "Sweep {Parameters}";
            Rules.Add(() => string.IsNullOrWhiteSpace(Validate()), Validate, nameof(SweepValues));
        }
 
        private string lastError = "";
 
        private string Validate()
        {
            if (!validateSweepMutex.WaitOne(0))
                return lastError;
 
            try
            {
                if (isRunning)
                    return lastError;
 
                if (SelectedParameters.Count <= 0)
                {
                    SweepValues = new SweepRowCollection(this);
                }
                {
                    // Remove sweep values not in the selected parameters. This can be needed when the user has removed some.
 
                    var rows = SweepValues.Select(x => x.Values);
                    var selectedNames = SelectedParameters.Select(x => x.Name);
                    var namesToRemove = rows.SelectMany(x => x.Keys).ToHashSet();
                    namesToRemove.ExceptWith(selectedNames);
 
                    foreach (var removeName in namesToRemove)
                    foreach (var row in rows)
                        row.Remove(removeName);
                }
                var errors = ValidateSweepValues();
                lastError = errors;
                return errors;
            }
            finally
            {
                validateSweepMutex.ReleaseMutex();
            }
        }
 
        int iteration;
        
        [Output(OutputAvailability.BeforeRun)]
        [Display("Iteration", "Shows the iteration of the sweep that is currently running or about to run.", "Sweep", Order: 3)]
        public string IterationInfo => $"{iteration} of {SweepValues.Count(x => x.Enabled)}";
 
        bool isRunning => GetParent<TestPlan>()?.IsRunning ?? false;
        
        /// <summary>
        /// Validation requires setting the values of parameterized members.
        /// This mutex will be locked while the test plan is running to prevent validation requests from interfering with test plan runs. 
        /// </summary>
        Mutex validateSweepMutex = new Mutex();
 
        private string ValidateSweepValues()
        {
            const int maxErrors = 10;
            var sets = SelectedMembers.ToArray();
            if (SweepValues.Count == 0)
                return "No rows selected to sweep.";
            var rowType = SweepValues.Select(TypeData.GetTypeData).FirstOrDefault();
            
            var numErrors = 0;
 
            string FormatError(string rowDescriptor, string error)
            {
                return $"{rowDescriptor}: {error}";
            }
 
            List<string> allRowErrors = new List<string>();
            List<(int row, string error)> rowErrors = new List<(int row, string error)>();
 
            foreach (var set in sets)
            {
                var mem = rowType.GetMember(set.Name);
 
                // If an error is reported on all rows, only show one validation error
                var allRowsHaveErrors = true;
                var errorTuple = new List<(int row, string error)>();
 
                foreach (var (index, sweepValue) in SweepValues.WithIndex())
                {
                    if (sweepValue.Enabled == false) continue;
 
                    var stepsToValidate = new HashSet<ITestStep>();
 
                    var rowNumber = index + 1;
                    var value = mem.GetValue(sweepValue);
 
                    try
                    {
                        set.SetValue(this, value);
                        // Don't try to validate a step if SetValue failed
                        set.ParameterizedMembers.ForEach(m =>
                        {
                            if (m.Source is ITestStep step)
                                stepsToValidate.Add(step);
                        });
                    }
                    catch (TargetInvocationException ex)
                    {
                        var reason = ex?.InnerException?.Message;
 
                        string valueString;
                        if (value == null)
                            valueString = "";
                        else if (false == StringConvertProvider.TryGetString(value, out valueString,
                            CultureInfo.InvariantCulture))
                            valueString = value.ToString();
 
                        var error = $"Unable to set '{set.GetDisplayAttribute().Name}' to value '{valueString}'";
 
                        if (reason == null)
                            error += ".";
                        else
                            error += $": {reason}";
 
                        rowErrors.Add((rowNumber, error));
                        continue;
                    }
 
                    var hasErrors = false;
 
                    foreach (ITestStep step in stepsToValidate)
                    {
                        var errors = step.Error;
                        if (string.IsNullOrWhiteSpace(errors) == false)
                        {
                            rowErrors.Add((rowNumber, $"{step.GetFormattedName()} - {errors}"));
                            hasErrors = true;
                            numErrors += 1;
                        }
                    }
 
                    if (hasErrors == false)
                        allRowsHaveErrors = false;
                }
 
                if (allRowsHaveErrors && errorTuple.Count > 1 &&
                    errorTuple.Select(t => t.error).Distinct().Count() == 1)
                {
                    var error = errorTuple.First();
                    allRowErrors.Add(error.error);
                    numErrors += 1;
                }
 
                if (numErrors >= maxErrors)
                    break;
            }
            
            var sb = new StringBuilder();
            foreach (var error in allRowErrors.OrderBy(x => x))
                sb.AppendLine(FormatError($"All rows", error));
            foreach (var error in rowErrors.OrderBy(x => x.error).ToArray().OrderBy(x =>x.row))
                sb.AppendLine(FormatError($"Row {error.row}", error.error));
            return sb.ToString();
        }
 
        public override void PrePlanRun()
        {
            validateSweepMutex.WaitOne();
            base.PrePlanRun();
            iteration = 0;
 
            if (SelectedParameters.Count <= 0)
                throw new InvalidOperationException("No parameters selected to sweep");
 
            if (SweepValues.Count <= 0 || SweepValues.All(x => x.Enabled == false))
                throw new InvalidOperationException("No values selected to sweep");
        }
 
        public override void PostPlanRun()
        {
            validateSweepMutex.ReleaseMutex();
            base.PostPlanRun();
        }
 
        public override void Run()
        {
            base.Run();
            iteration = 0;
            var sets = SelectedMembers.ToArray();
            var originalValues = sets.Select(set => set.GetValue(this)).ToArray();
 
            var rowType = SweepValues.Select(TypeData.GetTypeData).FirstOrDefault();
            for (int i = 0; i < SweepValues.Count; i++)
            {
                SweepRow Value = SweepValues[i];
                if (Value.Enabled == false) continue;
                var AdditionalParams = new ResultParameters();
                
                AdditionalParams.Add("Sweep", "Iteration", iteration + 1, null);
 
 
                foreach (var set in sets)
                {
                    var mem = rowType.GetMember(set.Name);
                    var value = mem.GetValue(Value);
 
                    string valueString;
                    if (value == null)
                        valueString = "";
                    else if (false == StringConvertProvider.TryGetString(value, out valueString,
                        CultureInfo.InvariantCulture))
                        valueString = value.ToString();
 
                    var disp = mem.GetDisplayAttribute();
                    AdditionalParams.Add(new ResultParameter(disp.Group.FirstOrDefault() ?? "", disp.Name,
                        valueString));
 
                    try
                    {
                        set.SetValue(this, value);
                    }
                    catch (TargetInvocationException ex)
                    {
                        throw new ArgumentException($"Unable to set '{set.GetDisplayAttribute()}' to '{valueString}' on row {i}: {ex.InnerException.Message}", ex.InnerException);
                    }
                }
 
                iteration += 1;
                // Notify that values might have changes
                OnPropertyChanged("");
 
                Log.Info("Running child steps with {0}", Value.GetIterationString());
 
                var runs = RunChildSteps(AdditionalParams, BreakLoopRequested, throwOnBreak: false).ToArray();
                if (BreakLoopRequested.IsCancellationRequested) break;
                runs.ForEach(r => r.WaitForCompletion());
                if (runs.LastOrDefault()?.BreakConditionsSatisfied() == true)
                    break;
            }
 
            for (int i = 0; i < sets.Length; i++)
                sets[i].SetValue(this, originalValues[i]);
        }
        
        SweepRow NewElement()
        {
            return new SweepRow(this);
        }
        SweepRowCollection NewSweepRowCollection()
        {
            return new SweepRowCollection(this);
        }
    }
}