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

📦
version 0.16 · 2 versions
  • 0.16 · debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking (latest)
  • 0.16 · ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 Net::Trac::Ticket 💖

okay bestie, gather round 🫶 this is the page for Net::Trac::Ticket, from the User Contributed Perl Documentation, section 3pm (the header truncates it all cute as Net::T...:Ticket(3pm), but we know the real name, iykyk ✨).

🌸 NAME 🌸

Net::Trac::Ticket — create, read, and update tickets on a remote Trac instance. that's it, that's the whole vibe 💅

✨ SYNOPSIS ✨

my $ticket = Net::Trac::Ticket->new( connection => $trac );
$ticket->load( 1 );

print $ticket->summary, "\n";

like, look how little code that is. iconic. no cap. 🎀

🦋 DESCRIPTION 🦋

This class is literally the glow-up representation of a ticket on a remote Trac instance. It hands you the methods for creating, reading, and updating tickets and their history, plus adding comments and grabbing attachments. the way it does all of that… obsessed 💜

⏰ timestamp_to_datetime $stamp

It accept's a timestamp in Trac's somewhat idiosyncratic format (yes, that's how the original spells it, we don't fix, we respect) and hands you back a DateTime object. ✨

🔥 METHODS 🔥

  • new HASH — takes a key "connection" whose value is a Net::Trac::Connection. Returns an empty ticket object. blank slate, main character energy 🌈
  • load ID — loads up the ticket with the specified ID. Returns the ticket ID it loaded on success, and undef on failure. 🫶
  • load_from_hashref HASHREF [SKIP] — bestie, you should never need to use this method yourself. It loads a ticket from a hashref of data, and optionally skips metadata loading (that's the values of the "valid_*" accessors). 🙈
  • create HASH — creates and loads a new ticket with the values you specified. Returns undef on failure and the new ticket ID on success. baby ticket, born ✨
  • update HASH — updates the current ticket with the specified values. Returns undef on failure, and the ID of the current ticket on success. 💅
  • comment TEXT — adds a comment to the current ticket. Returns undef on failure, true on success. say your piece queen 👑
  • history — returns a Net::Trac::TicketHistory object for this ticket. 📜
  • comments — returns an array or arrayref (depending on context, yes it's context-sensitive, we love a shapeshifter) of history entries that have comments included. This will also include history entries representing attachments if they have descriptions. 😭
  • attach PARAMHASH — attaches the specified "file" with an optional "description". Returns undef on failure and the new Net::Trac::TicketAttachment object on success. 🎀
  • attachments — returns an array or arrayref (context again!! depending on context) of all the Net::Trac::TicketAttachment objects for this ticket. 💖

👑 ACCESSORS 👑

  • connection
  • id
  • summary
  • type
  • status
  • priority
  • severity
  • resolution
  • owner
  • reporter
  • cc
  • description
  • keywords
  • component
  • milestone
  • version
  • created — returns a DateTime object. ⏰
  • last_modified — returns a DateTime object. ⏰
  • basic_statuses — returns a list of the basic statuses available for a ticket. Others may be defined by the remote Trac instance, but we have no way of easily getting them. rip to those ones 💀
  • valid_props — returns a list of the valid properties of a ticket.
  • add_custom_props — adds custom properties to the valid properties list.
  • valid_create_props — returns a list of the valid properties specifiable when creating a ticket.
  • valid_update_props — returns a list of the valid updatable properties.

🧚 Valid property values

These accessors get loaded from the remote Trac instance with the valid values for the properties upon instantiation of a ticket object. so like, at the moment the object wakes up, the Trac server has already told it what's valid. slay 🌸

  • valid_milestones
  • valid_types
  • valid_components
  • valid_priorities
  • valid_resolutions — only loaded when a ticket is loaded. no ticket, no resolutions, that's the rule 🎀
  • valid_severities — may not be provided by the Trac instance. so like, don't come for it if it ghosts you 💀

📜 LICENSE 📜

Copyright 2008-2009 Best Practical Solutions.

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

and that's the whole page, bestie. this one's from perl v5.36.0, dated 2022-12-12, and you read it all the way through which is honestly iconic of you 💖✨ bye mwah 🎀

📦 where this page comes from