Net::Trac::TicketSearch(3)

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.