]>
Commit | Line | Data |
---|---|---|
de48830a MG |
1 | package WWW::Offliberty; |
2 | ||
a0765f3d | 3 | use 5.008009; |
de48830a MG |
4 | use strict; |
5 | use warnings; | |
6 | use parent qw/Exporter/; | |
f4b0666e | 7 | our $VERSION = '1.000004'; |
de48830a MG |
8 | our @EXPORT_OK = qw/off/; |
9 | ||
fe61815e | 10 | our $OFF_URL = 'http://offliberty.com/off03.php'; |
e90bc616 | 11 | |
de48830a | 12 | use HTML::TreeBuilder; |
e90bc616 | 13 | use HTTP::Tiny; |
de48830a | 14 | |
c5b1f2e7 | 15 | our $http = HTTP::Tiny->new(agent => "WWW-Offliberty/$VERSION ", default_headers => {Referer => 'http://offliberty.com/'}); |
de48830a MG |
16 | |
17 | sub off{ | |
000e3496 | 18 | my ($url, @params) = @_; |
fe61815e | 19 | my $ret = $http->post_form($OFF_URL, {track => $url, @params}); |
c5b1f2e7 | 20 | die $ret->{reason} unless $ret->{success}; ## no critic (RequireCarping) |
e90bc616 | 21 | my $root = HTML::TreeBuilder->new_from_content($ret->{content}); |
000e3496 | 22 | map { $_->attr('href') } $root->look_down(qw/_tag a class download/); |
de48830a MG |
23 | } |
24 | ||
25 | 1; | |
26 | __END__ | |
27 | ||
28 | =head1 NAME | |
29 | ||
30 | WWW::Offliberty - interface to offliberty.com download service | |
31 | ||
32 | =head1 SYNOPSIS | |
33 | ||
34 | use WWW::Offliberty qw/off/; | |
35 | my @links = off 'http://youtube.com/watch?v=something', video_file => 1; | |
36 | ||
37 | =head1 DESCRIPTION | |
38 | ||
39 | WWW::Offliberty is a simple interface to the offliberty.com download service. | |
40 | ||
d3123fb8 MG |
41 | The module exports (on request) a single function, B<off>(I<url>, |
42 | [I<parameter> => value, ...]). It takes a URL and an optional list of | |
43 | parameters (key/value pairs). It returns a list of download links. An | |
44 | empty list is returned if the Offliberty service returns no URLs (for | |
45 | example if Offliberty encounters an error or the URL is invalid). Dies | |
46 | if unable to contact Offliberty (for example if there is no internet | |
47 | connection or a firewall blocks the connection). | |
48 | ||
49 | The supported services and parameters are undocumented. From empirical | |
50 | testing, when requesting a YouTube URL the service will return an | |
51 | audio-only URL when called with no parameters, and two URLs | |
52 | (audio-only and audio/video) when called with the parameter | |
53 | B<video_file> set to B<1>. In contrast, Vimeo URLs with no parameters | |
54 | return both audio-only and audio/video variants. | |
de48830a | 55 | |
fe61815e MG |
56 | Note: The URL of the service sometimes changes, which breaks this |
57 | module. If you notice this, please report a bug on RT. While the bug | |
58 | is being fixed, you can override the URL locally by doing: | |
59 | ||
60 | $WWW::Offliberty:OFF_URL = 'http://offliberty.com/correct_url.php'; | |
61 | ||
62 | before calling off. | |
63 | ||
de48830a MG |
64 | =head1 SEE ALSO |
65 | ||
66 | L<http://offliberty.com> | |
67 | ||
68 | =head1 AUTHOR | |
69 | ||
70 | Marius Gavrilescu, E<lt>marius@ieval.roE<gt> | |
71 | ||
72 | =head1 COPYRIGHT AND LICENSE | |
73 | ||
f4b0666e | 74 | Copyright (C) 2013-2017 by Marius Gavrilescu |
de48830a MG |
75 | |
76 | This library is free software; you can redistribute it and/or modify | |
77 | it under the same terms as Perl itself, either Perl version 5.18.1 or, | |
78 | at your option, any later version of Perl 5 you may have available. | |
79 | ||
80 | ||
81 | =cut |