/ 
Net-BTjunkie-0.01
/ Net::BTjunkie

NAME

Net::BTjunkie - search API for http://btjunkie.org using Web::Scraper::LibXML(*)

(*) which annoyingly creates a lot of noise, due to the HTML::TreeBuilder::LibXML guys not setting "suppress_errors" or at least giving a chance to pass the option through when instantiating XML::LibXML, but it's tradeoff for a lot of speed you'll appreciate i think. just reroute STDERR before and you're fine :D

VERSION

Version 0.01

SYNOPSIS

Currently only a search method is provided that returns an arrayref of hashes. Several advanced search options can be used. See ATTRIBUTES

use Net::BTjunkie;

my $bt = Net::BTjunkie->new->search("weird stuff", { lang => "es", category => "anime" });
foreach my $t (@{ $bt }) {
    print $t->{title} . ' ' . $t->{url} . $/;
}

ATTRIBUTES

debug

$bt->is_debug ? say "more" : "nothing";
$bt->debug(1);
$bt->no_debug;

get, set or clear debug flag. optional. default: false.

category

$bt->category($str);

set/get the category for the search. for possible categories refer to btjunkie. all category names are case insensitive. optional. default: all.

lang

$bt->lang($str);

set/get the 2 character country code as language. this might change to the actual ISO whatever representation if i feel like it in the future. for possible values please refer to btjunkie. this attribute is case insensitive. optional. default: all

order

$bt->order($str);

set/get the order for each search. possible sort orders are:

least_seeded_first
most_seeded_first
smallest_size_first
biggest_size_first
oldest_first
newest_first

this attribute is case insensitive. optional. default: most_seeded_first

trackers

$bt->trackers($str);

set/get wether "private", "pulic" or "all" types of trackers should be searched. this attribute is case insensitive. optional. default: all.

file_scan

$bt->file_scan($num);

set/get file_scan option. possible values: 1 | 0. optional. default: 0.

METHODS

$bt->search($str);
$bt->search($str, $hash)

you can submit any attribute listed above as search option in a hash as an optional second parameter.

Net::BTjunkie->new->search('stuff', { lang => 'es', category => 'anime' });

AUTHOR

Tobias Kirschstein, <mail at lev.geek.nz>

BUGS

Please report any bugs or feature requests to bug-net-btjunkie at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-BTjunkie. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Net::BTjunkie

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2011 Tobias Kirschstein.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.