📄 module-mailcap.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>12.10 mailcap -- Mailcap file handling.</title>
<META NAME="description" CONTENT="12.10 mailcap -- Mailcap file handling.">
<META NAME="keywords" CONTENT="lib">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="STYLESHEET" href="lib.css" tppabs="http://www.python.org/doc/current/lib/lib.css">
<LINK REL="next" href="module-mimetypes.html" tppabs="http://www.python.org/doc/current/lib/module-mimetypes.html">
<LINK REL="previous" href="module-xdrlib.html" tppabs="http://www.python.org/doc/current/lib/module-xdrlib.html">
<LINK REL="up" href="netdata.html" tppabs="http://www.python.org/doc/current/lib/netdata.html">
<LINK REL="next" href="module-mimetypes.html" tppabs="http://www.python.org/doc/current/lib/module-mimetypes.html">
</head>
<body>
<DIV CLASS="navigation"><table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td><A href="xdr-exceptions.html" tppabs="http://www.python.org/doc/current/lib/xdr-exceptions.html"><img src="previous.gif" tppabs="http://www.python.org/doc/current/icons/previous.gif" border="0" height="32"
alt="Previous Page" width="32"></A></td>
<td><A href="netdata.html" tppabs="http://www.python.org/doc/current/lib/netdata.html"><img src="up.gif" tppabs="http://www.python.org/doc/current/icons/up.gif" border="0" height="32"
alt="Up One Level" width="32"></A></td>
<td><A href="module-mimetypes.html" tppabs="http://www.python.org/doc/current/lib/module-mimetypes.html"><img src="next.gif" tppabs="http://www.python.org/doc/current/icons/next.gif" border="0" height="32"
alt="Next Page" width="32"></A></td>
<td align="center" width="100%">Python Library Reference</td>
<td><A href="contents.html" tppabs="http://www.python.org/doc/current/lib/contents.html"><img src="contents.gif" tppabs="http://www.python.org/doc/current/icons/contents.gif" border="0" height="32"
alt="Contents" width="32"></A></td>
<td><a href="modindex.html" tppabs="http://www.python.org/doc/current/lib/modindex.html" title="Module Index"><img src="modules.gif" tppabs="http://www.python.org/doc/current/icons/modules.gif" border="0" height="32"
alt="Module Index" width="32"></a></td>
<td><A href="genindex.html" tppabs="http://www.python.org/doc/current/lib/genindex.html"><img src="index.gif" tppabs="http://www.python.org/doc/current/icons/index.gif" border="0" height="32"
alt="Index" width="32"></A></td>
</tr></table>
<b class="navlabel">Previous:</b> <a class="sectref" href="xdr-exceptions.html" tppabs="http://www.python.org/doc/current/lib/xdr-exceptions.html">12.9.3 Exceptions</A>
<b class="navlabel">Up:</b> <a class="sectref" href="netdata.html" tppabs="http://www.python.org/doc/current/lib/netdata.html">12. Internet Data Handling</A>
<b class="navlabel">Next:</b> <a class="sectref" href="module-mimetypes.html" tppabs="http://www.python.org/doc/current/lib/module-mimetypes.html">12.11 mimetypes </A>
<br><hr></DIV>
<!--End of Navigation Panel-->
<H1><A NAME="SECTION00141000000000000000000">
12.10 <tt class="module">mailcap</tt> --
Mailcap file handling.</A>
</H1>
<P>
<P>
Mailcap files are used to configure how MIME-aware applications such
as mail readers and Web browsers react to files with different MIME
types. (The name ``mailcap'' is derived from the phrase ``mail
capability''.) For example, a mailcap file might contain a line like
"<tt class="samp">video/mpeg; xmpeg %s</tt>". Then, if the user encounters an email
message or Web document with the MIME type <span class="mimetype">video/mpeg</span>,
"<tt class="samp">%s</tt>" will be replaced by a filename (usually one belonging to a
temporary file) and the <b class="program">xmpeg</b> program can be automatically
started to view the file.
<P>
The mailcap format is documented in <a class="rfc" name="rfcref-47556"
href="javascript:if(confirm('http://www.ietf.org/rfc/rfc1524.txt \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ietf.org/rfc/rfc1524.txt'" tppabs="http://www.ietf.org/rfc/rfc1524.txt">RFC 1524 <img src="offsite.gif" tppabs="http://www.python.org/doc/current/icons/offsite.gif"
border='0' class='offsitelink' height='15' width='17' alt='[off-site link]'
></a>, ``A User Agent
Configuration Mechanism For Multimedia Mail Format Information,'' but
is not an Internet standard. However, mailcap files are supported on
most Unix systems.
<P>
<dl><dt><b><a name='l2h-2469'><tt class='function'>findmatch</tt></a></b> (<var>caps, MIMEtype</var><big>[</big><var>, key</var><big>[</big><var>,
filename</var><big>[</big><var>, plist</var><big>]</big><big>]</big><big>]</big>)
<dd>
Return a 2-tuple; the first element is a string containing the command
line to be executed
(which can be passed to <code>os.system()</code>), and the second element is
the mailcap entry for a given MIME type. If no matching MIME
type can be found, <code>(None, None)</code> is returned.
<P>
<var>key</var> is the name of the field desired, which represents the type
of activity to be performed; the default value is 'view', since in the
most common case you simply want to view the body of the MIME-typed
data. Other possible values might be 'compose' and 'edit', if you
wanted to create a new body of the given MIME type or alter the
existing body data. See <a class="rfc" name="rfcref-47558"
href="javascript:if(confirm('http://www.ietf.org/rfc/rfc1524.txt \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ietf.org/rfc/rfc1524.txt'" tppabs="http://www.ietf.org/rfc/rfc1524.txt">RFC 1524 <img src="offsite.gif" tppabs="http://www.python.org/doc/current/icons/offsite.gif"
border='0' class='offsitelink' height='15' width='17' alt='[off-site link]'
></a> for a complete list of these
fields.
<P>
<var>filename</var> is the filename to be substituted for "<tt class="samp">%s</tt>" in the
command line; the default value is
<code>'/dev/null'</code> which is almost certainly not what you want, so
usually you'll override it by specifying a filename.
<P>
<var>plist</var> can be a list containing named parameters; the default
value is simply an empty list. Each entry in the list must be a
string containing the parameter name, an equals sign (<code>=</code>), and the
parameter's value. Mailcap entries can contain
named parameters like <code>%{foo}</code>, which will be replaced by the
value of the parameter named 'foo'. For example, if the command line
"<tt class="samp">showpartial %{id} %{number} %{total}</tt>"was in a mailcap file, and <var>plist</var> was set to <code>['id=1',
'number=2', 'total=3']</code>, the resulting command line would be
<code>"showpartial 1 2 3"</code>.
<P>
In a mailcap file, the "test" field can optionally be specified to
test some external condition (e.g., the machine architecture, or the
window system in use) to determine whether or not the mailcap line
applies. <code>findmatch()</code> will automatically check such conditions
and skip the entry if the check fails.
</dl>
<P>
<dl><dt><b><a name='l2h-2470'><tt class='function'>getcaps</tt></a></b> ()
<dd>
Returns a dictionary mapping MIME types to a list of mailcap file
entries. This dictionary must be passed to the <code>findmatch()</code>
function. An entry is stored as a list of dictionaries, but it
shouldn't be necessary to know the details of this representation.
<P>
The information is derived from all of the mailcap files found on the
system. Settings in the user's mailcap file <span class="file">$HOME/.mailcap</span>
will override settings in the system mailcap files
<span class="file">/etc/mailcap</span>, <span class="file">/usr/etc/mailcap</span>, and
<span class="file">/usr/local/etc/mailcap</span>.
</dl>
<P>
An example usage:
<dl><dd><pre class="verbatim">
>>> import mailcap
>>> d=mailcap.getcaps()
>>> mailcap.findmatch(d, 'video/mpeg', filename='/tmp/tmp1223')
('xmpeg /tmp/tmp1223', {'view': 'xmpeg %s'})
</pre></dl>
<DIV CLASS="navigation"><p><hr><table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td><A href="xdr-exceptions.html" tppabs="http://www.python.org/doc/current/lib/xdr-exceptions.html"><img src="previous.gif" tppabs="http://www.python.org/doc/current/icons/previous.gif" border="0" height="32"
alt="Previous Page" width="32"></A></td>
<td><A href="netdata.html" tppabs="http://www.python.org/doc/current/lib/netdata.html"><img src="up.gif" tppabs="http://www.python.org/doc/current/icons/up.gif" border="0" height="32"
alt="Up One Level" width="32"></A></td>
<td><A href="module-mimetypes.html" tppabs="http://www.python.org/doc/current/lib/module-mimetypes.html"><img src="next.gif" tppabs="http://www.python.org/doc/current/icons/next.gif" border="0" height="32"
alt="Next Page" width="32"></A></td>
<td align="center" width="100%">Python Library Reference</td>
<td><A href="contents.html" tppabs="http://www.python.org/doc/current/lib/contents.html"><img src="contents.gif" tppabs="http://www.python.org/doc/current/icons/contents.gif" border="0" height="32"
alt="Contents" width="32"></A></td>
<td><a href="modindex.html" tppabs="http://www.python.org/doc/current/lib/modindex.html" title="Module Index"><img src="modules.gif" tppabs="http://www.python.org/doc/current/icons/modules.gif" border="0" height="32"
alt="Module Index" width="32"></a></td>
<td><A href="genindex.html" tppabs="http://www.python.org/doc/current/lib/genindex.html"><img src="index.gif" tppabs="http://www.python.org/doc/current/icons/index.gif" border="0" height="32"
alt="Index" width="32"></A></td>
</tr></table>
<b class="navlabel">Previous:</b> <a class="sectref" href="xdr-exceptions.html" tppabs="http://www.python.org/doc/current/lib/xdr-exceptions.html">12.9.3 Exceptions</A>
<b class="navlabel">Up:</b> <a class="sectref" href="netdata.html" tppabs="http://www.python.org/doc/current/lib/netdata.html">12. Internet Data Handling</A>
<b class="navlabel">Next:</b> <a class="sectref" href="module-mimetypes.html" tppabs="http://www.python.org/doc/current/lib/module-mimetypes.html">12.11 mimetypes </A>
</DIV>
<!--End of Navigation Panel-->
<ADDRESS>
<hr>See <i><a href="about.html" tppabs="http://www.python.org/doc/current/lib/about.html">About this document...</a></i> for information on suggesting changes.
</ADDRESS>
</BODY>
</HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -