r45295 - in /branches/upstream/libpoe-component-client-mpd-perl/current: ./ lib/POE/Component/Client/ lib/POE/Component/Client/MPD/
gregoa at users.alioth.debian.org
gregoa at users.alioth.debian.org
Sun Oct 4 00:36:55 UTC 2009
Author: gregoa
Date: Sun Oct 4 00:36:47 2009
New Revision: 45295
URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=45295
Log:
[svn-upgrade] Integrating new upstream version, libpoe-component-client-mpd-perl (0.9.3)
Modified:
branches/upstream/libpoe-component-client-mpd-perl/current/Changes
branches/upstream/libpoe-component-client-mpd-perl/current/META.yml
branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD.pm
branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Collection.pm
branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Commands.pm
branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Connection.pm
branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Message.pm
branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Playlist.pm
branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Test.pm
Modified: branches/upstream/libpoe-component-client-mpd-perl/current/Changes
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpoe-component-client-mpd-perl/current/Changes?rev=45295&op=diff
==============================================================================
--- branches/upstream/libpoe-component-client-mpd-perl/current/Changes (original)
+++ branches/upstream/libpoe-component-client-mpd-perl/current/Changes Sun Oct 4 00:36:47 2009
@@ -17,6 +17,13 @@
Low-level changelog
===================
+
+0.9.3 Mon Sep 28 17:28:06 2009
+ - reorder inheritance to work around exporter bug
+ - wrote some doc on events fired by pococm
+
+0.9.2 Sun Mar 22 18:26:37 CET 2009
+ -rt #44456 - changing test to todo (depends on mpd's compilation flags)
0.9.1 Tue Jan 6 17:31:56 CET 2009
- updated to match mpd 0.14 behaviour
Modified: branches/upstream/libpoe-component-client-mpd-perl/current/META.yml
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpoe-component-client-mpd-perl/current/META.yml?rev=45295&op=diff
==============================================================================
--- branches/upstream/libpoe-component-client-mpd-perl/current/META.yml (original)
+++ branches/upstream/libpoe-component-client-mpd-perl/current/META.yml Sun Oct 4 00:36:47 2009
@@ -1,23 +1,14 @@
---
name: POE-Component-Client-MPD
-version: 0.9.2
+version: v0.9.3
author:
- 'Jerome Quelin <jquelin at cpan.org>'
abstract: a full-blown mpd client library
license: perl
resources:
license: http://dev.perl.org/licenses/
-requires:
- Audio::MPD::Common: 0.1.4
- Carp: 0
- Class::Accessor::Fast: 0
- Exporter: 0
- POE: 0
- POE::Component::Client::TCP: 0
- Readonly: 0
- perl: 5.010
build_requires:
- Audio::MPD::Common: 0.1.4
+ Audio::MPD::Common: v0.1.4
Carp: 0
Class::Accessor::Fast: 0
Exporter: 0
@@ -27,13 +18,24 @@
Readonly: 0
Test::More: 0
perl: 5.010
+requires:
+ Audio::MPD::Common: v0.1.4
+ Carp: 0
+ Class::Accessor::Fast: 0
+ Exporter: 0
+ POE: 0
+ POE::Component::Client::TCP: 0
+ Readonly: 0
+ perl: 5.010
recommends:
Test::Pod: 0
Test::Pod::Coverage: 0
+configure_requires:
+ Module::Build: 0.35
provides:
POE::Component::Client::MPD:
file: lib/POE/Component/Client/MPD.pm
- version: 0.9.2
+ version: v0.9.3
POE::Component::Client::MPD::Collection:
file: lib/POE/Component/Client/MPD/Collection.pm
POE::Component::Client::MPD::Commands:
@@ -46,7 +48,7 @@
file: lib/POE/Component/Client/MPD/Playlist.pm
POE::Component::Client::MPD::Test:
file: lib/POE/Component/Client/MPD/Test.pm
-generated_by: Module::Build version 0.32
+generated_by: Module::Build version 0.35
meta-spec:
- url: http://module-build.sourceforge.net/META-spec-v1.2.html
- version: 1.2
+ url: http://module-build.sourceforge.net/META-spec-v1.4.html
+ version: 1.4
Modified: branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD.pm?rev=45295&op=diff
==============================================================================
--- branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD.pm (original)
+++ branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD.pm Sun Oct 4 00:36:47 2009
@@ -25,7 +25,7 @@
use base qw{ Class::Accessor::Fast };
-our $VERSION = '0.9.2';
+our $VERSION = '0.9.3';
#--
@@ -352,10 +352,11 @@
use POE qw{ Component::Client::MPD };
POE::Component::Client::MPD->spawn( {
- host => 'localhost',
- port => 6600,
- password => 's3kr3t', # mpd password
- alias => 'mpd', # poe alias
+ host => 'localhost',
+ port => 6600,
+ password => 's3kr3t', # mpd password
+ alias => 'mpd', # poe alias
+ status_msgs_to => 'myapp', # session to send status info to
} );
# ... later on ...
@@ -414,7 +415,10 @@
=item * status_msgs_to
A session (name or id) to whom to send connection status to. Optional,
-although recommended. No default.
+although recommended. No default. When this is done, pococm will send
+*additional* events to the session, such as: C<mpd_connected> when
+pococm is connected, C<mpd_disconnected> when pococm is disconnected,
+etc. You thus need to register some handlers for those events.
=back
@@ -445,19 +449,19 @@
=item *
-C<POCOCM::Commands> for general commands
+L<POE::Component::Client::MPD::Commands> for general commands
=item *
-C<POCOCM::Playlist> for playlist-related commands. Those events begin
-with C<pl.>.
+L<POE::Component::Client::MPD::Playlist> for playlist-related commands.
+Those events begin with C<pl.>.
=item *
-C<POCOCM::Collection> for collection-related commands. Those events
-begin with C<coll.>.
+L<POE::Component::Client::MPD::Collection> for collection-related
+commands. Those events begin with C<coll.>.
=back
@@ -497,10 +501,12 @@
=item * mpd_result( $msg, $answer )
-Indicates a success. C<$msg> is a C<POCOCM::Message> object with the
-original request, to identify the issued command (see C<POCOCM::Message>
-pod for more information). Its C<status()> attribute is true, further
-confirming success.
+Indicates a success. C<$msg> is a
+L<POE::Component::Client::MPD::Message> object with the original
+request, to identify the issued command (see
+L<POE::Component::Client::MPD::Message> pod for more information). Its
+C<status()> attribute is true, further confirming success.
+
C<$answer> is what has been answered by the MPD server. Depending on the
command, it can be either:
@@ -509,11 +515,11 @@
=item * C<undef>: commands C<play>, etc.
-=item * an C<Audio::MPD::Common::Stats> object: command C<stats>
-
-=item * an C<Audio::MPD::Common::Status> object: command C<status>
-
-=item * an C<Audio::MPD::Common::Item> object: commands C<song>, etc.
+=item * an L<Audio::MPD::Common::Stats> object: command C<stats>
+
+=item * an L<Audio::MPD::Common::Status> object: command C<status>
+
+=item * an L<Audio::MPD::Common::Item> object: commands C<song>, etc.
=item * an array reference: commands C<coll.files>, etc.
@@ -527,10 +533,12 @@
=item * mpd_error( $msg, $errstr )
-Indicates a failure. C<$msg> is a C<POCOCM::Message> object with the
-original request, to identify the issued command (see C<POCOCM::Message>
-pod for more information). Its C<status()> attribute is false, further
-confirming failure.
+Indicates a failure. C<$msg> is a
+L<POE::Component::Client::MPD::Message> object with the original
+request, to identify the issued command (see
+L<POE::Component::Client::MPD::Message> pod for more information). Its
+C<status()> attribute is false, further confirming failure.
+
C<$errstr> is what the error message as returned been answered by the
MPD server.
@@ -542,7 +550,22 @@
=head2 Auto-generated events
-To be written.
+The following events are fired by pococm:
+
+=over 4
+
+=item * mpd_connect_error_fatal( $reason )
+
+Called when pococm-conn could not connect to a mpd server. It can be
+either retriable, or fatal. Check C<$reason> for more information.
+
+
+=item * mpd_connected()
+
+Called when pococm-conn made sure we're talking to a mpd server.
+
+=back
+
=head1 BUGS
@@ -560,7 +583,7 @@
You can find more information on the mpd project on its homepage at
L<http://www.musicpd.org>, or its wiki L<http://mpd.wikia.com>.
-C<POE::Component::Client::MPD development> takes place on C<< <audio-mpd
+L<POE::Component::Client::MPD> development takes place on C<< <audio-mpd
at googlegroups.com> >>: feel free to join us. (use
L<http://groups.google.com/group/audio-mpd> to sign in). Our git
repository is located at
Modified: branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Collection.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Collection.pm?rev=45295&op=diff
==============================================================================
--- branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Collection.pm (original)
+++ branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Collection.pm Sun Oct 4 00:36:47 2009
@@ -298,16 +298,18 @@
=head1 DESCRIPTION
-C<POCOCM::Collection> is responsible for handling general purpose
-commands. They are in a dedicated module to achieve easier code
-maintenance.
-
-To achieve those commands, send the corresponding event to the POCOCM
-session you created: it will be responsible for dispatching the event
-where it is needed. Under no circumstance should you call directly subs
-or methods from this module directly.
-
-Read POCOCM's pod to learn how to deal with answers from those commands.
+L<POE::Component::Client::MPD::Collection> is responsible for handling
+general purpose commands. They are in a dedicated module to achieve
+easier code maintenance.
+
+To achieve those commands, send the corresponding event to the
+L<POE::Component::Client::MPD> session you created: it will be
+responsible for dispatching the event where it is needed. Under no
+circumstance should you call directly subs or methods from this
+module directly.
+
+Read L<POE::Component::Client::MPD>'s pod to learn how to deal with
+answers from those commands.
@@ -323,7 +325,7 @@
=item * coll.all_items( [$path] )
-Return all C<Audio::MPD::Common::Item>s (both songs & directories)
+Return all L<Audio::MPD::Common::Item>s (both songs & directories)
currently known by mpd.
If C<$path> is supplied (relative to mpd root), restrict the retrieval to
@@ -332,13 +334,13 @@
=item * coll.all_items_simple( [$path] )
-Return all C<Audio::MPD::Common::Item>s (both songs & directories)
+Return all L<Audio::MPD::Common::Item>s (both songs & directories)
currently known by mpd.
If C<$path> is supplied (relative to mpd root), restrict the retrieval
to songs and dirs in this directory.
-B</!\ Warning>: the C<Audio::MPD::Common::Item::Song> objects will only
+B</!\ Warning>: the L<Audio::MPD::Common::Item::Song> objects will only
have their attribute file filled. Any other attribute will be empty, so
don't use this sub for any other thing than a quick scan!
@@ -392,13 +394,13 @@
=item * coll.song( $path )
-Return the C<Audio::MPD::Common::Item::Song> which correspond to
+Return the L<Audio::MPD::Common::Item::Song> which correspond to
C<$path>.
=item * coll.songs_with_filename_partial( $string )
-Return the C<Audio::MPD::Common::Item::Song>s containing C<$string> in
+Return the L<Audio::MPD::Common::Item::Song>s containing C<$string> in
their path.
@@ -419,34 +421,34 @@
=item * coll.songs_by_artist( $artist )
-Return all C<Audio::MPD::Common::Item::Song>s performed by C<$artist>.
+Return all L<Audio::MPD::Common::Item::Song>s performed by C<$artist>.
=item * coll.songs_by_artist_partial( $artist )
-Return all C<Audio::MPD::Common::Item::Song>s performed by C<$artist>.
+Return all L<Audio::MPD::Common::Item::Song>s performed by C<$artist>.
=item * coll.songs_from_album( $album )
-Return all C<Audio::MPD::Common::Item::Song>s appearing in C<$album>.
+Return all L<Audio::MPD::Common::Item::Song>s appearing in C<$album>.
=item * coll.songs_from_album_partial( $string )
-Return all C<Audio::MPD::Common::Item::Song>s appearing in album
+Return all L<Audio::MPD::Common::Item::Song>s appearing in album
containing C<$string>.
=item * coll.songs_with_title( $title )
-Return all C<Audio::MPD::Common::Item::Song>s which title is exactly
+Return all L<Audio::MPD::Common::Item::Song>s which title is exactly
C<$title>.
=item * coll.songs_with_title_partial( $string )
-Return all C<Audio::MPD::Common::Item::Song>s where C<$string> is part
+Return all L<Audio::MPD::Common::Item::Song>s where C<$string> is part
of the title.
@@ -457,7 +459,7 @@
=head1 SEE ALSO
For all related information (bug reporting, mailing-list, pointers to
-MPD and POE, etc.), refer to C<POE::Component::Client::MPD>'s pod,
+MPD and POE, etc.), refer to L<POE::Component::Client::MPD>'s pod,
section C<SEE ALSO>
Modified: branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Commands.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Commands.pm?rev=45295&op=diff
==============================================================================
--- branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Commands.pm (original)
+++ branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Commands.pm Sun Oct 4 00:36:47 2009
@@ -470,9 +470,9 @@
=head1 DESCRIPTION
-C<POCOCM::Commands> is responsible for handling general purpose
-commands. They are in a dedicated module to achieve easier code
-maintenance.
+L<POE::Component::Client::MPD::Commands> is responsible for handling
+general purpose commands. They are in a dedicated module to achieve
+easier code maintenance.
To achieve those commands, send the corresponding event to the POCOCM
session you created: it will be responsible for dispatching the event
@@ -556,31 +556,31 @@
=item * stats()
-Return an C<Audio::MPD::Common::Stats> object with the current
+Return an L<Audio::MPD::Common::Stats> object with the current
statistics of MPD.
=item * status ()
-Return an C<Audio::MPD::Common::Status> object with the current
+Return an L<Audio::MPD::Common::Status> object with the current
status of MPD.
=item * current()
-Return an C<Audio::MPD::Common::Item::Song> representing the song
+Return an L<Audio::MPD::Common::Item::Song> representing the song
currently playing.
=item * song( [$song] )
-Return an C<Audio::MPD::Common::Item::Song> representing the song number
+Return an L<Audio::MPD::Common::Item::Song> representing the song number
C<$song>. If C<$song> is not supplied, returns the current song.
=item * songid( [$songid] )
-Return an C<Audio::MPD::Common::Item::Song> representing the song id
+Return an L<Audio::MPD::Common::Item::Song> representing the song id
C<$songid>. If C<$songid> is not supplied, returns the current song.
@@ -677,7 +677,7 @@
=head1 SEE ALSO
For all related information (bug reporting, mailing-list, pointers to
-MPD and POE, etc.), refer to C<POE::Component::Client::MPD>'s pod,
+MPD and POE, etc.), refer to L<POE::Component::Client::MPD>'s pod,
section C<SEE ALSO>
Modified: branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Connection.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Connection.pm?rev=45295&op=diff
==============================================================================
--- branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Connection.pm (original)
+++ branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Connection.pm Sun Oct 4 00:36:47 2009
@@ -476,7 +476,7 @@
=head1 SEE ALSO
For all related information (bug reporting, mailing-list, pointers to
-MPD and POE, etc.), refer to C<POE::Component::Client::MPD>'s pod,
+MPD and POE, etc.), refer to L<POE::Component::Client::MPD>'s pod,
section C<SEE ALSO>
Modified: branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Message.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Message.pm?rev=45295&op=diff
==============================================================================
--- branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Message.pm (original)
+++ branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Message.pm Sun Oct 4 00:36:47 2009
@@ -14,7 +14,7 @@
use Readonly;
-use base qw{ Class::Accessor::Fast Exporter };
+use base qw{ Exporter Class::Accessor::Fast };
__PACKAGE__->mk_accessors( qw{
request params status
_data _commands _cooking _transform _post _from
@@ -61,8 +61,8 @@
=head1 DESCRIPTION
-C<POCOCM::Message> is more a placeholder for a hash ref with some pre-defined
-keys.
+L<POE::Component::Client::MPD::Message> is more a placeholder for a hash
+ref with some pre-defined keys.
=head1 PUBLIC METHODS
@@ -96,7 +96,7 @@
=head1 SEE ALSO
For all related information (bug reporting, mailing-list, pointers to
-MPD and POE, etc.), refer to C<POE::Component::Client::MPD>'s pod,
+MPD and POE, etc.), refer to L<POE::Component::Client::MPD>'s pod,
section C<SEE ALSO>
Modified: branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Playlist.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Playlist.pm?rev=45295&op=diff
==============================================================================
--- branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Playlist.pm (original)
+++ branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Playlist.pm Sun Oct 4 00:36:47 2009
@@ -23,7 +23,7 @@
#
# event: pl.as_items()
#
-# Return an array of C<Audio::MPD::Common::Item::Song>s, one for each of
+# Return an array of L<Audio::MPD::Common::Item::Song>s, one for each of
# the songs in the current playlist.
#
sub _do_as_items {
@@ -299,9 +299,9 @@
=head1 DESCRIPTION
-C<POCOCM::Playlist> is responsible for handling general purpose
-commands. They are in a dedicated module to achieve easier code
-maintenance.
+L<POE::Component::Client::MPD::Playlist> is responsible for handling
+general purpose commands. They are in a dedicated module to achieve
+easier code maintenance.
To achieve those commands, send the corresponding event to the POCOCM
session you created: it will be responsible for dispatching the event
@@ -324,13 +324,13 @@
=item * pl.as_items()
-Return an array of C<Audio::MPD::Common::Item::Song>s, one for each of
+Return an array of L<Audio::MPD::Common::Item::Song>s, one for each of
the songs in the current playlist.
=item * pl.items_changed_since( $plversion )
-Return a list with all the songs (as C<Audio::MPD::Common::Item::Song>
+Return a list with all the songs (as L<Audio::MPD::Common::Item::Song>
objects) added to the playlist since playlist C<$plversion>.
@@ -438,7 +438,7 @@
=head1 SEE ALSO
For all related information (bug reporting, mailing-list, pointers to
-MPD and POE, etc.), refer to C<POE::Component::Client::MPD>'s pod,
+MPD and POE, etc.), refer to L<POE::Component::Client::MPD>'s pod,
section C<SEE ALSO>
Modified: branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Test.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Test.pm?rev=45295&op=diff
==============================================================================
--- branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Test.pm (original)
+++ branches/upstream/libpoe-component-client-mpd-perl/current/lib/POE/Component/Client/MPD/Test.pm Sun Oct 4 00:36:47 2009
@@ -275,7 +275,7 @@
=head1 SEE ALSO
For all related information (bug reporting, mailing-list, pointers to
-MPD and POE, etc.), refer to C<POE::Component::Client::MPD>'s pod,
+MPD and POE, etc.), refer to L<POE::Component::Client::MPD>'s pod,
section C<SEE ALSO>
More information about the Pkg-perl-cvs-commits
mailing list