From 9fbeda1dc776c602ce14d3874368d4620c079b60 Mon Sep 17 00:00:00 2001
From: ivan <ivan>
Date: Tue, 12 Aug 2008 04:02:02 +0000
Subject: [PATCH] add image handling and prevent leaking temporary files
 (ourselves, Archive::Zip might be)

---
 MANIFEST                           |   5 +-
 Makefile.PL                        |   7 +--
 TODO                               |  15 ++++--
 lib/HTML/AutoConvert.pm            |  39 +++++++++++++--
 lib/HTML/AutoConvert/OpenOffice.pm |  77 +++++++++++++++++++++++------
 lib/HTML/AutoConvert/poppler.pm    |  69 ++++++++++++++++----------
 t/01-doc.t                         |   2 +
 t/34-doc_images-OpenOffice.t       |  35 +++++++++++++
 t/46-pdf_images-poppler.t          |  38 ++++++++++++++
 t/HeatherElko.doc                  | Bin 0 -> 36864 bytes
 10 files changed, 237 insertions(+), 50 deletions(-)
 create mode 100644 t/34-doc_images-OpenOffice.t
 create mode 100644 t/46-pdf_images-poppler.t
 create mode 100644 t/HeatherElko.doc

diff --git a/MANIFEST b/MANIFEST
index 173ec7a..36a7492 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -20,6 +20,9 @@ t/04-doc-OpenOffice.t
 t/14-rtf-OpenOffice.t
 t/15-rtf-unrtf.t
 t/26-pdf-poppler.t
+t/34-doc_images-OpenOffice.t
+t/46-pdf_images-poppler.t
+t/attitude.pdf
 t/DiaryofaKillerCat.doc
+t/HeatherElko.doc
 t/VEGAN_RECIPES.rtf
