cli-tickwright-lite

module
v1.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 7, 2026 License: MIT

README

Tickwright Lite by PN Scripts

A free command-line tool (MIT) that checks cron expressions before they reach a server: it validates an expression, explains it in plain English and Bulgarian, and lists the next run times in any time zone, correct across daylight-saving changes.

Explain and next runs in a terminal

Install

  • Binaries: download the archive for your platform from GitHub Releases (Linux, macOS, Windows; amd64 and arm64), unpack, put tickwright-lite on your PATH. Verify with sha256sum -c SHA256SUMS.
  • Go (1.22 or newer): go install github.com/pnscripts/cli-tickwright-lite/cmd/tickwright-lite@latest (pkg.go.dev).
  • Docker: the image is not on Docker Hub yet; build it from this repository with docker build -t tickwright-lite ., then docker run --rm tickwright-lite explain "0 9 * * 1-5".

Usage

tickwright-lite validate "0 9 * * 1-5"                  # exit 0 valid, 1 invalid
tickwright-lite explain  "*/15 9-17 * * MON-FRI"        # EN and BG
tickwright-lite explain  "@weekly" --lang bg
tickwright-lite next     "30 3 * * *" --tz Europe/Sofia -n 5
tickwright-lite next     "0 0 * * *" --tz America/New_York --from "2026-11-01 00:00" --json
  • Syntax: 5 fields, 6 fields (seconds first), @yearly @annually @monthly @weekly @daily @midnight @hourly, lists, ranges, steps, JAN-DEC, SUN-SAT, 0 and 7 for Sunday, ? in day fields. Quartz L, W, # and robfig @every are rejected with an explanation.
  • Daylight saving follows classic Vixie cron: a skipped wall time runs moved forward by the gap; a repeated wall time runs once (hourly jobs run in both copies of the repeated hour). next marks such runs.
  • --json on every command, --color auto|always|never (honours NO_COLOR), exit codes 0 ok, 1 invalid, 2 usage error.
  • Single static binary with the time zone database embedded.

The full edition, Tickwright, adds lint (day-of-month and day-of-week both set, impossible dates, DST traps and more) and compare (are two expressions equivalent, checked over a full 400-year cycle): https://pnscripts.com/marketplace/cli-tickwright. Lite is complete on its own.

Build and test

make test     # go vet + go test (Go 1.22+, no third-party modules)
make dist     # dist/*.tar.gz, *.zip and SHA256SUMS for a GitHub release
docker build -t tickwright-lite .

Licence

MIT. Copyright (c) 2026 ПН СКРИПТС ЕООД (PN Scripts).

Directories

Path Synopsis
cmd
tickwright-lite command
Command tickwright-lite validates and explains cron expressions and lists their next run times.
Command tickwright-lite validates and explains cron expressions and lists their next run times.
Package cron parses, explains and schedules cron expressions.
Package cron parses, explains and schedules cron expressions.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL