LoggoCli.docopt.txt

{0}, the logfile generator v{1}

Usage:
  {0} [options] [DESTINATION]
  {0} --help
  {0} --version

Description:
  Generate fake log lines, optionally writing to DESTINATION.

Options:
  --stdout            Mirror to stdout as well (defaults to true if DESTINATION not specified)
  --prefix-line-num   Prefix each line with a line number. Note that a minimum length specified with `--width` will get
                      overridden to ensure that the line number+colon prefix is always printed.
  --prefix-time FMT   Prefix each line with a timestamp. FMT is a c# format string (for example `o` or `HH:mm:ss.fff`)
  --line-delay DELAY  Delay between each line being added to the log in ms [default: 0]
  --intra-line-delay  Use some of the time from DELAY to delay randomly in the middle of writing each line. This is
                      useful for testing that a tail-follow utility can handle partially written lines.
  --err-period ERR    Every ERR lines that are printed will be written to stderr instead (with a prefix of "err: ").
                      Only makes a difference when stdout is being written to.
  --width WIDTH       Width of generated lines [default: 1,200]
  --pattern PATTERN   Pattern to use for generated lines (one of: lorem, nums, loggy, PATH) [default: nums]
  --eol EOL           End of line character to use (one of: crlf, lf, mix) [default: lf]
  --rng-seed SEED     Use the provided SEED (an integer) to initialize the random number generator. (Good for tests and
                      anything else that requires determinism.)
  --stop-size SIZE    Stop generating after total log output gets to this size (can postfix SIZE with kb mb gb)
  --stop-lines LINES  Stop generating after LINES lines
  --stop-time TIME    Stop generating after TIME seconds
  --exit-code CODE    Exit with CODE on a normal exit; ctrl-c abort will exit with 128+SIGINT (130)

File options:
  --overwrite         Overwrite existing file if it already exists
  --delete-on-exit    Delete log file when program exits for any reason

  These options only apply if DESTINATION is specified.

Notes:
  * DELAY, WIDTH, and ERR can be ""min,max"" entries separated by a comma (for example `1MB,50GB`). Both min and max
    will be the same if there is only one entry.
  * PATTERN can be the PATH to a file, which would be used as the source material for the generator. If SIZE and/or
    LINES are also specified, then the file at PATH will be repeated as needed until the SIZE/LINES conditions are met.
  * WIDTH is ignored if a file path is specified for PATTERN

Alternative:
  go install github.com/mingrammer/flog@latest