r857@llin: dpavlin | 2006-08-23 13:04:58 +0200
[webpac2] / lib / WebPAC / Input.pm
index 8f4c3d4..4e58da2 100644 (file)
@@ -3,6 +3,8 @@ package WebPAC::Input;
 use warnings;
 use strict;
 
+use blib;
+
 use WebPAC::Common;
 use base qw/WebPAC::Common/;
 use Text::Iconv;
@@ -14,11 +16,11 @@ WebPAC::Input - read different file formats into WebPAC
 
 =head1 VERSION
 
-Version 0.05
+Version 0.10
 
 =cut
 
-our $VERSION = '0.05';
+our $VERSION = '0.10';
 
 =head1 SYNOPSIS
 
@@ -37,16 +39,14 @@ C<fetch_rec> and optional C<init> functions.
 
 Perhaps a little code snippet.
 
-    use WebPAC::Input;
+       use WebPAC::Input;
 
-    my $db = WebPAC::Input->new(
-       module => 'WebPAC::Input::ISIS',
-               config => $config,
-               lookup => $lookup_obj,
+       my $db = WebPAC::Input->new(
+               module => 'WebPAC::Input::ISIS',
                low_mem => 1,
-    );
+       );
 
-    $db->open('/path/to/database');
+       $db->open( path => '/path/to/database' );
        print "database size: ",$db->size,"\n";
        while (my $rec = $db->fetch) {
                # do something with $rec
@@ -62,16 +62,16 @@ Create new input database object.
 
   my $db = new WebPAC::Input(
        module => 'WebPAC::Input::MARC',
-       code_page => 'ISO-8859-2',
+       encoding => 'ISO-8859-2',
        low_mem => 1,
        recode => 'char pairs',
        no_progress_bar => 1,
   );
 
-C<module> is low-level file format module. See L<WebPAC::Input::Isis> and
+C<module> is low-level file format module. See L<WebPAC::Input::ISIS> and
 L<WebPAC::Input::MARC>.
 
-Optional parametar C<code_page> specify application code page (which will be
+Optional parametar C<encoding> specify application code page (which will be
 used internally). This should probably be your terminal encoding, and by
 default, it C<ISO-8859-2>.
 
@@ -94,6 +94,9 @@ sub new {
 
        my $log = $self->_get_logger;
 
+       $log->logconfess("code_page argument is not suppored any more. change it to encoding") if ($self->{lookup});
+       $log->logconfess("lookup argument is not suppored any more. rewrite call to lookup_ref") if ($self->{lookup});
+
        $log->logconfess("specify low-level file format module") unless ($self->{module});
        my $module = $self->{module};
        $module =~ s#::#/#g;
@@ -119,7 +122,7 @@ sub new {
                $self->{init}->($self, @_);
        }
 
-       $self->{'code_page'} ||= 'ISO-8859-2';
+       $self->{'encoding'} ||= 'ISO-8859-2';
 
        # running with low_mem flag? well, use DBM::Deep then.
        if ($self->{'low_mem'}) {
@@ -161,6 +164,14 @@ This function will read whole database in memory and produce lookups.
        offset => 6000,
        lookup => $lookup_obj,
        stats => 1,
+       lookup_ref => sub {
+               my ($k,$v) = @_;
+               # store lookup $k => $v
+       },
+       modify_records => {
+               900 => { '^a' => { ' : ' => '^b' } },
+               901 => { '*' => { '^b' => ' ; ' } },
+       },
  );
 
 By default, C<code_page> is assumed to be C<852>.
@@ -171,6 +182,13 @@ C<limit> is optional parametar to read just C<limit> records from database
 
 C<stats> create optional report about usage of fields and subfields
 
+C<lookup_coderef> is closure to call when adding C<< key => 'value' >> combinations to
+lookup.
+
+C<modify_records> specify mapping from subfields to delimiters or from
+delimiters to subfields, as well as oprations on fields (if subfield is
+defined as C<*>.
+
 Returns size of database, regardless of C<offset> and C<limit>
 parametars, see also C<size>.
 
@@ -182,6 +200,10 @@ sub open {
 
        my $log = $self->_get_logger();
 
+       $log->logconfess("lookup argument is not suppored any more. rewrite call to lookup_coderef") if ($arg->{lookup});
+       $log->logconfess("lookup_coderef must be CODE, not ",ref($arg->{lookup_coderef}))
+               if ($arg->{lookup_coderef} && ref($arg->{lookup_coderef}) ne 'CODE');
+
        $log->logcroak("need path") if (! $arg->{'path'});
        my $code_page = $arg->{'code_page'} || '852';
 
@@ -192,39 +214,70 @@ sub open {
        }
 
        # create Text::Iconv object
-       $self->{iconv} = Text::Iconv->new($code_page,$self->{'code_page'});
+       $self->{iconv} = Text::Iconv->new($code_page,$self->{'encoding'});      ## FIXME remove!
 
        my $filter_ref;
+       my $recode_regex;
+       my $recode_map;
 
        if ($self->{recode}) {
                my @r = split(/\s/, $self->{recode});
                if ($#r % 2 != 1) {
                        $log->logwarn("recode needs even number of elements (some number of valid pairs)");
                } else {
-                       my $recode;
                        while (@r) {
                                my $from = shift @r;
                                my $to = shift @r;
-                               $recode->{$from} = $to;
+                               $recode_map->{$from} = $to;
                        }
 
-                       my $regex = join '|' => keys %{ $recode };
-
-                       $log->debug("using recode regex: $regex");
-                       
-                       $filter_ref = sub {
-                               my $t = shift;
-                               $t =~ s/($regex)/$recode->{$1}/g;
-                               return $t;
-                       };
+                       $recode_regex = join '|' => keys %{ $recode_map };
 
+                       $log->debug("using recode regex: $recode_regex");
                }
 
        }
 
+       my $rec_regex = $self->modify_record_regexps(%{ $arg->{modify_records} });
+       $log->debug("rec_regex: ", Dumper($rec_regex));
+
        my ($db, $size) = $self->{open_db}->( $self, 
                path => $arg->{path},
-               filter => $filter_ref,
+               filter => sub {
+                               my ($l,$f_nr) = @_;
+                               return unless defined($l);
+
+                               ## FIXME remove iconv!
+                               $l = $self->{iconv}->convert($l) if ($self->{iconv});
+       
+                               $l =~ s/($recode_regex)/$recode_map->{$1}/g if ($recode_regex && $recode_map);
+
+                               ## FIXME remove this warning when we are sure that none of API is calling
+                               ## this wrongly
+                               #warn "filter called without field number" unless ($f_nr);
+
+                               return $l unless ($rec_regex && $f_nr);
+
+#                              my $max_regex = 100;
+
+                               # apply regexps
+                               if ($rec_regex && defined($rec_regex->{$f_nr})) {
+                                       $log->logconfess("regexps->{$f_nr} must be ARRAY") if (ref($rec_regex->{$f_nr}) ne 'ARRAY');
+                                       my $c = 0;
+                                       foreach my $r (@{ $rec_regex->{$f_nr} }) {
+                                               #$log->debug("\$l = $l\neval \$l =~ $r");
+                                               eval '$l =~ ' . $r;
+                                               $log->error("error applying regex: $r") if ($@);
+
+#                                              while ( $c < $max_regex && eval '$l =~ ' . $r ) { $c++ };
+#                                              $log->error("field $f_nr has more than $max_regex regex iterations\n\$l = $l\neval \$l =~ $r") if ($c == $max_regex);
+
+                                       }
+                               }
+
+                               return $l;
+               },
+               %{ $arg },
        );
 
        unless (defined($db)) {
@@ -241,7 +294,7 @@ sub open {
        my $to_rec = $size;
 
        if (my $s = $self->{offset}) {
-               $log->info("skipping to MFN $s");
+               $log->debug("skipping to MFN $s");
                $from_rec = $s;
        } else {
                $self->{offset} = $from_rec;
@@ -256,7 +309,7 @@ sub open {
        # store size for later
        $self->{size} = ($to_rec - $from_rec) ? ($to_rec - $from_rec + 1) : 0;
 
-       $log->info("processing $self->{size}/$size records [$from_rec-$to_rec] convert $code_page -> $self->{code_page}", $self->{stats} ? ' [stats]' : '');
+       $log->info("processing $self->{size}/$size records [$from_rec-$to_rec] convert $code_page -> $self->{encoding}", $self->{stats} ? ' [stats]' : '');
 
        # read database
        for (my $pos = $from_rec; $pos <= $to_rec; $pos++) {
@@ -280,25 +333,32 @@ sub open {
                }
 
                # create lookup
-               $self->{'lookup'}->add( $rec ) if ($rec && $self->{'lookup'});
+               $arg->{'lookup_coderef'}->( $rec ) if ($rec && $arg->{'lookup_coderef'});
 
                # update counters for statistics
                if ($self->{stats}) {
-                       map {
-                               my $fld = $_;
+
+                       foreach my $fld (keys %{ $rec }) {
                                $self->{_stats}->{fld}->{ $fld }++;
-                               if (ref($rec->{ $fld }) eq 'ARRAY') {
-                                       map {
-                                               if (ref($_) eq 'HASH') {
-                                                       map {
-                                                               $self->{_stats}->{sf}->{ $fld }->{ $_ }++;
-                                                       } keys %{ $_ };
-                                               } else {
-                                                       $self->{_stats}->{repeatable}->{ $fld }++;
+
+                               $log->logdie("invalid record fild $fld, not ARRAY")
+                                       unless (ref($rec->{ $fld }) eq 'ARRAY');
+       
+                               foreach my $row (@{ $rec->{$fld} }) {
+
+                                       if (ref($row) eq 'HASH') {
+
+                                               foreach my $sf (keys %{ $row }) {
+                                                       $self->{_stats}->{sf}->{ $fld }->{ $sf }->{count}++;
+                                                       $self->{_stats}->{sf}->{ $fld }->{ $sf }->{repeatable}++
+                                                                       if (ref($row->{$sf}) eq 'ARRAY');
                                                }
-                                       } @{ $rec->{$fld} };
+
+                                       } else {
+                                               $self->{_stats}->{repeatable}->{ $fld }++;
+                                       }
                                }
-                       } keys %{ $rec };
+                       }
                }
 
                $self->progress_bar($pos,$to_rec) unless ($self->{no_progress_bar});
@@ -426,13 +486,96 @@ sub seek {
 
 Dump statistics about field and subfield usage
 
-  print Dumper( $input->stats );
+  print $input->stats;
 
 =cut
 
 sub stats {
        my $self = shift;
-       return $self->{_stats};
+
+       my $log = $self->_get_logger();
+
+       my $s = $self->{_stats};
+       if (! $s) {
+               $log->warn("called stats, but there is no statistics collected");
+               return;
+       }
+
+       my $max_fld = 0;
+
+       my $out = join("\n",
+               map {
+                       my $f = $_ || die "no field";
+                       my $v = $s->{fld}->{$f} || die "no s->{fld}->{$f}";
+                       $max_fld = $v if ($v > $max_fld);
+
+                       my $o = sprintf("%4s %d ~", $f, $v);
+
+                       if (defined($s->{sf}->{$f})) {
+                               map {
+                                       $o .= sprintf(" %s:%d%s", $_, 
+                                               $s->{sf}->{$f}->{$_}->{count},
+                                               $s->{sf}->{$f}->{$_}->{repeatable} ? '*' : '',
+                                       );
+                               } sort keys %{ $s->{sf}->{$f} };
+                       }
+
+                       if (my $v_r = $s->{repeatable}->{$f}) {
+                               $o .= " ($v_r)" if ($v_r != $v);
+                       }
+
+                       $o;
+               } sort { $a cmp $b } keys %{ $s->{fld} }
+       );
+
+       $log->debug( sub { Dumper($s) } );
+
+       return $out;
+}
+
+=head2 modify_record_regexps
+
+Generate hash with regexpes to be applied using L<filter>.
+
+  my $regexpes = $input->modify_record_regexps(
+               900 => { '^a' => { ' : ' => '^b' } },
+               901 => { '*' => { '^b' => ' ; ' } },
+  );
+
+=cut
+
+sub modify_record_regexps {
+       my $self = shift;
+       my $modify_record = {@_};
+
+       my $regexpes;
+
+       foreach my $f (keys %$modify_record) {
+warn "--- f: $f\n";
+               foreach my $sf (keys %{ $modify_record->{$f} }) {
+warn "---- sf: $sf\n";
+                       foreach my $from (keys %{ $modify_record->{$f}->{$sf} }) {
+                               my $to = $modify_record->{$f}->{$sf}->{$from};
+                               #die "no field?" unless defined($to);
+warn "----- transform: |$from| -> |$to|\n";
+
+                               if ($sf =~ /^\^/) {
+                                       my $regex = 
+                                               's/\Q'. $sf .'\E([^\^]+)\Q'. $from .'\E([^\^]+)/'. $sf .'$1'. $to .'$2/g';
+                                       push @{ $regexpes->{$f} }, $regex;
+warn ">>>>> $regex [sf]\n";
+                               } else {
+                                       my $regex =
+                                               's/\Q'. $from .'\E/'. $to .'/g';
+                                       push @{ $regexpes->{$f} }, $regex;
+warn ">>>>> $regex [global]\n";
+                               }
+
+                       }
+               }
+       }
+
+       return $regexpes;
 }
 
 =head1 MEMORY USAGE
@@ -472,7 +615,7 @@ Dobrica Pavlinusic, C<< <dpavlin@rot13.org> >>
 
 =head1 COPYRIGHT & LICENSE
 
-Copyright 2005 Dobrica Pavlinusic, All Rights Reserved.
+Copyright 2005-2006 Dobrica Pavlinusic, All Rights Reserved.
 
 This program is free software; you can redistribute it and/or modify it
 under the same terms as Perl itself.