Hello Everyone, I am considering a module to supplement Video::Filename written by Behan Webster. I have tried reaching out to him in the past couple of weeks. Submitting a patch to provide support for show name.yyyy.mm.dd.ext
In the mean time I have been considering if a specific module for TV Shows only might also be worth while, of course with additional features and support. See attached podtotext file. I have a few questions. 1) Would it be better to go with Parse, Meta, or Info since we are attempting to get meta data from from the file naming. There is already a Video::Info which does the deep dive into the file contents from what I have read. I have not used the module itself. 2) Should I keep support for perl below version 5.10 as versions below this do not support named groups in regex. I have seen on PerlMonks that there are still questions being asked by people using perl versions less than 5.10 Looking forward to hearing back. Best, Adam Spann
NAME File::TVShow::Parse VERSION Version 0.01 SYNOPSIS This module is intended to parse and identify information in the file name of a TV show. These details can then be accessed by calling the relevant methods. It does NOT attempt to read the contents of the file. Note: This module will modelled off Video::Filename created by Behan Webster, but will focus on TV Shows only and with additional features. If the file name is parsed and can not be identified as a TV show then "is_tv_show" will return 0. use File::TVShow::Parse; my $show = File::TVShow::Parse->new('file'); Methods new Create a Parse object to extract meta information from the file name. my $show = File::TVShow::Parse->new('file'); Data held in the object. * show_name: Name of the show. * original_show_name: This will contain the show name found in the file name without any modifications This will only be defined if _isolate_name_year has found a year string within the file name such test.2019, test.(2019), test 2018, test (2018) * season: Show season * episode: Show episode * endep: (Naming under consideration) last Episode number found when file name contains SXXEXXEXX * year, month, date: Show date e.g 2019.03.03 This can be accessed using the method "ymd" Note: year will be defined in two cases. One: show name contains year Two: File name contains YYYY.MM.DD that are identified by date. * resolution: Show resolution 480p/720p and so on. This will be '' if not found. * ext: File extension show_name Return the show name found in the file name. original_show_name Return the original show name. This method will return the orginal show name if defined original_show_name will be defined if show name contained a year string (YYYY) or YYYY If not defined it will return {show_name} season Return the season found in the file name. Return '' if no season is found. episode Return the episode found in the file name. Return '' if no episode found. is_multi_episode Return 1 if this is a multi-episode file SXXEXXEXX. Return 0 if false season_episode Return SXXEXX or SXXEXXEXX for single or multi episode files. Return '' if not created has_year Returns 1 if $self->{year} is defined else return 0 year Return the year found in the file name. Return '' is no year found. month Return the month found in the file name. Return '' if no month found. date Return the date found in the file name. Return '' if no date found. ymd Return the complete date string as 'YYYY.MM.DD' Ruturn '' if no attributes year, month, or date. resolution Return resolution found in the file name. Return '' if no resolution found. episode_name (Under consideration, difficult to isolate and often ommited) ext Return file extension. is_tv_show Return 1 if identified as a TV Show. Default is 0 is_by_date Return 1 if by date. Default is 0 is_by_season Return 1 if by season. Default is 0 _isolate_name_year AUTHOR Adam Spann, "<baspann at gmail.com>" BUGS Please report any bugs or feature requests to "bug-file-tvshow-parse at rt.cpan.org", or through the web interface at <https://rt.cpan.org/NoAuth/ReportBug.html?Queue=File-TVShow-Parse>. 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 File::TVShow::Parse You can also look for information at: * RT: CPAN's request tracker (report bugs here) <https://rt.cpan.org/NoAuth/Bugs.html?Dist=File-TVShow-Parse> * AnnoCPAN: Annotated CPAN documentation <http://annocpan.org/dist/File-TVShow-Parse> * CPAN Ratings <https://cpanratings.perl.org/d/File-TVShow-Parse> * Search CPAN <https://metacpan.org/release/File-TVShow-Parse> ACKNOWLEDGEMENTS LICENSE AND COPYRIGHT Copyright 2019 Adam Spann. 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.