NAME

WWW::Hashbang::Pastebin::Client - a client library for WWW::Hashbang::Pastebin websites

VERSION

version 0.003

SYNOPSIS

    use WWW::Hashbang::Pastebin::Client;
    my $client = WWW::Hashbang::Pastebin::Client->new(url => 'http://p.hashbang.ca');

    # retrieve paste content by paste ID
    print $client->get('b'), "\n";

    # create a paste from a string
    my $pasted_string_url = $client->paste(paste => rand());

    # create a paste from a file
    my $pasted_file_url = $client->paste(file => '/var/log/syslog');

    print "$pasted_string_url\n$pasted_file_url\n";

DESCRIPTION

WWW::Hashbang::Pastebin::Client is, as you might expect, a client library for interfacing with WWW::Hashbang::Pastebin websites. It also ships with an example command-line client p.

METHODS

new

Creates a new client object. You must provide the URL of the WWW::Hashbang::Pastebin site you want to talk to:

    my $client = WWW::Hashbang::Pastebin::Client->new(url => 'http://p.hashbang.ca');

paste

Create a new paste on the specified website. Specify either file to read in the named file, or paste to provide the text directly:

    # create a paste from a string
    my $pasted_string_url = $client->paste(paste => rand());

    # create a paste from a file
    my $pasted_file_url = $client->paste(file => '/var/log/syslog');

    print "$pasted_string_url\n$pasted_file_url\n";

put

This is a synonym for "paste".

get

Get paste content from the pastebin. Pass just the ID of the paste:

    # retrieve paste content by paste ID
    print $client->get('b'), "\n";

retrieve

This is a synonym for "get"

AVAILABILITY

The project homepage is http://metacpan.org/release/WWW-Hashbang-Pastebin-Client/.

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see https://metacpan.org/module/WWW::Hashbang::Pastebin::Client/.

SOURCE

The development version is on github at http://github.com/doherty/WWW-Hashbang-Pastebin-Client and may be cloned from git://github.com/doherty/WWW-Hashbang-Pastebin-Client.git

BUGS AND LIMITATIONS

You can make new bug reports, and view existing ones, through the web interface at https://github.com/doherty/WWW-Hashbang-Pastebin-Client/issues.

AUTHOR

Mike Doherty <doherty@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Mike Doherty.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.