public void Dispose_AlreadyDisposed_RunsOk()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(false);
jobManager.Dispose();
// Act
jobManager.Dispose();
// Assert
Assert.That(jobManager.IsDisposed, Is.True);
}
public void Start_AlreadyDisposed_ThrowsException()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(false);
jobManager.Dispose();
// Act
var ex = Assert.Throws <JobObjectDisposedException>(() => jobManager.Start());
// Assert
Assert.That(ex.Message, Is.EqualTo($"'{typeof(IJobManager).FullName}' is disposed."));
Assert.That(ex.ObjectName, Is.EqualTo(typeof(IJobManager).FullName));
jobManager.Dispose();
}
public void WaitInt_WasRunningThenJobManagerIsDisposed_WaitsAndReturnsCanceled()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(true);
var start = "2000-01-01Z".ToUtcDateOffset();
var timeMachine = ShiftedTimeProvider.CreateTimeMachine(start);
TimeProvider.Override(timeMachine);
var job = jobManager.Create("my-job");
job.IsEnabled = true;
job.Routine = async(parameter, tracker, output, token) =>
{
await Task.Delay(500, token);
};
// Act
job.ForceStart();
ThreadPool.QueueUserWorkItem(state =>
{
Thread.Sleep(200);
jobManager.Dispose();
});
var waitResult = job.Wait(1000);
// Assert
Assert.That(waitResult, Is.EqualTo(JobRunStatus.Canceled));
}
public void Dispose_NotStarted_Disposes()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(false);
// Act
jobManager.Dispose();
// Assert
Assert.That(jobManager.IsDisposed, Is.True);
}
public void IsDisposed_NotStartedThenDisposed_ReturnsTrue()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(false);
jobManager.Dispose();
// Act
var isDisposed = jobManager.IsDisposed;
// Assert
Assert.That(isDisposed, Is.True);
}
public void IsRunning_NotStartedThenDisposed_ReturnsFalse()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(false);
jobManager.Dispose();
// Act
var isRunning = jobManager.IsRunning;
// Assert
Assert.That(isRunning, Is.False);
}
public void Start_AlreadyStarted_ThrowsInvalidJobOperationException()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(false);
jobManager.Start();
// Act
var ex = Assert.Throws <InvalidJobOperationException>(() => jobManager.Start());
// Assert
Assert.That(ex.Message, Is.EqualTo($"'{typeof(IJobManager).FullName}' is already running."));
jobManager.Dispose();
}
public void Routine_DisposedAndSet_ThrowsJobObjectDisposedException()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(true);
var start = "2000-01-01Z".ToUtcDateOffset();
var timeMachine = ShiftedTimeProvider.CreateTimeMachine(start);
TimeProvider.Override(timeMachine);
var job = jobManager.Create("my-job");
JobDelegate routine1 = async(parameter, tracker, output, token) =>
{
await output.WriteAsync("First Routine!");
await Task.Delay(1500, token);
};
JobDelegate routine2 = async(parameter, tracker, output, token) =>
{
await output.WriteAsync("Second Routine!");
await Task.Delay(1500, token);
};
// Act
job.Routine = routine1;
var updatedRoutine1 = job.Routine;
job.IsEnabled = true;
job.Routine = routine2;
var updatedRoutine2 = job.Routine;
jobManager.Dispose();
var updatedRoutineAfterDisposal = job.Routine;
var ex = Assert.Throws <JobObjectDisposedException>(() => job.Routine = routine1);
// Assert
Assert.That(updatedRoutine1, Is.SameAs(routine1));
Assert.That(updatedRoutine2, Is.SameAs(routine2));
Assert.That(updatedRoutineAfterDisposal, Is.SameAs(routine2));
Assert.That(ex.ObjectName, Is.EqualTo("my-job"));
}
public void IsRunning_Started_ReturnsTrue()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(false);
jobManager.Start();
// Act
var isRunning = jobManager.IsRunning;
// Assert
Assert.That(isRunning, Is.True);
jobManager.Dispose(); // otherwise
}
public async Task Routine_JustCreatedJob_NotNullAndRunsSuccessfully()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(true);
var start = "2000-01-01Z".ToUtcDateOffset();
var timeMachine = ShiftedTimeProvider.CreateTimeMachine(start);
TimeProvider.Override(timeMachine);
var job = jobManager.Create("my-job");
job.Schedule = new SimpleSchedule(SimpleScheduleKind.Second, 1, start.AddSeconds(2));
job.IsEnabled = true;
// Act
var routine = job.Routine;
var inTime = await timeMachine.WaitUntilSecondsElapse(start, 2.7);
if (!inTime)
{
throw new Exception("Test failed. TPL was too slow.");
}
jobManager.Dispose();
var info = job.GetInfo(null);
// Assert
try
{
Assert.That(routine, Is.Not.Null);
var run = info.Runs.First();
Assert.That(run.Status, Is.EqualTo(JobRunStatus.Completed));
}
catch (Exception ex)
{
var sb = new StringBuilder();
sb.AppendLine("*** Test Failed ***");
sb.AppendLine(ex.ToString());
sb.AppendLine("*** Log: ***");
var log = _logWriter.ToString();
sb.AppendLine(log);
Assert.Fail(sb.ToString());
}
}
public void Start_NotStarted_Starts()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(false);
// Act
jobManager.Start();
// Assert
Assert.That(jobManager.IsRunning, Is.True);
Assert.That(jobManager.IsDisposed, Is.False);
Assert.That(jobManager.GetNames(), Has.Count.Zero);
jobManager.Dispose();
}
public void GetNames_Disposed_ThrowsJobObjectIsDisposedException()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(true);
jobManager.Create("job1");
jobManager.Create("job2");
jobManager.Dispose();
// Act
var ex = Assert.Throws <JobObjectDisposedException>(() => jobManager.GetNames());
// Assert
Assert.That(ex.Message, Is.EqualTo($"'{typeof(IJobManager).FullName}' is disposed."));
Assert.That(ex.ObjectName, Is.EqualTo(typeof(IJobManager).FullName));
}
public void Schedule_JustCreatedJob_ReturnsNeverSchedule()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(true);
var start = "2000-01-01Z".ToUtcDateOffset();
var job = jobManager.Create("my-job");
// Act
var schedule = job.Schedule;
var dueTime = schedule.GetDueTimeAfter(start);
// Assert
Assert.That(schedule, Is.Not.Null);
Assert.That(schedule.GetType().FullName, Is.EqualTo("TauCode.Jobs.Schedules.NeverSchedule"));
Assert.That(dueTime.Year, Is.EqualTo(9000)); // 'Never'
jobManager.Dispose();
}
public async Task Routine_SetOnTheFly_CompletesWithOldRoutineAndThenStartsWithNewRoutine()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(true);
var start = "2000-01-01Z".ToUtcDateOffset();
var timeMachine = ShiftedTimeProvider.CreateTimeMachine(start);
TimeProvider.Override(timeMachine);
var job = jobManager.Create("my-job");
var output = new StringWriterWithEncoding(Encoding.UTF8);
job.Output = output;
job.Schedule = new SimpleSchedule(SimpleScheduleKind.Second, 1, start);
async Task Routine1(object parameter, IProgressTracker tracker, TextWriter writer, CancellationToken token)
{
await writer.WriteAsync("First Routine!");
await Task.Delay(1500, token);
}
async Task Routine2(object parameter, IProgressTracker tracker, TextWriter writer, CancellationToken token)
{
await writer.WriteAsync("Second Routine!");
await Task.Delay(1500, token);
}
job.IsEnabled = true;
job.Routine = Routine1;
// Act
await timeMachine.WaitUntilSecondsElapse(start, 1.4);
job.Routine = Routine2;
await timeMachine.WaitUntilSecondsElapse(start, 2.8);
var output1 = output.ToString();
await timeMachine.WaitUntilSecondsElapse(start, 4.8);
var output2 = output.ToString();
jobManager.Dispose();
var info = job.GetInfo(null);
// Assert
try
{
Assert.That(info.NextDueTime, Is.EqualTo(start.AddSeconds(5)));
Assert.That(info.CurrentRun, Is.Null);
Assert.That(info.RunCount, Is.EqualTo(2));
Assert.That(info.Runs, Has.Count.EqualTo(2));
var run0 = info.Runs[0];
Assert.That(run0.DueTime, Is.EqualTo(start.AddSeconds(1)));
Assert.That(run0.Output, Is.EqualTo("First Routine!"));
Assert.That(output1, Is.EqualTo("First Routine!"));
var run1 = info.Runs[1];
Assert.That(run1.DueTime, Is.EqualTo(start.AddSeconds(3)));
Assert.That(run1.Output, Is.EqualTo("Second Routine!"));
Assert.That(output2, Is.EqualTo("First Routine!Second Routine!"));
}
catch (Exception ex)
{
var sb = new StringBuilder();
sb.AppendLine("*** Test Failed ***");
sb.AppendLine(ex.ToString());
sb.AppendLine("*** Log: ***");
var log = _logWriter.ToString();
sb.AppendLine(log);
Assert.Fail(sb.ToString());
}
}
public async Task Dispose_JobsCreated_DisposesAndJobsAreCanceledAndDisposed()
{
// Arrange
using IJobManager jobManager = TestHelper.CreateJobManager(true);
var start = "2020-01-01Z".ToUtcDateOffset();
TimeProvider.Override(ShiftedTimeProvider.CreateTimeMachine(start));
var job1 = jobManager.Create("job1");
job1.IsEnabled = true;
var job2 = jobManager.Create("job2");
job2.IsEnabled = true;
job1.Output = new StringWriterWithEncoding(Encoding.UTF8);
job2.Output = new StringWriterWithEncoding(Encoding.UTF8);
async Task Routine(object parameter, IProgressTracker tracker, TextWriter output, CancellationToken token)
{
for (var i = 0; i < 100; i++)
{
var time = TimeProvider.GetCurrentTime();
await output.WriteLineAsync($"Iteration {i}: {time.Second:D2}:{time.Millisecond:D3}");
try
{
await Task.Delay(1000, token);
}
catch (TaskCanceledException)
{
time = TimeProvider.GetCurrentTime();
await output.WriteLineAsync($"Canceled! {time.Second:D2}:{time.Millisecond:D3}");
throw;
}
}
}
ISchedule schedule = new SimpleSchedule(
SimpleScheduleKind.Second,
1,
start.AddMilliseconds(400));
job1.Schedule = schedule;
job2.Schedule = schedule;
job1.Routine = Routine;
job2.Routine = Routine;
job1.IsEnabled = true;
job2.IsEnabled = true;
await Task.Delay(2500); // 3 iterations should be completed: ~400, ~1400, ~2400 todo: ut this
// Act
var jobInfoBeforeDispose1 = job1.GetInfo(null);
var jobInfoBeforeDispose2 = job2.GetInfo(null);
jobManager.Dispose();
await Task.Delay(50); // let background TPL work get done.
// Assert
Assert.That(jobManager.IsDisposed, Is.True);
foreach (var job in new[] { job1, job2 })
{
Assert.That(job.IsDisposed, Is.True);
var info = job.GetInfo(null);
var run = info.Runs.Single();
Assert.That(run.Status, Is.EqualTo(JobRunStatus.Canceled));
}
}
public async Task GetInfo_RunsSeveralTimes_ReturnsAllRuns()
{
// Arrange
const double runTime = 0.7;
const double t1 = 1.6; // !1 - force start
const double t2 = 2.8; // !2 - due time is overridden
const double t3 = 3.4; // !3 - overridden due time
const double t4 = 5.0; // !4 - starts by schedule
const double tA = 1.1; // ^A - before all runs
const double tB = 1.9; // ^B - right after force start
const double tC = 2.6; // ^C - after forced run completes, but before time override
const double tD = 3.1; // ^D - after time override, but before overridden-due-time start
const double tE = 3.9; // ^E - after overridden-due-time start
const double tF = 4.8; // ^F - after overridden-due-time run completes, and before schedule-due-time start
const double tG = 5.3; // ^G - after schedule-due-time start
const double tH = 6.6; // ^H - after schedule-due-time run completes
using IJobManager jobManager = TestHelper.CreateJobManager(true);
var start = "2000-01-01Z".ToUtcDateOffset();
var timeMachine = ShiftedTimeProvider.CreateTimeMachine(start);
TimeProvider.Override(timeMachine);
var job = jobManager.Create("my-job");
job.IsEnabled = true;
job.Routine = async(parameter, tracker, output, token) =>
{
var msg = (string)parameter;
await output.WriteAsync(msg);
await Task.Delay(TimeSpan.FromSeconds(runTime), token);
};
ISchedule schedule = new ConcreteSchedule(
start.AddSeconds(2),
start.AddSeconds(3),
start.AddSeconds(4),
start.AddSeconds(5));
job.Schedule = schedule;
// Act
// ^A - before all runs
await timeMachine.WaitUntilSecondsElapse(start, tA);
var infoA = job.GetInfo(null);
// !1 - force start
await timeMachine.WaitUntilSecondsElapse(start, t1);
job.Parameter = "force";
job.ForceStart();
// ^B - right after force start
await timeMachine.WaitUntilSecondsElapse(start, tB);
var infoB = job.GetInfo(null);
// ^C - after forced run completes, but before time override
await timeMachine.WaitUntilSecondsElapse(start, tC);
var infoC = job.GetInfo(null);
// !2 - due time is overridden
await timeMachine.WaitUntilSecondsElapse(start, t2);
job.Parameter = "overridden";
job.OverrideDueTime(start.AddSeconds(t3));
// ^D - after time override, but before overridden-due-time start
await timeMachine.WaitUntilSecondsElapse(start, tD);
var infoD = job.GetInfo(null);
// !3 - overridden due time
await timeMachine.WaitUntilSecondsElapse(start, t3);
await _logWriter.WriteLineAsync($"=== t3 came! {t3} ===");
// ^E - after overridden-due-time start
await timeMachine.WaitUntilSecondsElapse(start, tE);
var infoE = job.GetInfo(null);
// ^F - after overridden-due-time run completes, and before schedule-due-time start
await timeMachine.WaitUntilSecondsElapse(start, tF);
var infoF = job.GetInfo(null);
job.Parameter = "schedule";
// !4 - starts by schedule
await timeMachine.WaitUntilSecondsElapse(start, t4);
await _logWriter.WriteLineAsync($"=== t4 came! {t4} ===");
// ^G - after schedule-due-time start
await timeMachine.WaitUntilSecondsElapse(start, tG);
var infoG = job.GetInfo(null);
// ^H - after schedule-due-time run completes
await timeMachine.WaitUntilSecondsElapse(start, tH);
var infoH = job.GetInfo(null);
// dispose
jobManager.Dispose();
var infoFinal = job.GetInfo(null);
// Assert
var DEFECT = TimeSpan.FromMilliseconds(30);
#region ^A - before all runs
Assert.That(infoA.CurrentRun, Is.Null);
Assert.That(infoA.NextDueTime, Is.EqualTo(start.AddSeconds(2)));
Assert.That(infoA.NextDueTimeIsOverridden, Is.False);
Assert.That(infoA.RunCount, Is.Zero);
Assert.That(infoA.Runs, Is.Empty);
#endregion
#region ^B - right after force start
Assert.That(infoB.CurrentRun, Is.Not.Null);
Assert.That(infoB.NextDueTime, Is.EqualTo(start.AddSeconds(2)));
Assert.That(infoB.NextDueTimeIsOverridden, Is.False);
Assert.That(infoB.RunCount, Is.Zero);
Assert.That(infoB.Runs, Is.Empty);
var currentB = infoB.CurrentRun.Value;
Assert.That(currentB.RunIndex, Is.EqualTo(0));
Assert.That(currentB.StartReason, Is.EqualTo(JobStartReason.Force));
Assert.That(currentB.DueTime, Is.EqualTo(start.AddSeconds(2)));
Assert.That(currentB.DueTimeWasOverridden, Is.False);
Assert.That(currentB.StartTime, Is.EqualTo(start.AddSeconds(t1)).Within(DEFECT));
Assert.That(currentB.EndTime, Is.Null);
Assert.That(currentB.Status, Is.EqualTo(JobRunStatus.Running));
Assert.That(currentB.Output, Is.EqualTo("force"));
Assert.That(currentB.Exception, Is.Null);
#endregion
#region ^C - after forced run completes, but before time override
Assert.That(infoC.CurrentRun, Is.Null);
Assert.That(infoC.NextDueTime, Is.EqualTo(start.AddSeconds(3)));
Assert.That(infoC.NextDueTimeIsOverridden, Is.False);
Assert.That(infoC.RunCount, Is.EqualTo(1));
Assert.That(infoC.Runs, Has.Count.EqualTo(1));
var infoCRun0 = infoC.Runs[0];
Assert.That(infoCRun0.RunIndex, Is.EqualTo(0));
Assert.That(infoCRun0.StartReason, Is.EqualTo(JobStartReason.Force));
Assert.That(infoCRun0.DueTime, Is.EqualTo(start.AddSeconds(2)));
Assert.That(infoCRun0.DueTimeWasOverridden, Is.False);
Assert.That(infoCRun0.StartTime, Is.EqualTo(currentB.StartTime));
Assert.That(infoCRun0.EndTime, Is.EqualTo(infoCRun0.StartTime.AddSeconds(runTime)).Within(DEFECT * 2));
Assert.That(infoCRun0.Status, Is.EqualTo(JobRunStatus.Completed));
Assert.That(infoCRun0.Output, Is.EqualTo("force"));
Assert.That(infoCRun0.Exception, Is.Null);
#endregion
#region ^D - after time override, but before overridden-due-time start
Assert.That(infoD.CurrentRun, Is.Null);
Assert.That(infoD.NextDueTime, Is.EqualTo(start.AddSeconds(t3)));
Assert.That(infoD.NextDueTimeIsOverridden, Is.True);
Assert.That(infoD.RunCount, Is.EqualTo(1));
Assert.That(infoD.Runs, Has.Count.EqualTo(1));
Assert.That(infoD.Runs[0], Is.EqualTo(infoC.Runs[0]));
#endregion
#region ^E - after overridden-due-time start
Assert.That(infoE.CurrentRun, Is.Not.Null);
Assert.That(infoE.NextDueTime, Is.EqualTo(start.AddSeconds(4)));
Assert.That(infoE.NextDueTimeIsOverridden, Is.False);
Assert.That(infoE.RunCount, Is.EqualTo(1));
Assert.That(infoE.Runs, Has.Count.EqualTo(1));
var currentE = infoE.CurrentRun.Value;
Assert.That(currentE.RunIndex, Is.EqualTo(1));
Assert.That(currentE.StartReason, Is.EqualTo(JobStartReason.OverriddenDueTime));
Assert.That(currentE.DueTime, Is.EqualTo(start.AddSeconds(t3)));
Assert.That(currentE.DueTimeWasOverridden, Is.True);
Assert.That(currentE.StartTime, Is.EqualTo(start.AddSeconds(t3)).Within(DEFECT));
Assert.That(currentE.EndTime, Is.Null);
Assert.That(currentE.Status, Is.EqualTo(JobRunStatus.Running));
Assert.That(currentE.Output, Is.EqualTo("overridden"));
Assert.That(currentE.Exception, Is.Null);
#endregion
#region ^F - after overridden-due-time run completes, and before schedule-due-time start
Assert.That(infoF.CurrentRun, Is.Null);
Assert.That(infoF.NextDueTime, Is.EqualTo(start.AddSeconds(5)));
Assert.That(infoF.NextDueTimeIsOverridden, Is.False);
Assert.That(infoF.RunCount, Is.EqualTo(2));
Assert.That(infoF.Runs, Has.Count.EqualTo(2));
var infoFRun0 = infoF.Runs[0];
var infoFRun1 = infoF.Runs[1];
Assert.That(infoFRun0, Is.EqualTo(infoD.Runs[0]));
Assert.That(infoFRun1.RunIndex, Is.EqualTo(1));
Assert.That(infoFRun1.StartReason, Is.EqualTo(JobStartReason.OverriddenDueTime));
Assert.That(infoFRun1.DueTime, Is.EqualTo(start.AddSeconds(t3)));
Assert.That(infoFRun1.DueTimeWasOverridden, Is.True);
Assert.That(infoFRun1.StartTime, Is.EqualTo(currentE.StartTime));
Assert.That(infoFRun1.EndTime, Is.EqualTo(infoFRun1.StartTime.AddSeconds(runTime)).Within(DEFECT * 2));
Assert.That(infoFRun1.Status, Is.EqualTo(JobRunStatus.Completed));
Assert.That(infoFRun1.Output, Is.EqualTo("overridden"));
Assert.That(infoFRun1.Exception, Is.Null);
#endregion
#region ^G - after schedule-due-time start
Assert.That(infoG.CurrentRun, Is.Not.Null);
Assert.That(infoG.NextDueTime, Is.EqualTo(TestHelper.NeverCopy));
Assert.That(infoG.NextDueTimeIsOverridden, Is.False);
Assert.That(infoG.RunCount, Is.EqualTo(2));
Assert.That(infoG.Runs, Has.Count.EqualTo(2));
var currentG = infoG.CurrentRun.Value;
Assert.That(currentG.RunIndex, Is.EqualTo(2));
Assert.That(currentG.StartReason, Is.EqualTo(JobStartReason.ScheduleDueTime));
Assert.That(currentG.DueTime, Is.EqualTo(start.AddSeconds(5)));
Assert.That(currentG.DueTimeWasOverridden, Is.False);
Assert.That(currentG.StartTime, Is.EqualTo(start.AddSeconds(5)).Within(DEFECT));
Assert.That(currentG.EndTime, Is.Null);
Assert.That(currentG.Status, Is.EqualTo(JobRunStatus.Running));
Assert.That(currentG.Output, Is.EqualTo("schedule"));
Assert.That(currentG.Exception, Is.Null);
CollectionAssert.AreEqual(infoF.Runs, infoG.Runs);
#endregion
#region ^H - after schedule-due-time run completes
Assert.That(infoH.CurrentRun, Is.Null);
Assert.That(infoH.NextDueTime, Is.EqualTo(TestHelper.NeverCopy));
Assert.That(infoH.NextDueTimeIsOverridden, Is.False);
Assert.That(infoH.RunCount, Is.EqualTo(3));
Assert.That(infoH.Runs, Has.Count.EqualTo(3));
CollectionAssert.AreEqual(infoG.Runs.Take(2), infoH.Runs.Take(2));
var infoHRun2 = infoH.Runs[2];
Assert.That(infoHRun2.RunIndex, Is.EqualTo(2));
Assert.That(infoHRun2.StartReason, Is.EqualTo(JobStartReason.ScheduleDueTime));
Assert.That(infoHRun2.DueTime, Is.EqualTo(start.AddSeconds(5)));
Assert.That(infoHRun2.DueTimeWasOverridden, Is.False);
Assert.That(infoHRun2.StartTime, Is.EqualTo(currentG.StartTime));
Assert.That(infoHRun2.EndTime, Is.EqualTo(infoHRun2.StartTime.AddSeconds(runTime)).Within(DEFECT * 2));
Assert.That(infoHRun2.Status, Is.EqualTo(JobRunStatus.Completed));
Assert.That(infoHRun2.Output, Is.EqualTo("schedule"));
Assert.That(infoHRun2.Exception, Is.Null);
#endregion
#region after disposal
Assert.That(infoFinal.CurrentRun, Is.EqualTo(infoH.CurrentRun));
Assert.That(infoFinal.NextDueTime, Is.EqualTo(infoH.NextDueTime));
Assert.That(infoFinal.NextDueTimeIsOverridden, Is.EqualTo(infoH.NextDueTimeIsOverridden));
Assert.That(infoFinal.RunCount, Is.EqualTo(infoH.RunCount));
Assert.That(infoFinal.Runs.Count, Is.EqualTo(infoH.Runs.Count));
CollectionAssert.AreEqual(infoH.Runs, infoFinal.Runs);
#endregion
}
