Schedule Task#

Schedule and manage recurring tasks using cron.

Quick Start#

bash

# Add a scheduled task
python scripts/scheduler.py add --cron "0 9 * * *" --command "backup.sh"

# List all tasks
python scripts/scheduler.py list

# Remove a task
python scripts/scheduler.py remove --id 1

Core Features#

• Cron Expression Parser: Validate and understand cron expressions
• Task Management: Add, list, remove scheduled tasks
• Health Checks: Monitor task execution status
• Notifications: Alert on task failure

Cron Format#

text

┌───────────── minute (0 - 59)
│ ┌───────────── hour (0 - 23)
│ │ ┌───────────── day of month (1 - 31)
│ │ │ ┌───────────── month (1 - 12)
│ │ │ │ ┌───────────── day of week (0 - 6)
│ │ │ │ │
* * * * *

Common Examples#

ExpressionMeaning0 9 * * *Daily at 9 AM0 * * * *Every hour*/15 * * * *Every 15 minutes0 0 * * 0Weekly on Sunday0 0 1 * *Monthly on 1st

Script Usage#

bash

python scripts/scheduler.py [COMMAND] [OPTIONS]

Commands:
  add         Add a new scheduled task
  list        List all scheduled tasks
  remove      Remove a task
  enable      Enable a disabled task
  disable     Disable a task without removing
  log         Show task execution log
  health      Check task health status

Options#

text

--cron TEXT      Cron expression (required for add)
--command TEXT   Command to run (required for add)
--name TEXT      Task name for identification
--log PATH       Log file path
--notify EMAIL   Email notification on failure
--timeout SECS   Task timeout in seconds

Examples#

Daily Backup#

bash

python scripts/scheduler.py add \
  --cron "0 2 * * *" \
  --command "/home/user/backup.sh" \
  --name "daily-backup" \
  --log /var/log/backup.log

Hourly Sync#

bash

python scripts/scheduler.py add \
  --cron "0 * * *" \
  --command "sync-data.sh" \
  --name "hourly-sync"

Weekly Report#

bash

python scripts/scheduler.py add \
  --cron "0 9 * * 1" \
  --command "generate-report.sh" \
  --name "weekly-report"

Integration#

With Web Monitor#

bash

# Monitor website every hour
python scripts/scheduler.py add \
  --cron "0 * * *" \
  --command "python /path/to/web-monitor/scripts/monitor.py --url https://example.com --compare last.json"

With Telegram Bot#

bash

# Send daily summary
python scripts/scheduler.py add \
  --cron "0 8 * * *" \
  --command "telegram-send 'Good morning! Daily summary ready'"

Best Practices#

1. Use absolute paths in commands
2. Log output for debugging
3. Set timeouts to prevent hanging tasks
4. Test commands manually before scheduling
5. Use UTC for server schedules