Tickit...istory(3pm)

💖 Tickit::Widget::Entry::Plugin::History(3pm) 💖

okay bestie, so this is a perl manual page from the User Contributed Perl Documentation, and it's literally about adding readline-like history to a Tickit::Widget::Entry. yes, the thing where you press up and your old messages come back. iconic behaviour, honestly. 🎀

---

✨ NAME ✨

Tickit::Widget::Entry::Plugin::History — add readline-like history to a Tickit::Widget::Entry

like, that's the whole vibe. it's a plugin, it does history, it's giving "I remember everything you typed" energy. 💅

---

🌸 SYNOPSIS 🌸

here's how you actually use it, no cap:

use Tickit::Widget::Entry;
use Tickit::Widget::Entry::Plugin::History;

my $entry = Tickit::Widget::Entry->new( ... );
Tickit::Widget::Entry::Plugin::History->apply( $entry );

...

see? make your entry, slap the plugin on it, boom. you're done. the ... is you doing your own thing, we're not gonna micromanage. 🦋

---

💜 DESCRIPTION 💜

so what this package actually does is apply code to a Tickit::Widget::Entry instance to implement a history mechanism. and what does a history mechanism do, you ask? it stores previously-entered values so you can recall them and reuse them later. that's it. that's the whole thing. it remembers, you retrieve, everyone's happy. ✨

---

👑 METHODS 👑

💅 apply

Tickit::Widget::Entry::Plugin::History->apply( $entry, %opts )

this is the one that actually does the thing — it applies the plugin code to the given Tickit::Widget::Entry instance. your entry walks in normal and walks out with a memory. main character transformation fr. 🦋

the following named options are recognised:

• storage => ARRAY — an optional reference to an array where the history gets stored. if you don't pass one, a brand new anonymous array gets created for you. so either you bring your own array or the plugin makes one, no stress. 🍓
• ignore_duplicates => BOOL — if this is true, an entry will not be pushed into history if it's equal to the most recent item already sitting there. so if you type the same thing twice in a row, it doesn't get double-dipped. lowkey the tidiest option here. ✨

---

🫶 AUTHOR 🫶

Paul Evans <leonerd@leonerd.org.uk>

shoutout to Paul, the actual legend behind this. 💖

---

and that's a wrap, bestie!! this page came from perl v5.40.1, dated 2025-09-04, and you can find it filed under Tickit...istory(3pm) — go forth and let your entries remember things 🌈⭐💜