/[webpac]/trunk2/lib/WebPAC.pm
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Diff of /trunk2/lib/WebPAC.pm

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 356 by dpavlin, Wed Jun 16 13:41:54 2004 UTC revision 411 by dpavlin, Sun Sep 5 22:22:37 2004 UTC
# Line 1  Line 1 
1  package WebPAC;  package WebPAC;
2    
3    use warnings;
4    use strict;
5    
6  use Carp;  use Carp;
7  use Text::Iconv;  use Text::Iconv;
8  use Config::IniFiles;  use Config::IniFiles;
9    use XML::Simple;
10    use Template;
11    use Log::Log4perl qw(get_logger :levels);
12    
13    use Data::Dumper;
14    
15    #my $LOOKUP_REGEX = '\[[^\[\]]+\]';
16    #my $LOOKUP_REGEX_SAVE = '\[([^\[\]]+)\]';
17    my $LOOKUP_REGEX = 'lookup{[^\{\}]+}';
18    my $LOOKUP_REGEX_SAVE = 'lookup{([^\{\}]+)}';
19    
20  =head1 NAME  =head1 NAME
21    
# Line 32  which describes databases to be indexed. Line 45  which describes databases to be indexed.
45    
46  =cut  =cut
47    
48    # mapping between data type and tag which specify
49    # format in XML file
50    my %type2tag = (
51            'isis' => 'isis',
52    #       'excel' => 'column',
53    #       'marc' => 'marc',
54    #       'feed' => 'feed'
55    );
56    
57  sub new {  sub new {
58          my $class = shift;          my $class = shift;
59          my $self = {@_};          my $self = {@_};
60          bless($self, $class);          bless($self, $class);
61    
62            my $log_file = $self->{'log'} || "log.conf";
63            Log::Log4perl->init($log_file);
64    
65            my $log = $self->_get_logger();
66    
67          # fill in default values          # fill in default values
68          # output codepage          # output codepage
69          $self->{'code_page'} = 'ISO-8859-2' if (! $self->{'code_page'});          $self->{'code_page'} = 'ISO-8859-2' if (! $self->{'code_page'});
# Line 44  sub new { Line 71  sub new {
71          #          #
72          # read global.conf          # read global.conf
73          #          #
74            $log->debug("read 'global.conf'");
75    
76          $self->{global_config_file} = new Config::IniFiles( -file => 'global.conf' ) || croak "can't open 'global.conf'";          my $config = new Config::IniFiles( -file => 'global.conf' ) || $log->logcroak("can't open 'global.conf'");
77    
78          # read global config parametars          # read global config parametars
79          foreach my $var (qw(          foreach my $var (qw(
# Line 55  sub new { Line 83  sub new {
83                          dbi_passwd                          dbi_passwd
84                          show_progress                          show_progress
85                          my_unac_filter                          my_unac_filter
86                            output_template
87                  )) {                  )) {
88                  $self->{global_config}->{$var} = $self->{global_config_file}->val('global', $var);                  $self->{'global_config'}->{$var} = $config->val('global', $var);
89          }          }
90    
91          #          #
92          # read indexer config file          # read indexer config file
93          #          #
94    
95          $self->{indexer_config_file} = new Config::IniFiles( -file => $self->{config_file} ) || croak "can't open '$self->{config_file}'";          $self->{indexer_config_file} = new Config::IniFiles( -file => $self->{config_file} ) || $log->logcroak("can't open '",$self->{config_file},"'");
96    
97          # read global config parametars          # create UTF-8 convertor for import_xml files
98          foreach my $var (qw(          $self->{'utf2cp'} = Text::Iconv->new('UTF-8' ,$self->{'code_page'});
99                          dbi_dbd  
100                          dbi_dsn          # create Template toolkit instance
101                          dbi_user          $self->{'tt'} = Template->new(
102                          dbi_passwd                  INCLUDE_PATH => ($self->{'global_config_file'}->{'output_template'} || './output_template'),
103                          show_progress  #               FILTERS => {
104                          my_unac_filter  #                       'foo' => \&foo_filter,
105                  )) {  #               },
106                  $self->{global_config}->{$var} = $self->{global_config_file}->val('global', $var);                  EVAL_PERL => 1,
107          }          );
108    
109          return $self;          return $self;
110  }  }
# Line 96  By default, ISIS code page is assumed to Line 125  By default, ISIS code page is assumed to
125  If optional parametar C<limit_mfn> is set, it will read just 500 records  If optional parametar C<limit_mfn> is set, it will read just 500 records
126  from database in example above.  from database in example above.
127    
 Returns number of last record read into memory (size of database, really).  
   
