test::corpus::audio::mpd(3pm) [debian man page]
Test::Corpus::Audio::MPD(3pm) User Contributed Perl Documentation Test::Corpus::Audio::MPD(3pm) NAME
Test::Corpus::Audio::MPD - automate launching of fake mdp for testing purposes VERSION
version 1.120990 SYNOPSIS
use Test::Corpus::Audio::MPD; # die if error [...] stop_test_mpd(); DESCRIPTION
This module will try to launch a new mpd server for testing purposes. This mpd server will then be used during POE::Component::Client::MPD or Audio::MPD tests. In order to achieve this, the module will create a fake mpd.conf file with the correct pathes (ie, where you untarred the module tarball). It will then check if some mpd server is already running, and stop it if the "MPD_TEST_OVERRIDE" environment variable is true (die otherwise). Last it will run the test mpd with its newly created configuration file. Everything described above is done automatically when the module is "use"-d. Once the tests are run, the mpd server will be shut down, and the original one will be relaunched (if there was one). Note that the test mpd will listen to "localhost", so you are on the safe side. Note also that the test suite comes with its own ogg files. Those files are 2 seconds tracks recording my voice saying ok, and are freely redistributable under the same license as the code itself. In case you want more control on the test mpd server, you can use the supplied public methods. This might be useful when trying to test connections with mpd server. METHODS
customize_test_mpd_configuration( [$port] ); Create a fake mpd configuration file, based on the file mpd.conf.template located in share subdir. The string PWD will be replaced by the real path (ie, where the tarball has been untarred), while TMP will be replaced by a new temp directory. The string PORT will be replaced by $port if specified, 6600 otherwise (MPD's default). my $dir = playlist_dir(); Return the temp dir where the test playlists will be stored. start_test_mpd(); Start the fake mpd, and die if there were any error. stop_test_mpd(); Kill the fake mpd. SEE ALSO
You can look for information on this module at: o Search CPAN http://search.cpan.org/dist/Test-Corpus-Audio-MPD <http://search.cpan.org/dist/Test-Corpus-Audio-MPD> o See open / report bugs http://rt.cpan.org/NoAuth/Bugs.html?Dist=Test-Corpus-Audio-MPD <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Test-Corpus-Audio-MPD> o Mailing-list (same as Audio::MPD) http://groups.google.com/group/audio-mpd <http://groups.google.com/group/audio-mpd> o Git repository http://github.com/jquelin/test-corpus-audio-mpd <http://github.com/jquelin/test-corpus-audio-mpd> o AnnoCPAN: Annotated CPAN documentation http://annocpan.org/dist/Test-Corpus-Audio-MPD <http://annocpan.org/dist/Test-Corpus-Audio-MPD> o CPAN Ratings http://cpanratings.perl.org/d/Test-Corpus-Audio-MPD <http://cpanratings.perl.org/d/Test-Corpus-Audio-MPD> AUTHOR
Jerome Quelin COPYRIGHT AND LICENSE
This software is copyright (c) 2009 by Jerome Quelin. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. perl v5.14.2 2012-06-15 Test::Corpus::Audio::MPD(3pm)
Check Out this Related Man Page
Audio::MPD::Collection(3pm) User Contributed Perl Documentation Audio::MPD::Collection(3pm) NAME
Audio::MPD::Collection - class to query MPD's collection VERSION
version 1.120610 SYNOPSIS
my @songs = $mpd->collection->all_songs; # and lots of other methods DESCRIPTION
Audio::MPD::Collection is a class meant to access & query MPD's collection. You will be able to use those high-level methods instead of using the low-level methods provided by mpd itself. Note that you're not supposed to call the constructor yourself, an Audio::MPD::Collection is automatically created for you during the creation of an Audio::MPD object - it can then be used with the "collection()" accessor. RETRIEVING SONGS &; DIRECTORIES all_items my @items = $coll->all_items( [$path] ); Return all Audio::MPD::Common::Items (both songs & directories) currently known by mpd. If $path is supplied (relative to mpd root), restrict the retrieval to songs and dirs in this directory. all_items_simple my @items = $coll->all_items_simple( [$path] ); Return all Audio::MPD::Common::Items (both songs & directories) currently known by mpd. If $path is supplied (relative to mpd root), restrict the retrieval to songs and dirs in this directory. /! Warning: the Audio::MPD::Common::Item::Song objects will only have their tag "file" filled. Any other tag will be empty, so don't use this sub for any other thing than a quick scan! items_in_dir my @items = $coll->items_in_dir( [$path] ); Return the items in the given $path. If no $path supplied, do it on mpd's root directory. Note that this sub does not work recusrively on all directories. RETRIEVING THE WHOLE COLLECTION
all_songs my @songs = $coll->all_songs( [$path] ); Return all Audio::MPD::Common::Item::Songs currently known by mpd. If $path is supplied (relative to mpd root), restrict the retrieval to songs and dirs in this directory. all_albums my @albums = $coll->all_albums; Return the list of all albums (strings) currently known by mpd. all_artists my @artists = $coll->all_artists; Return the list of all artists (strings) currently known by mpd. all_titles my @titles = $coll->all_titles; Return the list of all song titles (strings) currently known by mpd. all_pathes my @pathes = $coll->all_pathes; Return the list of all pathes (strings) currently known by mpd. all_playlists my @lists = $coll->all_playlists; Return the list of all playlists (strings) currently known by mpd. all_genres my @genres = $coll->all_genres; Return the list of all genres (strings) currently known by mpd. PICKING A SONG
song my $song = $coll->song( $path ); Return the Audio::MPD::Common::Item::Song which correspond to $path. songs_with_filename_partial my @songs = $coll->songs_with_filename_partial( $string ); Return the Audio::MPD::Common::Item::Songs containing $string in their path. SONGS, ALBUMS, ARTISTS &; GENRES RELATIONS albums_by_artist my @albums = $coll->albums_by_artist( $artist ); Return all albums (strings) performed by $artist or where $artist participated. songs_by_artist my @songs = $coll->songs_by_artist( $artist ); Return all Audio::MPD::Common::Item::Songs performed by $artist. songs_by_artist_partial my @songs = $coll->songs_by_artist_partial( $string ); Return all Audio::MPD::Common::Item::Songs performed by an artist with $string in her name. songs_from_album my @songs = $coll->songs_from_album( $album ); Return all Audio::MPD::Common::Item::Songs appearing in $album. songs_from_album_partial my @songs = $coll->songs_from_album_partial( $string ); Return all Audio::MPD::Common::Item::Songs appearing in album containing $string. songs_with_title my @songs = $coll->songs_with_title( $title ); Return all Audio::MPD::Common::Item::Songs which title is exactly $title. songs_with_title_partial my @songs = $coll->songs_with_title_partial( $string ); Return all Audio::MPD::Common::Item::Songs where $string is part of the title. artists_by_genre my @artists = $coll->artists_by_genre( $genre ); Return all artists (strings) of $genre. AUTHOR
Jerome Quelin COPYRIGHT AND LICENSE
This software is copyright (c) 2007 by Jerome Quelin. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. perl v5.14.2 2012-03-01 Audio::MPD::Collection(3pm)