/[Biblio-Isis]/trunk/lib/Biblio/Isis.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 /trunk/lib/Biblio/Isis.pm

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

revision 44 by dpavlin, Thu Jul 6 11:02:37 2006 UTC revision 56 by dpavlin, Sat Jul 8 16:03:52 2006 UTC
# Line 4  use strict; Line 4  use strict;
4  use Carp;  use Carp;
5  use File::Glob qw(:globally :nocase);  use File::Glob qw(:globally :nocase);
6    
 use Data::Dumper;  
   
7  BEGIN {  BEGIN {
8          use Exporter ();          use Exporter ();
9          use vars qw ($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);          use vars qw ($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);
10          $VERSION     = 0.13;          $VERSION     = 0.20;
11          @ISA         = qw (Exporter);          @ISA         = qw (Exporter);
12          #Give a hoot don't pollute, do not export more than needed by default          #Give a hoot don't pollute, do not export more than needed by default
13          @EXPORT      = qw ();          @EXPORT      = qw ();
# Line 119  Filter code ref which will be used befor Line 117  Filter code ref which will be used befor
117    
118  =item debug  =item debug
119    
120  Dump a B<lot> of debugging output.  Dump a B<lot> of debugging output even at level 1. For even more increase level.
121    
122  =back  =back
123    
# Line 153  sub new { Line 151  sub new {
151                  }                  }
152          }          }
153    
154          print STDERR "## using files: ",join(" ",@isis_files),"\n" if ($self->{debug});          if ($self->{debug}) {
155                    print STDERR "## using files: ",join(" ",@isis_files),"\n";
156                    eval "use Data::Dump";
157    
158                    if (! $@) {
159                            *Dumper = *Data::Dump::dump;
160                    } else {
161                            use Data::Dumper;
162                    }
163            }
164    
165          # if you want to read .FDT file use read_fdt argument when creating class!          # if you want to read .FDT file use read_fdt argument when creating class!
166          if ($self->{read_fdt} && -e $self->{fdt_file}) {          if ($self->{read_fdt} && -e $self->{fdt_file}) {
# Line 202  sub new { Line 209  sub new {
209          read($self->{'fileMST'}, $buff, 4) || croak "can't read NXTMFN from MST: $!";          read($self->{'fileMST'}, $buff, 4) || croak "can't read NXTMFN from MST: $!";
210          $self->{'NXTMFN'}=unpack("V",$buff) || croak "NXTNFN is zero";          $self->{'NXTMFN'}=unpack("V",$buff) || croak "NXTNFN is zero";
211    
212          print STDERR Dumper($self),"\n" if ($self->{debug});          print STDERR "## self ",Dumper($self),"\n" if ($self->{debug});
213    
214          # open files for later          # open files for later
215          open($self->{'fileXRF'}, $self->{xrf_file}) || croak "can't open '$self->{xrf_file}': $!";          open($self->{'fileXRF'}, $self->{xrf_file}) || croak "can't open '$self->{xrf_file}': $!";
# Line 378  sub fetch { Line 385  sub fetch {
385          return $self->{'record'};          return $self->{'record'};
386  }  }
387    
388    =head2 mfn
389    
390    Returns current MFN position
391    
392      my $mfn = $isis->mfn;
393    
394    =cut
395    
396    # This function should be simple return $self->{current_mfn},
397    # but if new is called with _hack_mfn it becomes setter.
398    # It's useful in tests when setting $isis->{record} directly
399    
400    sub mfn {
401            my $self = shift;
402            return $self->{current_mfn};
403    };
404    
405    
406  =head2 to_ascii  =head2 to_ascii
407    
408  Returns ASCII output of record with specified MFN  Returns ASCII output of record with specified MFN
# Line 457  which will be used for identifiers, C<i1 Line 482  which will be used for identifiers, C<i1
482               }               }
483             ],             ],
484    
485    In case there are repeatable subfields in record, this will create
486    following structure:
487    
488      '900' => [ {
489            'a' => [ 'foo', 'bar', 'baz' ],
490      }]
491    
492  This method will also create additional field C<000> with MFN.  This method will also create additional field C<000> with MFN.
493    
494    There is also more elaborative way to call C<to_hash> like this:
495    
496      my $hash = $isis->to_hash({
497            mfn => 42,
498            include_empty_subfields => 1,
499      });
500    
501  =cut  =cut
502    
503  sub to_hash {  sub to_hash {
504          my $self = shift;          my $self = shift;
505    
506    
507          my $mfn = shift || confess "need mfn!";          my $mfn = shift || confess "need mfn!";
508            my $arg;
509    
510            if (ref($mfn) eq 'HASH') {
511                    $arg = $mfn;
512                    $mfn = $arg->{mfn} || confess "need mfn in arguments";
513            }
514    
515          # init record to include MFN as field 000          # init record to include MFN as field 000
516          my $rec = { '000' => [ $mfn ] };          my $rec = { '000' => [ $mfn ] };
# Line 489  sub to_hash { Line 535  sub to_hash {
535                          if ($l =~ m/\^/) {                          if ($l =~ m/\^/) {
536                                  foreach my $t (split(/\^/,$l)) {                                  foreach my $t (split(/\^/,$l)) {
537                                          next if (! $t);                                          next if (! $t);
538                                          $val->{substr($t,0,1)} = substr($t,1);                                          my ($sf,$v) = (substr($t,0,1), substr($t,1));
539                                            # FIXME make this option !
540                                            next unless ($v);
541    #                                       warn "### $k^$sf:$v",$/ if ($self->{debug} > 1);
542    
543                                            # FIXME array return optional, by default unroll to ' ; '
544                                            if (ref( $val->{$sf} ) eq 'ARRAY') {
545    
546                                                    push @{ $val->{$sf} }, $v;
547                                            } elsif (defined( $val->{$sf} )) {
548                                                    # convert scalar field to array
549                                                    $val->{$sf} = [ $val->{$sf}, $v ];
550                                            } else {
551                                                    $val->{$sf} = $v;
552                                            }
553                                  }                                  }
554                          } else {                          } else {
555                                  $val = $l;                                  $val = $l;
# Line 608  module with databases from programs othe Line 668  module with databases from programs othe
668  tested this against ouput of one C<isis.dll>-based application, but I don't  tested this against ouput of one C<isis.dll>-based application, but I don't
669  know any details about it's version.  know any details about it's version.
670    
671    =head1 VERSIONS
672    
673    You can find version dependencies documented here
674    
675    =over 8
676    
677    =item 0.20
678    
679    Added C<< $isis->mfn >>, support for repeatable subfields and
680    C<< $isis->to_hash({ mfn => 42, ... }) >> calling convention
681    
682    =back
683    
684  =head1 AUTHOR  =head1 AUTHOR
685    
686          Dobrica Pavlinusic          Dobrica Pavlinusic
Legend:
Removed from v.44  
changed lines
  Added in v.56
  ViewVC Help
Powered by ViewVC 1.1.26