random-cron-generator

Random Cron Generator

This package provides tools to generate random cron expressions based on configurable parameters and calculate the next run time for any given cron expression. It uses cron-validate to ensure generated cron expressions are valid and cron-parser integrated with luxon for calculating run times.

Features

• Generate random cron expressions with configurable settings.
• Validate cron expressions for correctness.
• Calculate the next run time of a cron expression.
• Optional logging of next run times during cron generation.

Installation

Install the package with npm:

npm install random-cron-generator

Usage

Importing the module

import { RandomCronGenerator, generateRandomCron, getNextRunTime } from 'random-cron-generator';

Generating a Random Cron Expression

// Generate a cron expression with default settings:
const cronExpression = generateRandomCron();
console.log(cronExpression); // Outputs a valid cron string (e.g. '0 0 * * *')

// Generate a cron expression with custom settings:
const customCronExpression = generateRandomCron({
    randomConfig: {
        minute: { min: 0, max: 59 }, // range of minutes
        hour: true, // random hour. If false, it will be * (default)
        dayOfMonth: '*/7', // string cron expression
        month: 5, // specific month
        dayOfWeek: undefined // * (default)
    },
    log: true // log the next run time
    }
); 
console.log(customCronExpression); // Outputs a valid cron string and logs the next run time (e.g. '33 * 1 10 *')