mirror of
https://git.yoctoproject.org/poky
synced 2026-06-15 17:50:07 +00:00
Frazer Clews
fa5524890e
amend the code to handle singleton comparisons properly so it only checks if they only refer to the same object or not, and not bother comparing the values. (Bitbake rev: b809a6812aa15a8a9af97bc382cc4b19571e6bfc) Signed-off-by: Frazer Clews <frazer.clews@codethink.co.uk> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
339 lines
13 KiB
Python
339 lines
13 KiB
Python
__all__ = [
|
|
'HTML5TreeBuilder',
|
|
]
|
|
|
|
import warnings
|
|
from bs4.builder import (
|
|
PERMISSIVE,
|
|
HTML,
|
|
HTML_5,
|
|
HTMLTreeBuilder,
|
|
)
|
|
from bs4.element import (
|
|
NamespacedAttribute,
|
|
whitespace_re,
|
|
)
|
|
import html5lib
|
|
try:
|
|
# html5lib >= 0.99999999/1.0b9
|
|
from html5lib.treebuilders import base as treebuildersbase
|
|
except ImportError:
|
|
# html5lib <= 0.9999999/1.0b8
|
|
from html5lib.treebuilders import _base as treebuildersbase
|
|
from html5lib.constants import namespaces
|
|
|
|
from bs4.element import (
|
|
Comment,
|
|
Doctype,
|
|
NavigableString,
|
|
Tag,
|
|
)
|
|
|
|
class HTML5TreeBuilder(HTMLTreeBuilder):
|
|
"""Use html5lib to build a tree."""
|
|
|
|
NAME = "html5lib"
|
|
|
|
features = [NAME, PERMISSIVE, HTML_5, HTML]
|
|
|
|
def prepare_markup(self, markup, user_specified_encoding,
|
|
document_declared_encoding=None, exclude_encodings=None):
|
|
# Store the user-specified encoding for use later on.
|
|
self.user_specified_encoding = user_specified_encoding
|
|
|
|
# document_declared_encoding and exclude_encodings aren't used
|
|
# ATM because the html5lib TreeBuilder doesn't use
|
|
# UnicodeDammit.
|
|
if exclude_encodings:
|
|
warnings.warn("You provided a value for exclude_encoding, but the html5lib tree builder doesn't support exclude_encoding.")
|
|
yield (markup, None, None, False)
|
|
|
|
# These methods are defined by Beautiful Soup.
|
|
def feed(self, markup):
|
|
if self.soup.parse_only is not None:
|
|
warnings.warn("You provided a value for parse_only, but the html5lib tree builder doesn't support parse_only. The entire document will be parsed.")
|
|
parser = html5lib.HTMLParser(tree=self.create_treebuilder)
|
|
doc = parser.parse(markup, encoding=self.user_specified_encoding)
|
|
|
|
# Set the character encoding detected by the tokenizer.
|
|
if isinstance(markup, str):
|
|
# We need to special-case this because html5lib sets
|
|
# charEncoding to UTF-8 if it gets Unicode input.
|
|
doc.original_encoding = None
|
|
else:
|
|
doc.original_encoding = parser.tokenizer.stream.charEncoding[0]
|
|
|
|
def create_treebuilder(self, namespaceHTMLElements):
|
|
self.underlying_builder = TreeBuilderForHtml5lib(
|
|
self.soup, namespaceHTMLElements)
|
|
return self.underlying_builder
|
|
|
|
def test_fragment_to_document(self, fragment):
|
|
"""See `TreeBuilder`."""
|
|
return '<html><head></head><body>%s</body></html>' % fragment
|
|
|
|
|
|
class TreeBuilderForHtml5lib(treebuildersbase.TreeBuilder):
|
|
|
|
def __init__(self, soup, namespaceHTMLElements):
|
|
self.soup = soup
|
|
super(TreeBuilderForHtml5lib, self).__init__(namespaceHTMLElements)
|
|
|
|
def documentClass(self):
|
|
self.soup.reset()
|
|
return Element(self.soup, self.soup, None)
|
|
|
|
def insertDoctype(self, token):
|
|
name = token["name"]
|
|
publicId = token["publicId"]
|
|
systemId = token["systemId"]
|
|
|
|
doctype = Doctype.for_name_and_ids(name, publicId, systemId)
|
|
self.soup.object_was_parsed(doctype)
|
|
|
|
def elementClass(self, name, namespace):
|
|
tag = self.soup.new_tag(name, namespace)
|
|
return Element(tag, self.soup, namespace)
|
|
|
|
def commentClass(self, data):
|
|
return TextNode(Comment(data), self.soup)
|
|
|
|
def fragmentClass(self):
|
|
self.soup = BeautifulSoup("")
|
|
self.soup.name = "[document_fragment]"
|
|
return Element(self.soup, self.soup, None)
|
|
|
|
def appendChild(self, node):
|
|
# XXX This code is not covered by the BS4 tests.
|
|
self.soup.append(node.element)
|
|
|
|
def getDocument(self):
|
|
return self.soup
|
|
|
|
def getFragment(self):
|
|
return treebuildersbase.TreeBuilder.getFragment(self).element
|
|
|
|
class AttrList(object):
|
|
def __init__(self, element):
|
|
self.element = element
|
|
self.attrs = dict(self.element.attrs)
|
|
def __iter__(self):
|
|
return list(self.attrs.items()).__iter__()
|
|
def __setitem__(self, name, value):
|
|
# If this attribute is a multi-valued attribute for this element,
|
|
# turn its value into a list.
|
|
list_attr = HTML5TreeBuilder.cdata_list_attributes
|
|
if (name in list_attr['*']
|
|
or (self.element.name in list_attr
|
|
and name in list_attr[self.element.name])):
|
|
# A node that is being cloned may have already undergone
|
|
# this procedure.
|
|
if not isinstance(value, list):
|
|
value = whitespace_re.split(value)
|
|
self.element[name] = value
|
|
def items(self):
|
|
return list(self.attrs.items())
|
|
def keys(self):
|
|
return list(self.attrs.keys())
|
|
def __len__(self):
|
|
return len(self.attrs)
|
|
def __getitem__(self, name):
|
|
return self.attrs[name]
|
|
def __contains__(self, name):
|
|
return name in list(self.attrs.keys())
|
|
|
|
|
|
class Element(treebuildersbase.Node):
|
|
def __init__(self, element, soup, namespace):
|
|
treebuildersbase.Node.__init__(self, element.name)
|
|
self.element = element
|
|
self.soup = soup
|
|
self.namespace = namespace
|
|
|
|
def appendChild(self, node):
|
|
string_child = child = None
|
|
if isinstance(node, str):
|
|
# Some other piece of code decided to pass in a string
|
|
# instead of creating a TextElement object to contain the
|
|
# string.
|
|
string_child = child = node
|
|
elif isinstance(node, Tag):
|
|
# Some other piece of code decided to pass in a Tag
|
|
# instead of creating an Element object to contain the
|
|
# Tag.
|
|
child = node
|
|
elif node.element.__class__ == NavigableString:
|
|
string_child = child = node.element
|
|
else:
|
|
child = node.element
|
|
|
|
if not isinstance(child, str) and child.parent is not None:
|
|
node.element.extract()
|
|
|
|
if (string_child and self.element.contents
|
|
and self.element.contents[-1].__class__ == NavigableString):
|
|
# We are appending a string onto another string.
|
|
# TODO This has O(n^2) performance, for input like
|
|
# "a</a>a</a>a</a>..."
|
|
old_element = self.element.contents[-1]
|
|
new_element = self.soup.new_string(old_element + string_child)
|
|
old_element.replace_with(new_element)
|
|
self.soup._most_recent_element = new_element
|
|
else:
|
|
if isinstance(node, str):
|
|
# Create a brand new NavigableString from this string.
|
|
child = self.soup.new_string(node)
|
|
|
|
# Tell Beautiful Soup to act as if it parsed this element
|
|
# immediately after the parent's last descendant. (Or
|
|
# immediately after the parent, if it has no children.)
|
|
if self.element.contents:
|
|
most_recent_element = self.element._last_descendant(False)
|
|
elif self.element.next_element is not None:
|
|
# Something from further ahead in the parse tree is
|
|
# being inserted into this earlier element. This is
|
|
# very annoying because it means an expensive search
|
|
# for the last element in the tree.
|
|
most_recent_element = self.soup._last_descendant()
|
|
else:
|
|
most_recent_element = self.element
|
|
|
|
self.soup.object_was_parsed(
|
|
child, parent=self.element,
|
|
most_recent_element=most_recent_element)
|
|
|
|
def getAttributes(self):
|
|
return AttrList(self.element)
|
|
|
|
def setAttributes(self, attributes):
|
|
|
|
if attributes is not None and len(attributes) > 0:
|
|
|
|
converted_attributes = []
|
|
for name, value in list(attributes.items()):
|
|
if isinstance(name, tuple):
|
|
new_name = NamespacedAttribute(*name)
|
|
del attributes[name]
|
|
attributes[new_name] = value
|
|
|
|
self.soup.builder._replace_cdata_list_attribute_values(
|
|
self.name, attributes)
|
|
for name, value in list(attributes.items()):
|
|
self.element[name] = value
|
|
|
|
# The attributes may contain variables that need substitution.
|
|
# Call set_up_substitutions manually.
|
|
#
|
|
# The Tag constructor called this method when the Tag was created,
|
|
# but we just set/changed the attributes, so call it again.
|
|
self.soup.builder.set_up_substitutions(self.element)
|
|
attributes = property(getAttributes, setAttributes)
|
|
|
|
def insertText(self, data, insertBefore=None):
|
|
if insertBefore:
|
|
text = TextNode(self.soup.new_string(data), self.soup)
|
|
self.insertBefore(data, insertBefore)
|
|
else:
|
|
self.appendChild(data)
|
|
|
|
def insertBefore(self, node, refNode):
|
|
index = self.element.index(refNode.element)
|
|
if (node.element.__class__ == NavigableString and self.element.contents
|
|
and self.element.contents[index-1].__class__ == NavigableString):
|
|
# (See comments in appendChild)
|
|
old_node = self.element.contents[index-1]
|
|
new_str = self.soup.new_string(old_node + node.element)
|
|
old_node.replace_with(new_str)
|
|
else:
|
|
self.element.insert(index, node.element)
|
|
node.parent = self
|
|
|
|
def removeChild(self, node):
|
|
node.element.extract()
|
|
|
|
def reparentChildren(self, new_parent):
|
|
"""Move all of this tag's children into another tag."""
|
|
# print "MOVE", self.element.contents
|
|
# print "FROM", self.element
|
|
# print "TO", new_parent.element
|
|
element = self.element
|
|
new_parent_element = new_parent.element
|
|
# Determine what this tag's next_element will be once all the children
|
|
# are removed.
|
|
final_next_element = element.next_sibling
|
|
|
|
new_parents_last_descendant = new_parent_element._last_descendant(False, False)
|
|
if len(new_parent_element.contents) > 0:
|
|
# The new parent already contains children. We will be
|
|
# appending this tag's children to the end.
|
|
new_parents_last_child = new_parent_element.contents[-1]
|
|
new_parents_last_descendant_next_element = new_parents_last_descendant.next_element
|
|
else:
|
|
# The new parent contains no children.
|
|
new_parents_last_child = None
|
|
new_parents_last_descendant_next_element = new_parent_element.next_element
|
|
|
|
to_append = element.contents
|
|
append_after = new_parent_element.contents
|
|
if len(to_append) > 0:
|
|
# Set the first child's previous_element and previous_sibling
|
|
# to elements within the new parent
|
|
first_child = to_append[0]
|
|
if new_parents_last_descendant:
|
|
first_child.previous_element = new_parents_last_descendant
|
|
else:
|
|
first_child.previous_element = new_parent_element
|
|
first_child.previous_sibling = new_parents_last_child
|
|
if new_parents_last_descendant:
|
|
new_parents_last_descendant.next_element = first_child
|
|
else:
|
|
new_parent_element.next_element = first_child
|
|
if new_parents_last_child:
|
|
new_parents_last_child.next_sibling = first_child
|
|
|
|
# Fix the last child's next_element and next_sibling
|
|
last_child = to_append[-1]
|
|
last_child.next_element = new_parents_last_descendant_next_element
|
|
if new_parents_last_descendant_next_element:
|
|
new_parents_last_descendant_next_element.previous_element = last_child
|
|
last_child.next_sibling = None
|
|
|
|
for child in to_append:
|
|
child.parent = new_parent_element
|
|
new_parent_element.contents.append(child)
|
|
|
|
# Now that this element has no children, change its .next_element.
|
|
element.contents = []
|
|
element.next_element = final_next_element
|
|
|
|
# print "DONE WITH MOVE"
|
|
# print "FROM", self.element
|
|
# print "TO", new_parent_element
|
|
|
|
def cloneNode(self):
|
|
tag = self.soup.new_tag(self.element.name, self.namespace)
|
|
node = Element(tag, self.soup, self.namespace)
|
|
for key,value in self.attributes:
|
|
node.attributes[key] = value
|
|
return node
|
|
|
|
def hasContent(self):
|
|
return self.element.contents
|
|
|
|
def getNameTuple(self):
|
|
if self.namespace is None:
|
|
return namespaces["html"], self.name
|
|
else:
|
|
return self.namespace, self.name
|
|
|
|
nameTuple = property(getNameTuple)
|
|
|
|
class TextNode(Element):
|
|
def __init__(self, element, soup):
|
|
treebuildersbase.Node.__init__(self, None)
|
|
self.element = element
|
|
self.soup = soup
|
|
|
|
def cloneNode(self):
|
|
raise NotImplementedError
|