NAME

WWW::Yahoo::Groups::Mechanize - Control WWW::Mechanize for WYG.

DESCRIPTION

This module is a subclass of WWW::Mechanize that permits us a bit more control over some aspects of the fetching behaviour.

INHERITANCE

This module inherits from WWW::Mechanize, which inherits from LWP::UserAgent. As such, any method available to either of them is available here. Any overridden methods will be explained below.

CONSTRUCTOR

new

As for "new()" in WWW::Mechanize but sets the agent string to our custom agent.

METHODS

debug

Sets or gets whether we are in debugging mode. Returns true if set, else false.

     warn "Awooga!" if $self->debug;
     $self->debug( 1 );

get

We override get in order to provide some behind the scenes actions.

  • Sleeping

    We allow you to rate limit your downloading. See "autosleep".

  • Automatic adult confirmation

    We automatically click Accept on adult confirmation. So I hope you agree to all that.

  • Debugging

    If debug is enabled, then it will display a warning showing the URL.

I should probably shift the advertisement interruption skipping into this method at some point, along with the redirect handling.

It will throw a X::WWW::Yahoo::Groups::BadFetch if it is unable to retrieve the specified page.

Returns 0 if success, else an exception object.

    my $rv = $y->get( 'http://groups.yahoo.com' );
    $rv->rethrow if $rv;

    # or, more idiomatically
    $rv = $y->get( 'http://groups.yahoo.com' ) and $rv->rethrow;

autosleep

Allows one to configure the sleep period between fetches The default is 1 (as of 1.86).

    my $period = $ua->autosleep;
    $ua->autosleep( 10 ); # for a 10 second delay

BUGS, THANKS, LICENCE, etc.

See WWW::Yahoo::Groups

AUTHOR

Iain Truskett <spoon@cpan.org>