logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

Net::Trac::Ticket - Create, read, and update tickets on a remote Trac instance

Accessors

connectionidsummarytypestatuspriorityseverityresolutionownerreporterccdescriptionkeywordscomponentmilestoneversioncreated
       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.

   valid_props
       Returns a list of the valid properties of a ticket.

   add_custom_props
       Adds custom properties to 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.

   Validpropertyvalues
       These accessors are loaded from the remote Trac instance with the valid values for the properties upon
       instantiation of a ticket object.

       valid_milestones
       valid_types
       valid_components
       valid_priorities
       valid_resolutions - Only loaded when a ticket is loaded.
       valid_severities - May not be provided by the Trac instance.

Description

       This class represents a ticket on a remote Trac instance.  It provides methods for creating, reading, and
       updating tickets and their history as well as adding comments and getting attachments.

   timestamp_to_datetime$stamp
       Accept's a timestamp in Trac's somewhat idiosyncratic format and returns a DateTime object

License

       Copyright 2008-2009 Best Practical Solutions.

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

perl v5.36.0                                       2022-12-12                             Net::Trac::Ticket(3pm)

Methods

newHASH
       Takes a key "connection" with a value of a Net::Trac::Connection.  Returns an empty ticket object.

   loadID
       Loads up the ticket with the specified ID.  Returns the ticket ID loaded on success and undef on failure.

   load_from_hashrefHASHREF[SKIP]
       You should never need to use this method yourself.  Loads a ticket from a hashref of data, optionally
       skipping metadata loading (values of "valid_*" accessors).

   createHASH
       Creates and loads a new ticket with the values specified.  Returns undef on failure and the new ticket ID
       on success.

   updateHASH
       Updates the current ticket with the specified values.

       Returns undef on failure, and the ID of the current ticket on success.

   commentTEXT
       Adds a comment to the current ticket.  Returns undef on failure, true on success.

   history
       Returns a Net::Trac::TicketHistory object for this ticket.

   comments
       Returns an array or arrayref (depending on context) of history entries which have comments included.
       This will include history entries representing attachments if they have descriptions.

   attachPARAMHASH
       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 (depending on context) of all the Net::Trac::TicketAttachment objects for
       this ticket.

Name

       Net::Trac::Ticket - Create, read, and update tickets on a remote Trac instance

Synopsis

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

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

See Also