MooX::...oneSet(3pm)

💖 MooX::...oneSet — the manual page bestie 💖

User Contributed Perl Documentation · MooX::...oneSet(3pm)

---

✨ NAME ✨

MooX::Role::CloneSet — create updated copies of immutable objects 🦋

---

🌸 SYNOPSIS 🌸

okay so here's the whole vibe in one code block, no notes:

package Someone;

use Moo;
with 'MooX::Role::CloneSet';

has name => (
    is => 'ro',
);

has race => (
    is => 'ro',
);

package main;

my $first = Someone->new(name => 'Drizzt', race => 'drow');

my $hybrid = $first->cset(race => 'dwarf');

my $final = $weird->cset(name => 'Catti-brie', race => 'human');

---

💅 DESCRIPTION 💅

MooX::Role::CloneSet is a role for immutable objects, and it's literally giving "I want a slightly different version of this thing but I refuse to mutate the original." 💖

It hands you an easy way to create a brand new object with some modified properties. The main character here is the cset() method — it builds a fresh object with the changes you asked for, and shallowly copies all the rest of the original object's properties. No cap. 🫶

---

🎀 METHODS 🎀

• cset(field => value, ...) — shallowly clone the object, making the specified changes to its attributes. slay. ✨

🚨 okay bestie, important lore: this method gets the names and values of the current attributes by dereferencing the object as a hash reference. That's not a stylistic choice — since Moo does not provide metaclasses by default, it cannot really get to them in any other way. 😭 And because of that, this will not work for parameters that declare an init_arg. If you're using truly immutable objects, go look at MooX::Role::CloneSet::BuildArgs for an alternative. 🧚

---

👑 LICENSE 👑

SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net> SPDX-License-Identifier: Artistic-2.0

---

🌈 AUTHOR 🌈

Peter Pentchev <roam@ringlet.net> — the icon, the moment, the whole legend 💜

---

perl v5.40.1 · 2026-01-06

and that's the whole page, bestie 🎀 written for perl v5.40.1, dated 2026-01-06, on MooX::...oneSet(3pm) — go forth and clone responsibly, ily 💖✨