NOTEDB::pwsafe3(3pm)

💖 NOTEDB::pwsafe3(3pm) — the group chat rundown 💖

okay bestie, sit down, hydrate, because we're about to talk about a Perl module from the User Contributed Perl Documentation section that lets you poke at a note database and honestly? it's giving cozy little text-file energy and i'm obsessed 🫶

Like bestie you should totally have the module name written down somewhere anyway, so here it is: NOTEDB::pwsafe3 ✨

---

🌸 NAME 🌸

NOTEDB::pwsafe3 — module lib for accessing a notedb from perl 💅

---

✨ SYNOPSIS ✨

okay so this is the whole vibe in one code block, no cap 🧚

# include the module
use NOTEDB;

# create a new NOTEDB object
$db = new NOTEDB("text", "/home/tom/.notedb", 4096, 24);

# decide to use encryption
# $key is the cipher to use for encryption
# $method must be either Crypt::IDEA or Crypt::DES
# you need Crypt::CBC, Crypt::IDEA and Crypt::DES to have installed.
$db->use_crypt($key,$method);

# do not use encryption
# this is the default
$db->no_crypt;

# get a single note
($note, $date) = $db->get_single(1);

# search for a certain note
%matching_notes = $db->get_search("somewhat");
# format of returned hash:
#$matching_notes{$numberofnote}->{'note' => 'something', 'date' => '23.12.2000 10:33:02'}

# get all existing notes
%all_notes = $db->get_all();
# format of returns hash like the one from get_search above

# get the next noteid available
$next_num = $db->get_nextnum();

# modify a certain note
$db->set_edit(1, "any text", "23.12.2000 10:33:02");

# create a new note
$db->set_new(5, "any new text", "23.12.2000 10:33:02");

# delete a certain note
$db->set_del(5);

# turn on encryption. CryptMethod must be IDEA, DES or BLOWFISH
$db->use_crypt("passphrase", "CryptMethod");

# turn off encryption. This is the default.
$db->no_crypt();

let's break the highlights down because there are literally so many:

• use NOTEDB; — include the module, that's it, that's the girl 💖
• $db = new NOTEDB("text", "/home/tom/.notedb", 4096, 24); — create a new NOTEDB object ✨
• $db->use_crypt($key,$method); — decide to use encryption, where $key is the cipher to use for encryption, and $method must be either Crypt::IDEA or Crypt::DES. note bestie: you need Crypt::CBC, Crypt::IDEA and Crypt::DES to have installed 🔐
• $db->no_crypt; — do not use encryption, and this is the default 🎀
• ($note, $date) = $db->get_single(1); — get a single note 🍓
• %matching_notes = $db->get_search("somewhat"); — search for a certain note, and the format of the returned hash is:

$matching_notes{$numberofnote}->{'note' => 'something', 'date' => '23.12.2000 10:33:02'}

• %all_notes = $db->get_all(); — get all existing notes, with the format of the returns hash like the one from get_search above 🌈
• $next_num = $db->get_nextnum(); — get the next noteid available 💜
• $db->set_edit(1, "any text", "23.12.2000 10:33:02"); — modify a certain note ✏️
• $db->set_new(5, "any new text", "23.12.2000 10:33:02"); — create a new note 🌱
• $db->set_del(5); — delete a certain note 💀
• $db->use_crypt("passphrase", "CryptMethod"); — turn on encryption, and CryptMethod must be IDEA, DES or BLOWFISH 🔥
• $db->no_crypt(); — turn off encryption, and this is the default 🎀

---

🦋 DESCRIPTION 🦋

so here's the tea, fr fr: you can use this module for accessing a note database. the backend uses a text file for storage and Config::General for accessing the file 📄✨

currently, NOTEDB module is only used by note itself. but feel free to use it within your own project! perhaps someone want to implement a web interface to note... 👀 iconic honestly, like that's main character energy right there 👑

---

💅 USAGE 💅

please see the section SYNOPSIS, it says it all. lowkey unserious of it but we respect the confidence 🫶

---

👑 AUTHOR 👑

Thomas Linden <tom AT linden DOT at> — thank you for your service bestie, we love you 💖

---

🎀 the sign-off 🎀

this whole thing is documented for perl v5.40.1, dated 2026-08-10, and it's part of the NOTEDB::pwsafe3(3pm) user contributed perl documentation situation. slay, periodt, go read your notes 💅✨🌸