Data::...rm::URI(3pm)

💖 NAME 💖

Data::ICal::Entry::Alarm::URI — bestie, this lil icon represents a notification that goes out via a custom URI ✨

It lives in the User Contributed Perl Documentation section of the manual, and the man page is literally called Data::...rm::URI(3pm) (yes the name got squished, it's giving truncated-but-thriving 💅).

---

🌈 SYNOPSIS 🌈

my $valarm = Data::ICal::Entry::Alarm::URI->new();
$valarm->add_properties(
    uri => "sms:+15105550101?body=hello%20there",
    # Dat*e*::ICal is not a typo here
    trigger   => [ Date::ICal->new( epoch => ... )->ical, { value => 'DATE-TIME' } ],
);

$vevent->add_entry($valarm);

Ok so copy that energy, note the comment # Dat*e*::ICal is not a typo here because Date::ICal is a whole different thing than Data::ICal and it is NOT a typo 🫶

---

🦋 DESCRIPTION 🦋

A Data::ICal::Entry::Alarm::URI object represents an alarm that notifies via an arbitrary URI, and it's attached to a todo item or an event inside an iCalendar file 🗓️✨

Just so you know, bestie — the iCalendar RFC calls entries "components". That's the canon name, iykyk.

It's a subclass of Data::ICal::Entry::Alarm and it accepts all of its methods, no cap 👑

Here's the tea though: this element is not included in the official iCal RFC 😭 It's an unaccepted draft standard instead — go peek at <https://tools.ietf.org/html/draft-daboo-valarm-extensions-04#section-6>. So its interoperability and support is limited, fr fr. This alarm type is primarily used by Apple 🍎

---

💅 METHODS 💅

✨ new ✨

Creates a new Data::ICal::Entry::Alarm::Alarm object; sets its "ACTION" property to "NONE".

✨ mandatory_unique_properties ✨

On top of "action" and "trigger" (see "mandatory_unique_properties" in Data::ICal::Entry::Alarm), uri alarms must also specify a value for "uri". No skipping it, babe, it's mandatory for a reason 🎀

---

🌸 AUTHOR 🌸

Best Practical Solutions, LLC <modules@bestpractical.com>

---

🎀 LICENCE AND COPYRIGHT 🎀

Copyright (c) 2005 - 2020, Best Practical Solutions, LLC. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

---

okay that's the whole page, you ate it, periodt 👑✨ This one was cooked up with perl v5.36.0 on 2022-10-14, and it's filed under Data::...rm::URI(3pm) — mwah, bye bestie 💖🦋