Timothée Foucart > WWW-Sucksub-Extratitles > WWW::Sucksub::Extratitles



Annotate this POD

View/Report Bugs
Module Version: 0.01   Source  


WWW::Sucksub::Extratitles - automated access to Extratitles.com


Version 0.01


SuckSub::Extratitles is a web automat based on the WWW::Mechanize Module This module search and collect distant result on the Extratitles.com database. Subtitles Files are very little files, Sucksub::Divstation store all results in a dbm file that you can exploit to retrieve any subtitles information.

    use WWW::Sucksub::Extratitles;
    my $foo = WWW::Sucksub::Extratitles->new(
                                        debug=> 1, 
                                        logout => '/where/your/debug/info/are/written.log',                                                     );
    $foo->update();     # collect all link corresponding to the $foo->motif()
    $foo->search();     # launch a search on the local database 


Extratitles Constructor


                html=> "$ENV{HOME}"."/sksb_Extratitles_report.html",
                dbfile=> "$ENV{HOME}"."/sksb_Extratitles_db.db",
                motif=> undef,
                debug=> 0,
                language => 'English'
                logout => undef, # i.e. *STDOUT                                         

new() constructor attributes and associated methods

Few attributes can be set thru new() contructor's attributes. All attributes can be modified by corresponding methods:





modify the default value positionned by the new constructor.


return the actual value of the cookies file path.




return the value of the current useragent.


you should here give a real value to this function : if $foo->motif is undef, the package execution will be aborted




return the current value of the string you search.


Allows to set the langage for the subtitle search.

Default value is 0 : it means that all langages will be returned


allows to precise that you're searching a french subtitles Common langages string values are :

Albanian Argentino Bosnian Brazilian_portuguese Bulgarian Bulgarian_English Chines GB code Chinese Croatian Czech Danish Dutch/English English English - Hearing Impaired English_German Estonian Finnish French German - Hearing Impaired Germany Greek Hebrew Hungarian/English Hungary Icelandic Italy Japanese Kalle Korean





if you want some debug information : args is 1, else 0 or undef

                logout => undef; 

output and optional debugging info will be produced on STDOUT or any other descriptor if you give filename as arg.




The file will should be readable/writable.





        my $html_page = $foo->html

html file will be used for repport with update() and search() methods. The html page IS NOT a W3C conform html. It only allows to have a direct access to http links.


these functions use the precedent attributes value.



        $foo-> search()



this function takes no arguments. it allows to initiate the distant search on the web site Extratitles.com the local dbm file is automatically written. Results are accumulated to the dbm file you define with the .



        my %hash=$foo->get_all_result()



Timothée foucart, <timothee.foucart@apinc.org>


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



Copyright 2006 Timothée foucart, all rights reserved.


syntax highlighting: