AwsScheduleExpressionValidator 1.2.0

aws-schedule-expression-validator

Validate AWS EventBridge Scheduler expressions (cron, rate, and at) and optionally enforce minimum/maximum intervals between runs. Includes FluentValidation integrations.

• Demo: https://trossr32.github.io/aws-schedule-expression-validator/
• Repository: https://github.com/trossr32/aws-schedule-expression-validator

Features

• Validate cron(...), rate(...), and at(...) expressions
• Accepts bare CRON fields for backward compatibility
• Validate interval constraints (min/max) between occurrences
• Retrieve upcoming execution times
• FluentValidation rule extensions

Installation

dotnet add package AwsScheduleExpressionValidator

Usage

Fluent validation API

using AwsScheduleExpressionValidator;

var result = "rate(5 minutes)"
    .ValidateAwsScheduleExpression()
    .WithMinInterval(TimeSpan.FromMinutes(1))
    .WithMaxInterval(TimeSpan.FromMinutes(10))
    .Evaluate();

var isValid = "cron(0 10 * * ? *)"
    .ValidateAwsScheduleExpression()
    .IsValid();

var occurrences = "rate(1 minutes)"
    .ValidateAwsScheduleExpression()
    .WithOccurrenceCount(3)
    .WithOccurrenceStart(DateTimeOffset.UtcNow)
    .GetNextScheduleExpressionOccurrences();

"invalid"
    .ValidateAwsScheduleExpression()
    .ThrowExceptionOnFailure()
    .Evaluate();

Fluent API reference

• ValidateAwsScheduleExpression()
  • Starts validation for a schedule expression string.
• WithMinInterval(TimeSpan)
  • Sets a minimum interval constraint.
• WithMaxInterval(TimeSpan)
  • Sets a maximum interval constraint.
• WithOccurrenceCount(int)
  • Sets the number of occurrences to return for GetNextScheduleExpressionOccurrences().
• WithOccurrenceStart(DateTimeOffset)
  • Sets the starting point for occurrence calculation.
• ThrowExceptionOnFailure()
  • Throws AwsScheduleExpressionFormatException, AwsScheduleIntervalConfigurationException, or AwsScheduleIntervalViolationException when validation fails.
• IsValid()
  • Returns true/false for the current configuration.
• Evaluate()
  • Returns AwsScheduleExpressionValidationResult with IsValid, Error, and Message.
• GetNextScheduleExpressionOccurrences()
  • Returns upcoming execution times using the configured occurrence settings.

Format validation

using AwsScheduleExpressionValidator;

// Valid CRON expression
var isValid = AwsScheduleExpressionValidator.ValidateFormat("cron(0 10 * * ? *)");
var isValid = AwsScheduleExpressionValidator.ValidateFormat("0 10 * * ? *");

// Valid rate expression
var isValid = AwsScheduleExpressionValidator.ValidateFormat("rate(5 minutes)");

// Valid at expression
var isValid = AwsScheduleExpressionValidator.ValidateFormat("at(2024-12-31T23:59:00)");

Validate with interval constraints

using AwsScheduleExpressionValidator;

var minInterval = TimeSpan.FromHours(1);
var maxInterval = TimeSpan.FromDays(1);

var isValid = AwsScheduleExpressionValidator.ValidateWithIntervals("rate(5 minutes)", minInterval, maxInterval);

Get upcoming executions

using AwsScheduleExpressionValidator;

var nextRuns = AwsScheduleExpressionValidator.GetNextOccurrences("cron(0 10 * * ? *)", count: 5);

foreach (var run in nextRuns)
{
    Console.WriteLine(run.ToLocalTime().ToString("f"));
}

FluentValidation integration

using AwsScheduleExpressionValidator;
using FluentValidation;

public class ScheduleRequest
{
    public string Expression { get; set; } = string.Empty;
}

public class ScheduleRequestValidator : AbstractValidator<ScheduleRequest>
{
    public ScheduleRequestValidator()
    {
        // Basic format validation
        RuleFor(x => x.Expression)
            .MustBeValidAwsSchedule();

        // Validate with a minimum interval of 5 minutes
        RuleFor(x => x.Expression)
            .MustBeValidAwsSchedule(TimeSpan.FromMinutes(5));
            
        // Validate with a maximum interval of 24 hours
        RuleFor(x => x.Expression)
            .MustBeValidAwsSchedule(null, TimeSpan.FromHours(24));
            
        // Validate with a minimum interval of 5 minutes and a maximum interval of 24 hours
        RuleFor(x => x.Expression)
            .MustBeValidAwsSchedule(TimeSpan.FromMinutes(5), TimeSpan.FromHours(24));
    }
}

Notes

• For at(...) expressions, interval constraints are not applicable (one-time schedules).
• When no cron(...) prefix is provided, the validator assumes the input is a CRON expression.