/usr/share/perl5/Email/MIME/CreateHTML/Resolver/Filesystem.pm is in libemail-mime-createhtml-perl 1.030-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 | ###############################################################################
# Purpose : Load resources from the filesystem
# Author : John Alden
# Created : Aug 2006
# CVS : $Header: /home/cvs/software/cvsroot/email/lib/Email/MIME/CreateHTML/Resolver/Filesystem.pm,v 1.6 2006/08/24 21:41:38 johna Exp $
###############################################################################
package Email::MIME::CreateHTML::Resolver::Filesystem;
use strict;
use URI::file;
use File::Slurp::WithinPolicy 'read_file';
use MIME::Types;
use File::Spec;
use vars qw($VERSION);
$VERSION = sprintf "%d.%03d", q$Revision: 1.6 $ =~ /: (\d+)\.(\d+)/;
sub new {
my ($class, $options) = @_;
$options ||= {};
my $self = {%$options};
return bless($self, $class);
}
#Simple/secure resource loader from local filesystem
sub get_resource {
my ($self, $uri) = @_;
my $base = $self->{base};
#Handle file:// URIs if necessary
my ($path, $base_dir) = map {defined && m|^file://|? URI::file->new($_)->file() : $_} ($uri, $base);
#Allow for base dir
my $fullpath = defined($base_dir) ? File::Spec->catfile($base_dir,$path) : $path;
#Read in the file
my $content = read_file($fullpath);
my ($volume,$directories,$filename) = File::Spec->splitpath( $path );
#Deduce MIME type/transfer encoding (currently using extension)
#We may want to improve the sophistication of this (e.g. making use of $content)
my ($mimetype,$encoding) = MIME::Types::by_suffix($filename);
return ($content,$filename,$mimetype,$encoding);
}
1;
=head1 NAME
Email::MIME::CreateHTML::Resolver::Filesystem - finds resources via the filesystem
=head1 SYNOPSIS
my $o = new Email::MIME::CreateHTML::Resolver::Filesystem(\%args)
my ($content,$filename,$mimetype,$xfer_encoding) = $o->get_resource($uri)
=head1 DESCRIPTION
This is used by Email::MIME::CreateHTML to load resources.
=head1 METHODS
=over 4
=item $o = new Email::MIME::CreateHTML::Resolver::Filesystem(\%args)
%args can contain:
=over 4
=item base
Base directory used to resolve relative filepaths passed to get_resource.
=back
=item ($content,$filename,$mimetype,$xfer_encoding) = $o->get_resource($uri)
=back
=head1 TODO
- Currently the MIME type is deduced from the file extension via MIME::Types; given we have the content available, more sophisticated strategies are probably possible
=head1 VERSION
$Revision: 1.6 $ on $Date: 2006/08/24 21:41:38 $ by $Author: johna $
=head1 AUTHOR
Tony Hennessy, Simon Flack and John Alden
=head1 COPYRIGHT
(c) BBC 2005,2006. This program is free software; you can redistribute it and/or modify it under the GNU GPL.
See the file COPYING in this distribution, or http://www.gnu.org/licenses/gpl.txt
=cut
|