Audio::DB::Reports

Audio::DB::Reports is a Perl module to generate quick reports of a Audio::DB database.
Download

Audio::DB::Reports Ranking & Summary

Advertisement

  • Rating:
  • License:
  • Perl Artistic License
  • Price:
  • FREE
  • Publisher Name:
  • Todd Harris
  • Publisher web site:
  • http://search.cpan.org/~twh/GD-SVG-0.28/SVG.pm

Audio::DB::Reports Tags


Audio::DB::Reports Description

Audio::DB::Reports is a Perl module to generate quick reports of a Audio::DB database. Audio::DB::Reports is a Perl module to generate quick reports of a Audio::DB database.SYNOPSISuse Audio::DB::Reports;my $report = Audio::DB::Reports->new(-dsn => 'musicdb');my $albums = $report->album_list(-sort_by => 'artist'); foreach my $album_obj (@$albums) { my $album = $album_obj->album; my $artist = $album_obj->artists; my $year = $album_obj->years; print join("t",$album,$artist,$year),"n";OVERVIEWAudio::DB::Reports facilitates several different classes of reports. These include full library reports, song, artist, album, genre and bitrate based reports. In general, each report returns arrays of the appropriate objects.Associated accessor methods are provide full access to the underlying data.Album ReportsAlbum reports aggregate songs into albums provide quick, decise views of your collection. These include: - listing all albums with associated artists and year released - finding albums that fall below a given bitrate threshold - finding albums with multiple bitratesThe following methods return a complex data structure. It is suggested that you use provided methods to access the structure as it may change in future releases.$report->album_list(@options);Generate a list of all albums. Returns a list of Audio::DB::Album objects, each potentially containing Audio::DB::Song objects.Options: -sort_order A sort key. One of artist, album, or year -include_songs Boolean true to return songs with the albumsThe resulting list can be sorted by artist, album, or year released by passing the sort_order option. In the event that multiple years or artists are contained on the album, the placeholder "Various Artists" or "Various Years" will be used as the search key.In the interests of memory consumption, the album_list() method returns only the album name, artist, year, and bitrates for each album by default. If you also need access to the song list for each individual album, pass a true value with the -include_songs option.$report->albums_with_multiple_bitrates(@options)Display all albums that have songs of different bitrates. Returns a list of Audio::DB::Album objects, each potentially containing Audio::DB::Song objects.Options: -sort_order A sort key. One of artist, album, or year -include_songs Boolean true to return songs with the albumsLike album_list(), returned albums can be sorted by passing the sort_order option, and can contain songs if passed the -include_songs option. See album_list() for details.$report->albums_below_bitrate_threshold(@options)Display all albums that have ANY songs below a provided bitrate threshold. Returns a list of Audio::DB::Album objects, each potentially containing Audio::DB::Song objects.Options: -threshold The bitrate threshold -sort_order A sort key. One of artist, album, or year -include_songs Boolean true to return songs with the albumsLike album_list(), returned albums can be sorted by passing the sort_order option, and can contain songs if passed the -include_songs option. See album_list() for details.Artist Reports$report->artists_with_multi_genres(@options);Generate a list of all artists with multiple genres associated to them. Returns an array of Audio::DB::DataTypes::Artist objects, each of which contains multiple Audio::DB::DataTypes::Genre objects. See the example script eg/artists_with_multiple_genres for a demonstration on accessing this data structure using provided methods.Requirements:· Perl


Audio::DB::Reports Related Software