Minion:...on::job(3)

📦
version 11.0 · 10 versions
, in fedora 44

💖 Minion::Command::minion::job — the job command, bestie 💖

okay so this is a page from the User Contributed Perl Documentation collection, and it's literally all about Minion::Command::minion::job, which is your girl for managing the Minion job queue. no cap. 🎀

✨ NAME ✨

Minion::Command::minion::job — the Minion job command. that's it, that's the name. 💅

🌈 SYNOPSIS 🌈

here's the vibe, copy-paste ready:

Usage: APPLICATION minion job [OPTIONS] [IDS]

  ./myapp.pl minion job
  ./myapp.pl minion job 10023
  ./myapp.pl minion job -w
  ./myapp.pl minion job -w 23
  ./myapp.pl minion job -s
  ./myapp.pl minion job -f 10023
  ./myapp.pl minion job -q important -t foo -t bar -S inactive
  ./myapp.pl minion job -q 'host:localhost' -S inactive
  ./myapp.pl minion job -e foo -a '[23, "bar"]'
  ./myapp.pl minion job -e foo -x 1 -P 10023 -P 10024 -p 5 -q important
  ./myapp.pl minion job -e 'foo' -n '{"test":123}'
  ./myapp.pl minion job -R -d 10 -E 300 10023
  ./myapp.pl minion job --remove 10023
  ./myapp.pl minion job --retry-failed
  ./myapp.pl minion job -n '["test"]'
  ./myapp.pl minion job -L
  ./myapp.pl minion job -L some_lock some_other_lock
  ./myapp.pl minion job -b jobs -a '[12]'
  ./myapp.pl minion job -b jobs -a '[12]' 23 24 25

and then, the whole menu of options 🍓

Options:
  -A, --attempts <number>     Number of times performing this new job will be
                              attempted, defaults to 1
  -a, --args <JSON array>     Arguments for new job or worker remote control
                              command in JSON format
  -b, --broadcast <command>   Broadcast remote control command to one or more
                              workers
  -d, --delay <seconds>       Delay new job for this many seconds
  -E, --expire <seconds>      New job is valid for this many seconds before
                              it expires
  -e, --enqueue <task>        New job to be enqueued
  -f, --foreground            Retry job in "minion_foreground" queue and
                              perform it right away in the foreground (very
                              useful for debugging)
  -H, --history               Show queue history
  -h, --help                  Show this summary of available options
      --home <path>           Path to home directory of your application,
                              defaults to the value of MOJO_HOME or
                              auto-detection
  -L, --locks                 List active named locks
  -l, --limit <number>        Number of jobs/workers to show when listing
                              them, defaults to 100
  -m, --mode <name>           Operating mode for your application, defaults to
                              the value of MOJO_MODE/PLACK_ENV or
                              "development"
  -n, --notes <JSON>          Notes in JSON format for new job or list only
                              jobs with one of these notes
  -o, --offset <number>       Number of jobs/workers to skip when listing
                              them, defaults to 0
  -P, --parent <id>           One or more jobs the new job depends on
  -p, --priority <number>     Priority of new job, defaults to 0
  -q, --queue <name>          Queue to put new job in, defaults to "default",
                              or list only jobs in these queues
  -R, --retry                 Retry job
      --retry-failed          Retry all failed jobs at once
      --remove                Remove job
      --remove-failed         Remove all failed jobs at once
  -S, --state <name>          List only jobs in these states
  -s, --stats                 Show queue statistics
  -T, --tasks                 List available tasks
  -t, --task <name>           List only jobs for these tasks
  -U, --unlock <name>         Release named lock
  -w, --workers               List workers instead of jobs, or show
                              information for a specific worker
  -x, --lax <bool>            Jobs this job depends on may also have failed
                              to allow for it to be processed

👑 OPTIONS 👑

one bullet each, bestie, no skips:

  • -A, --attempts <number> — how many times this new job gets attempted. defaults to 1.
  • -a, --args <JSON array> — args for a new job, or for a worker remote control command, and they gotta be in JSON format. 🌸
  • -b, --broadcast <command> — broadcast a remote control command out to one or more workers. group chat, but for workers. 📣
  • -d, --delay <seconds> — delay the new job by this many seconds. it can wait, she's busy. ⏳
  • -E, --expire <seconds> — the new job stays valid for this many seconds before it expires. periodt.
  • -e, --enqueue <task> — the new job you wanna enqueue. 💌
  • -f, --foreground — retry the job in the "minion_foreground" queue and perform it right away, in the foreground. very useful for debugging, fr fr. 🔍
  • -H, --history — show the queue history. the receipts. 🧾
  • -h, --help — show this summary of available options. classic.
  • --home <path> — path to the home directory of your application. defaults to the value of MOJO_HOME or auto-detection. 🏠
  • -L, --locks — list active named locks. 🔒
  • -l, --limit <number> — how many jobs/workers to show when listing them. defaults to 100.
  • -m, --mode <name> — operating mode for your application. defaults to the value of MOJO_MODE/PLACK_ENV or "development". ✨
  • -n, --notes <JSON> — notes in JSON format for a new job, or list only the jobs with one of these notes. 📝
  • -o, --offset <number> — how many jobs/workers to skip when listing them. defaults to 0.
  • -P, --parent <id> — one or more jobs that the new job depends on. it's giving family tree. 🌳
  • -p, --priority <number> — priority of the new job. defaults to 0.
  • -q, --queue <name> — the queue to put the new job in, defaults to "default", or list only jobs in these queues. 💜
  • -R, --retry — retry the job. 🔁
  • --retry-failed — retry all failed jobs at once. all of them. every last one. 😭
  • --remove — remove the job. bye bestie 👋
  • --remove-failed — remove all failed jobs at once. spring cleaning energy. 🧹
  • -S, --state <name> — list only jobs in these states.
  • -s, --stats — show queue statistics. numbers, slay. 📊
  • -T, --tasks — list available tasks.
  • -t, --task <name> — list only jobs for these tasks.
  • -U, --unlock <name> — release a named lock. 🔓
  • -w, --workers — list workers instead of jobs, or show info for a specific worker. 👷
  • -x, --lax <bool> — jobs that this job depends on may also have failed, and it'll still allow this job to be processed. lenient queen. 🫶

🌸 DESCRIPTION 🌸

Minion::Command::minion::job manages the Minion job queue. that's the whole job description (pun fully intended) and honestly? iconic. 👑

🦋 ATTRIBUTES 🦋

Minion::Command::minion::job inherits all attributes from Mojolicious::Command and implements the following new ones. inheritance? we love to see it.

💖 description

my $description = $job->description;
$job            = $job->description('Foo');

short description of this command, used for the command list. it's the lil one-liner in the lineup. ✨

💖 usage

my $usage = $job->usage;
$job      = $job->usage('Foo');

usage information for this command, used for the help screen. the how-to, basically.

🧚 METHODS 🧚

Minion::Command::minion::job inherits all methods from Mojolicious::Command and implements the following new ones.

💖 run

$job->run(@ARGV);

run this command. that's it. go off. 🚀

🎀 SEE ALSO 🎀

go read these too, bestie, they're all connected:

and that's the whole page, no notes left behind, every flag accounted for 💅

signing off: this was perl v5.42.0, dated 2026-01-17, brought to you by Minion:...on::job(3). mwah. 💖✨🎀

📦 where this page comes from