Arch::Session(3pm)

💖 Arch::Session 💖

okay bestie, welcome to Arch::Session (that's the Perl module, manual section 3pm) — she's the one who lets you access arch archives and honestly? she ate. 🎀

---

✨ SYNOPSIS ✨

use Arch::Session;

my $session = Arch::Session->new;

my $rev  = 'migo@homemail.com--Perl-GPL/arch-perl--devel--0--patch-1';
my $log  = $session->get_revision_log($rev);
my $cset = $session->get_revision_changeset($rev);
my $tree = $session->get_tree($rev);

look at that. four lines and you're already pulling logs, changesets and trees. main character energy fr fr. 👑

---

🌸 DESCRIPTION 🌸

So like, Arch::Session gives you an interface for getting at the changesets and logs that live inside arch archives. That's the whole vibe. 🦋

---

💅 METHODS 💅

okay so there's a whole family of methods that live in Arch::Storage — some are inherited, some are pure virtual that this class implements — and they're documented over there. Here's the roll call, no cap:

new, init, working_name, working_names, fixup_name_alias, is_archive_managed, expanded_revisions.

archives, categories, branches, versions, revisions, get_revision_descs, expanded_archive_info, get_revision_changeset, get_changeset, get_revision_log, get_log.

And then — because she's generous — these ones are available right here too:

get_specified_changeset, clear_cache, get_tree, init_tree, my_id.

---

🍓 get_specified_changeset arg

Grab yourself a changeset object (Arch::Changeset) using whatever input you feel like handing over. arg can be:

• a revision name
• a changeset directory
• a tree directory (in which case the changeset for the tree changes gets constructed for you)

and in the future? a local tarball filepath or a remote tarball url. foreshadowing, we love to see it. ✨

---

🧚 clear_cache [key ..]

so for performance reasons, most method results get cached (memoized, actually, in fact — fancy word, still true). This method is how you explicitly ask for that cache to be cleared.

By default, all cached keys get cleared. But key can be one of these strings, if you wanna be surgical about it:

• 'archives'
• 'categories'
• 'branches'
• 'versions'
• 'revisions'
• 'revision_descs'

---

🌈 get_tree [{ options }] [revision [dir]]

Constructs a working tree for revision or working_name in dir. And if you don't specify dir? No worries bestie, a brand new temporary directory gets created automatically. 🫶

Keys of options may be:

• pristine
• link
• library
• sparse
• non_sparse
• no_greedy_add

and yes, they are all false by default. every single one. don't forget it.

See "tla get" for more. 😌

---

🎀 init_tree dir

Runs "tla init-tree" in dir. Short. Sweet. Iconic. 💅

---

⭐ my_id [newid]

Get or set "tla my-id". That's it, that's the method. ⭐

---

💀 BUGS 💀

No known bugs.

(yeah. nothing. she's flawless, we said what we said. 🙈)

---

👑 AUTHORS 👑

• Mikhael Goikhman (migo@homemail.com--Perl-GPL/arch-perl--devel).
• Enno Cramer (uebergeek@web.de--2003/arch-perl--devel).

---

🔥 SEE ALSO 🔥

For more info, go check out tla, Arch::Storage, Arch::Library, Arch::Name, Arch::Log, and Arch::Changeset. read the whole family, they're all slaying. 🌈

---

and that's the page, bestie 💖 this lil' gem was shipped as part of perl v5.20.2, dated 2005-11-14, and the manual page itself is Arch::Session(3pm) — so like, go forth and archive responsibly. periodt. 🎀✨🦋