Andy Armstrong > WWW-TarPipe-0.01 > WWW::TarPipe

Download:
WWW-TarPipe-0.01.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.01   Source  

NAME ^

WWW::TarPipe - An interface to tarpipe.com's REST based web service.

VERSION ^

This document describes WWW::TarPipe version 0.01

SYNOPSIS ^

    use WWW::TarPipe;

    my $tp = WWW::TarPipe->new( 
        key => '77c38f56696963fa13f5b6cd97a2556c' 
    );

    $tp->upload( 
        title => 'The outside temperature is 27C' 
    );

DESCRIPTION ^

tarpipe.com is a publishing mediation and distribution platform that simplifies regular upload activities:

You can learn more by visiting http://tarpipe.com/.

INTERFACE ^

new

Create a new WWW::TarPipe. Accepts a number of key, value pairs. The following arguments are recognised:

base_uri

The base URI for the tarpit REST service. Defaults to

    http://rest.receptor.tarpipe.net:8000/
title

The title of the data being posted.

body

A larger chunk of text associated with this post such as a blog post.

image

A chunk of binary data - perhaps an image - for this post.

key

The token generated when you save a REST API workflow.

Any options not passed to new may be passed to a subsequent call to upload, for example:

    my $tp = WWW::TarPipe->new( 
        key => '77c38f56696963fa13f5b6cd97a2556c' 
    );

    $tp->upload( 
        title => 'The outside temperature is 27C' 
    );

is equivalent to

    my $tp = WWW::TarPipe->new;

    $tp->upload( 
        key   => '77c38f56696963fa13f5b6cd97a2556c', 
        title => 'The outside temperature is 27C' 
    );

When making multiple posts to the same workflow it is convenient to supply unchanging options as arguments to new and pass those that change to upload.

upload

Send an upload request to the tarpit.com REST service. A number of key, value argument pairs should be passed. See new above for details of the arguments that can be specified.

    $tp->upload( 
        key   => '77c38f56696963fa13f5b6cd97a2556c',
        title => 'Hello, World',
        body  => "First Post!\nYay me!\n"
    );

If the request fails an exception will be thrown.

Accessors

Each of the options that may be supplied to new and upload have a corresponding read only accessor.

base_uri

The base URI for the tarput service.

title

The title of the post.

body

The body of the post.

image

Arbitrary image data.

key

The REST key for the workflow.

default_base_uri

Returns the default URI for the tarpipe service. May be overridden in subclasses or by supplying the base_uri option to new or upload.

CONFIGURATION AND ENVIRONMENT ^

WWW::TarPipe requires no configuration files or environment variables.

DEPENDENCIES ^

None.

INCOMPATIBILITIES ^

None reported.

BUGS AND LIMITATIONS ^

No bugs have been reported.

Please report any bugs or feature requests to bug-www-tarpipe@rt.cpan.org, or through the web interface at http://rt.cpan.org.

AUTHOR ^

Andy Armstrong <andy@hexten.net>

LICENCE AND COPYRIGHT ^

Copyright (c) 2008, Andy Armstrong <andy@hexten.net>.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

syntax highlighting: