Changeset 20 in mp3-find for trunk

Timestamp:

04/02/06 21:14:53 (18 years ago)

Author:

peter

Message:

• documented "status_callback" in DB.pm
• updated Changes

Location:

trunk

Files:

• Changes (modified) (1 diff)
• lib/MP3/Find/DB.pm (modified) (1 diff)

trunk/Changes

@@ -1 +1 @@
 Revision history for Perl extension MP3::Find.
+
+0.04  2 Apr 2006
+    - BUGFIX: fixed tests that were failing because the test mp3 was not included
+    - added "status_callback" option to DB backend constructor
 
 0.03  27 Mar 2006

trunk/lib/MP3/Find/DB.pm

@@ -275 +275 @@
 =head1 METHODS
 
+=head2 new
+
+    my $finder = MP3::Find::DB->new(
+        status_callback => \&callback,
+    );
+
+The C<status_callback> gets called each time an entry in the
+database is added, updated, or deleted by the C<update_db> and
+C<sync_db> methods. The arguments passed to the callback are
+a status code (A, U, or D) and the filename for that entry.
+The default callback just prints these to C<STDERR>:
+
+    sub default_callback {
+        my ($status_code, $filename) = @_;
+        print STDERR "$status_code $filename\n";
+    }
+
+To suppress any output, set C<status_callback> to an empty sub:
+
+    status_callback => sub {}
+
 =head2 create_db