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

VERSION
    version 0.001

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 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.