Visit Our UNIX and Linux User Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

file::mimeinfo::applications(3pm) [debian man page]

File::MimeInfo::Applications(3pm)			User Contributed Perl Documentation			 File::MimeInfo::Applications(3pm)

NAME
File::MimeInfo::Applications - Find programs to open a file by mimetype SYNOPSIS
use File::MimeInfo::Magic; use File::MimeInfo::Applications; my $file = '/foo/bar'; my $mimetype = mimetype($file) || die "Could not find mimetype for $file "; my ($default, @other) = mime_applications($mimetype); if (defined $default) { $default->system($file) } else { # prompt user with choice from @others # ... } DESCRIPTION
This module tries to find applications that can open files with a certain mimetype. This is done in the way suggested by the freedesktop Desktop Entry specification. This module is intended to be compatible with file managers and other applications that implement this specification. This module depends on File::DesktopEntry being installed. To use this module effectively you need to have the desktop-file-utils package from freedesktop and run update-desktop-database after installing new .desktop files. See http://www.freedesktop.org/wiki/Software/desktop-file-utils <http://www.freedesktop.org/wiki/Software/desktop-file-utils>. At the moment of writing this module is compatible with the way Nautilus (Gnome) and with Thunar (XFCE) handle applications for mimetypes. I understand KDE is still working on implementing the freedesktop mime specifications but will follow. At the very least all perl applications using this module are using the same defaults. EXPORT
All methods are exported by default. METHODS
"mime_applications(MIMETYPE)" Returns an array of File::DesktopEntry objects. The first is the default application for this mimetype, the rest are applications that say they can handle this mimetype. If the first result is undefined there is no default application and it is good practise to ask the user which application he wants to use. "mime_applications_all(MIMETYPE)" Like "mime_applications()" but also takes into account applications that can open mimetypes from which MIMETYPE inherits. Parent mimetypes tell aomething about the data format, all code inherits from text/plain for example. "mime_applications_set_default(MIMETYPE, APPLICATION)" Save a default application for this mimetype. This action will affect other applications using the same mechanism to find a default appliction. APPLICATION can either be a File::DesktopEntry object or the basename of a .desktop file. "mime_applications_set_custom(MIMETYPE, COMMAND)" Save a custom shell command as default application. Generates a DesktopEntry file on the fly and calls "mime_applications_set_custom". Returns the DesktopEntry object. No checks are done at all on COMMAND. It should however contain at least one word. NOTES
At present the file with defaults is $XDG_DATA_HOME/applications/defaults.list. This file is not specified in any freedesktop spec and if it gets standardized it should probably be located in $XDG_CONFIG_HOME. For this module I tried to implement the status quo. BUGS
Please mail the author when you encounter any bugs. AUTHOR
Jaap Karssenberg <pardus@cpan.org> Copyright (c) 2005, 2012 Jaap G Karssenberg. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. SEE ALSO
File::DesktopEntry, File::MimeInfo, File::MimeInfo::Magic, File::BaseDir <http://freedesktop.org/wiki/Software_2fdesktop_2dfile_2dutils> perl v5.14.2 2012-01-05 File::MimeInfo::Applications(3pm)

Check Out this Related Man Page

File::MimeInfo::Magic(3pm)				User Contributed Perl Documentation				File::MimeInfo::Magic(3pm)

NAME
File::MimeInfo::Magic - Determine file type with magic SYNOPSIS
use File::MimeInfo::Magic; my $mime_type = mimetype($file); DESCRIPTION
This module inherits from File::MimeInfo, it is transparent to its functions but adds support for the freedesktop magic file. Magic data is hashed when you need it for the first time. If you want to force hashing earlier use the "rehash()" function. EXPORT
The method "mimetype" is exported by default. The methods "magic", "inodetype", "globs" and "describe" can be exported on demand. METHODS
See also File::MimeInfo for methods that are inherited. "mimetype($file)" Returns a mime-type string for $file, returns undef on failure. This method bundles "inodetype()", "globs()" and "magic()". Magic rules with an priority of 80 and higher are checked before "globs()" is called, all other magic rules afterwards. If this doesn't work the file is read and the mime-type defaults to 'text/plain' or to 'application/octet-stream' when the first ten chars of the file match ascii control chars (white spaces excluded). If the file doesn't exist or isn't readable "undef" is returned. If $file is an object reference only "magic" and the default method are used. See below for details. "magic($file)" Returns a mime-type string for $file based on the magic rules, returns undef on failure. $file can be an object reference, in that case it is supposed to have a "seek()" and a "read()" method. This allows you for example to determine the mimetype of data in memory by using IO::Scalar. Be aware that when using a filehandle or an "IO::" object you need to set the ":utf8" binmode yourself if apropriate. "rehash()" Rehash the data files. Glob and magic information is preparsed when this method is called. If you want to by-pass the XDG basedir system you can specify your database directories by setting @File::MimeInfo::DIRS. But normally it is better to change the XDG basedir environment variables. "default" "describe" "extensions" "globs" "inodetype" These routines are imported from File::MimeInfo. SEE ALSO
File::MimeInfo LIMITATIONS
Only word sizes of 1, 2 or 4 are supported. Any other word size is ignored and will cause a warning. BUGS
Please mail the author when you encounter any bugs. AUTHOR
Jaap Karssenberg <pardus@cpan.org> Copyright (c) 2003, 2012 Jaap G Karssenberg. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.14.2 2012-01-05 File::MimeInfo::Magic(3pm)

Featured Tech Videos