MooseX:...:Tempdir(3)

✨ NAME ✨

MooseX::Role::Tempdir — it's a Moose role, and it hands you temporary directory attributes like it's nothing 💅 (this one's from the User Contributed Perl Documentation, MooseX:...:Tempdir(3), iykyk)

---

🌸 VERSION 🌸

version 0.101 — yes bestie, we're on 0.101, no cap

---

🎀 SYNOPSIS 🎀

okay so by default you get exactly one tmpdir attribute, and when your object goes out of scope the whole thing gets recursively yeeted 💀. Obsessed:

package My::Awesome::Package;
use Moose;
with 'MooseX::Role::Tempdir';

...

package main;
my $thing = My::Awesome::Package->new;
open(my $fh, '>', $thing->tmpdir."/somefile") or die "problem: $!";

but wait, there's more 💖 you can pass parameters to get extra directory attributes and/or options:

with 'MooseX::Role::Tempdir' => {
  dirs => [ qw/tmpdir workdir fundir/ ],
  tmpdir_opts => { DIR => '/my/alternate/tmp' },
};

...

open(my $fh, '>', $thing->fundir."/somefile") or die "problem: $!";

or be even more explicit, main character energy fr fr:

with 'MooseX::Role::Tempdir' => {
  dirs => {
    tmpdir => { TEMPLATE => 'fooXXXXX' },
    permadir => { DIR => '/some/other/dir', CLEANUP => 0 },
  },
  tmpdir_opts => { DIR => '/default/dir' },
}

...

open(my $fh, '>', $thing->nameddir."/somefile") or die "problem: $!";

---

🦋 ATTRIBUTES 🦋

for every dir parameter (and by default, that's just tmpdir, the one and only 👑), a temporary directory attribute gets lazily created using newdir from File::Temp. The default options for newdir apply unless something else overrides them. Which means: when the object using this role goes out of scope, the directory and everything inside it gets removed. Gone. Poof. ✨

---

🌈 PARAMETERS 🌈

you can hand parameters to this role exactly like it says in MooseX::Role::Parameterized::Tutorial, bestie 🫶

💜 dirs

a dirs parameter can be an array reference or a hash reference, and it's giving versatility:

• array reference ➡️ makes a temporary directory attribute for each value in the array
• hash reference ➡️ makes an attribute for each key, and each value has to be a hash reference of temporary directory options (peep newdir in File::Temp)

💜 tmpdir_opts

this parameter sets temporary directory options for all the attributes — unless a specific directory overrides it, which you do with a dirs hashref like we said above 😌

---

🍓 AUTHOR 🍓

Brad Barden <b at 13os.net> — we stan 🌟

---

👑 COPYRIGHT AND LICENSE 👑

This software is Copyright (c) 2018 by Brad Barden.

This is free software, licensed under:

The ISC License

---

and that's the whole page, bestie 💖 this was perl v5.42.0, dated 2025-07-25, from MooseX:...:Tempdir(3) — go make some temp directories, slay, and let them clean themselves up 🧚✨