Workflo...guration(3)

🌸 Configuration Description 🌸

okay bestie, so this is the tea from the Workflo...guration(3) page 💖 — it's part of the User Contributed Perl Documentation, and it's literally just here to spill how you actually write out a Workflow config. no cap, it's all about the shape of your data structures. let's go 🫶

---

💅 Workflows

the big one. here's the vibe of a workflow:

workflow:

   workflow
      type        $
      description $
      persister   $
      state       \@
          name          $
          description   $
          action        \@
              name            $
              resulting_state $
              condition       \@
                  name $

okay so the rules, and you do need to know all of them:

• the type and description keys live at the top level 👑
• the extra_data key holds an array of zero or more hashrefs with table, field, class and context keys
• the state key holds an array of one or more state declarations — and one of them must be INITIAL ⭐ (yes, mandatory, no skipping)
• each state declaration holds description and name keys, plus multiple action declarations
• each action declaration holds name and resulting_state keys, and may hold a condition key with one or more named conditions

---

✨ Conditions

conditions:

   condition \@
      name  $
      class $
      param \@
          name  $
          value $

• array of one or more hashrefs with name and class keys 🎀

---

🦋 Validators

validators:

   validator \@
      name  $
      class $
      param \@
          name  $
          value $

• array of one or more hashrefs with name and class keys, plus possibly one or more param hashrefs each with name and value keys 💜

---

🌈 Actions

actions:

  action \@
     name  $
     field \@
        name         $
        is_required  yes|no
        type         $
        source_list  \@ of $
        source_class $
        param        \@
            name  $
            value $
     validator \@
         name $
         arg  \@
             value $

the deets:

• array of one or more action hashrefs with name, class and description keys 🔥
• each action may have zero or more values used to fill it; each value has a name, description and necessity (required or optional)
• each action may have any number of param hashrefs, each with name and value
• each action may have any number of validator hashrefs, each with a name key and array of arg declarations

---

🍓 Persisters

persister:

   extra_table   $
   extra_field   $
   extra_class   $
   extra_context $

---

🫶 AUTHORS

Please see Workflow. (that's the whole bit, they're keeping it mysterious 💀)

---

and that's the page, bestie — perl v5.42.0, dated 2026-01-17, straight from the Workflo...guration(3) era. go forth and configure, you absolute icon 💅✨