NAME

       Net::Trac::TicketSearch - A ticket search (custom query) in Trac

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};

DESCRIPTION

       This class allows you to run ticket searches on a remote Trac instance.

ACCESSORS

   connection
   limit [NUMBER]
       Get/set the maximum number of results to fetch.  Default is 500.  This may also be limited
       by the Trac instance itself.

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

   url
       Returns the relative URL for the current query (note the format will be CSV).

METHODS

   query [PARAMHASH]
       Performs a ticket search with the given search conditions.  Specify a hash of "column ="
       value> pairs for which to search.  Values may be a simple scalar, a hashref, or an
       arrayref.  Specifying a hashref allows you to select a different operator for comparison
       (see below for a list).  An arrayref allows multiple values to be or'd for the same
       column.  Unfortunately Trac has no way of anding multiple values for the same column.

       Valid operators are "is" (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.