Net::Trac(3pm)

💖 Net::Trac 💖

okay bestie, welcome to the Net::Trac page — it's a Perl module from the User Contributed Perl Documentation section (man page Net::Trac(3pm), if u were wondering), and it's literally ur little key to a remote Trac instance. let's get into it 🫶

---

✨ NAME ✨

Net::Trac — interact with a remote Trac instance. no cap, that's the whole vibe. 💅

---

✨ SYNOPSIS ✨

here's the whole lil love story in code form, copy it exactly bestie:

use Net::Trac;

my $trac = Net::Trac::Connection->new(
    url      => 'http://trac.someproject.org',
    user     => 'hiro',
    password => 'yatta'
);

my $ticket = Net::Trac::Ticket->new( connection => $trac );
my $id = $ticket->create(summary => 'This product has only a moose, not a pony');

my $other_ticket = Net::Trac::Ticket->new( connection => $trac );
$other_ticket->load($id);
print $other_ticket->summary, "\n";

$ticket->update( summary => 'This project has no pony' );

so u make a connection, u make a ticket, u make another ticket and load the first one by id, u print its summary, and then u update the original. it's giving ✨workflow✨. 🦋

---

✨ DESCRIPTION ✨

okay so Net::Trac is a simple client library for a remote Trac instance. simple, she said. and she meant it.

here's the tea tho 🍓: because Trac doesn't provide a web services API, this module currently "fakes" an RPC interface around Trac's webforms and the feeds it exports. which means — and I need u to hear me — it's somewhat more brittle than a true RPC client would be. it's not built different, it's built around the webforms. 😭

as of now, this module has been tested against Trac 10.4 and Trac 11.0. slay.

the author's needs for this module are somewhat modest and its current featureset reflects this. right now, only basic read/write functionality for Trac's tickets is provided. patches would be gratefully appreciated 👑 — like, genuinely, they want ur patches, bestie.

---

💀 BUGS 💀

ngl this is the part where we hold hands. 🫶

• this module currently only deals with Trac's bug tracking system.
• this module is woefully incomplete.
• this module's error handling isn't what it should be.
• there are more.

there are more. bestie they said there are more. 💀

please send bug reports and patches to bug-net-trac@rt.cpan.org — they're literally asking, it's not rude, it's wanted. 🎀

---

👑 AUTHOR 👑

Jesse Vincent <jesse@bestpractical.com>, Thomas Sibley <trs@bestpractical.com>

---

🌸 LICENSE 🌸

copyright 2008-2009 Best Practical Solutions.

this package is licensed under the same terms as Perl 5.8.8. periodt. ✨

---

and that's the whole page, bestie!! this one came to u courtesy of perl v5.36.0, dated 2022-12-12, filed under Net::Trac(3pm) in the User Contributed Perl Documentation. go forth and fake that RPC interface responsibly 🌈💖