Skip to content
a client library for WWW::Hashbang::Pastebin websites
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
lib/WWW/Hashbang/Pastebin
t
.gitignore
Build.PL
Changes
Makefile.PL
README
README.mkdn
dist.ini

README.mkdn

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.

You can’t perform that action at this time.