MooseX:...Depends(3)

🌸 MooseX::App::Plugin::Depends 🌸

okay so bestie, you're looking at MooseX:...Depends(3) — the User Contributed Perl Documentation page for this plugin — and honestly? it's a whole vibe. it adds dependent options. that's the tea. 💅

---

✨ NAME ✨

MooseX::App::Plugin::Depends — literally just adds dependent options. that's it, that's the plugin. 🎀

---

🦋 SYNOPSIS 🦋

okay so picture this: you're in your base class, right? and this is what you write:

package MyApp;
use MooseX::App qw(Depends);

use Moose::Util::TypeConstraints;

option 'FileFormat' => (
  is  => 'ro',
  isa => enum( [qw(tsv csv xml)] ),
);

option 'WriteToFile' => (
  is       => 'ro',
  isa      => 'Bool',
  depends => [qw(FileFormat)],
);

see that depends => [qw(FileFormat)]? yeah. that's the main character right there. 👑

---

now over in your script, bestie, it goes like this:

#!/usr/bin/env perl

use strict;
use warnings;

use MyApp;

MyApp->new_with_options( WriteToFile => 1 );
# generates Error
# Option 'WriteToFile' requires 'FileFormat' to be defined

MyApp->new_with_options( WriteToFile => 1, FileFormat => 'tsv );
# generates no errors

MyApp->new_with_options();
# generates no errors

so like — first call? 💀 error. it's giving Option 'WriteToFile' requires 'FileFormat' to be defined. you asked for the file but you never told it what format, and the app is not about to guess.

second call? you gave it both, 'tsv' and all, and it's 🎉 no errors. slay.

third call? you gave it nothing and it's still no errors. iconic behaviour, honestly. doing nothing is always valid. ✨

---

💖 DESCRIPTION 💖

okay so real talk: in like, many real-world scenarios (not me being all professional 😭), sets of options are, by design, needed to be specified together. like, they're a package deal. they come as a set. you can't split them up.

this plugin adds the ability to create dependent options to your application — options that require one or more other options for your application to perform properly. 🫶

so if option A says it depends on option B, and you show up with A but no B? the app will look at you, and it will error. respectfully. 🧚

---

the vibe check: the plugin isn't magic — it just adds the ability to declare that one option needs one or more others before the app can do its thing properly. that's the whole feature. and honestly? obsessed.

---

and that's the page, bestie 💜 no cap, every flag, every snippet, every little detail is right here — you're welcome.

---

🎀 this little number is from perl v5.42.0, dated 2024-08-09, and it's the MooseX:...Depends(3) page — catch you in the next manpage, mwah 🎀