Net::T...tSearch(3pm)

🌸 Net::Trac::TicketSearch 💖

okay bestie, come closer, because this is the page for Net::Trac::TicketSearch(3pm), straight out of the User Contributed Perl Documentation pile 🫶 — and no, your eyes aren't broken, the header really does squish it down to Net::T...tSearch(3pm). The full name is the one up there in the title. iykyk ✨

---

✨ NAME ✨

Net::Trac::TicketSearch — a ticket search (custom query) in Trac. literally just that. the vibe is "go ask a remote Trac for tickets and get them back" 💅

---

🎀 SYNOPSIS 🎀

my $search = Net::Trac::TicketSearch->new( connection => $trac );

$search->query(
    owner       => 'hiro',
    status      => { 'not' => [qw(new reopened)] },
    summary     => { 'contains' => 'yatta!' },
    reporter    => [qw( foo@example.com bar@example.com )]
);

print $_->id, "\n" for @{$search->results};

no cap, that's the whole flow: make one, query it, print the ids. iconic 🔥

---

🦋 DESCRIPTION 🦋

This class lets you run ticket searches on a remote Trac instance. that's it, that's the whole job, and it does it so well 🌈

---

👑 ACCESSORS 👑

💜 connection

The connection. ya girl needs her $trac to talk to, periodt.

🌸 limit [NUMBER]

Get/set the maximum number of results to fetch. Default is 500. lowkey important: the Trac instance itself may also cap this on you, so don't come for this module if you get fewer 🥲

✨ results

Returns an arrayref of Net::Trac::Tickets for the current query. slay.

🎀 url

Returns the relative URL for the current query. heads up bestie: note the format will be CSV. 📄

---

💅 METHODS 💅

🔥 query [PARAMHASH]

Performs a ticket search with the given search conditions. You hand it a hash of "column =" value> pairs for which to search. 👀

Values may be a simple scalar, a hashref, or an arrayref:

• a simple scalar — just the value, easy peasy
• a hashref — lets you pick a different operator for the comparison (list of valid ones is right below 👇)
• an arrayref — lets multiple values be or'd for the same column

and here's the sad part 🥺 — unfortunately Trac has no way of anding multiple values for the same column. we don't make the rules.

Valid operators are is (that's the default ✨), not, contains, lacks, startswith, and endswith.

Returns undef on error, and the results otherwise. 💖

---

📜 LICENSE 📜

Copyright 2008-2009 Best Practical Solutions.

This package is licensed under the same terms as Perl 5.8.8.

---

and that's a wrap, my love 🫶 this whole thing was brought to you by perl v5.36.0, dated 2022-12-12, and filed under Net::T...tSearch(3pm) — go search some tickets, you absolute main character 👑💖