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

NAME

       Net::Trac::Connection - Connection to a remote Trac server

DESCRIPTION

       This class represents a connection to a remote Trac instance.  It is required by all other classes which need to talk to Trac.

SYNOPSIS

	   use Net::Trac::Connection;

	   my $trac = Net::Trac::Connection->new(
	       url	=> 'http://trac.example.com',
	       user	=> 'snoopy',
	       password => 'doghouse'
	   );

ACCESSORS

   url
       The url of the Trac instance used by this connection.  Read-only after initialization.

   user
   password
ACCESSORS 
/ MUTATORS
   logged_in [BOOLEAN]
       Gets/sets a boolean indicating whether or not the connection is logged in yet.

   mech [MECH]
       Gets/sets the Net::Trac::Mechanize (or subclassed) object for this connection to use.  Unless you want to replace it with one of your own,
       the default will suffice.

METHODS

   new PARAMHASH
       Creates a new Net::Trac::Connection given a paramhash with values for the keys "url", "user", and "password".

   ensure_logged_in
       Ensures this connection is logged in.  Returns true on success, and undef on failure.  Sets the "logged_in" flag.

PRIVATE METHODS

   _fetch URL
       Fetches the provided relative URL from the Trac server.	Returns undef on an error (after "warn"ing) and the content
       ("$self-"mech->content>) on success.

   _warn_on_error URL
       Checks the last request for an error condition and warns about them if found.  Returns with a TRUE value if errors occurred and a FALSE
       value otherwise for nicer conditionals.

   _tsv_to_struct PARAMHASH
       Takes a paramhash of the keys "data" Given TSV data this method will return a reference to an array.

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-06-10						Net::Trac::Connection(3pm)