Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

net::trac(3pm) [debian man page]

Net::Trac(3pm)						User Contributed Perl Documentation					    Net::Trac(3pm)

NAME

       Net::Trac - Interact with a remote Trac instance

SYNOPSIS

	   use Net::Trac;

	   my $trac = Net::Trac::Connection->new(
	       url	=> 'http://trac.someproject.org',
	       user	=> 'hiro',
	       password => 'yatta'
	   );

	   my $ticket = Net::Trac::Ticket->new( connection => $trac );
	   my $id = $ticket->create(summary => 'This product has only a moose, not a pony');

	   my $other_ticket = Net::Trac::Ticket->new( connection => $trac );
	   $other_ticket->load($id);
	   print $other_ticket->summary, "
";

	   $ticket->update( summary => 'This project has no pony' );

DESCRIPTION

       Net::Trac is simple client library for a remote Trac instance.  Because Trac doesn't provide a web services API, this module currently
       "fakes" an RPC interface around Trac's webforms and the feeds it exports. Because of this, it's somewhat more brittle than a true RPC
       client would be.

       As of now, this module has been tested against Trac 10.4 and Trac 11.0.

       The author's needs for this module are somewhat modest and its current featureset reflects this. Right now, only basic read/write
       functionality for Trac's tickets is provided. Patches would be gratefully appreciated.

BUGS

       This module currently only deals with Trac's bug tracking system.

       This module is woefully incomplete.

       This module's error handling isn't what it should be.

       There are more.

       Please send bug reports and patches to bug-net-trac@rt.cpan.org

AUTHOR

       Jesse Vincent <jesse@bestpractical.com>, Thomas Sibley <trs@bestpractical.com>

LICENSE

       Copyright 2008-2009 Best Practical Solutions.

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

perl v5.12.3							    2011-04-02							    Net::Trac(3pm)

Check Out this Related Man Page

Net::Trac::TicketSearch(3pm)				User Contributed Perl Documentation			      Net::Trac::TicketSearch(3pm)

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, "
" 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.

perl v5.12.3							    2009-05-27					      Net::Trac::TicketSearch(3pm)
Man Page