-t/attitude.pdf
diff --git a/Makefile.PL b/Makefile.PL
index cd7c009..18af759 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -12,9 +12,10 @@ WriteMakefile(
     'INSTALLSCRIPT'     => '/usr/local/bin',
     'INSTALLSITEBIN'    => '/usr/local/bin',
     PREREQ_PM => {
-        'Test::More'  => 0,
-        'IPC::Run'    => 0,
-        'File::Slurp' => 0,
+        'Test::More'   => 0,
+        'IPC::Run'     => 0,
+        'File::Slurp'  => 0,
+        'Archive::Zip' => 0,
     },
     dist                => { COMPRESS => 'gzip -9f', SUFFIX => 'gz', },
     clean               => { FILES => 'HTML-AutoConvert-*' },
diff --git a/TODO b/TODO
index 0058ab2..2969e53 100644
--- a/TODO
+++ b/TODO
@@ -1,6 +1,13 @@
-- DOC: images
-- PDF: images
-- RTF: images
+- add the ability to supress starting our own OO and connect to one running
+  elsewhere
+
+- OpenOffice.pm: image converter seems to be leaving behind images in /tmp...
+                 Archive::Zip?
+
+- auto-convert non-web images to jpg/gif/png?
+
+- wvWare/other backends besides OO and poppler: handle images?
+
+- OpenOffice.pm: poll via UNO to determine readiness rather than sleep (or not)
 
-- OpenOffice.pm: poll via UNO to determine readiness rather than sleep
 - OpenOffice.pm: convert DocumentConverter.py to Perl using OpenOffice::UNO
diff --git a/lib/HTML/AutoConvert.pm b/lib/HTML/AutoConvert.pm
index 7df3b82..bdbc5fd 100644
--- a/lib/HTML/AutoConvert.pm
+++ b/lib/HTML/AutoConvert.pm
@@ -23,6 +23,8 @@ our $VERSION = '0.01';
     #or to turn on debugging
     my $converter = HTML::AutoConvert->new('debug'=>1);
 
+    my $html = $converter->html_convert( $file );
+    # OR 
     my( $html, @images ) = $converter->html_convert( $file );
 
     #turn on or off debugging later
@@ -58,7 +60,22 @@ sub new {
 
 =head2 html_convert FILENAME
 
-Convert the given filename to HTML.  The HTML output is returned as a scalar.
+Convert the given filename to HTML.
+
+In a scalar context, simply returns the HTML output as a scalar.
+
+    my $html = $converter->html_convert( $file );
+
+In a list context, returns a list consisting of the HTML output as a scalar,
+followed by references for each image extracted, if any.  Each image reference
+is a list reference consisting of two elements: the first is the filename and
+the second is the image itself.
+
+    my( $html, @images ) = $converter->html_convert( $file );
+    foreach my $image ( @images ) {
+      my( $filename, $data ) = @$image;
+      #...
+    }
 
 =cut
 
@@ -72,10 +89,21 @@ sub html_convert {
     or die "no registered handlers for filetype ". $self->filetype( $file );
 
   my( $converted, $html, $errors ) = ( 0, '', '' );
+  my @imgs = ();
   foreach my $handler ( @handlers ) {
 
     my $module = 'HTML::AutoConvert::'. $handler->{'module'};
-    my $tmp_html = eval { $module->html_convert( $self->{'file'} ) };
+
+    my $tmp_html = '';
+    my @tmp_imgs = ();
+    if ( $handler->{'returns_images'} && wantarray ) {
+      ( $tmp_html, @tmp_imgs ) =
+        eval { $module->html_convert( $self->{'file'} ) };
+    } else {
+      $tmp_html =
+        eval { $module->html_convert( $self->{'file'} ) };
+    }
+
     if ( $@ ) {
        my $tmp_err = "conversion with $module failed: $@\n";
        warn $tmp_err if $self->{'debug'};
@@ -85,12 +113,17 @@ sub html_convert {
 
     $converted = 1;
     $html = $tmp_html;
+    @imgs = @tmp_imgs;
     last;
   }
 
   die "couldn't convert $file:\n$errors" unless $converted;
 
-  $html;
+  if ( wantarray ) {
+    ( $html, @imgs );
+  } else {
+    $html;
+  }
 
 }
 
diff --git a/lib/HTML/AutoConvert/OpenOffice.pm b/lib/HTML/AutoConvert/OpenOffice.pm
index e09a9e4..7b35595 100644
--- a/lib/HTML/AutoConvert/OpenOffice.pm
+++ b/lib/HTML/AutoConvert/OpenOffice.pm
@@ -34,24 +34,66 @@ use strict;
 use vars qw( %info ); #$slept );
 use IPC::Run qw( run timeout io );
 use File::Slurp qw( slurp );
+use Archive::Zip qw( :ERROR_CODES :CONSTANTS );
 
 %info = (
-  'types'   => [qw( doc rtf odt sxw )],
-  'weight'  => 80,
-  'url'     => 'http://wvware.sourceforge.net/',
+  'types'          => [qw( doc rtf odt sxw )],
+  'weight'         => 10,
+  'returns_images' => 1,
+  'url'            => 'http://www.openoffice.org/',
 );
 
 #$slept = 0;
 
 #sub program { ( 'openoffice', '-headless' ); }
 
-#half-ass using DocumentConverter.py for now
-#need to recode with OpenOffice::UNO
-
 sub html_convert {
   my( $self, $file ) = ( shift, shift );
   my $opt = ref($_[0]) ? shift : { @_ };
 
+  my $outfile = $self->odconvert($file, 'html');
+  my $html = slurp($outfile);
+  unlink($outfile) or warn "can't unlink $outfile";
+
+  return $html unless wantarray;
+
+  my @images = $self->extract_images($file, $opt);
+
+  ( $html, @images );
+
+}
+
+#http://cdriga.kfacts.com/open-source-world/tutorial-extract-original-images-from-ms-word-doc-using-openofficeorg/2007/11/04/
+sub extract_images {
+  my( $self, $file ) = ( shift, shift );
+  my $opt = ref($_[0]) ? shift : { @_ };
+
+  my $zipfile = $self->odconvert($file, 'odt');
+  my $zip = Archive::Zip->new();
+
+  unless ( $zip->read( $zipfile ) == AZ_OK ) {
+    die "error reading $zipfile for images";
+  }
+
+  my @members = $zip->membersMatching( '^Pictures/*' );
+
+  my @images = map {
+                     ( my $filename = $_->fileName ) =~ s/^.*\///;
+                     [ $filename, $zip->contents($_) ];
+                   }
+                   @members;
+
+  unlink($zipfile);
+
+  @images;
+}
+
+#half-ass using DocumentConverter.py for now
+#need to recode with OpenOffice::UNO
+sub odconvert {
+  my( $self, $file, $suffix ) = ( shift, shift, shift );
+  my $opt = ref($_[0]) ? shift : { @_ };
+
   $self->start_openoffice($opt);
 
   my $program = 'DocumentConverter.py';
@@ -59,20 +101,27 @@ sub html_convert {
   my $timeout = 60; #?
 
   use File::Temp qw/ tempfile /;
-  my($fh, $outfile) = tempfile(SUFFIX => '.html');
+  my($fh, $outfile) = tempfile(SUFFIX => ".$suffix");
   #hmm, it gets overwritten so $fh is bunk
 
   my($out, $err) = ( '', '' );
   local($SIG{CHLD}) = sub {};
-  run( [ $program, $file, $outfile ], \undef, \$out, \$err, timeout($timeout) )
-    or die "$program failed with exit status ". ( $? >> 8 ). ": $out\n";
-
-  my $html = slurp($outfile);
-
-  $html;
-
+  eval {
+    run( [ $program, $file, $outfile ], \undef, \$out, \$err, timeout($timeout) )
+      or do {
+              unlink($outfile) or warn "$!\n";
+              die "$program failed with exit status ". ( $? >> 8 ). ": $out\n";
+            };
+  };
+  if ( $@ ) {
+    unlink($outfile) or warn "$!\n";
+    die "$program failed: $@\n";
+  }
+
+  $outfile;
 }
 
+
 sub start_openoffice {
   my( $self ) = ( shift, shift );
   my $opt = ref($_[0]) ? shift : { @_ };
diff --git a/lib/HTML/AutoConvert/poppler.pm b/lib/HTML/AutoConvert/poppler.pm
index cca5b0d..a75a54f 100644
--- a/lib/HTML/AutoConvert/poppler.pm
+++ b/lib/HTML/AutoConvert/poppler.pm
@@ -13,36 +13,55 @@ poppler can be downloaded from http://poppler.freedesktop.org/
 use strict;
 use vars qw( %info );
 use base 'HTML::AutoConvert::Run';
+use File::Temp qw( tempdir );
+use File::Slurp qw( slurp );
+use IPC::Run qw( run timeout );
 
 %info = (
-  'types'   => 'pdf',
-  'weight'  => 10,
-  'url'     => 'http://poppler.freedesktop.org/',
+  'types'          => 'pdf',
+  'weight'         => 10,
+  'returns_images' => 1,
+  'url'            => 'http://poppler.freedesktop.org/',
 );
 
 sub program { ( 'pdftohtml', '-stdout' ) }
 
-#false laziness w/OpenOffice.pm
-#sub html_convert {
-#  my( $self, $file ) = ( shift, shift );
-#  my $opt = ref($_[0]) ? shift : { @_ };
-#
-#  my $program = 'pdftohtml';
-#
-#  my $timeout = 60; #?
-#
-#  my($out, $err) = ( '', '' );
-#  local($SIG{CHLD}) = sub {};
-#  run( [ $program, $file ], \undef, \$out, \$err, timeout($timeout) )
-#    or die "$program failed with exit status ". ( $? >> 8 ). ": $out\n";
-#
-#  ( my $outfile = $file ) =~ s/\.pdf$/.html/i
-#    or die "poppler.pm called with non-PDF file?!";
-#
-#  my $html = slurp($outfile);
-#
-#  $html;
-#
-#}
+#some false laziness "in spirit" w/OpenOffice.pm
+sub html_convert {
+  my( $self, $file ) = ( shift, shift );
+  my $opt = ref($_[0]) ? shift : { @_ };
+
+  my $html = $self->SUPER::html_convert($file, $opt);
+  return $html unless wantarray;
+
+  my @images = $self->extract_images($file, $opt);
+
+  ( $html, @images);
+}
+
+sub extract_images {
+  my( $self, $file ) = ( shift, shift );
+  my $opt = ref($_[0]) ? shift : { @_ };
+
+  my $imgdir = tempdir( CLEANUP=>1 ).'/';
+
+  #some false laziness w/Run::html_convert :(
+  my @program = ( 'pdfimages' );
+  my $program = $program[0];
+
+  my $timeout = 60; #?
+
+  my( $out, $err ) = ( '', '');
+  local($SIG{CHLD}) = sub {};
+  run( [ @program, $file, $imgdir ], \undef, \$out, \$err, timeout($timeout) )
+    or die "$program failed with exit status ". ( $? >> 8 ). ": $err\n";
+
+  map {
+        ( my $filename = $_ ) =~ s/^.*\/\-?//;
+        [ $filename, scalar(slurp($_)) ];
+      }
+      glob("$imgdir*");
+
+}
 
 1;
diff --git a/t/01-doc.t b/t/01-doc.t
index cbb8286..a2a788d 100644
--- a/t/01-doc.t
+++ b/t/01-doc.t
@@ -1,5 +1,7 @@
 #!perl
 
+BEGIN { chomp($pwd=`pwd`); $ENV{PATH} .= ":$pwd/bin"; };
+
 use Test::More tests => 2;
 
 use HTML::AutoConvert;
diff --git a/t/34-doc_images-OpenOffice.t b/t/34-doc_images-OpenOffice.t
new file mode 100644
index 0000000..ba32b2d
--- /dev/null
+++ b/t/34-doc_images-OpenOffice.t
@@ -0,0 +1,35 @@
+#!perl
+
+BEGIN { chomp($pwd=`pwd`); $ENV{PATH} .= ":$pwd/bin"; };
+
+use Test::More tests => 5;
+
+use HTML::AutoConvert;
+
+my $c = new HTML::AutoConvert;
+
+my $force = 'OpenOffice';
+#$c->{'handlers'}{'doc'}{$force}{'weight'} = -1;
+my @del = grep { $_ ne $force } keys %{ $c->{'handlers'}{'doc'} };
+delete($c->{'handlers'}{'doc'}{$_}) foreach @del;
+
+my( $html, @images ) = $c->html_convert('t/HeatherElko.doc');
+
+ok( scalar(@images) == 2, 'got two images' );
+
+#save em off
+#foreach my $image (@images) {
+#  my( $file, $data) = @$image;
+#  open(FILE, ">t/$file") or die $!;
+#  print FILE $data;
+#  close FILE or die $!;
+#}
+
+#check the names & lengths at least
+is( $images[0]->[0], '10000000000000C80000009688B0FEF3.png', '1st image name');
+ok( length($images[0]->[1]) == 8704, '1st image size');
+
+is( $images[1]->[0], '100000000000009D0000009F54B4BCB3.png', '2nd image name');
+ok( length($images[1]->[1]) == 2125, '2nd image size');
+
+
diff --git a/t/46-pdf_images-poppler.t b/t/46-pdf_images-poppler.t
new file mode 100644
index 0000000..9bc1fc1
--- /dev/null
+++ b/t/46-pdf_images-poppler.t
@@ -0,0 +1,38 @@
+#!perl
+
+use Test::More tests => 9;
+
+use HTML::AutoConvert;
+
+my $c = new HTML::AutoConvert;
+
+my $force = 'poppler';
+#$c->{'handlers'}{'doc'}{$force}{'weight'} = -1;
+my @del = grep { $_ ne $force } keys %{ $c->{'handlers'}{'pdf'} };
+delete($c->{'handlers'}{'pdf'}{$_}) foreach @del;
+
+my( $html, @images ) = $c->html_convert('t/attitude.pdf');
+
+ok( scalar(@images) == 21, 'got 21 images' );
+
+#save em off
+#foreach my $image (@images) {
+#  my( $file, $data) = @$image;
+#  open(FILE, ">t/$file") or die $!;
+#  print FILE $data;
+#  close FILE or die $!;
+#}
+
+#check the names & lengths at least
+is( $images[0]->[0], '000.ppm', '1st image name');
+ok( length($images[0]->[1]) == 25949, '1st image size');
+
+is( $images[1]->[0], '001.ppm', '2nd image name');
+ok( length($images[1]->[1]) == 43664, '1st image size');
+
+is( $images[2]->[0], '002.ppm', '3rd image name');
+ok( length($images[2]->[1]) == 46833, '1st image size');
+
+is( $images[9]->[0], '009.ppm', '10th image name');
+ok( length($images[9]->[1]) == 46374, '10th image size');
+
diff --git a/t/HeatherElko.doc b/t/HeatherElko.doc
new file mode 100644
index 0000000000000000000000000000000000000000..4af5af7ceda150250526fda1d295b3b108357557
GIT binary patch
literal 36864
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

literal 0
HcmV?d00001

-- 
2.20.1