<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>entries[i].source — feedparser 5.1.3 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/feedparser.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '',
VERSION: '5.1.3',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="feedparser 5.1.3 documentation" href="index.html" />
<link rel="up" title="Reference" href="reference.html" />
<link rel="next" title="entries[i].summary" href="reference-entry-summary.html" />
<link rel="prev" title="entries[i].publisher_detail" href="reference-entry-publisher_detail.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="reference-entry-summary.html" title="entries[i].summary"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="reference-entry-publisher_detail.html" title="entries[i].publisher_detail"
accesskey="P">previous</a> |</li>
<li><a href="index.html">feedparser 5.1.3 documentation</a> »</li>
<li><a href="reference.html" accesskey="U">Reference</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="entries-i-source">
<span id="reference-entry-source"></span><h1><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source</span></tt><a class="headerlink" href="#entries-i-source" title="Permalink to this headline">¶</a></h1>
<p>A dictionary with details about the source of the entry.</p>
<p class="rubric">Comes from</p>
<ul class="simple">
<li>/atom10:feed/atom10:entry/atom10:source</li>
</ul>
<div class="section" id="entries-i-source-author">
<h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.author</span></tt><a class="headerlink" href="#entries-i-source-author" title="Permalink to this headline">¶</a></h2>
<p>The author of the source of this entry.</p>
</div>
<div class="section" id="entries-i-source-author-detail">
<h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.author_detail</span></tt><a class="headerlink" href="#entries-i-source-author-detail" title="Permalink to this headline">¶</a></h2>
<p>A dictionary containing details about the author of the source of this entry.</p>
<div class="section" id="entries-i-source-author-detail-name">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.author_detail.name</span></tt><a class="headerlink" href="#entries-i-source-author-detail-name" title="Permalink to this headline">¶</a></h3>
<p>The name of the author of the source of this entry.</p>
</div>
<div class="section" id="entries-i-source-author-detail-href">
<span id="reference-entry-source-author-detail-href"></span><h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.author_detail.href</span></tt><a class="headerlink" href="#entries-i-source-author-detail-href" title="Permalink to this headline">¶</a></h3>
<p>The <abbr title="Uniform Resource Locator">URL</abbr> of the author of the source of this
entry. This can be the author’s home page, or a contact page with a webmail
form.</p>
<p>If this is a relative <abbr title="Uniform Resource Identifier">URI</abbr>, it is
<a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>resolved according to a set of rules</em></a>.</p>
</div>
<div class="section" id="entries-i-source-author-detail-email">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.author_detail.email</span></tt><a class="headerlink" href="#entries-i-source-author-detail-email" title="Permalink to this headline">¶</a></h3>
<p>The email address of the author of the source of this entry.</p>
</div>
</div>
<div class="section" id="entries-i-source-contributors">
<h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.contributors</span></tt><a class="headerlink" href="#entries-i-source-contributors" title="Permalink to this headline">¶</a></h2>
<p>A list of contributors to the source of this entry.</p>
<div class="section" id="entries-i-source-contributors-j-name">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.contributors[j].name</span></tt><a class="headerlink" href="#entries-i-source-contributors-j-name" title="Permalink to this headline">¶</a></h3>
<p>The name of a contributor to the source of this entry.</p>
</div>
<div class="section" id="entries-i-source-contributors-j-href">
<span id="reference-entry-source-contributors-href"></span><h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.contributors[j].href</span></tt><a class="headerlink" href="#entries-i-source-contributors-j-href" title="Permalink to this headline">¶</a></h3>
<p>The <abbr title="Uniform Resource Locator">URL</abbr> of a contributor to the source of
this entry. This can be the contributor’s home page, or a contact page with a
webmail form.</p>
<p>If this is a relative <abbr title="Uniform Resource Identifier">URI</abbr>, it is
<a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>resolved according to a set of rules</em></a>.</p>
</div>
<div class="section" id="entries-i-source-contributors-j-email">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.contributors[j].email</span></tt><a class="headerlink" href="#entries-i-source-contributors-j-email" title="Permalink to this headline">¶</a></h3>
<p>The email address of a contributor to the source of this entry.</p>
</div>
</div>
<div class="section" id="entries-i-source-icon">
<h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.icon</span></tt><a class="headerlink" href="#entries-i-source-icon" title="Permalink to this headline">¶</a></h2>
<p>The <abbr title="Uniform Resource Locator">URL</abbr> of an icon representing the source
of this entry.</p>
<p>If this is a relative <abbr title="Uniform Resource Identifier">URI</abbr>, it is
<a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>resolved according to a set of rules</em></a>.</p>
</div>
<div class="section" id="entries-i-source-id">
<h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.id</span></tt><a class="headerlink" href="#entries-i-source-id" title="Permalink to this headline">¶</a></h2>
<p>A globally unique identifier for the source of this entry.</p>
</div>
<div class="section" id="entries-i-source-link">
<h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.link</span></tt><a class="headerlink" href="#entries-i-source-link" title="Permalink to this headline">¶</a></h2>
<p>The primary permanent link of the source of this entry</p>
</div>
<div class="section" id="entries-i-source-links">
<h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.links</span></tt><a class="headerlink" href="#entries-i-source-links" title="Permalink to this headline">¶</a></h2>
<p>A list of all links defined by the source of this entry.</p>
<div class="section" id="entries-i-source-links-j-rel">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.links[j].rel</span></tt><a class="headerlink" href="#entries-i-source-links-j-rel" title="Permalink to this headline">¶</a></h3>
<p>The relationship of a link defined by the source of this entry.</p>
<p>Atom 1.0 defines five standard link relationships and describes the process for
registering others. Here are the five standard rel values:</p>
<ul class="simple">
<li><tt class="docutils literal"><span class="pre">alternate</span></tt></li>
<li><tt class="docutils literal"><span class="pre">self</span></tt></li>
<li><tt class="docutils literal"><span class="pre">related</span></tt></li>
<li><tt class="docutils literal"><span class="pre">via</span></tt></li>
<li><tt class="docutils literal"><span class="pre">enclosure</span></tt></li>
</ul>
</div>
<div class="section" id="entries-i-source-links-j-type">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.links[j].type</span></tt><a class="headerlink" href="#entries-i-source-links-j-type" title="Permalink to this headline">¶</a></h3>
<p>The content type of the page pointed to by a link defined by the source of this
entry.</p>
</div>
<div class="section" id="entries-i-source-links-j-href">
<span id="reference-entry-source-links-href"></span><h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.links[j].href</span></tt><a class="headerlink" href="#entries-i-source-links-j-href" title="Permalink to this headline">¶</a></h3>
<p>The <abbr title="Uniform Resource Locator">URL</abbr> of the page pointed to by a link
defined by the source of this entry.</p>
<p>If this is a relative <abbr title="Uniform Resource Identifier">URI</abbr>, it is
<a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>resolved according to a set of rules</em></a>.</p>
</div>
<div class="section" id="entries-i-source-links-j-title">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.links[j].title</span></tt><a class="headerlink" href="#entries-i-source-links-j-title" title="Permalink to this headline">¶</a></h3>
<p>The title of a link defined by the source of this entry.</p>
</div>
</div>
<div class="section" id="entries-i-source-logo">
<h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.logo</span></tt><a class="headerlink" href="#entries-i-source-logo" title="Permalink to this headline">¶</a></h2>
<p>The <abbr title="Uniform Resource Locator">URL</abbr> of a logo representing the source of
this entry.</p>
<p>If this is a relative <abbr title="Uniform Resource Identifier">URI</abbr>, it is
<a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>resolved according to a set of rules</em></a>.</p>
</div>
<div class="section" id="entries-i-source-rights">
<span id="reference-entry-source-rights"></span><h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.rights</span></tt><a class="headerlink" href="#entries-i-source-rights" title="Permalink to this headline">¶</a></h2>
<p>A human-readable copyright statement for the source of this entry.</p>
</div>
<div class="section" id="entries-i-source-rights-detail">
<h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.rights_detail</span></tt><a class="headerlink" href="#entries-i-source-rights-detail" title="Permalink to this headline">¶</a></h2>
<p>A dictionary containing details about the copyright statement for the source of
this entry.</p>
<div class="section" id="entries-i-source-rights-detail-value">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.rights_detail.value</span></tt><a class="headerlink" href="#entries-i-source-rights-detail-value" title="Permalink to this headline">¶</a></h3>
<p>Same as <a class="reference internal" href="#reference-entry-source-rights"><em>entries[i].source.rights</em></a>.</p>
<p>If this contains <abbr title="HyperText Markup Language">HTML</abbr> or
<abbr title="Extensible HyperText Markup Language">XHTML</abbr>, it is
<a class="reference internal" href="html-sanitization.html#advanced-sanitization"><em>sanitized</em></a> by default.</p>
<p>If this contains <abbr title="HyperText Markup Language">HTML</abbr> or
<abbr title="Extensible HyperText Markup Language">XHTML</abbr>, certain (X)HTML elements
within this value may contain relative
<abbr title="Uniform Resource Identifier">URI</abbr>s. If so, they are
<a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>resolved according to a set of rules</em></a>.</p>
</div>
<div class="section" id="entries-i-source-rights-detail-type">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.rights_detail.type</span></tt><a class="headerlink" href="#entries-i-source-rights-detail-type" title="Permalink to this headline">¶</a></h3>
<p>The content type of the copyright statement for the source of this entry.</p>
<p>Most likely values for <tt class="xref py py-attr docutils literal"><span class="pre">type</span></tt>:</p>
<ul class="simple">
<li><em class="mimetype">text/plain</em></li>
<li><em class="mimetype">text/html</em></li>
<li><em class="mimetype">application/xhtml+xml</em></li>
</ul>
<p>For Atom feeds, the content type is taken from the type attribute, which
defaults to <em class="mimetype">text/plain</em> if not specified. For
<abbr title="Rich Site Summary">RSS</abbr> feeds, the content type is auto-determined by
inspecting the content, and defaults to <em class="mimetype">text/html</em>. Note that this
may cause silent data loss if the value contains plain text with angle
brackets. There is nothing I can do about this problem; it is a limitation of
<abbr title="Rich Site Summary">RSS</abbr>.</p>
<p>Future enhancement: some versions of <abbr title="Rich Site Summary">RSS</abbr> clearly
specify that certain values default to <em class="mimetype">text/plain</em>, and
<strong class="program">Universal Feed Parser</strong> should respect this, but it doesn’t yet.</p>
</div>
<div class="section" id="entries-i-source-rights-detail-language">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.rights_detail.language</span></tt><a class="headerlink" href="#entries-i-source-rights-detail-language" title="Permalink to this headline">¶</a></h3>
<p>The language of the copyright statement for the source of this entry.</p>
<p><tt class="xref py py-attr docutils literal"><span class="pre">language</span></tt> is supposed to be a
language code, as specified by <a class="reference external" href="http://www.ietf.org/rfc/rfc3066.txt">RFC 3066</a>, but publishers have been known to
publish random values like “English” or “German”.
<strong class="program">Universal Feed Parser</strong> does not do any parsing or normalization of
language codes.</p>
<p><tt class="xref py py-attr docutils literal"><span class="pre">language</span></tt> may come from the
element’s xml:lang attribute, or it may inherit from a parent element’s
xml:lang, or the Content-Language <abbr title="Hypertext Transfer Protocol">HTTP</abbr>
header. If the feed does not specify a language,
<tt class="xref py py-attr docutils literal"><span class="pre">language</span></tt> will be <tt class="docutils literal"><span class="pre">None</span></tt>, the
<strong class="program">Python</strong> null value.</p>
</div>
<div class="section" id="entries-i-source-rights-detail-base">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.rights_detail.base</span></tt><a class="headerlink" href="#entries-i-source-rights-detail-base" title="Permalink to this headline">¶</a></h3>
<p>The original base <abbr title="Uniform Resource Identifier">URI</abbr> for links within
the copyright statement for the source of this entry.</p>
<p><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.rights_detail.base</span></tt> is only useful in rare
situations and can usually be ignored. It is the original base
<abbr title="Uniform Resource Identifier">URI</abbr> for this value, as specified by the
element’s xml:base attribute, or a parent element’s xml:base, or the
appropriate <abbr title="Hypertext Transfer Protocol">HTTP</abbr> header, or the
<abbr title="Uniform Resource Identifier">URI</abbr> of the feed. (See
<a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>Relative Link Resolution</em></a> for more details.) By the time you see it,
<strong class="program">Universal Feed Parser</strong> has already resolved relative links in all
values where it makes sense to do so. <em>Clients should never need to manually
resolve relative links.</em></p>
</div>
</div>
<div class="section" id="entries-i-source-subtitle">
<span id="reference-entry-source-subtitle"></span><h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.subtitle</span></tt><a class="headerlink" href="#entries-i-source-subtitle" title="Permalink to this headline">¶</a></h2>
<p>A subtitle, tagline, slogan, or other short description of the source of this
entry.</p>
<p>If this contains <abbr title="HyperText Markup Language">HTML</abbr> or
<abbr title="Extensible HyperText Markup Language">XHTML</abbr>, it is
<a class="reference internal" href="html-sanitization.html#advanced-sanitization"><em>sanitized</em></a> by default.</p>
<p>If this contains <abbr title="HyperText Markup Language">HTML</abbr> or
<abbr title="Extensible HyperText Markup Language">XHTML</abbr>, certain (X)HTML elements
within this value may contain relative
<abbr title="Uniform Resource Identifier">URI</abbr>s. If so, they are
<a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>resolved according to a set of rules</em></a>.</p>
</div>
<div class="section" id="entries-i-source-subtitle-detail">
<h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.subtitle_detail</span></tt><a class="headerlink" href="#entries-i-source-subtitle-detail" title="Permalink to this headline">¶</a></h2>
<p>A dictionary containing details about the subtitle for the source of this
entry.</p>
<div class="section" id="entries-i-source-subtitle-detail-value">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.subtitle_detail.value</span></tt><a class="headerlink" href="#entries-i-source-subtitle-detail-value" title="Permalink to this headline">¶</a></h3>
<p>Same as <a class="reference internal" href="#reference-entry-source-subtitle"><em>entries[i].source.subtitle</em></a>.</p>
<p>If this contains <abbr title="HyperText Markup Language">HTML</abbr> or
<abbr title="Extensible HyperText Markup Language">XHTML</abbr>, it is
<a class="reference internal" href="html-sanitization.html#advanced-sanitization"><em>sanitized</em></a> by default.</p>
<p>If this contains <abbr title="HyperText Markup Language">HTML</abbr> or
<abbr title="Extensible HyperText Markup Language">XHTML</abbr>, certain (X)HTML elements
within this value may contain relative
<abbr title="Uniform Resource Identifier">URI</abbr>s. If so,
they are <a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>resolved according to a set of rules</em></a>.</p>
</div>
<div class="section" id="entries-i-source-subtitle-detail-type">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.subtitle_detail.type</span></tt><a class="headerlink" href="#entries-i-source-subtitle-detail-type" title="Permalink to this headline">¶</a></h3>
<p>The content type of the subtitle of the source of this entry.</p>
<p>Most likely values for <tt class="xref py py-attr docutils literal"><span class="pre">type</span></tt>:</p>
<ul class="simple">
<li><em class="mimetype">text/plain`</em></li>
<li><em class="mimetype">text/html`</em></li>
<li><em class="mimetype">application/xhtml+xml`</em></li>
</ul>
<p>For Atom feeds, the content type is taken from the type attribute, which
defaults to <em class="mimetype">text/plain`</em> if not specified. For
<abbr title="Rich Site Summary">RSS</abbr> feeds, the content type is auto-determined by
inspecting the content, and defaults to <em class="mimetype">text/html`</em>. Note that this
may cause silent data loss if the value contains plain text with angle
brackets. There is nothing I can do about this problem; it is a limitation of
<abbr title="Rich Site Summary">RSS</abbr>.</p>
<p>Future enhancement: some versions of <abbr title="Rich Site Summary">RSS</abbr> clearly
specify that certain values default to <em class="mimetype">text/plain`</em>, and
<strong class="program">Universal Feed Parser</strong> should respect this, but it doesn’t yet.</p>
</div>
<div class="section" id="entries-i-source-subtitle-detail-language">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.subtitle_detail.language</span></tt><a class="headerlink" href="#entries-i-source-subtitle-detail-language" title="Permalink to this headline">¶</a></h3>
<p>The language of the subtitle of the source of this entry.</p>
<p><tt class="xref py py-attr docutils literal"><span class="pre">language</span></tt> is supposed to be a
language code, as specified by <a class="reference external" href="http://www.ietf.org/rfc/rfc3066.txt">RFC 3066</a>, but publishers have been known to
publish random values like “English” or “German”.
<strong class="program">Universal Feed Parser</strong> does not do any parsing or normalization of
language codes.</p>
<p><tt class="xref py py-attr docutils literal"><span class="pre">language</span></tt> may come from the
element’s xml:lang attribute, or it may inherit from a parent element’s
xml:lang, or the Content-Language <abbr title="Hypertext Transfer Protocol">HTTP</abbr>
header. If the feed does not specify a language,
<tt class="xref py py-attr docutils literal"><span class="pre">language</span></tt> will be <tt class="docutils literal"><span class="pre">None</span></tt>, the
<strong class="program">Python</strong> null value.</p>
</div>
<div class="section" id="entries-i-source-subtitle-detail-base">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.subtitle_detail.base</span></tt><a class="headerlink" href="#entries-i-source-subtitle-detail-base" title="Permalink to this headline">¶</a></h3>
<p>The original base <abbr title="Uniform Resource Identifier">URI</abbr> for links within
the subtitle of the source of this entry.</p>
<p><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.subtitle_detail.base</span></tt> is only useful in rare
situations and can usually be ignored. It is the original base
<abbr title="Uniform Resource Identifier">URI</abbr> for this value, as specified by the
element’s xml:base attribute, or a parent element’s xml:base, or the
appropriate <abbr title="Hypertext Transfer Protocol">HTTP</abbr> header, or the
<abbr title="Uniform Resource Identifier">URI</abbr> of the feed. (See
<a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>Relative Link Resolution</em></a> for more details.) By the time you see it,
<strong class="program">Universal Feed Parser</strong> has already resolved relative links in all
values where it makes sense to do so. <em>Clients should never need to manually
resolve relative links.</em></p>
</div>
</div>
<div class="section" id="entries-i-source-title">
<span id="reference-entry-source-title"></span><h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.title</span></tt><a class="headerlink" href="#entries-i-source-title" title="Permalink to this headline">¶</a></h2>
<p>The title of the source of this entry.</p>
<p>If this contains <abbr title="HyperText Markup Language">HTML</abbr> or
<abbr title="Extensible HyperText Markup Language">XHTML</abbr>, it is
<a class="reference internal" href="html-sanitization.html#advanced-sanitization"><em>sanitized</em></a> by default.</p>
<p>If this contains <abbr title="HyperText Markup Language">HTML</abbr> or
<abbr title="Extensible HyperText Markup Language">XHTML</abbr>, certain (X)HTML elements within this
value may contain relative <abbr title="Uniform Resource Identifier">URI</abbr>s. If so,
they are <a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>resolved according to a set of rules</em></a>.</p>
</div>
<div class="section" id="entries-i-source-title-detail">
<h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.title_detail</span></tt><a class="headerlink" href="#entries-i-source-title-detail" title="Permalink to this headline">¶</a></h2>
<p>A dictionary containing details about the title for the source of this entry.</p>
<div class="section" id="entries-i-source-title-detail-value">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.title_detail.value</span></tt><a class="headerlink" href="#entries-i-source-title-detail-value" title="Permalink to this headline">¶</a></h3>
<p>Same as <a class="reference internal" href="#reference-entry-source-title"><em>entries[i].source.title</em></a>.</p>
<p>If this contains <abbr title="HyperText Markup Language">HTML</abbr> or
<abbr title="Extensible HyperText Markup Language">XHTML</abbr>, it is
<a class="reference internal" href="html-sanitization.html#advanced-sanitization"><em>sanitized</em></a> by default.</p>
<p>If this contains <abbr title="HyperText Markup Language">HTML</abbr> or
<abbr title="Extensible HyperText Markup Language">XHTML</abbr>, certain (X)HTML elements within this
value may contain relative <abbr title="Uniform Resource Identifier">URI</abbr>s. If so,
they are <a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>resolved according to a set of rules</em></a>.</p>
</div>
<div class="section" id="entries-i-source-title-detail-type">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.title_detail.type</span></tt><a class="headerlink" href="#entries-i-source-title-detail-type" title="Permalink to this headline">¶</a></h3>
<p>The content type of the title of the source of this entry.</p>
<p>Most likely values for <tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.title_detail.type</span></tt>:</p>
<ul class="simple">
<li><em class="mimetype">text/plain</em></li>
<li><em class="mimetype">text/html</em></li>
<li><em class="mimetype">application/xhtml+xml</em></li>
</ul>
<p>For Atom feeds, the content type is taken from the type attribute, which
defaults to <em class="mimetype">text/plain</em> if not specified. For
<abbr title="Rich Site Summary">RSS</abbr> feeds, the content type is auto-determined by
inspecting the content, and defaults to <em class="mimetype">text/html</em>. Note that this
may cause silent data loss if the value contains plain text with angle
brackets. There is nothing I can do about this problem; it is a limitation of
<abbr title="Rich Site Summary">RSS</abbr>.</p>
<p>Future enhancement: some versions of <abbr title="Rich Site Summary">RSS</abbr> clearly
specify that certain values default to <em class="mimetype">text/plain</em>, and
<strong class="program">Universal Feed Parser</strong> should respect this, but it doesn’t yet.</p>
</div>
<div class="section" id="entries-i-source-title-detail-language">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.title_detail.language</span></tt><a class="headerlink" href="#entries-i-source-title-detail-language" title="Permalink to this headline">¶</a></h3>
<p>The language of the title of the source of this entry.</p>
<p><tt class="xref py py-attr docutils literal"><span class="pre">language</span></tt> is supposed to be a
language code, as specified by <a class="reference external" href="http://www.ietf.org/rfc/rfc3066.txt">RFC 3066</a>, but publishers have been known to
publish random values like “English” or “German”.
<strong class="program">Universal Feed Parser</strong> does not do any parsing or normalization of language codes.</p>
<p><tt class="xref py py-attr docutils literal"><span class="pre">language</span></tt> may come from the element’s
xml:lang attribute, or it may inherit from a parent element’s xml:lang, or the
Content-Language <abbr title="Hypertext Transfer Protocol">HTTP</abbr> header. If the
feed does not specify a language,
<tt class="xref py py-attr docutils literal"><span class="pre">language</span></tt> will be <tt class="docutils literal"><span class="pre">None</span></tt>, the
<strong class="program">Python</strong> null value.</p>
</div>
<div class="section" id="entries-i-source-title-detail-base">
<h3><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.title_detail.base</span></tt><a class="headerlink" href="#entries-i-source-title-detail-base" title="Permalink to this headline">¶</a></h3>
<p>The original base <abbr title="Uniform Resource Identifier">URI</abbr> for links within
the title of the source of this entry.</p>
<p><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.title_detail.base</span></tt> is only useful in rare
situations and can usually be ignored. It is the original base
<abbr title="Uniform Resource Identifier">URI</abbr> for this value, as specified by the element’s
xml:base attribute, or a parent element’s xml:base, or the appropriate
<abbr title="Hypertext Transfer Protocol">HTTP</abbr> header, or the
<abbr title="Uniform Resource Identifier">URI</abbr> of the feed. (See <a class="reference internal" href="resolving-relative-links.html#advanced-base"><em>Relative Link Resolution</em></a> for more
details.) By the time you see it, <strong class="program">Universal Feed Parser</strong> has already
resolved relative links in all values where it makes sense to do so. <em>Clients
should never need to manually resolve relative links.</em></p>
</div>
</div>
<div class="section" id="entries-i-source-updated">
<h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.updated</span></tt><a class="headerlink" href="#entries-i-source-updated" title="Permalink to this headline">¶</a></h2>
<p>The date the source of this entry was last updated, as a string in the same
format as it was published in the original feed.</p>
<p>This element is <a class="reference internal" href="date-parsing.html#advanced-date"><em>parsed as a date</em></a> and stored in
<a class="reference internal" href="#reference-entry-source-updated-parsed"><em>entries[i].source.updated_parsed</em></a>.</p>
</div>
<div class="section" id="entries-i-source-updated-parsed">
<span id="reference-entry-source-updated-parsed"></span><h2><tt class="xref py py-attr docutils literal"><span class="pre">entries[i].source.updated_parsed</span></tt><a class="headerlink" href="#entries-i-source-updated-parsed" title="Permalink to this headline">¶</a></h2>
<p>The date this entry was last updated, as a standard <strong class="program">Python</strong> 9-tuple.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#"><tt class="docutils literal"><span class="pre">entries[i].source</span></tt></a><ul>
<li><a class="reference internal" href="#entries-i-source-author"><tt class="docutils literal"><span class="pre">entries[i].source.author</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-author-detail"><tt class="docutils literal"><span class="pre">entries[i].source.author_detail</span></tt></a><ul>
<li><a class="reference internal" href="#entries-i-source-author-detail-name"><tt class="docutils literal"><span class="pre">entries[i].source.author_detail.name</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-author-detail-href"><tt class="docutils literal"><span class="pre">entries[i].source.author_detail.href</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-author-detail-email"><tt class="docutils literal"><span class="pre">entries[i].source.author_detail.email</span></tt></a></li>
</ul>
</li>
<li><a class="reference internal" href="#entries-i-source-contributors"><tt class="docutils literal"><span class="pre">entries[i].source.contributors</span></tt></a><ul>
<li><a class="reference internal" href="#entries-i-source-contributors-j-name"><tt class="docutils literal"><span class="pre">entries[i].source.contributors[j].name</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-contributors-j-href"><tt class="docutils literal"><span class="pre">entries[i].source.contributors[j].href</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-contributors-j-email"><tt class="docutils literal"><span class="pre">entries[i].source.contributors[j].email</span></tt></a></li>
</ul>
</li>
<li><a class="reference internal" href="#entries-i-source-icon"><tt class="docutils literal"><span class="pre">entries[i].source.icon</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-id"><tt class="docutils literal"><span class="pre">entries[i].source.id</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-link"><tt class="docutils literal"><span class="pre">entries[i].source.link</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-links"><tt class="docutils literal"><span class="pre">entries[i].source.links</span></tt></a><ul>
<li><a class="reference internal" href="#entries-i-source-links-j-rel"><tt class="docutils literal"><span class="pre">entries[i].source.links[j].rel</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-links-j-type"><tt class="docutils literal"><span class="pre">entries[i].source.links[j].type</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-links-j-href"><tt class="docutils literal"><span class="pre">entries[i].source.links[j].href</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-links-j-title"><tt class="docutils literal"><span class="pre">entries[i].source.links[j].title</span></tt></a></li>
</ul>
</li>
<li><a class="reference internal" href="#entries-i-source-logo"><tt class="docutils literal"><span class="pre">entries[i].source.logo</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-rights"><tt class="docutils literal"><span class="pre">entries[i].source.rights</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-rights-detail"><tt class="docutils literal"><span class="pre">entries[i].source.rights_detail</span></tt></a><ul>
<li><a class="reference internal" href="#entries-i-source-rights-detail-value"><tt class="docutils literal"><span class="pre">entries[i].source.rights_detail.value</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-rights-detail-type"><tt class="docutils literal"><span class="pre">entries[i].source.rights_detail.type</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-rights-detail-language"><tt class="docutils literal"><span class="pre">entries[i].source.rights_detail.language</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-rights-detail-base"><tt class="docutils literal"><span class="pre">entries[i].source.rights_detail.base</span></tt></a></li>
</ul>
</li>
<li><a class="reference internal" href="#entries-i-source-subtitle"><tt class="docutils literal"><span class="pre">entries[i].source.subtitle</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-subtitle-detail"><tt class="docutils literal"><span class="pre">entries[i].source.subtitle_detail</span></tt></a><ul>
<li><a class="reference internal" href="#entries-i-source-subtitle-detail-value"><tt class="docutils literal"><span class="pre">entries[i].source.subtitle_detail.value</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-subtitle-detail-type"><tt class="docutils literal"><span class="pre">entries[i].source.subtitle_detail.type</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-subtitle-detail-language"><tt class="docutils literal"><span class="pre">entries[i].source.subtitle_detail.language</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-subtitle-detail-base"><tt class="docutils literal"><span class="pre">entries[i].source.subtitle_detail.base</span></tt></a></li>
</ul>
</li>
<li><a class="reference internal" href="#entries-i-source-title"><tt class="docutils literal"><span class="pre">entries[i].source.title</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-title-detail"><tt class="docutils literal"><span class="pre">entries[i].source.title_detail</span></tt></a><ul>
<li><a class="reference internal" href="#entries-i-source-title-detail-value"><tt class="docutils literal"><span class="pre">entries[i].source.title_detail.value</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-title-detail-type"><tt class="docutils literal"><span class="pre">entries[i].source.title_detail.type</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-title-detail-language"><tt class="docutils literal"><span class="pre">entries[i].source.title_detail.language</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-title-detail-base"><tt class="docutils literal"><span class="pre">entries[i].source.title_detail.base</span></tt></a></li>
</ul>
</li>
<li><a class="reference internal" href="#entries-i-source-updated"><tt class="docutils literal"><span class="pre">entries[i].source.updated</span></tt></a></li>
<li><a class="reference internal" href="#entries-i-source-updated-parsed"><tt class="docutils literal"><span class="pre">entries[i].source.updated_parsed</span></tt></a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="reference-entry-publisher_detail.html"
title="previous chapter"><tt class="docutils literal docutils literal docutils literal"><span class="pre">entries[i].publisher_detail</span></tt></a></p>
<h4>Next topic</h4>
<p class="topless"><a href="reference-entry-summary.html"
title="next chapter"><tt class="docutils literal"><span class="pre">entries[i].summary</span></tt></a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/reference-entry-source.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="reference-entry-summary.html" title="entries[i].summary"
>next</a> |</li>
<li class="right" >
<a href="reference-entry-publisher_detail.html" title="entries[i].publisher_detail"
>previous</a> |</li>
<li><a href="index.html">feedparser 5.1.3 documentation</a> »</li>
<li><a href="reference.html" >Reference</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2004-2008 Mark Pilgrim, 2010-2012 Kurt McKee.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
</div>
</body>
</html>
