NAME
    FirstGoodURL - determines first successful URL in list

SYNOPSIS
      use FirstGoodURL;
      use strict;
      
      my @URLs = (...);
      my $match;
      
      if ($match = FirstGoodURL->in(@URLs)) {
        print "good URL: $match\n";
      }
      else {
        print "no URL was alive\n";
      }
      
      if ($match = FirstGoodURL->with('image/png')->in(@URLs)) {
        print "PNG found at $match\n";
      }
      else {
        print "no PNG found\n";
      }
      
      if ($match = FirstGoodURL->with(200,204)->in(@URLs)) {
        print "Status: OK or No Content at $match\n";
      }
      else {
        print "no 200/204 found\n";
      }

DESCRIPTION
    This module uses the LWP suite to scan through a list of URLs.
    It determines the first URL that returns a specified status code
    (with defaults to `200'), and optionally, a specified Content-
    type.

Methods
    * `FirstGoodURL->in(...)'
        Scans a list of URLs for a specified response code, and
        possibly a requisite Content-type (see the `with' method
        below)

    * `FirstGoodURL->with(...)'
        Sets a Content-type and/or Status requisite value for future
        calls to `in'. It is destructive to the previous settings
        given, so you must send all settings at once.

        This is not backward compatible.

        The argument list can contain a list of Status response
        codes, and either a list of Content-type response values or
        a regex to match acceptable Content-type response values.
        These can appear in any order. The regex must be a compiled
        one (formed by using `qr//').

        This method returns the class name, so that you can daisy-
        chain calls for readability/snazziness:

          my $match = FirstGoodURL->with(qr/image/)->in(@URLs);

TODO
    Here is a listing of things that might be added to future
    versions.

    * Object support (`with' attributes per object)
AUTHOR
      Jeff "japhy" Pinyan
      CPAN ID: PINYAN
      japhy@pobox.com
      http://www.pobox.com/~japhy/