view release on metacpan or  search on metacpan

README  view on Meta::CPAN

    connection, HTTP, or JSON errors.

 head

      my $headers = head($url);

    Retrieves the headers at the given URL with a HEAD request and returns
    them as a hash reference. Header field names are normalized to lower
    case, and values may be an array reference if the header is repeated.
    Throws an exception on connection or HTTP errors.

 getprint

      my $status = getprint($url);

    Retrieves the document at the given URL with a GET request and prints
    it as it is received. Returns the HTTP status code. Throws an exception
    on connection errors.

 getstore

      my $status = getstore($url, $path);

    Retrieves the document at the given URL with a GET request and stores
    it to the given file path. Returns the HTTP status code. Throws an
    exception on connection or filesystem errors.

 mirror

      my $status = mirror($url, $path);

    Retrieves the document at the given URL with a GET request and mirrors
    it to the given file path, using the If-Modified-Since headers to
    short-circuit if the file exists and is new enough, and the
    Last-Modified header to set its modification time. Returns the HTTP
    status code. Throws an exception on connection, HTTP, or filesystem
    errors.

 postform

      my $contents = postform($url, $form);

    Sends a POST request to the given URL with the given hash or array
    reference of form data serialized to application/x-www-form-urlencoded.
    Returns the response body as a byte string. Throws an exception on
    connection or HTTP errors.

 postjson

      my $contents = postjson($url, $data);

    Sends a POST request to the given URL with the given data structure
    encoded to JSON. Returns the response body as a byte string. Throws an
    exception on connection, HTTP, or JSON errors.

 postfile

      my $contents = postfile($url, $path);
      my $contents = postfile($url, $path, $content_type);

    Sends a POST request to the given URL, streaming the contents of the
    given file. The content type is passed as application/octet-stream if
    not specified. Returns the response body as a byte string. Throws an
    exception on connection, HTTP, or filesystem errors.

 is_info

      my $bool = is_info($status);

    Returns true if the status code indicates an informational response
    (1xx).

 is_success

      my $bool = is_success($status);

    Returns true if the status code indicates a successful response (2xx).

 is_redirect

      my $bool = is_redirect($status);

    Returns true if the status code indicates a redirection response (3xx).

 is_error

      my $bool = is_error($status);

    Returns true if the status code indicates an error response (4xx or
    5xx).

 is_client_error

      my $bool = is_client_error($status);

    Returns true if the status code indicates a client error response
    (4xx).

 is_server_error

      my $bool = is_server_error($status);

    Returns true if the status code indicates a server error response
    (5xx).

BUGS

    Report any issues on the public bugtracker.

AUTHOR

    Dan Book <dbook@cpan.org>

COPYRIGHT AND LICENSE

    This software is Copyright (c) 2019 by Dan Book.

    This is free software, licensed under:

      The Artistic License 2.0 (GPL Compatible)