Features

This chapter covers the core features and capabilities of Job Scheduler.

Features

• Cron expressions — Standard 5-field cron syntax with ranges, steps, and lists
• Retry with backoff — Configurable retries with linear backoff on failures
• Dependency chains — Jobs can depend on other jobs completing successfully
• Execution logging — Structured logs with timestamps, duration, exit codes
• Health monitoring — JSON health file for external monitoring tools
• Failure hooks — Run custom commands (alerts, webhooks) when jobs fail
• Timeout protection — Kill hung jobs after a configurable timeout
• Environment variables — Pass custom env vars to each job
• Run-once mode — Execute all jobs once for testing, then exit

Requirements

• Python 3.10+
• No external dependencies (stdlib only)

Quick Start

Follow this guide to get Job Scheduler up and running in your environment.

Quick Start

# Run scheduler in continuous mode
python src/job_scheduler.py --config examples/jobs_config.json

# Run all jobs once (for testing)
python src/job_scheduler.py --config examples/jobs_config.json --run-once

# List all configured jobs
python src/job_scheduler.py --config examples/jobs_config.json --list

Configuration Reference

{
    "jobs": [
        {
            "name": "my-job",
            "schedule": "0 */2 * * *",
            "command": "python my_script.py",
            "enabled": true,
            "max_retries": 3,
            "retry_delay": 10,
            "timeout": 300,
            "depends_on": ["other-job"],
            "env": {"MY_VAR": "value"},
            "on_failure": "curl https://hooks.example.com/alert"
        }
    ]
}