file::type::webimages(3pm) [debian man page]

File::Type::WebImages(3pm)				User Contributed Perl Documentation				File::Type::WebImages(3pm)

NAME

       File::Type::WebImages - determine web image file types using magic

SYNOPSIS

	   use File::Type::WebImages 'mime_type';

	   my $type_1 = mime_type($file);
	   my $type_2 = mime_type($data);

DESCRIPTION

       "mime_type()" can use either a filename, or file contents, to determine the type of a file. The process involves looking the data at the
       beginning of the file, sometimes called "magic numbers".

THE BIG TRADE OFF

       For minimum memory consumption, only the following common web image  file types are supported:

       BMP, GIF, JPEG and PNG.	( image/bmp, image/gif, image/jpeg and image/png ).

       Unlike with File::Type and File::MMagic, 'undef', not "application/octet-stream" will be returned for unknown formats.

       Unlike File::Type, we return "image/png" for PNGs, not "image/x-png";

       If you want more mime types detected use File::Type or some other module.

TODO

       It would be even better to have a pluggable system that would allow you to plug-in different sets of MIME-types you care about.

SEE ALSO

       File::Type. Similar, but supports over 100 file types.

ACKNOWLEDGMENTS

       File::Type::WebImages is built from a mime-magic file from cleancode.org. The original can be found at
       <http://cleancode.org/cgi-bin/viewcvs.cgi/email/mime-magic.mime?rev=1.1.1.1>.

AUTHORS

       Paul Mison <pmison@fotango.com> - wrote original File::Type Mark Stosberg <mark@summersault.com> - hacked up this.

COPYRIGHT

       Copyright 2003-2004 Fotango Ltd.

LICENSE

       Licensed under the same terms as Perl itself.

perl v5.10.1							    2011-04-23						File::Type::WebImages(3pm)

File::Type(3pm) 					User Contributed Perl Documentation					   File::Type(3pm)

NAME

       File::Type - determine file type using magic

SYNOPSIS

	   my $ft = File::Type->new();

	   # read in data from file to $data, then
	   my $type_from_data = $ft->checktype_contents($data);

	   # alternatively, check file from disk
	   my $type_from_file = $ft->checktype_filename($file);

	   # convenient method for checking either a file or data
	   my $type_1 = $ft->mime_type($file);
	   my $type_2 = $ft->mime_type($data);

DESCRIPTION

       File::Type uses magic numbers (typically at the start of a file) to determine the MIME type of that file.

       File::Type can use either a filename, or file contents, to determine the type of a file.

METHODS

       new

       Returns a new File::Type object.

       mime_type($argument)

       Takes either data or a filename, determines what it is, and passes the argument through to the relevant method below. If the argument is a
       directory, returns undef.

       checktype_filename($filename)

       Opens $filename (if possible; if not, returns undef) and returns the MIME type of the file.

       checktype_contents($data)

       Matches $data against the magic database criteria and returns the MIME type of the file.

TODO

	   * Add additional magic match criteria

BUGS

       None known.

       NOTES

       Some magic definitions in the mime-magic file used in the creation of this module vary from those in other apps (eg image/x-png not
       image/png).

SEE ALSO

       File::MMagic and File::MimeInfo perform the same job, but have a number of problems that led to the creation of this module.

       File::MMagic inlines a copy of the magic database, and uses a DATA filehandle, which causes problems when running under mod_perl.

       File::MimeInfo uses an external magic file, and relies on file extensions rather than magic to determine the mime type.

       As a result, File::Type uses a seperate module and script to create the code at the core of this module, which means that there is no need
       to include a magic database at all, and that it is safe to run under mod_perl.

       File::Type::Builder, which generates the code at the heart of this module.

ACKNOWLEDGMENTS

       File::Type is built from a mime-magic file from cleancode.org. The original can be found at <http://clean-
       code.org/cgi-bin/viewcvs.cgi/email/mime-magic.mime?rev=1.1.1.1>.

AUTHOR

       Paul Mison <pmison@fotango.com>

COPYRIGHT

       Copyright 2003-2004 Fotango Ltd.

LICENSE

       Licensed under the same terms as Perl itself.

perl v5.8.8							    2004-10-08							   File::Type(3pm)