/usr/share/doc/python-rdflib-doc/html/_modules/rdflib/plugins/parsers/pyRdfa/transform/lite.html is in python-rdflib-doc 4.1.2-3.
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 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 | <!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>rdflib.plugins.parsers.pyRdfa.transform.lite — rdflib 4.1.2 documentation</title>
<meta name="viewport" content="width=device-width; initial-scale=1.0; maximum-scale=1.0; user-scalable=0;"/>
<link rel="stylesheet" href="../../../../../../_static/rtd.css" type="text/css" />
<link rel="stylesheet" href="../../../../../../_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../../../../../../',
VERSION: '4.1.2',
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>
<script type="text/javascript" src="../../../../../../../../../../../../_static/searchtools.js"></script>
<link rel="top" title="rdflib 4.1.2 documentation" href="../../../../../../index.html" />
<link rel="up" title="rdflib.plugins.parsers.pyRdfa.transform" href="../transform.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="../../../../../../py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li><a href="../../../../../../index.html">rdflib 4.1.2 documentation</a> »</li>
<li><a href="../../../../../index.html" >Module code</a> »</li>
<li><a href="../../pyRdfa.html" >rdflib.plugins.parsers.pyRdfa</a> »</li>
<li><a href="../transform.html" accesskey="U">rdflib.plugins.parsers.pyRdfa.transform</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<h1>Source code for rdflib.plugins.parsers.pyRdfa.transform.lite</h1><div class="highlight"><pre>
<span class="c"># -*- coding: utf-8 -*-</span>
<span class="sd">"""</span>
<span class="sd">@author: U{Ivan Herman<a href="http://www.w3.org/People/Ivan/">}</span>
<span class="sd">@license: This software is available for use under the</span>
<span class="sd">U{W3C® SOFTWARE NOTICE AND LICENSE<href="http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231">}</span>
<span class="sd">@contact: Ivan Herman, ivan@w3.org</span>
<span class="sd">@version: $Id: lite.py,v 1.11 2013-09-26 16:37:54 ivan Exp $</span>
<span class="sd">$Date: 2013-09-26 16:37:54 $</span>
<span class="sd">"""</span>
<span class="kn">from</span> <span class="nn">..host</span> <span class="kn">import</span> <span class="n">HostLanguage</span>
<span class="n">non_lite_attributes</span> <span class="o">=</span> <span class="p">[</span><span class="s">"about"</span><span class="p">,</span><span class="s">"inlist"</span><span class="p">,</span><span class="s">"datatype"</span><span class="p">,</span><span class="s">"rev"</span><span class="p">,</span><span class="s">"rel"</span><span class="p">,</span><span class="s">"content"</span><span class="p">]</span>
<span class="n">non_lite_attributes_html</span> <span class="o">=</span> <span class="p">[</span><span class="s">"about"</span><span class="p">,</span><span class="s">"inlist"</span><span class="p">,</span><span class="s">"datatype"</span><span class="p">,</span><span class="s">"rev"</span><span class="p">]</span>
<div class="viewcode-block" id="lite_prune"><a class="viewcode-back" href="../../../../../../apidocs/rdflib.plugins.parsers.pyRdfa.transform.html#rdflib.plugins.parsers.pyRdfa.transform.lite.lite_prune">[docs]</a><span class="k">def</span> <span class="nf">lite_prune</span><span class="p">(</span><span class="n">top</span><span class="p">,</span> <span class="n">options</span><span class="p">,</span> <span class="n">state</span><span class="p">)</span> <span class="p">:</span>
<span class="sd">"""</span>
<span class="sd"> This is a misnomer. The current version does not remove anything from the tree, just generates warnings as for the</span>
<span class="sd"> usage of non-lite attributes. A more aggressive version would mean to remove those attributes, but that would,</span>
<span class="sd"> in fact, define an RDFa Lite conformance level in the parser, which is against the WG decisions. So this should</span>
<span class="sd"> not be done; the corresponding commands are commented in the code below...</span>
<span class="sd"> </span>
<span class="sd"> @param top: a DOM node for the top level element</span>
<span class="sd"> @param options: invocation options</span>
<span class="sd"> @type options: L{Options<pyRdfa.options>}</span>
<span class="sd"> @param state: top level execution state</span>
<span class="sd"> @type state: L{State<pyRdfa.state>}</span>
<span class="sd"> """</span>
<span class="k">def</span> <span class="nf">generate_warning</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">attr</span><span class="p">)</span> <span class="p">:</span>
<span class="k">if</span> <span class="n">attr</span> <span class="o">==</span> <span class="s">"rel"</span> <span class="p">:</span>
<span class="n">msg</span> <span class="o">=</span> <span class="s">"Attribute @rel should not be used in RDFa Lite (consider using @property)"</span>
<span class="k">elif</span> <span class="n">attr</span> <span class="o">==</span> <span class="s">"about"</span> <span class="p">:</span>
<span class="n">msg</span> <span class="o">=</span> <span class="s">"Attribute @about should not be used in RDFa Lite (consider using a <link> element with @href or @resource)"</span>
<span class="k">else</span> <span class="p">:</span>
<span class="n">msg</span> <span class="o">=</span> <span class="s">"Attribute @</span><span class="si">%s</span><span class="s"> should not be used in RDFa Lite"</span> <span class="o">%</span> <span class="n">attr</span>
<span class="n">options</span><span class="o">.</span><span class="n">add_warning</span><span class="p">(</span><span class="n">msg</span><span class="p">,</span> <span class="n">node</span><span class="o">=</span><span class="n">node</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">remove_attrs</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> <span class="p">:</span>
<span class="kn">from</span> <span class="nn">..termorcurie</span> <span class="kn">import</span> <span class="n">termname</span>
<span class="c"># first the @content; this has a special treatment</span>
<span class="c"># there are some extras to check for HTML dialects</span>
<span class="k">if</span> <span class="n">options</span><span class="o">.</span><span class="n">host_language</span> <span class="ow">in</span> <span class="p">[</span> <span class="n">HostLanguage</span><span class="o">.</span><span class="n">html5</span><span class="p">,</span> <span class="n">HostLanguage</span><span class="o">.</span><span class="n">xhtml5</span><span class="p">,</span> <span class="n">HostLanguage</span><span class="o">.</span><span class="n">xhtml</span> <span class="p">]</span> <span class="p">:</span>
<span class="k">if</span> <span class="n">node</span><span class="o">.</span><span class="n">tagName</span> <span class="o">!=</span> <span class="s">"meta"</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">hasAttribute</span><span class="p">(</span><span class="s">"content"</span><span class="p">)</span> <span class="p">:</span>
<span class="n">generate_warning</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="s">"content"</span><span class="p">)</span>
<span class="c"># node.removeAttribute("content")</span>
<span class="k">if</span> <span class="n">node</span><span class="o">.</span><span class="n">tagName</span> <span class="o">!=</span> <span class="s">"link"</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">hasAttribute</span><span class="p">(</span><span class="s">"rel"</span><span class="p">)</span> <span class="p">:</span>
<span class="c"># Unfortunately, this has to be checked separately and run-time for <link> where @rel is allowed for non-RDFa purposes...</span>
<span class="c"># Additional complication: @rel is allowed in an <a> element, for example, if used as a pure term and not as a URI or CURIE</span>
<span class="k">if</span> <span class="n">node</span><span class="o">.</span><span class="n">tagName</span> <span class="o">==</span> <span class="s">"a"</span> <span class="p">:</span>
<span class="n">vals</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">getAttribute</span><span class="p">(</span><span class="s">"rel"</span><span class="p">)</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span><span class="o">.</span><span class="n">split</span><span class="p">()</span>
<span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">vals</span><span class="p">)</span> <span class="o">!=</span> <span class="mi">0</span> <span class="p">:</span>
<span class="n">final_vals</span> <span class="o">=</span> <span class="p">[</span> <span class="n">v</span> <span class="k">for</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">vals</span> <span class="k">if</span> <span class="ow">not</span> <span class="n">termname</span><span class="o">.</span><span class="n">match</span><span class="p">(</span><span class="n">v</span><span class="p">)</span> <span class="p">]</span>
<span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">final_vals</span><span class="p">)</span> <span class="o">!=</span> <span class="mi">0</span> <span class="p">:</span>
<span class="n">generate_warning</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="s">"rel"</span><span class="p">)</span>
<span class="k">else</span> <span class="p">:</span>
<span class="n">generate_warning</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="s">"rel"</span><span class="p">)</span>
<span class="k">for</span> <span class="n">attr</span> <span class="ow">in</span> <span class="n">non_lite_attributes_html</span> <span class="p">:</span>
<span class="k">if</span> <span class="n">node</span><span class="o">.</span><span class="n">hasAttribute</span><span class="p">(</span><span class="n">attr</span><span class="p">)</span> <span class="p">:</span>
<span class="n">generate_warning</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">attr</span><span class="p">)</span>
<span class="c"># node.removeAttribute(attr)</span>
<span class="k">else</span> <span class="p">:</span>
<span class="k">for</span> <span class="n">attr</span> <span class="ow">in</span> <span class="n">non_lite_attributes</span> <span class="p">:</span>
<span class="k">if</span> <span class="n">node</span><span class="o">.</span><span class="n">hasAttribute</span><span class="p">(</span><span class="n">attr</span><span class="p">)</span> <span class="p">:</span>
<span class="n">generate_warning</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">attr</span><span class="p">)</span>
<span class="c"># node.removeAttribute(attr)</span>
<span class="n">remove_attrs</span><span class="p">(</span><span class="n">top</span><span class="p">)</span>
<span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="n">top</span><span class="o">.</span><span class="n">childNodes</span> <span class="p">:</span>
<span class="k">if</span> <span class="n">n</span><span class="o">.</span><span class="n">nodeType</span> <span class="o">==</span> <span class="n">top</span><span class="o">.</span><span class="n">ELEMENT_NODE</span> <span class="p">:</span>
<span class="n">lite_prune</span><span class="p">(</span><span class="n">n</span><span class="p">,</span> <span class="n">options</span><span class="p">,</span> <span class="n">state</span><span class="p">)</span>
</div>
</pre></div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="../../../../../../index.html">
<img class="logo" src="../../../../../../_static/logo.svg" alt="Logo"/>
</a></p>
<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="../../../../../../py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li><a href="../../../../../../index.html">rdflib 4.1.2 documentation</a> »</li>
<li><a href="../../../../../index.html" >Module code</a> »</li>
<li><a href="../../pyRdfa.html" >rdflib.plugins.parsers.pyRdfa</a> »</li>
<li><a href="../transform.html" >rdflib.plugins.parsers.pyRdfa.transform</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2009 - 2013, RDFLib Team.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.2.
<br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
</div>
</body>
</html>
|