128  C<lookup> argument is an array of lookups to create. Each lookup must have C<key> and  C<lookup> argument is an array of lookups to create. Each lookup must have C<key> and
129  C<val>. Optional parametar C<eval> is perl code to evaluate before storing  C<val>. Optional parametar C<eval> is perl code to evaluate before storing
130  value in index.  value in index.
# Line 109  value in index. Line 136  value in index.
136      'val' => 'v900' },      'val' => 'v900' },
137   ]   ]
138    
139    Returns number of last record read into memory (size of database, really).
140    
141  =cut  =cut
142    
143  sub open_isis {  sub open_isis {
144          my $self = shift;          my $self = shift;
145          my $arg = {@_};          my $arg = {@_};
146    
147          croak "need filename" if (! $arg->{'filename'});          my $log = $self->_get_logger();
148    
149            $log->logcroak("need filename") if (! $arg->{'filename'});
150          my $code_page = $arg->{'code_page'} || '852';          my $code_page = $arg->{'code_page'} || '852';
151    
152          use OpenIsis;          use OpenIsis;
# Line 125  sub open_isis { Line 156  sub open_isis {
156          # create Text::Iconv object          # create Text::Iconv object
157          my $cp = Text::Iconv->new($code_page,$self->{'code_page'});          my $cp = Text::Iconv->new($code_page,$self->{'code_page'});
158    
159            $log->info("reading ISIS database '",$arg->{'filename'},"'");
160    
161          my $isis_db = OpenIsis::open($arg->{'filename'});          my $isis_db = OpenIsis::open($arg->{'filename'});
162    
163          my $maxmfn = OpenIsis::maxRowid( $isis_db ) || 1;          my $maxmfn = OpenIsis::maxRowid( $isis_db ) || 1;
164    
165            $maxmfn = $self->{limit_mfn} if ($self->{limit_mfn});
166    
167            $log->info("processing $maxmfn records...");
168    
169          # read database          # read database
170          for (my $mfn = 1; $mfn <= $maxmfn; $mfn++) {          for (my $mfn = 1; $mfn <= $maxmfn; $mfn++) {
171    
# Line 151  sub open_isis { Line 188  sub open_isis {
188    
189                                          push @{$self->{'data'}->{$mfn}->{$k}}, $val;                                          push @{$self->{'data'}->{$mfn}->{$k}}, $val;
190                                  }                                  }
191                            } else {
192                                    push @{$self->{'data'}->{$mfn}->{'000'}}, $mfn;
193                          }                          }
194    
195                  }                  }
# Line 159  sub open_isis { Line 198  sub open_isis {
198                  my $rec = $self->{'data'}->{$mfn};                  my $rec = $self->{'data'}->{$mfn};
199                  $self->create_lookup($rec, @{$arg->{'lookup'}});                  $self->create_lookup($rec, @{$arg->{'lookup'}});
200    
201                    $self->progress_bar($mfn,$maxmfn);
202    
203          }          }
204    
205            $self->{'current_mfn'} = 1;
206            $self->{'last_pcnt'} = 0;
207    
208          # store max mfn and return it.          # store max mfn and return it.
209          return $self->{'max_mfn'} = $maxmfn;          return $self->{'max_mfn'} = $maxmfn;
210  }  }
211    
212    =head2 fetch_rec
213    
214    Fetch next record from database. It will also display progress bar (once
215    it's implemented, that is).
216    
217     my $rec = $webpac->fetch_rec;
218    
219    =cut
220    
221    sub fetch_rec {
222            my $self = shift;
223    
224            my $log = $self->_get_logger();
225    
226            my $mfn = $self->{'current_mfn'}++ || $log->logconfess("it seems that you didn't load database!");
227    
228            if ($mfn > $self->{'max_mfn'}) {
229                    $self->{'current_mfn'} = $self->{'max_mfn'};
230                    $log->debug("at EOF");
231                    return;
232            }
233    
234            $self->progress_bar($mfn,$self->{'max_mfn'});
235    
236            return $self->{'data'}->{$mfn};
237    }
238    
239    =head2 progress_bar
240    
241    Draw progress bar on STDERR.
242    
243     $webpac->progress_bar($current, $max);
244    
245    =cut
246    
247    sub progress_bar {
248            my $self = shift;
249    
250            my ($curr,$max) = @_;
251    
252            my $log = $self->_get_logger();
253    
254            $log->logconfess("no current value!") if (! $curr);
255            $log->logconfess("no maximum value!") if (! $max);
256    
257            if ($curr > $max) {
258                    $max = $curr;
259                    $log->debug("overflow to $curr");
260            }
261    
262            $self->{'last_pcnt'} ||= 1;
263    
264            $self->{'last_pcnt'} = $curr if ($curr < $self->{'last_pcnt'});
265    
266            my $p = int($curr * 100 / $max);
267            if ($p != $self->{'last_pcnt'}) {
268                    printf STDERR ("%5d / %5d [%-51s] %-2d %% \r",$curr,$max,"=" x ($p/2).">", $p );
269                    $self->{'last_pcnt'} = $p;
270            }
271    }
272    
273    =head2 open_import_xml
274    
275    Read file from C<import_xml/> directory and parse it.
276    
277     $webpac->open_import_xml(type => 'isis');
278    
279    =cut
280    
281    sub open_import_xml {
282            my $self = shift;
283    
284            my $log = $self->_get_logger();
285    
286            my $arg = {@_};
287            $log->logconfess("need type to load file from import_xml/") if (! $arg->{'type'});
288    
289            $self->{'type'} = $arg->{'type'};
290    
291            my $type_base = $arg->{'type'};
292            $type_base =~ s/_.*$//g;
293    
294            $self->{'tag'} = $type2tag{$type_base};
295    
296            $log->info("using type '",$self->{'type'},"' tag <",$self->{'tag'},">");
297    
298            my $f = "./import_xml/".$self->{'type'}.".xml";
299            $log->logconfess("import_xml file '$f' doesn't exist!") if (! -e "$f");
300    
301            $log->info("reading '$f'");
302    
303            $self->{'import_xml_file'} = $f;
304    
305            $self->{'import_xml'} = XMLin($f,
306                    ForceArray => [ $self->{'tag'}, 'config', 'format' ],
307            );
308    
309            $log->debug("import xml is ",sub { Dumper($self->{'import_xml'}) });
310    
311    }
312    
313  =head2 create_lookup  =head2 create_lookup
314    
315  Create lookup from record using lookup definition.  Create lookup from record using lookup definition.
316    
317     $self->create_lookup($rec, @lookups);
318    
319    Called internally by C<open_*> methods.
320    
321  =cut  =cut
322    
323  sub create_lookup {  sub create_lookup {
324          my $self = shift;          my $self = shift;
325    
326          my $rec = shift || confess "need record to create lookup";          my $log = $self->_get_logger();
327          confess("need HASH as first argument!") if ($rec !~ /HASH/o);  
328            my $rec = shift || $log->logconfess("need record to create lookup");
329            $log->logconfess("need HASH as first argument!") if ($rec !~ /HASH/o);
330    
331          foreach my $i (@_) {          foreach my $i (@_) {
332                  if ($i->{'eval'}) {                  if ($i->{'eval'}) {
# Line 183  sub create_lookup { Line 334  sub create_lookup {
334                          my $key = $self->fill_in($rec,$i->{'key'});                          my $key = $self->fill_in($rec,$i->{'key'});
335                          my @val = $self->fill_in($rec,$i->{'val'});                          my @val = $self->fill_in($rec,$i->{'val'});
336                          if ($key && @val && eval $eval) {                          if ($key && @val && eval $eval) {
337                                    $log->debug("stored $key = ",sub { join(" | ",@val) });
338                                  push @{$self->{'lookup'}->{$key}}, @val;                                  push @{$self->{'lookup'}->{$key}}, @val;
339                          }                          }
340                  } else {                  } else {
341                          my $key = $self->fill_in($rec,$i->{'key'});                          my $key = $self->fill_in($rec,$i->{'key'});
342                          my @val = $self->fill_in($rec,$i->{'val'});                          my @val = $self->fill_in($rec,$i->{'val'});
343                          if ($key && @val) {                          if ($key && @val) {
344                                    $log->debug("stored $key = ",sub { join(" | ",@val) });
345                                  push @{$self->{'lookup'}->{$key}}, @val;                                  push @{$self->{'lookup'}->{$key}}, @val;
346                          }                          }
347                  }                  }
# Line 199  sub create_lookup { Line 352  sub create_lookup {
352    
353  Returns value from record.  Returns value from record.
354    
355   $self->get_data(\$rec,$f,$sf,$i,\$found);   my $text = $self->get_data(\$rec,$f,$sf,$i,\$found);
356    
357  Arguments are:  Arguments are:
358  record reference C<$rec>,  record reference C<$rec>,
# Line 207  field C<$f>, Line 360  field C<$f>,
360  optional subfiled C<$sf>,  optional subfiled C<$sf>,
361  index for repeatable values C<$i>.  index for repeatable values C<$i>.
362    
363  Optinal variable C<$found> will be incremeted if thre  Optinal variable C<$found> will be incremeted if there
364  is field.  is field.
365    
366  Returns value or empty string.  Returns value or empty string.
# Line 218  sub get_data { Line 371  sub get_data {
371          my $self = shift;          my $self = shift;
372    
373          my ($rec,$f,$sf,$i,$found) = @_;          my ($rec,$f,$sf,$i,$found) = @_;
374    
375          if ($$rec->{$f}) {          if ($$rec->{$f}) {
376                    return '' if (! $$rec->{$f}->[$i]);
377                    no strict 'refs';
378                  if ($sf && $$rec->{$f}->[$i]->{$sf}) {                  if ($sf && $$rec->{$f}->[$i]->{$sf}) {
379                          $$found++ if (defined($$found));                          $$found++ if (defined($$found));
380                          return $$rec->{$f}->[$i]->{$sf};                          return $$rec->{$f}->[$i]->{$sf};
381                  } elsif ($$rec->{$f}->[$i]) {                  } elsif ($$rec->{$f}->[$i]) {
382                          $$found++ if (defined($$found));                          $$found++ if (defined($$found));
383                          return $$rec->{$f}->[$i];                          # it still might have subfield, just
384                            # not specified, so we'll dump all
385                            if ($$rec->{$f}->[$i] =~ /HASH/o) {
386                                    my $out;
387                                    foreach my $k (keys %{$$rec->{$f}->[$i]}) {
388                                            $out .= $$rec->{$f}->[$i]->{$k}." ";
389                                    }
390                                    return $out;
391                            } else {
392                                    return $$rec->{$f}->[$i];
393                            }
394                  }                  }
395          } else {          } else {
396                  return '';                  return '';
# Line 237  Workhourse of all: takes record from in- Line 403  Workhourse of all: takes record from in-
403  strings with placeholders and returns string or array of with substituted  strings with placeholders and returns string or array of with substituted
404  values from record.  values from record.
405    
406   $webpac->fill_in($rec,'v250^a');   my $text = $webpac->fill_in($rec,'v250^a');
407    
408  Optional argument is ordinal number for repeatable fields. By default,  Optional argument is ordinal number for repeatable fields. By default,
409  it's assume to be first repeatable field (fields are perl array, so first  it's assume to be first repeatable field (fields are perl array, so first
410  element is 0).  element is 0).
411  Following example will read second value from repeatable field.  Following example will read second value from repeatable field.
412    
413   $webpac->fill_in($rec,'Title: v250^a',1);   my $text = $webpac->fill_in($rec,'Title: v250^a',1);
414    
415  This function B<does not> perform parsing of format to inteligenty skip  This function B<does not> perform parsing of format to inteligenty skip
416  delimiters before fields which aren't used.  delimiters before fields which aren't used.
417    
418    This method will automatically decode UTF-8 string to local code page
419    if needed.
420    
421  =cut  =cut
422    
423  sub fill_in {  sub fill_in {
424          my $self = shift;          my $self = shift;
425    
426          my $rec = shift || confess "need data record";          my $log = $self->_get_logger();
427          my $format = shift || confess "need format to parse";  
428            my $rec = shift || $log->logconfess("need data record");
429            my $format = shift || $log->logconfess("need format to parse");
430          # iteration (for repeatable fields)          # iteration (for repeatable fields)
431          my $i = shift || 0;          my $i = shift || 0;
432    
433          # FIXME remove for speedup?          # FIXME remove for speedup?
434          confess("need HASH as first argument!") if ($rec !~ /HASH/o);          $log->logconfess("need HASH as first argument!") if ($rec !~ /HASH/o);
435    
436            if (utf8::is_utf8($format)) {
437                    $format = $self->_x($format);
438            }
439    
440          my $found = 0;          my $found = 0;
441    
442            my $eval_code;
443            # remove eval{...} from beginning
444            $eval_code = $1 if ($format =~ s/^eval{([^}]+)}//s);
445    
446          # do actual replacement of placeholders          # do actual replacement of placeholders
447          $format =~ s/v(\d+)(?:\^(\w))*/$self->get_data(\$rec,$1,$2,$i,\$found)/ges;          $format =~ s/v(\d+)(?:\^(\w))?/$self->get_data(\$rec,$1,$2,$i,\$found)/ges;
448    
449          if ($found) {          if ($found) {
450                    $log->debug("format: $format");
451                    if ($eval_code) {
452                            my $eval = $self->fill_in($rec,$eval_code,$i);
453                            return if (! $self->_eval($eval));
454                    }
455                  # do we have lookups?                  # do we have lookups?
456                  if ($format =~ /\[[^\[\]]+\]/o) {                  if ($format =~ /$LOOKUP_REGEX/o) {
457                            $log->debug("format '$format' has lookup");
458                          return $self->lookup($format);                          return $self->lookup($format);
459                  } else {                  } else {
460                          return $format;                          return $format;
# Line 283  sub fill_in { Line 468  sub fill_in {
468    
469  Perform lookups on format supplied to it.  Perform lookups on format supplied to it.
470    
471   my $txt = $self->lookup('[v900]');   my $text = $self->lookup('[v900]');
472    
473  Lookups can be nested (like C<[d:[a:[v900]]]>).  Lookups can be nested (like C<[d:[a:[v900]]]>).
474    
# Line 292  Lookups can be nested (like C<[d:[a:[v90 Line 477  Lookups can be nested (like C<[d:[a:[v90
477  sub lookup {  sub lookup {
478          my $self = shift;          my $self = shift;
479    
480          my $tmp = shift || confess "need format";          my $log = $self->_get_logger();
481    
482            my $tmp = shift || $log->logconfess("need format");
483    
484          if ($tmp =~ /\[[^\[\]]+\]/o) {          if ($tmp =~ /$LOOKUP_REGEX/o) {
485                  my @in = ( $tmp );                  my @in = ( $tmp );
486  #print "##lookup $tmp\n";  
487                    $log->debug("lookup for: ",$tmp);
488    
489                  my @out;                  my @out;
490                  while (my $f = shift @in) {                  while (my $f = shift @in) {
491                          if ($f =~ /\[([^\[\]]+)\]/) {                          if ($f =~ /$LOOKUP_REGEX_SAVE/o) {
492                                  my $k = $1;                                  my $k = $1;
493                                  if ($self->{'lookup'}->{$k}) {                                  if ($self->{'lookup'}->{$k}) {
 #print "## lookup key = $k\n";  
494                                          foreach my $nv (@{$self->{'lookup'}->{$k}}) {                                          foreach my $nv (@{$self->{'lookup'}->{$k}}) {
495                                                  my $tmp2 = $f;                                                  my $tmp2 = $f;
496                                                  $tmp2 =~ s/\[$k\]/$nv/g;                                                  $tmp2 =~ s/lookup{$k}/$nv/g;
497                                                  push @in, $tmp2;                                                  push @in, $tmp2;
 #print "## lookup in => $tmp2\n";  
498                                          }                                          }
499                                  } else {                                  } else {
500                                          undef $f;                                          undef $f;
501                                  }                                  }
502                          } elsif ($f) {                          } elsif ($f) {
503                                  push @out, $f;                                  push @out, $f;
 #print "## lookup out => $f\n";  
504                          }                          }
505                  }                  }
506                    $log->logconfess("return is array and it's not expected!") unless wantarray;
507                  return @out;                  return @out;
508          } else {          } else {
509                  return $tmp;                  return $tmp;
# Line 329  Perform smart parsing of string, skippin Line 516  Perform smart parsing of string, skippin
516  defined. It can also eval code in format starting with C<eval{...}> and  defined. It can also eval code in format starting with C<eval{...}> and
517  return output or nothing depending on eval code.  return output or nothing depending on eval code.
518    
519   $webpac->parse($rec,'eval{"v901^a" eq "Deskriptor"}descriptor: v250^a', $i);   my $text = $webpac->parse($rec,'eval{"v901^a" eq "Deskriptor"}descriptor: v250^a', $i);
520    
521  =cut  =cut
522    
523  sub parse {  sub parse {
524          my $self = shift;          my $self = shift;
525    
526          my ($rec, $format, $i) = @_;          my ($rec, $format_utf8, $i) = @_;
527    
528            return if (! $format_utf8);
529    
530            my $log = $self->_get_logger();
531    
532            $log->logconfess("need HASH as first argument!") if ($rec !~ /HASH/o);
533            $log->logconfess("need utf2cp Text::Iconv object!") if (! $self->{'utf2cp'});
534    
535            $i = 0 if (! $i);
536    
537            my $format = $self->_x($format_utf8) || $log->logconfess("can't convert '$format_utf8' from UTF-8 to ",$self->{'code_page'});
538    
539          my @out;          my @out;
540    
541            $log->debug("format: $format");
542    
543          my $eval_code;          my $eval_code;
544          # remove eval{...} from beginning          # remove eval{...} from beginning
545          $eval_code = $1 if ($format =~ s/^eval{([^}]+)}//s);          $eval_code = $1 if ($format =~ s/^eval{([^}]+)}//s);
546    
547          my $prefix = '';          my $prefix;
548          $prefix = $1 if ($format =~ s/^(.+)(v\d+(?:\^\w)*)/$2/s);          my $all_found=0;
549    
550            while ($format =~ s/^(.*?)v(\d+)(?:\^(\w))?//s) {
551    
552          sub f_sf_del {                  my $del = $1 || '';
553                  my ($self,$rec,$out,$f,$sf,$del,$i) = @_;                  $prefix ||= $del if ($all_found == 0);
554    
555                    my $found = 0;
556                    my $tmp = $self->get_data(\$rec,$2,$3,$i,\$found);
557    
                 my $found=0;  
                 my $tmp = $self->get_data($rec,$f,$sf,$i,\$found);  
558                  if ($found) {                  if ($found) {
559                          push @{$$out}, $tmp;                          push @out, $del;
560                          push @{$$out}, $del;                          push @out, $tmp;
561                            $all_found += $found;
562                  }                  }
                 return '';  
563          }          }
564    
565          #$format =~ s/(.*)v(\d+)(?:\^(\w))*/f_sf_del($self,\$rec,\@out,$2,$3,$1,$i/ges;          return if (! $all_found);
566    
567            my $out = join('',@out);
568    
569            if ($out) {
570                    # add rest of format (suffix)
571                    $out .= $format;
572    
573                    # add prefix if not there
574                    $out = $prefix . $out if ($out !~ m/^\Q$prefix\E/);
575    
576                    $log->debug("result: $out");
577            }
578    
579            if ($eval_code) {
580                    my $eval = $self->fill_in($rec,$eval_code,$i);
581                    $log->debug("about to eval{",$eval,"} format: $out");
582                    return if (! $self->_eval($eval));
583            }
584    
585            return $out;
586    }
587    
588    =head2 parse_to_arr
589    
590    Similar to C<parse>, but returns array of all repeatable fields
591    
592     my @arr = $webpac->parse_to_arr($rec,'v250^a');
593    
594    =cut
595    
596    sub parse_to_arr {
597            my $self = shift;
598    
599            my ($rec, $format_utf8) = @_;
600    
601            my $log = $self->_get_logger();
602    
603            $log->logconfess("need HASH as first argument!") if ($rec !~ /HASH/o);
604            return if (! $format_utf8);
605    
606            my $i = 0;
607            my @arr;
608    
609            while (my $v = $self->parse($rec,$format_utf8,$i++)) {
610                    push @arr, $v;
611            }
612    
613            $log->debug("format '$format_utf8' returned ",--$i," elements: ", sub { join(" | ",@arr) }) if (@arr);
614    
615            return @arr;
616    }
617    
618    =head2 fill_in_to_arr
619    
620    Similar to C<fill_in>, but returns array of all repeatable fields. Usable
621    for fields which have lookups, so they shouldn't be parsed but rather
622    C<fill_id>ed.
623    
624     my @arr = $webpac->fill_in_to_arr($rec,'[v900];;[v250^a]');
625    
626    =cut
627    
628    sub fill_in_to_arr {
629            my $self = shift;
630    
631            my ($rec, $format_utf8) = @_;
632    
633            my $log = $self->_get_logger();
634    
635            $log->logconfess("need HASH as first argument!") if ($rec !~ /HASH/o);
636            return if (! $format_utf8);
637    
638            my $i = 0;
639            my @arr;
640    
641            while (my @v = $self->fill_in($rec,$format_utf8,$i++)) {
642                    push @arr, @v;
643            }
644    
645            $log->debug("format '$format_utf8' returned ",--$i," elements: ", sub { join(" | ",@arr) }) if (@arr);
646    
647            return @arr;
648    }
649    
650    
651    =head2 data_structure
652    
653    Create in-memory data structure which represents layout from C<import_xml>.
654    It is used later to produce output.
655    
656     my @ds = $webpac->data_structure($rec);
657    
658    This method will also set C<$webpac->{'currnet_filename'}> if there is
659    <filename> tag in C<import_xml> and C<$webpac->{'headline'}> if there is
660    <headline> tag.
661    
662    =cut
663    
664    sub data_structure {
665            my $self = shift;
666    
667            my $log = $self->_get_logger();
668    
669            my $rec = shift;
670            $log->logconfess("need HASH as first argument!") if ($rec !~ /HASH/o);
671    
672            undef $self->{'currnet_filename'};
673            undef $self->{'headline'};
674    
675            my @sorted_tags;
676            if ($self->{tags_by_order}) {
677                    @sorted_tags = @{$self->{tags_by_order}};
678            } else {
679                    @sorted_tags = sort { $self->_sort_by_order } keys %{$self->{'import_xml'}->{'indexer'}};
680                    $self->{tags_by_order} = \@sorted_tags;
681            }
682    
683            my @ds;
684    
685            $log->debug("tags: ",sub { join(", ",@sorted_tags) });
686    
687            foreach my $field (@sorted_tags) {
688    
689                    my $row;
690    
691    #print "field $field [",$self->{'tag'},"] = ",Dumper($self->{'import_xml'}->{'indexer'}->{$field}->{$self->{'tag'}});
692    
693                    foreach my $tag (@{$self->{'import_xml'}->{'indexer'}->{$field}->{$self->{'tag'}}}) {
694                            my $format = $tag->{'value'} || $tag->{'content'};
695    
696                            $log->debug("format: $format");
697    
698                            my @v;
699                            if ($format =~ /$LOOKUP_REGEX/o) {
700                                    @v = $self->fill_in_to_arr($rec,$format);
701                            } else {
702                                    @v = $self->parse_to_arr($rec,$format);
703                            }
704                            next if (! @v);
705    
706                            # use format?
707                            if ($tag->{'format_name'}) {
708                                    @v = map { $self->apply_format($tag->{'format_name'},$tag->{'format_delimiter'},$_) } @v;
709                            }
710    
711                            if ($field eq 'filename') {
712                                    $self->{'current_filename'} = join('',@v);
713                                    $log->debug("filename: ",$self->{'current_filename'});
714                            } elsif ($field eq 'headline') {
715                                    $self->{'headline'} .= join('',@v);
716                                    $log->debug("headline: ",$self->{'headline'});
717                                    next; # don't return headline in data_structure!
718                            }
719    
720                            # does tag have type?
721                            if ($tag->{'type'}) {
722                                    push @{$row->{$tag->{'type'}}}, @v;
723                            } else {
724                                    push @{$row->{'display'}}, @v;
725                                    push @{$row->{'swish'}}, @v;
726                            }
727    
728    
729                    }
730    
731                    if ($row) {
732                            $row->{'tag'} = $field;
733    
734                            # TODO: name_sigular, name_plural
735                            my $name = $self->{'import_xml'}->{'indexer'}->{$field}->{'name'};
736                            $row->{'name'} = $name ? $self->_x($name) : $field;
737    
738                            push @ds, $row;
739    
740                            $log->debug("row $field: ",sub { Dumper($row) });
741                    }
742    
743            }
744    
745            return @ds;
746    
747    }
748    
749    =head2 output
750    
751    Create output from in-memory data structure using Template Toolkit template.
752    
753    my $text = $webpac->output( template => 'text.tt', data => @ds );
754    
755    =cut
756    
757    sub output {
758            my $self = shift;
759    
760            my $args = {@_};
761    
762            my $log = $self->_get_logger();
763    
764            $log->logconfess("need template name") if (! $args->{'template'});
765            $log->logconfess("need data array") if (! $args->{'data'});
766    
767            my $out;
768    
769            $self->{'tt'}->process(
770                    $args->{'template'},
771                    $args,
772                    \$out
773            ) || confess $self->{'tt'}->error();
774    
775            return $out;
776    }
777    
778    =head2 output_file
779    
780    Create output from in-memory data structure using Template Toolkit template
781    to a file.
782    
783     $webpac->output_file(
784            file => 'out.txt',
785            template => 'text.tt',
786            data => @ds
787     );
788    
789    =cut
790    
791    sub output_file {
792            my $self = shift;
793    
794            my $args = {@_};
795    
796            my $log = $self->_get_logger();
797    
798            $log->logconfess("need file name") if (! $args->{'file'});
799    
800            $log->debug("creating file ",$args->{'file'});
801    
802            open(my $fh, ">", $args->{'file'}) || $log->logdie("can't open output file '$self->{'file'}': $!");
803            print $fh $self->output(
804                    template => $args->{'template'},
805                    data => $args->{'data'},
806            ) || $log->logdie("print: $!");
807            close($fh) || $log->logdie("close: $!");
808    }
809    
810    =head2 apply_format
811    
812    Apply format specified in tag with C<format_name="name"> and
813    C<format_delimiter=";;">.
814    
815     my $text = $webpac->apply_format($format_name,$format_delimiter,$data);
816    
817    Formats can contain C<lookup{...}> if you need them.
818    
819    =cut
820    
821    sub apply_format {
822            my $self = shift;
823    
824            my ($name,$delimiter,$data) = @_;
825    
826            my $log = $self->_get_logger();
827    
828            if (! $self->{'import_xml'}->{'format'}->{$name}) {
829                    $log->warn("<format name=\"$name\"> is not defined in ",$self->{'import_xml_file'});
830                    return $data;
831            }
832    
833            $log->warn("no delimiter for format $name") if (! $delimiter);
834    
835            my $format = $self->_x($self->{'import_xml'}->{'format'}->{$name}->{'content'}) || $log->logdie("can't find format '$name'");
836    
837          print Dumper(@out);          my @data = split(/\Q$delimiter\E/, $data);
838    
839            my $out = sprintf($format, @data);
840            $log->debug("using format $name [$format] on $data to produce: $out");
841    
842            if ($out =~ m/$LOOKUP_REGEX/o) {
843                    return $self->lookup($out);
844            } else {
845                    return $out;
846            }
847    
848  }  }
849    
850    
851    #
852    #
853    #
854    
855    =head1 INTERNAL METHODS
856    
857    Here is a quick list of internal methods, mostly useful to turn debugging
858    on them (see L<LOGGING> below for explanation).
859    
860    =cut
861    
862    =head2 _eval
863    
864    Internal function to eval code without C<strict 'subs'>.
865    
866    =cut
867    
868    sub _eval {
869            my $self = shift;
870    
871            my $code = shift || return;
872    
873            my $log = $self->_get_logger();
874    
875            no strict 'subs';
876            my $ret = eval $code;
877            if ($@) {
878                    $log->error("problem with eval code [$code]: $@");
879            }
880    
881            $log->debug("eval: ",$code," [",$ret,"]");
882    
883            return $ret || 0;
884    }
885    
886    =head2 _sort_by_order
887    
888    Sort xml tags data structure accoding to C<order=""> attribute.
889    
890    =cut
891    
892    sub _sort_by_order {
893            my $self = shift;
894    
895            my $va = $self->{'import_xml'}->{'indexer'}->{$a}->{'order'} ||
896                    $self->{'import_xml'}->{'indexer'}->{$a};
897            my $vb = $self->{'import_xml'}->{'indexer'}->{$b}->{'order'} ||
898                    $self->{'import_xml'}->{'indexer'}->{$b};
899    
900            return $va <=> $vb;
901    }
902    
903    =head2 _get_logger
904    
905    Get C<Log::Log4perl> object with a twist: domains are defined for each
906    method
907    
908     my $log = $webpac->_get_logger();
909    
910    =cut
911    
912    sub _get_logger {
913            my $self = shift;
914    
915            my $name = (caller(1))[3] || caller;
916            return get_logger($name);
917    }
918    
919    =head2 _x
920    
921    Convert string from UTF-8 to code page defined in C<import_xml>.
922    
923     my $text = $webpac->_x('utf8 text');
924    
925    =cut
926    
927    sub _x {
928            my $self = shift;
929            my $utf8 = shift || return;
930    
931            return $self->{'utf2cp'}->convert($utf8) ||
932                    $self->_get_logger()->logwarn("can't convert '$utf8'");
933    }
934    
935    #
936    #
937    #
938    
939    =head1 LOGGING
940    
941    Logging in WebPAC is performed by L<Log::Log4perl> with config file
942    C<log.conf>.
943    
944    Methods defined above have different levels of logging, so
945    it's descriptions will be useful to turn (mostry B<debug> logging) on
946    or off to see why WabPAC isn't perforing as you expect it (it might even
947    be a bug!).
948    
949    B<This is different from normal Log4perl behaviour>. To repeat, you can
950    also use method names, and not only classes (which are just few)
951    to filter logging.
952    
953    =cut
954    
955  1;  1;

Legend:
Removed from v.356  
changed lines
  Added in v.411

  ViewVC Help
Powered by ViewVC 1.1.26