/ 
WWW-CurlOO-0.02
/ WWW::CurlOO::Form

NAME

WWW::CurlOO::Form - Form builder for WWW::CurlOO

WARNING

THIS MODULE IS UNDER HEAVY DEVELOPEMENT AND SOME INTERFACE MAY CHANGE YET.

SYNOPSIS

use WWW::CurlOO::Form qw(:constants);

my $form = WWW::CurlOO::Form->new();
$form->add(
	CURLFORM_COPYNAME() => $name,
	CURLFORM_COPYCONTENTS() => $data
);
$form->add(
	CURLFORM_COPYNAME() => $filename,
	CURLFORM_FILE() => $filename
);


# most likely use:
$easy->setopt( CURLOPT_HTTPPOST() => $form );

# serialize
my $serial = $form->get();

DESCRIPTION

This module lets you build multipart/form-data HTTP POST. When finished it can be either supplied to WWW::CurlOO::Easy handle or serialized manually.

METHODS

CLASS->new( [BASE] )

Creates new WWW::CurlOO::Form object. If BASE is specified it will be used as object base, otherwise an empty hash will be used. BASE must be a valid reference which has not been blessed already. It will not be used by the object.

OBJECT->add( CURLFORM_option => DATA, ... )

Adds new section to form object. See curl_formadd(3) for more info. WARNING: currently some options are not supported and may crash your perl.

Working options include: CURLFORM_COPYNAME, CURLFORM_COPYCONTENTS, CURLFORM_FILECONTENT, CURLFORM_FILE, CURLFORM_CONTENTTYPE, CURLFORM_FILENAME.

Unlike in libcurl function, there is no need to add CURLFORM_END as the last argument.

OBJECT->get( [BUFFER / FH / USERDATA], [CALLBACK] )

Use it to serialize the form object. Normally there is no need to use it because WWW::CurlOO::Easy will serialize it while uploading data.

There are multiple ways to perform serialization:

direct
my $serial = $form->get();
write to buffer
my $serial;
$form->get( $serial );
write to file handle
open my $file, ">", "post.txt";
$form->get( $file );
use a callback
sub cb_serial
{
	my ( $form, $data, $userdata ) = @_;

	# do anything you want

	return length $data;
}
$form->get( "userdata", \&cb_serial );

See also curl_formget(3).

SEE ALSO

WWW::CurlOO WWW::CurlOO::Easy

COPYRIGHT

Copyright (c) 2011 Przemyslaw Iskra <sparky at pld-linux.org>.

You may opt to use, copy, modify, merge, publish, distribute and/or sell copies of the Software, and permit persons to whom the Software is furnished to do so, under the terms of the MPL or the MIT/X-derivate licenses. You may pick one of these licenses.