| # -*- coding: utf-8 -*- |
| """Tests for Beautiful Soup's tree traversal methods. |
| |
| The tree traversal methods are the main advantage of using Beautiful |
| Soup over just using a parser. |
| |
| Different parsers will build different Beautiful Soup trees given the |
| same markup, but all Beautiful Soup trees can be traversed with the |
| methods tested here. |
| """ |
| |
| import copy |
| import pickle |
| import re |
| import warnings |
| from bs4 import BeautifulSoup |
| from bs4.builder import builder_registry |
| from bs4.element import ( |
| PY3K, |
| CData, |
| Comment, |
| Declaration, |
| Doctype, |
| NavigableString, |
| SoupStrainer, |
| Tag, |
| ) |
| from bs4.testing import SoupTest |
| |
| XML_BUILDER_PRESENT = (builder_registry.lookup("xml") is not None) |
| LXML_PRESENT = (builder_registry.lookup("lxml") is not None) |
| |
| class TreeTest(SoupTest): |
| |
| def assertSelects(self, tags, should_match): |
| """Make sure that the given tags have the correct text. |
| |
| This is used in tests that define a bunch of tags, each |
| containing a single string, and then select certain strings by |
| some mechanism. |
| """ |
| self.assertEqual([tag.string for tag in tags], should_match) |
| |
| def assertSelectsIDs(self, tags, should_match): |
| """Make sure that the given tags have the correct IDs. |
| |
| This is used in tests that define a bunch of tags, each |
| containing a single string, and then select certain strings by |
| some mechanism. |
| """ |
| self.assertEqual([tag['id'] for tag in tags], should_match) |
| |
| |
| class TestFind(TreeTest): |
| """Basic tests of the find() method. |
| |
| find() just calls find_all() with limit=1, so it's not tested all |
| that thouroughly here. |
| """ |
| |
| def test_find_tag(self): |
| soup = self.soup("<a>1</a><b>2</b><a>3</a><b>4</b>") |
| self.assertEqual(soup.find("b").string, "2") |
| |
| def test_unicode_text_find(self): |
| soup = self.soup('<h1>Räksmörgås</h1>') |
| self.assertEqual(soup.find(string='Räksmörgås'), 'Räksmörgås') |
| |
| def test_unicode_attribute_find(self): |
| soup = self.soup('<h1 id="Räksmörgås">here it is</h1>') |
| str(soup) |
| self.assertEqual("here it is", soup.find(id='Räksmörgås').text) |
| |
| |
| def test_find_everything(self): |
| """Test an optimization that finds all tags.""" |
| soup = self.soup("<a>foo</a><b>bar</b>") |
| self.assertEqual(2, len(soup.find_all())) |
| |
| def test_find_everything_with_name(self): |
| """Test an optimization that finds all tags with a given name.""" |
| soup = self.soup("<a>foo</a><b>bar</b><a>baz</a>") |
| self.assertEqual(2, len(soup.find_all('a'))) |
| |
| class TestFindAll(TreeTest): |
| """Basic tests of the find_all() method.""" |
| |
| def test_find_all_text_nodes(self): |
| """You can search the tree for text nodes.""" |
| soup = self.soup("<html>Foo<b>bar</b>\xbb</html>") |
| # Exact match. |
| self.assertEqual(soup.find_all(string="bar"), ["bar"]) |
| self.assertEqual(soup.find_all(text="bar"), ["bar"]) |
| # Match any of a number of strings. |
| self.assertEqual( |
| soup.find_all(text=["Foo", "bar"]), ["Foo", "bar"]) |
| # Match a regular expression. |
| self.assertEqual(soup.find_all(text=re.compile('.*')), |
| ["Foo", "bar", '\xbb']) |
| # Match anything. |
| self.assertEqual(soup.find_all(text=True), |
| ["Foo", "bar", '\xbb']) |
| |
| def test_find_all_limit(self): |
| """You can limit the number of items returned by find_all.""" |
| soup = self.soup("<a>1</a><a>2</a><a>3</a><a>4</a><a>5</a>") |
| self.assertSelects(soup.find_all('a', limit=3), ["1", "2", "3"]) |
| self.assertSelects(soup.find_all('a', limit=1), ["1"]) |
| self.assertSelects( |
| soup.find_all('a', limit=10), ["1", "2", "3", "4", "5"]) |
| |
| # A limit of 0 means no limit. |
| self.assertSelects( |
| soup.find_all('a', limit=0), ["1", "2", "3", "4", "5"]) |
| |
| def test_calling_a_tag_is_calling_findall(self): |
| soup = self.soup("<a>1</a><b>2<a id='foo'>3</a></b>") |
| self.assertSelects(soup('a', limit=1), ["1"]) |
| self.assertSelects(soup.b(id="foo"), ["3"]) |
| |
| def test_find_all_with_self_referential_data_structure_does_not_cause_infinite_recursion(self): |
| soup = self.soup("<a></a>") |
| # Create a self-referential list. |
| l = [] |
| l.append(l) |
| |
| # Without special code in _normalize_search_value, this would cause infinite |
| # recursion. |
| self.assertEqual([], soup.find_all(l)) |
| |
| def test_find_all_resultset(self): |
| """All find_all calls return a ResultSet""" |
| soup = self.soup("<a></a>") |
| result = soup.find_all("a") |
| self.assertTrue(hasattr(result, "source")) |
| |
| result = soup.find_all(True) |
| self.assertTrue(hasattr(result, "source")) |
| |
| result = soup.find_all(text="foo") |
| self.assertTrue(hasattr(result, "source")) |
| |
| |
| class TestFindAllBasicNamespaces(TreeTest): |
| |
| def test_find_by_namespaced_name(self): |
| soup = self.soup('<mathml:msqrt>4</mathml:msqrt><a svg:fill="red">') |
| self.assertEqual("4", soup.find("mathml:msqrt").string) |
| self.assertEqual("a", soup.find(attrs= { "svg:fill" : "red" }).name) |
| |
| |
| class TestFindAllByName(TreeTest): |
| """Test ways of finding tags by tag name.""" |
| |
| def setUp(self): |
| super(TreeTest, self).setUp() |
| self.tree = self.soup("""<a>First tag.</a> |
| <b>Second tag.</b> |
| <c>Third <a>Nested tag.</a> tag.</c>""") |
| |
| def test_find_all_by_tag_name(self): |
| # Find all the <a> tags. |
| self.assertSelects( |
| self.tree.find_all('a'), ['First tag.', 'Nested tag.']) |
| |
| def test_find_all_by_name_and_text(self): |
| self.assertSelects( |
| self.tree.find_all('a', text='First tag.'), ['First tag.']) |
| |
| self.assertSelects( |
| self.tree.find_all('a', text=True), ['First tag.', 'Nested tag.']) |
| |
| self.assertSelects( |
| self.tree.find_all('a', text=re.compile("tag")), |
| ['First tag.', 'Nested tag.']) |
| |
| |
| def test_find_all_on_non_root_element(self): |
| # You can call find_all on any node, not just the root. |
| self.assertSelects(self.tree.c.find_all('a'), ['Nested tag.']) |
| |
| def test_calling_element_invokes_find_all(self): |
| self.assertSelects(self.tree('a'), ['First tag.', 'Nested tag.']) |
| |
| def test_find_all_by_tag_strainer(self): |
| self.assertSelects( |
| self.tree.find_all(SoupStrainer('a')), |
| ['First tag.', 'Nested tag.']) |
| |
| def test_find_all_by_tag_names(self): |
| self.assertSelects( |
| self.tree.find_all(['a', 'b']), |
| ['First tag.', 'Second tag.', 'Nested tag.']) |
| |
| def test_find_all_by_tag_dict(self): |
| self.assertSelects( |
| self.tree.find_all({'a' : True, 'b' : True}), |
| ['First tag.', 'Second tag.', 'Nested tag.']) |
| |
| def test_find_all_by_tag_re(self): |
| self.assertSelects( |
| self.tree.find_all(re.compile('^[ab]$')), |
| ['First tag.', 'Second tag.', 'Nested tag.']) |
| |
| def test_find_all_with_tags_matching_method(self): |
| # You can define an oracle method that determines whether |
| # a tag matches the search. |
| def id_matches_name(tag): |
| return tag.name == tag.get('id') |
| |
| tree = self.soup("""<a id="a">Match 1.</a> |
| <a id="1">Does not match.</a> |
| <b id="b">Match 2.</a>""") |
| |
| self.assertSelects( |
| tree.find_all(id_matches_name), ["Match 1.", "Match 2."]) |
| |
| |
| class TestFindAllByAttribute(TreeTest): |
| |
| def test_find_all_by_attribute_name(self): |
| # You can pass in keyword arguments to find_all to search by |
| # attribute. |
| tree = self.soup(""" |
| <a id="first">Matching a.</a> |
| <a id="second"> |
| Non-matching <b id="first">Matching b.</b>a. |
| </a>""") |
| self.assertSelects(tree.find_all(id='first'), |
| ["Matching a.", "Matching b."]) |
| |
| def test_find_all_by_utf8_attribute_value(self): |
| peace = "םולש".encode("utf8") |
| data = '<a title="םולש"></a>'.encode("utf8") |
| soup = self.soup(data) |
| self.assertEqual([soup.a], soup.find_all(title=peace)) |
| self.assertEqual([soup.a], soup.find_all(title=peace.decode("utf8"))) |
| self.assertEqual([soup.a], soup.find_all(title=[peace, "something else"])) |
| |
| def test_find_all_by_attribute_dict(self): |
| # You can pass in a dictionary as the argument 'attrs'. This |
| # lets you search for attributes like 'name' (a fixed argument |
| # to find_all) and 'class' (a reserved word in Python.) |
| tree = self.soup(""" |
| <a name="name1" class="class1">Name match.</a> |
| <a name="name2" class="class2">Class match.</a> |
| <a name="name3" class="class3">Non-match.</a> |
| <name1>A tag called 'name1'.</name1> |
| """) |
| |
| # This doesn't do what you want. |
| self.assertSelects(tree.find_all(name='name1'), |
| ["A tag called 'name1'."]) |
| # This does what you want. |
| self.assertSelects(tree.find_all(attrs={'name' : 'name1'}), |
| ["Name match."]) |
| |
| self.assertSelects(tree.find_all(attrs={'class' : 'class2'}), |
| ["Class match."]) |
| |
| def test_find_all_by_class(self): |
| tree = self.soup(""" |
| <a class="1">Class 1.</a> |
| <a class="2">Class 2.</a> |
| <b class="1">Class 1.</b> |
| <c class="3 4">Class 3 and 4.</c> |
| """) |
| |
| # Passing in the class_ keyword argument will search against |
| # the 'class' attribute. |
| self.assertSelects(tree.find_all('a', class_='1'), ['Class 1.']) |
| self.assertSelects(tree.find_all('c', class_='3'), ['Class 3 and 4.']) |
| self.assertSelects(tree.find_all('c', class_='4'), ['Class 3 and 4.']) |
| |
| # Passing in a string to 'attrs' will also search the CSS class. |
| self.assertSelects(tree.find_all('a', '1'), ['Class 1.']) |
| self.assertSelects(tree.find_all(attrs='1'), ['Class 1.', 'Class 1.']) |
| self.assertSelects(tree.find_all('c', '3'), ['Class 3 and 4.']) |
| self.assertSelects(tree.find_all('c', '4'), ['Class 3 and 4.']) |
| |
| def test_find_by_class_when_multiple_classes_present(self): |
| tree = self.soup("<gar class='foo bar'>Found it</gar>") |
| |
| f = tree.find_all("gar", class_=re.compile("o")) |
| self.assertSelects(f, ["Found it"]) |
| |
| f = tree.find_all("gar", class_=re.compile("a")) |
| self.assertSelects(f, ["Found it"]) |
| |
| # Since the class is not the string "foo bar", but the two |
| # strings "foo" and "bar", this will not find anything. |
| f = tree.find_all("gar", class_=re.compile("o b")) |
| self.assertSelects(f, []) |
| |
| def test_find_all_with_non_dictionary_for_attrs_finds_by_class(self): |
| soup = self.soup("<a class='bar'>Found it</a>") |
| |
| self.assertSelects(soup.find_all("a", re.compile("ba")), ["Found it"]) |
| |
| def big_attribute_value(value): |
| return len(value) > 3 |
| |
| self.assertSelects(soup.find_all("a", big_attribute_value), []) |
| |
| def small_attribute_value(value): |
| return len(value) <= 3 |
| |
| self.assertSelects( |
| soup.find_all("a", small_attribute_value), ["Found it"]) |
| |
| def test_find_all_with_string_for_attrs_finds_multiple_classes(self): |
| soup = self.soup('<a class="foo bar"></a><a class="foo"></a>') |
| a, a2 = soup.find_all("a") |
| self.assertEqual([a, a2], soup.find_all("a", "foo")) |
| self.assertEqual([a], soup.find_all("a", "bar")) |
| |
| # If you specify the class as a string that contains a |
| # space, only that specific value will be found. |
| self.assertEqual([a], soup.find_all("a", class_="foo bar")) |
| self.assertEqual([a], soup.find_all("a", "foo bar")) |
| self.assertEqual([], soup.find_all("a", "bar foo")) |
| |
| def test_find_all_by_attribute_soupstrainer(self): |
| tree = self.soup(""" |
| <a id="first">Match.</a> |
| <a id="second">Non-match.</a>""") |
| |
| strainer = SoupStrainer(attrs={'id' : 'first'}) |
| self.assertSelects(tree.find_all(strainer), ['Match.']) |
| |
| def test_find_all_with_missing_atribute(self): |
| # You can pass in None as the value of an attribute to find_all. |
| # This will match tags that do not have that attribute set. |
| tree = self.soup("""<a id="1">ID present.</a> |
| <a>No ID present.</a> |
| <a id="">ID is empty.</a>""") |
| self.assertSelects(tree.find_all('a', id=None), ["No ID present."]) |
| |
| def test_find_all_with_defined_attribute(self): |
| # You can pass in None as the value of an attribute to find_all. |
| # This will match tags that have that attribute set to any value. |
| tree = self.soup("""<a id="1">ID present.</a> |
| <a>No ID present.</a> |
| <a id="">ID is empty.</a>""") |
| self.assertSelects( |
| tree.find_all(id=True), ["ID present.", "ID is empty."]) |
| |
| def test_find_all_with_numeric_attribute(self): |
| # If you search for a number, it's treated as a string. |
| tree = self.soup("""<a id=1>Unquoted attribute.</a> |
| <a id="1">Quoted attribute.</a>""") |
| |
| expected = ["Unquoted attribute.", "Quoted attribute."] |
| self.assertSelects(tree.find_all(id=1), expected) |
| self.assertSelects(tree.find_all(id="1"), expected) |
| |
| def test_find_all_with_list_attribute_values(self): |
| # You can pass a list of attribute values instead of just one, |
| # and you'll get tags that match any of the values. |
| tree = self.soup("""<a id="1">1</a> |
| <a id="2">2</a> |
| <a id="3">3</a> |
| <a>No ID.</a>""") |
| self.assertSelects(tree.find_all(id=["1", "3", "4"]), |
| ["1", "3"]) |
| |
| def test_find_all_with_regular_expression_attribute_value(self): |
| # You can pass a regular expression as an attribute value, and |
| # you'll get tags whose values for that attribute match the |
| # regular expression. |
| tree = self.soup("""<a id="a">One a.</a> |
| <a id="aa">Two as.</a> |
| <a id="ab">Mixed as and bs.</a> |
| <a id="b">One b.</a> |
| <a>No ID.</a>""") |
| |
| self.assertSelects(tree.find_all(id=re.compile("^a+$")), |
| ["One a.", "Two as."]) |
| |
| def test_find_by_name_and_containing_string(self): |
| soup = self.soup("<b>foo</b><b>bar</b><a>foo</a>") |
| a = soup.a |
| |
| self.assertEqual([a], soup.find_all("a", text="foo")) |
| self.assertEqual([], soup.find_all("a", text="bar")) |
| self.assertEqual([], soup.find_all("a", text="bar")) |
| |
| def test_find_by_name_and_containing_string_when_string_is_buried(self): |
| soup = self.soup("<a>foo</a><a><b><c>foo</c></b></a>") |
| self.assertEqual(soup.find_all("a"), soup.find_all("a", text="foo")) |
| |
| def test_find_by_attribute_and_containing_string(self): |
| soup = self.soup('<b id="1">foo</b><a id="2">foo</a>') |
| a = soup.a |
| |
| self.assertEqual([a], soup.find_all(id=2, text="foo")) |
| self.assertEqual([], soup.find_all(id=1, text="bar")) |
| |
| |
| |
| |
| class TestIndex(TreeTest): |
| """Test Tag.index""" |
| def test_index(self): |
| tree = self.soup("""<div> |
| <a>Identical</a> |
| <b>Not identical</b> |
| <a>Identical</a> |
| |
| <c><d>Identical with child</d></c> |
| <b>Also not identical</b> |
| <c><d>Identical with child</d></c> |
| </div>""") |
| div = tree.div |
| for i, element in enumerate(div.contents): |
| self.assertEqual(i, div.index(element)) |
| self.assertRaises(ValueError, tree.index, 1) |
| |
| |
| class TestParentOperations(TreeTest): |
| """Test navigation and searching through an element's parents.""" |
| |
| def setUp(self): |
| super(TestParentOperations, self).setUp() |
| self.tree = self.soup('''<ul id="empty"></ul> |
| <ul id="top"> |
| <ul id="middle"> |
| <ul id="bottom"> |
| <b>Start here</b> |
| </ul> |
| </ul>''') |
| self.start = self.tree.b |
| |
| |
| def test_parent(self): |
| self.assertEqual(self.start.parent['id'], 'bottom') |
| self.assertEqual(self.start.parent.parent['id'], 'middle') |
| self.assertEqual(self.start.parent.parent.parent['id'], 'top') |
| |
| def test_parent_of_top_tag_is_soup_object(self): |
| top_tag = self.tree.contents[0] |
| self.assertEqual(top_tag.parent, self.tree) |
| |
| def test_soup_object_has_no_parent(self): |
| self.assertEqual(None, self.tree.parent) |
| |
| def test_find_parents(self): |
| self.assertSelectsIDs( |
| self.start.find_parents('ul'), ['bottom', 'middle', 'top']) |
| self.assertSelectsIDs( |
| self.start.find_parents('ul', id="middle"), ['middle']) |
| |
| def test_find_parent(self): |
| self.assertEqual(self.start.find_parent('ul')['id'], 'bottom') |
| self.assertEqual(self.start.find_parent('ul', id='top')['id'], 'top') |
| |
| def test_parent_of_text_element(self): |
| text = self.tree.find(text="Start here") |
| self.assertEqual(text.parent.name, 'b') |
| |
| def test_text_element_find_parent(self): |
| text = self.tree.find(text="Start here") |
| self.assertEqual(text.find_parent('ul')['id'], 'bottom') |
| |
| def test_parent_generator(self): |
| parents = [parent['id'] for parent in self.start.parents |
| if parent is not None and 'id' in parent.attrs] |
| self.assertEqual(parents, ['bottom', 'middle', 'top']) |
| |
| |
| class ProximityTest(TreeTest): |
| |
| def setUp(self): |
| super(TreeTest, self).setUp() |
| self.tree = self.soup( |
| '<html id="start"><head></head><body><b id="1">One</b><b id="2">Two</b><b id="3">Three</b></body></html>') |
| |
| |
| class TestNextOperations(ProximityTest): |
| |
| def setUp(self): |
| super(TestNextOperations, self).setUp() |
| self.start = self.tree.b |
| |
| def test_next(self): |
| self.assertEqual(self.start.next_element, "One") |
| self.assertEqual(self.start.next_element.next_element['id'], "2") |
| |
| def test_next_of_last_item_is_none(self): |
| last = self.tree.find(text="Three") |
| self.assertEqual(last.next_element, None) |
| |
| def test_next_of_root_is_none(self): |
| # The document root is outside the next/previous chain. |
| self.assertEqual(self.tree.next_element, None) |
| |
| def test_find_all_next(self): |
| self.assertSelects(self.start.find_all_next('b'), ["Two", "Three"]) |
| self.start.find_all_next(id=3) |
| self.assertSelects(self.start.find_all_next(id=3), ["Three"]) |
| |
| def test_find_next(self): |
| self.assertEqual(self.start.find_next('b')['id'], '2') |
| self.assertEqual(self.start.find_next(text="Three"), "Three") |
| |
| def test_find_next_for_text_element(self): |
| text = self.tree.find(text="One") |
| self.assertEqual(text.find_next("b").string, "Two") |
| self.assertSelects(text.find_all_next("b"), ["Two", "Three"]) |
| |
| def test_next_generator(self): |
| start = self.tree.find(text="Two") |
| successors = [node for node in start.next_elements] |
| # There are two successors: the final <b> tag and its text contents. |
| tag, contents = successors |
| self.assertEqual(tag['id'], '3') |
| self.assertEqual(contents, "Three") |
| |
| class TestPreviousOperations(ProximityTest): |
| |
| def setUp(self): |
| super(TestPreviousOperations, self).setUp() |
| self.end = self.tree.find(text="Three") |
| |
| def test_previous(self): |
| self.assertEqual(self.end.previous_element['id'], "3") |
| self.assertEqual(self.end.previous_element.previous_element, "Two") |
| |
| def test_previous_of_first_item_is_none(self): |
| first = self.tree.find('html') |
| self.assertEqual(first.previous_element, None) |
| |
| def test_previous_of_root_is_none(self): |
| # The document root is outside the next/previous chain. |
| # XXX This is broken! |
| #self.assertEqual(self.tree.previous_element, None) |
| pass |
| |
| def test_find_all_previous(self): |
| # The <b> tag containing the "Three" node is the predecessor |
| # of the "Three" node itself, which is why "Three" shows up |
| # here. |
| self.assertSelects( |
| self.end.find_all_previous('b'), ["Three", "Two", "One"]) |
| self.assertSelects(self.end.find_all_previous(id=1), ["One"]) |
| |
| def test_find_previous(self): |
| self.assertEqual(self.end.find_previous('b')['id'], '3') |
| self.assertEqual(self.end.find_previous(text="One"), "One") |
| |
| def test_find_previous_for_text_element(self): |
| text = self.tree.find(text="Three") |
| self.assertEqual(text.find_previous("b").string, "Three") |
| self.assertSelects( |
| text.find_all_previous("b"), ["Three", "Two", "One"]) |
| |
| def test_previous_generator(self): |
| start = self.tree.find(text="One") |
| predecessors = [node for node in start.previous_elements] |
| |
| # There are four predecessors: the <b> tag containing "One" |
| # the <body> tag, the <head> tag, and the <html> tag. |
| b, body, head, html = predecessors |
| self.assertEqual(b['id'], '1') |
| self.assertEqual(body.name, "body") |
| self.assertEqual(head.name, "head") |
| self.assertEqual(html.name, "html") |
| |
| |
| class SiblingTest(TreeTest): |
| |
| def setUp(self): |
| super(SiblingTest, self).setUp() |
| markup = '''<html> |
| <span id="1"> |
| <span id="1.1"></span> |
| </span> |
| <span id="2"> |
| <span id="2.1"></span> |
| </span> |
| <span id="3"> |
| <span id="3.1"></span> |
| </span> |
| <span id="4"></span> |
| </html>''' |
| # All that whitespace looks good but makes the tests more |
| # difficult. Get rid of it. |
| markup = re.compile("\n\s*").sub("", markup) |
| self.tree = self.soup(markup) |
| |
| |
| class TestNextSibling(SiblingTest): |
| |
| def setUp(self): |
| super(TestNextSibling, self).setUp() |
| self.start = self.tree.find(id="1") |
| |
| def test_next_sibling_of_root_is_none(self): |
| self.assertEqual(self.tree.next_sibling, None) |
| |
| def test_next_sibling(self): |
| self.assertEqual(self.start.next_sibling['id'], '2') |
| self.assertEqual(self.start.next_sibling.next_sibling['id'], '3') |
| |
| # Note the difference between next_sibling and next_element. |
| self.assertEqual(self.start.next_element['id'], '1.1') |
| |
| def test_next_sibling_may_not_exist(self): |
| self.assertEqual(self.tree.html.next_sibling, None) |
| |
| nested_span = self.tree.find(id="1.1") |
| self.assertEqual(nested_span.next_sibling, None) |
| |
| last_span = self.tree.find(id="4") |
| self.assertEqual(last_span.next_sibling, None) |
| |
| def test_find_next_sibling(self): |
| self.assertEqual(self.start.find_next_sibling('span')['id'], '2') |
| |
| def test_next_siblings(self): |
| self.assertSelectsIDs(self.start.find_next_siblings("span"), |
| ['2', '3', '4']) |
| |
| self.assertSelectsIDs(self.start.find_next_siblings(id='3'), ['3']) |
| |
| def test_next_sibling_for_text_element(self): |
| soup = self.soup("Foo<b>bar</b>baz") |
| start = soup.find(text="Foo") |
| self.assertEqual(start.next_sibling.name, 'b') |
| self.assertEqual(start.next_sibling.next_sibling, 'baz') |
| |
| self.assertSelects(start.find_next_siblings('b'), ['bar']) |
| self.assertEqual(start.find_next_sibling(text="baz"), "baz") |
| self.assertEqual(start.find_next_sibling(text="nonesuch"), None) |
| |
| |
| class TestPreviousSibling(SiblingTest): |
| |
| def setUp(self): |
| super(TestPreviousSibling, self).setUp() |
| self.end = self.tree.find(id="4") |
| |
| def test_previous_sibling_of_root_is_none(self): |
| self.assertEqual(self.tree.previous_sibling, None) |
| |
| def test_previous_sibling(self): |
| self.assertEqual(self.end.previous_sibling['id'], '3') |
| self.assertEqual(self.end.previous_sibling.previous_sibling['id'], '2') |
| |
| # Note the difference between previous_sibling and previous_element. |
| self.assertEqual(self.end.previous_element['id'], '3.1') |
| |
| def test_previous_sibling_may_not_exist(self): |
| self.assertEqual(self.tree.html.previous_sibling, None) |
| |
| nested_span = self.tree.find(id="1.1") |
| self.assertEqual(nested_span.previous_sibling, None) |
| |
| first_span = self.tree.find(id="1") |
| self.assertEqual(first_span.previous_sibling, None) |
| |
| def test_find_previous_sibling(self): |
| self.assertEqual(self.end.find_previous_sibling('span')['id'], '3') |
| |
| def test_previous_siblings(self): |
| self.assertSelectsIDs(self.end.find_previous_siblings("span"), |
| ['3', '2', '1']) |
| |
| self.assertSelectsIDs(self.end.find_previous_siblings(id='1'), ['1']) |
| |
| def test_previous_sibling_for_text_element(self): |
| soup = self.soup("Foo<b>bar</b>baz") |
| start = soup.find(text="baz") |
| self.assertEqual(start.previous_sibling.name, 'b') |
| self.assertEqual(start.previous_sibling.previous_sibling, 'Foo') |
| |
| self.assertSelects(start.find_previous_siblings('b'), ['bar']) |
| self.assertEqual(start.find_previous_sibling(text="Foo"), "Foo") |
| self.assertEqual(start.find_previous_sibling(text="nonesuch"), None) |
| |
| |
| class TestTagCreation(SoupTest): |
| """Test the ability to create new tags.""" |
| def test_new_tag(self): |
| soup = self.soup("") |
| new_tag = soup.new_tag("foo", bar="baz") |
| self.assertTrue(isinstance(new_tag, Tag)) |
| self.assertEqual("foo", new_tag.name) |
| self.assertEqual(dict(bar="baz"), new_tag.attrs) |
| self.assertEqual(None, new_tag.parent) |
| |
| def test_tag_inherits_self_closing_rules_from_builder(self): |
| if XML_BUILDER_PRESENT: |
| xml_soup = BeautifulSoup("", "lxml-xml") |
| xml_br = xml_soup.new_tag("br") |
| xml_p = xml_soup.new_tag("p") |
| |
| # Both the <br> and <p> tag are empty-element, just because |
| # they have no contents. |
| self.assertEqual(b"<br/>", xml_br.encode()) |
| self.assertEqual(b"<p/>", xml_p.encode()) |
| |
| html_soup = BeautifulSoup("", "html.parser") |
| html_br = html_soup.new_tag("br") |
| html_p = html_soup.new_tag("p") |
| |
| # The HTML builder users HTML's rules about which tags are |
| # empty-element tags, and the new tags reflect these rules. |
| self.assertEqual(b"<br/>", html_br.encode()) |
| self.assertEqual(b"<p></p>", html_p.encode()) |
| |
| def test_new_string_creates_navigablestring(self): |
| soup = self.soup("") |
| s = soup.new_string("foo") |
| self.assertEqual("foo", s) |
| self.assertTrue(isinstance(s, NavigableString)) |
| |
| def test_new_string_can_create_navigablestring_subclass(self): |
| soup = self.soup("") |
| s = soup.new_string("foo", Comment) |
| self.assertEqual("foo", s) |
| self.assertTrue(isinstance(s, Comment)) |
| |
| class TestTreeModification(SoupTest): |
| |
| def test_attribute_modification(self): |
| soup = self.soup('<a id="1"></a>') |
| soup.a['id'] = 2 |
| self.assertEqual(soup.decode(), self.document_for('<a id="2"></a>')) |
| del(soup.a['id']) |
| self.assertEqual(soup.decode(), self.document_for('<a></a>')) |
| soup.a['id2'] = 'foo' |
| self.assertEqual(soup.decode(), self.document_for('<a id2="foo"></a>')) |
| |
| def test_new_tag_creation(self): |
| builder = builder_registry.lookup('html')() |
| soup = self.soup("<body></body>", builder=builder) |
| a = Tag(soup, builder, 'a') |
| ol = Tag(soup, builder, 'ol') |
| a['href'] = 'http://foo.com/' |
| soup.body.insert(0, a) |
| soup.body.insert(1, ol) |
| self.assertEqual( |
| soup.body.encode(), |
| b'<body><a href="http://foo.com/"></a><ol></ol></body>') |
| |
| def test_append_to_contents_moves_tag(self): |
| doc = """<p id="1">Don't leave me <b>here</b>.</p> |
| <p id="2">Don\'t leave!</p>""" |
| soup = self.soup(doc) |
| second_para = soup.find(id='2') |
| bold = soup.b |
| |
| # Move the <b> tag to the end of the second paragraph. |
| soup.find(id='2').append(soup.b) |
| |
| # The <b> tag is now a child of the second paragraph. |
| self.assertEqual(bold.parent, second_para) |
| |
| self.assertEqual( |
| soup.decode(), self.document_for( |
| '<p id="1">Don\'t leave me .</p>\n' |
| '<p id="2">Don\'t leave!<b>here</b></p>')) |
| |
| def test_replace_with_returns_thing_that_was_replaced(self): |
| text = "<a></a><b><c></c></b>" |
| soup = self.soup(text) |
| a = soup.a |
| new_a = a.replace_with(soup.c) |
| self.assertEqual(a, new_a) |
| |
| def test_unwrap_returns_thing_that_was_replaced(self): |
| text = "<a><b></b><c></c></a>" |
| soup = self.soup(text) |
| a = soup.a |
| new_a = a.unwrap() |
| self.assertEqual(a, new_a) |
| |
| def test_replace_with_and_unwrap_give_useful_exception_when_tag_has_no_parent(self): |
| soup = self.soup("<a><b>Foo</b></a><c>Bar</c>") |
| a = soup.a |
| a.extract() |
| self.assertEqual(None, a.parent) |
| self.assertRaises(ValueError, a.unwrap) |
| self.assertRaises(ValueError, a.replace_with, soup.c) |
| |
| def test_replace_tag_with_itself(self): |
| text = "<a><b></b><c>Foo<d></d></c></a><a><e></e></a>" |
| soup = self.soup(text) |
| c = soup.c |
| soup.c.replace_with(c) |
| self.assertEqual(soup.decode(), self.document_for(text)) |
| |
| def test_replace_tag_with_its_parent_raises_exception(self): |
| text = "<a><b></b></a>" |
| soup = self.soup(text) |
| self.assertRaises(ValueError, soup.b.replace_with, soup.a) |
| |
| def test_insert_tag_into_itself_raises_exception(self): |
| text = "<a><b></b></a>" |
| soup = self.soup(text) |
| self.assertRaises(ValueError, soup.a.insert, 0, soup.a) |
| |
| def test_replace_with_maintains_next_element_throughout(self): |
| soup = self.soup('<p><a>one</a><b>three</b></p>') |
| a = soup.a |
| b = a.contents[0] |
| # Make it so the <a> tag has two text children. |
| a.insert(1, "two") |
| |
| # Now replace each one with the empty string. |
| left, right = a.contents |
| left.replaceWith('') |
| right.replaceWith('') |
| |
| # The <b> tag is still connected to the tree. |
| self.assertEqual("three", soup.b.string) |
| |
| def test_replace_final_node(self): |
| soup = self.soup("<b>Argh!</b>") |
| soup.find(text="Argh!").replace_with("Hooray!") |
| new_text = soup.find(text="Hooray!") |
| b = soup.b |
| self.assertEqual(new_text.previous_element, b) |
| self.assertEqual(new_text.parent, b) |
| self.assertEqual(new_text.previous_element.next_element, new_text) |
| self.assertEqual(new_text.next_element, None) |
| |
| def test_consecutive_text_nodes(self): |
| # A builder should never create two consecutive text nodes, |
| # but if you insert one next to another, Beautiful Soup will |
| # handle it correctly. |
| soup = self.soup("<a><b>Argh!</b><c></c></a>") |
| soup.b.insert(1, "Hooray!") |
| |
| self.assertEqual( |
| soup.decode(), self.document_for( |
| "<a><b>Argh!Hooray!</b><c></c></a>")) |
| |
| new_text = soup.find(text="Hooray!") |
| self.assertEqual(new_text.previous_element, "Argh!") |
| self.assertEqual(new_text.previous_element.next_element, new_text) |
| |
| self.assertEqual(new_text.previous_sibling, "Argh!") |
| self.assertEqual(new_text.previous_sibling.next_sibling, new_text) |
| |
| self.assertEqual(new_text.next_sibling, None) |
| self.assertEqual(new_text.next_element, soup.c) |
| |
| def test_insert_string(self): |
| soup = self.soup("<a></a>") |
| soup.a.insert(0, "bar") |
| soup.a.insert(0, "foo") |
| # The string were added to the tag. |
| self.assertEqual(["foo", "bar"], soup.a.contents) |
| # And they were converted to NavigableStrings. |
| self.assertEqual(soup.a.contents[0].next_element, "bar") |
| |
| def test_insert_tag(self): |
| builder = self.default_builder |
| soup = self.soup( |
| "<a><b>Find</b><c>lady!</c><d></d></a>", builder=builder) |
| magic_tag = Tag(soup, builder, 'magictag') |
| magic_tag.insert(0, "the") |
| soup.a.insert(1, magic_tag) |
| |
| self.assertEqual( |
| soup.decode(), self.document_for( |
| "<a><b>Find</b><magictag>the</magictag><c>lady!</c><d></d></a>")) |
| |
| # Make sure all the relationships are hooked up correctly. |
| b_tag = soup.b |
| self.assertEqual(b_tag.next_sibling, magic_tag) |
| self.assertEqual(magic_tag.previous_sibling, b_tag) |
| |
| find = b_tag.find(text="Find") |
| self.assertEqual(find.next_element, magic_tag) |
| self.assertEqual(magic_tag.previous_element, find) |
| |
| c_tag = soup.c |
| self.assertEqual(magic_tag.next_sibling, c_tag) |
| self.assertEqual(c_tag.previous_sibling, magic_tag) |
| |
| the = magic_tag.find(text="the") |
| self.assertEqual(the.parent, magic_tag) |
| self.assertEqual(the.next_element, c_tag) |
| self.assertEqual(c_tag.previous_element, the) |
| |
| def test_append_child_thats_already_at_the_end(self): |
| data = "<a><b></b></a>" |
| soup = self.soup(data) |
| soup.a.append(soup.b) |
| self.assertEqual(data, soup.decode()) |
| |
| def test_move_tag_to_beginning_of_parent(self): |
| data = "<a><b></b><c></c><d></d></a>" |
| soup = self.soup(data) |
| soup.a.insert(0, soup.d) |
| self.assertEqual("<a><d></d><b></b><c></c></a>", soup.decode()) |
| |
| def test_insert_works_on_empty_element_tag(self): |
| # This is a little strange, since most HTML parsers don't allow |
| # markup like this to come through. But in general, we don't |
| # know what the parser would or wouldn't have allowed, so |
| # I'm letting this succeed for now. |
| soup = self.soup("<br/>") |
| soup.br.insert(1, "Contents") |
| self.assertEqual(str(soup.br), "<br>Contents</br>") |
| |
| def test_insert_before(self): |
| soup = self.soup("<a>foo</a><b>bar</b>") |
| soup.b.insert_before("BAZ") |
| soup.a.insert_before("QUUX") |
| self.assertEqual( |
| soup.decode(), self.document_for("QUUX<a>foo</a>BAZ<b>bar</b>")) |
| |
| soup.a.insert_before(soup.b) |
| self.assertEqual( |
| soup.decode(), self.document_for("QUUX<b>bar</b><a>foo</a>BAZ")) |
| |
| def test_insert_after(self): |
| soup = self.soup("<a>foo</a><b>bar</b>") |
| soup.b.insert_after("BAZ") |
| soup.a.insert_after("QUUX") |
| self.assertEqual( |
| soup.decode(), self.document_for("<a>foo</a>QUUX<b>bar</b>BAZ")) |
| soup.b.insert_after(soup.a) |
| self.assertEqual( |
| soup.decode(), self.document_for("QUUX<b>bar</b><a>foo</a>BAZ")) |
| |
| def test_insert_after_raises_exception_if_after_has_no_meaning(self): |
| soup = self.soup("") |
| tag = soup.new_tag("a") |
| string = soup.new_string("") |
| self.assertRaises(ValueError, string.insert_after, tag) |
| self.assertRaises(NotImplementedError, soup.insert_after, tag) |
| self.assertRaises(ValueError, tag.insert_after, tag) |
| |
| def test_insert_before_raises_notimplementederror_if_before_has_no_meaning(self): |
| soup = self.soup("") |
| tag = soup.new_tag("a") |
| string = soup.new_string("") |
| self.assertRaises(ValueError, string.insert_before, tag) |
| self.assertRaises(NotImplementedError, soup.insert_before, tag) |
| self.assertRaises(ValueError, tag.insert_before, tag) |
| |
| def test_replace_with(self): |
| soup = self.soup( |
| "<p>There's <b>no</b> business like <b>show</b> business</p>") |
| no, show = soup.find_all('b') |
| show.replace_with(no) |
| self.assertEqual( |
| soup.decode(), |
| self.document_for( |
| "<p>There's business like <b>no</b> business</p>")) |
| |
| self.assertEqual(show.parent, None) |
| self.assertEqual(no.parent, soup.p) |
| self.assertEqual(no.next_element, "no") |
| self.assertEqual(no.next_sibling, " business") |
| |
| def test_replace_first_child(self): |
| data = "<a><b></b><c></c></a>" |
| soup = self.soup(data) |
| soup.b.replace_with(soup.c) |
| self.assertEqual("<a><c></c></a>", soup.decode()) |
| |
| def test_replace_last_child(self): |
| data = "<a><b></b><c></c></a>" |
| soup = self.soup(data) |
| soup.c.replace_with(soup.b) |
| self.assertEqual("<a><b></b></a>", soup.decode()) |
| |
| def test_nested_tag_replace_with(self): |
| soup = self.soup( |
| """<a>We<b>reserve<c>the</c><d>right</d></b></a><e>to<f>refuse</f><g>service</g></e>""") |
| |
| # Replace the entire <b> tag and its contents ("reserve the |
| # right") with the <f> tag ("refuse"). |
| remove_tag = soup.b |
| move_tag = soup.f |
| remove_tag.replace_with(move_tag) |
| |
| self.assertEqual( |
| soup.decode(), self.document_for( |
| "<a>We<f>refuse</f></a><e>to<g>service</g></e>")) |
| |
| # The <b> tag is now an orphan. |
| self.assertEqual(remove_tag.parent, None) |
| self.assertEqual(remove_tag.find(text="right").next_element, None) |
| self.assertEqual(remove_tag.previous_element, None) |
| self.assertEqual(remove_tag.next_sibling, None) |
| self.assertEqual(remove_tag.previous_sibling, None) |
| |
| # The <f> tag is now connected to the <a> tag. |
| self.assertEqual(move_tag.parent, soup.a) |
| self.assertEqual(move_tag.previous_element, "We") |
| self.assertEqual(move_tag.next_element.next_element, soup.e) |
| self.assertEqual(move_tag.next_sibling, None) |
| |
| # The gap where the <f> tag used to be has been mended, and |
| # the word "to" is now connected to the <g> tag. |
| to_text = soup.find(text="to") |
| g_tag = soup.g |
| self.assertEqual(to_text.next_element, g_tag) |
| self.assertEqual(to_text.next_sibling, g_tag) |
| self.assertEqual(g_tag.previous_element, to_text) |
| self.assertEqual(g_tag.previous_sibling, to_text) |
| |
| def test_unwrap(self): |
| tree = self.soup(""" |
| <p>Unneeded <em>formatting</em> is unneeded</p> |
| """) |
| tree.em.unwrap() |
| self.assertEqual(tree.em, None) |
| self.assertEqual(tree.p.text, "Unneeded formatting is unneeded") |
| |
| def test_wrap(self): |
| soup = self.soup("I wish I was bold.") |
| value = soup.string.wrap(soup.new_tag("b")) |
| self.assertEqual(value.decode(), "<b>I wish I was bold.</b>") |
| self.assertEqual( |
| soup.decode(), self.document_for("<b>I wish I was bold.</b>")) |
| |
| def test_wrap_extracts_tag_from_elsewhere(self): |
| soup = self.soup("<b></b>I wish I was bold.") |
| soup.b.next_sibling.wrap(soup.b) |
| self.assertEqual( |
| soup.decode(), self.document_for("<b>I wish I was bold.</b>")) |
| |
| def test_wrap_puts_new_contents_at_the_end(self): |
| soup = self.soup("<b>I like being bold.</b>I wish I was bold.") |
| soup.b.next_sibling.wrap(soup.b) |
| self.assertEqual(2, len(soup.b.contents)) |
| self.assertEqual( |
| soup.decode(), self.document_for( |
| "<b>I like being bold.I wish I was bold.</b>")) |
| |
| def test_extract(self): |
| soup = self.soup( |
| '<html><body>Some content. <div id="nav">Nav crap</div> More content.</body></html>') |
| |
| self.assertEqual(len(soup.body.contents), 3) |
| extracted = soup.find(id="nav").extract() |
| |
| self.assertEqual( |
| soup.decode(), "<html><body>Some content. More content.</body></html>") |
| self.assertEqual(extracted.decode(), '<div id="nav">Nav crap</div>') |
| |
| # The extracted tag is now an orphan. |
| self.assertEqual(len(soup.body.contents), 2) |
| self.assertEqual(extracted.parent, None) |
| self.assertEqual(extracted.previous_element, None) |
| self.assertEqual(extracted.next_element.next_element, None) |
| |
| # The gap where the extracted tag used to be has been mended. |
| content_1 = soup.find(text="Some content. ") |
| content_2 = soup.find(text=" More content.") |
| self.assertEqual(content_1.next_element, content_2) |
| self.assertEqual(content_1.next_sibling, content_2) |
| self.assertEqual(content_2.previous_element, content_1) |
| self.assertEqual(content_2.previous_sibling, content_1) |
| |
| def test_extract_distinguishes_between_identical_strings(self): |
| soup = self.soup("<a>foo</a><b>bar</b>") |
| foo_1 = soup.a.string |
| bar_1 = soup.b.string |
| foo_2 = soup.new_string("foo") |
| bar_2 = soup.new_string("bar") |
| soup.a.append(foo_2) |
| soup.b.append(bar_2) |
| |
| # Now there are two identical strings in the <a> tag, and two |
| # in the <b> tag. Let's remove the first "foo" and the second |
| # "bar". |
| foo_1.extract() |
| bar_2.extract() |
| self.assertEqual(foo_2, soup.a.string) |
| self.assertEqual(bar_2, soup.b.string) |
| |
| def test_extract_multiples_of_same_tag(self): |
| soup = self.soup(""" |
| <html> |
| <head> |
| <script>foo</script> |
| </head> |
| <body> |
| <script>bar</script> |
| <a></a> |
| </body> |
| <script>baz</script> |
| </html>""") |
| [soup.script.extract() for i in soup.find_all("script")] |
| self.assertEqual("<body>\n\n<a></a>\n</body>", str(soup.body)) |
| |
| |
| def test_extract_works_when_element_is_surrounded_by_identical_strings(self): |
| soup = self.soup( |
| '<html>\n' |
| '<body>hi</body>\n' |
| '</html>') |
| soup.find('body').extract() |
| self.assertEqual(None, soup.find('body')) |
| |
| |
| def test_clear(self): |
| """Tag.clear()""" |
| soup = self.soup("<p><a>String <em>Italicized</em></a> and another</p>") |
| # clear using extract() |
| a = soup.a |
| soup.p.clear() |
| self.assertEqual(len(soup.p.contents), 0) |
| self.assertTrue(hasattr(a, "contents")) |
| |
| # clear using decompose() |
| em = a.em |
| a.clear(decompose=True) |
| self.assertEqual(0, len(em.contents)) |
| |
| def test_string_set(self): |
| """Tag.string = 'string'""" |
| soup = self.soup("<a></a> <b><c></c></b>") |
| soup.a.string = "foo" |
| self.assertEqual(soup.a.contents, ["foo"]) |
| soup.b.string = "bar" |
| self.assertEqual(soup.b.contents, ["bar"]) |
| |
| def test_string_set_does_not_affect_original_string(self): |
| soup = self.soup("<a><b>foo</b><c>bar</c>") |
| soup.b.string = soup.c.string |
| self.assertEqual(soup.a.encode(), b"<a><b>bar</b><c>bar</c></a>") |
| |
| def test_set_string_preserves_class_of_string(self): |
| soup = self.soup("<a></a>") |
| cdata = CData("foo") |
| soup.a.string = cdata |
| self.assertTrue(isinstance(soup.a.string, CData)) |
| |
| class TestElementObjects(SoupTest): |
| """Test various features of element objects.""" |
| |
| def test_len(self): |
| """The length of an element is its number of children.""" |
| soup = self.soup("<top>1<b>2</b>3</top>") |
| |
| # The BeautifulSoup object itself contains one element: the |
| # <top> tag. |
| self.assertEqual(len(soup.contents), 1) |
| self.assertEqual(len(soup), 1) |
| |
| # The <top> tag contains three elements: the text node "1", the |
| # <b> tag, and the text node "3". |
| self.assertEqual(len(soup.top), 3) |
| self.assertEqual(len(soup.top.contents), 3) |
| |
| def test_member_access_invokes_find(self): |
| """Accessing a Python member .foo invokes find('foo')""" |
| soup = self.soup('<b><i></i></b>') |
| self.assertEqual(soup.b, soup.find('b')) |
| self.assertEqual(soup.b.i, soup.find('b').find('i')) |
| self.assertEqual(soup.a, None) |
| |
| def test_deprecated_member_access(self): |
| soup = self.soup('<b><i></i></b>') |
| with warnings.catch_warnings(record=True) as w: |
| tag = soup.bTag |
| self.assertEqual(soup.b, tag) |
| self.assertEqual( |
| '.bTag is deprecated, use .find("b") instead.', |
| str(w[0].message)) |
| |
| def test_has_attr(self): |
| """has_attr() checks for the presence of an attribute. |
| |
| Please note note: has_attr() is different from |
| __in__. has_attr() checks the tag's attributes and __in__ |
| checks the tag's chidlren. |
| """ |
| soup = self.soup("<foo attr='bar'>") |
| self.assertTrue(soup.foo.has_attr('attr')) |
| self.assertFalse(soup.foo.has_attr('attr2')) |
| |
| |
| def test_attributes_come_out_in_alphabetical_order(self): |
| markup = '<b a="1" z="5" m="3" f="2" y="4"></b>' |
| self.assertSoupEquals(markup, '<b a="1" f="2" m="3" y="4" z="5"></b>') |
| |
| def test_string(self): |
| # A tag that contains only a text node makes that node |
| # available as .string. |
| soup = self.soup("<b>foo</b>") |
| self.assertEqual(soup.b.string, 'foo') |
| |
| def test_empty_tag_has_no_string(self): |
| # A tag with no children has no .stirng. |
| soup = self.soup("<b></b>") |
| self.assertEqual(soup.b.string, None) |
| |
| def test_tag_with_multiple_children_has_no_string(self): |
| # A tag with no children has no .string. |
| soup = self.soup("<a>foo<b></b><b></b></b>") |
| self.assertEqual(soup.b.string, None) |
| |
| soup = self.soup("<a>foo<b></b>bar</b>") |
| self.assertEqual(soup.b.string, None) |
| |
| # Even if all the children are strings, due to trickery, |
| # it won't work--but this would be a good optimization. |
| soup = self.soup("<a>foo</b>") |
| soup.a.insert(1, "bar") |
| self.assertEqual(soup.a.string, None) |
| |
| def test_tag_with_recursive_string_has_string(self): |
| # A tag with a single child which has a .string inherits that |
| # .string. |
| soup = self.soup("<a><b>foo</b></a>") |
| self.assertEqual(soup.a.string, "foo") |
| self.assertEqual(soup.string, "foo") |
| |
| def test_lack_of_string(self): |
| """Only a tag containing a single text node has a .string.""" |
| soup = self.soup("<b>f<i>e</i>o</b>") |
| self.assertFalse(soup.b.string) |
| |
| soup = self.soup("<b></b>") |
| self.assertFalse(soup.b.string) |
| |
| def test_all_text(self): |
| """Tag.text and Tag.get_text(sep=u"") -> all child text, concatenated""" |
| soup = self.soup("<a>a<b>r</b> <r> t </r></a>") |
| self.assertEqual(soup.a.text, "ar t ") |
| self.assertEqual(soup.a.get_text(strip=True), "art") |
| self.assertEqual(soup.a.get_text(","), "a,r, , t ") |
| self.assertEqual(soup.a.get_text(",", strip=True), "a,r,t") |
| |
| def test_get_text_ignores_comments(self): |
| soup = self.soup("foo<!--IGNORE-->bar") |
| self.assertEqual(soup.get_text(), "foobar") |
| |
| self.assertEqual( |
| soup.get_text(types=(NavigableString, Comment)), "fooIGNOREbar") |
| self.assertEqual( |
| soup.get_text(types=None), "fooIGNOREbar") |
| |
| def test_all_strings_ignores_comments(self): |
| soup = self.soup("foo<!--IGNORE-->bar") |
| self.assertEqual(['foo', 'bar'], list(soup.strings)) |
| |
| class TestCDAtaListAttributes(SoupTest): |
| |
| """Testing cdata-list attributes like 'class'. |
| """ |
| def test_single_value_becomes_list(self): |
| soup = self.soup("<a class='foo'>") |
| self.assertEqual(["foo"],soup.a['class']) |
| |
| def test_multiple_values_becomes_list(self): |
| soup = self.soup("<a class='foo bar'>") |
| self.assertEqual(["foo", "bar"], soup.a['class']) |
| |
| def test_multiple_values_separated_by_weird_whitespace(self): |
| soup = self.soup("<a class='foo\tbar\nbaz'>") |
| self.assertEqual(["foo", "bar", "baz"],soup.a['class']) |
| |
| def test_attributes_joined_into_string_on_output(self): |
| soup = self.soup("<a class='foo\tbar'>") |
| self.assertEqual(b'<a class="foo bar"></a>', soup.a.encode()) |
| |
| def test_accept_charset(self): |
| soup = self.soup('<form accept-charset="ISO-8859-1 UTF-8">') |
| self.assertEqual(['ISO-8859-1', 'UTF-8'], soup.form['accept-charset']) |
| |
| def test_cdata_attribute_applying_only_to_one_tag(self): |
| data = '<a accept-charset="ISO-8859-1 UTF-8"></a>' |
| soup = self.soup(data) |
| # We saw in another test that accept-charset is a cdata-list |
| # attribute for the <form> tag. But it's not a cdata-list |
| # attribute for any other tag. |
| self.assertEqual('ISO-8859-1 UTF-8', soup.a['accept-charset']) |
| |
| def test_string_has_immutable_name_property(self): |
| string = self.soup("s").string |
| self.assertEqual(None, string.name) |
| def t(): |
| string.name = 'foo' |
| self.assertRaises(AttributeError, t) |
| |
| class TestPersistence(SoupTest): |
| "Testing features like pickle and deepcopy." |
| |
| def setUp(self): |
| super(TestPersistence, self).setUp() |
| self.page = """<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" |
| "http://www.w3.org/TR/REC-html40/transitional.dtd"> |
| <html> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> |
| <title>Beautiful Soup: We called him Tortoise because he taught us.</title> |
| <link rev="made" href="mailto:leonardr@segfault.org"> |
| <meta name="Description" content="Beautiful Soup: an HTML parser optimized for screen-scraping."> |
| <meta name="generator" content="Markov Approximation 1.4 (module: leonardr)"> |
| <meta name="author" content="Leonard Richardson"> |
| </head> |
| <body> |
| <a href="foo">foo</a> |
| <a href="foo"><b>bar</b></a> |
| </body> |
| </html>""" |
| self.tree = self.soup(self.page) |
| |
| def test_pickle_and_unpickle_identity(self): |
| # Pickling a tree, then unpickling it, yields a tree identical |
| # to the original. |
| dumped = pickle.dumps(self.tree, 2) |
| loaded = pickle.loads(dumped) |
| self.assertEqual(loaded.__class__, BeautifulSoup) |
| self.assertEqual(loaded.decode(), self.tree.decode()) |
| |
| def test_deepcopy_identity(self): |
| # Making a deepcopy of a tree yields an identical tree. |
| copied = copy.deepcopy(self.tree) |
| self.assertEqual(copied.decode(), self.tree.decode()) |
| |
| def test_unicode_pickle(self): |
| # A tree containing Unicode characters can be pickled. |
| html = "<b>\N{SNOWMAN}</b>" |
| soup = self.soup(html) |
| dumped = pickle.dumps(soup, pickle.HIGHEST_PROTOCOL) |
| loaded = pickle.loads(dumped) |
| self.assertEqual(loaded.decode(), soup.decode()) |
| |
| def test_copy_navigablestring_is_not_attached_to_tree(self): |
| html = "<b>Foo<a></a></b><b>Bar</b>" |
| soup = self.soup(html) |
| s1 = soup.find(string="Foo") |
| s2 = copy.copy(s1) |
| self.assertEqual(s1, s2) |
| self.assertEqual(None, s2.parent) |
| self.assertEqual(None, s2.next_element) |
| self.assertNotEqual(None, s1.next_sibling) |
| self.assertEqual(None, s2.next_sibling) |
| self.assertEqual(None, s2.previous_element) |
| |
| def test_copy_navigablestring_subclass_has_same_type(self): |
| html = "<b><!--Foo--></b>" |
| soup = self.soup(html) |
| s1 = soup.string |
| s2 = copy.copy(s1) |
| self.assertEqual(s1, s2) |
| self.assertTrue(isinstance(s2, Comment)) |
| |
| def test_copy_entire_soup(self): |
| html = "<div><b>Foo<a></a></b><b>Bar</b></div>end" |
| soup = self.soup(html) |
| soup_copy = copy.copy(soup) |
| self.assertEqual(soup, soup_copy) |
| |
| def test_copy_tag_copies_contents(self): |
| html = "<div><b>Foo<a></a></b><b>Bar</b></div>end" |
| soup = self.soup(html) |
| div = soup.div |
| div_copy = copy.copy(div) |
| |
| # The two tags look the same, and evaluate to equal. |
| self.assertEqual(str(div), str(div_copy)) |
| self.assertEqual(div, div_copy) |
| |
| # But they're not the same object. |
| self.assertFalse(div is div_copy) |
| |
| # And they don't have the same relation to the parse tree. The |
| # copy is not associated with a parse tree at all. |
| self.assertEqual(None, div_copy.parent) |
| self.assertEqual(None, div_copy.previous_element) |
| self.assertEqual(None, div_copy.find(string='Bar').next_element) |
| self.assertNotEqual(None, div.find(string='Bar').next_element) |
| |
| class TestSubstitutions(SoupTest): |
| |
| def test_default_formatter_is_minimal(self): |
| markup = "<b><<Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!>></b>" |
| soup = self.soup(markup) |
| decoded = soup.decode(formatter="minimal") |
| # The < is converted back into < but the e-with-acute is left alone. |
| self.assertEqual( |
| decoded, |
| self.document_for( |
| "<b><<Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!>></b>")) |
| |
| def test_formatter_html(self): |
| markup = "<b><<Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!>></b>" |
| soup = self.soup(markup) |
| decoded = soup.decode(formatter="html") |
| self.assertEqual( |
| decoded, |
| self.document_for("<b><<Sacré bleu!>></b>")) |
| |
| def test_formatter_minimal(self): |
| markup = "<b><<Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!>></b>" |
| soup = self.soup(markup) |
| decoded = soup.decode(formatter="minimal") |
| # The < is converted back into < but the e-with-acute is left alone. |
| self.assertEqual( |
| decoded, |
| self.document_for( |
| "<b><<Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!>></b>")) |
| |
| def test_formatter_null(self): |
| markup = "<b><<Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!>></b>" |
| soup = self.soup(markup) |
| decoded = soup.decode(formatter=None) |
| # Neither the angle brackets nor the e-with-acute are converted. |
| # This is not valid HTML, but it's what the user wanted. |
| self.assertEqual(decoded, |
| self.document_for("<b><<Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!>></b>")) |
| |
| def test_formatter_custom(self): |
| markup = "<b><foo></b><b>bar</b>" |
| soup = self.soup(markup) |
| decoded = soup.decode(formatter = lambda x: x.upper()) |
| # Instead of normal entity conversion code, the custom |
| # callable is called on every string. |
| self.assertEqual( |
| decoded, |
| self.document_for("<b><FOO></b><b>BAR</b>")) |
| |
| def test_formatter_is_run_on_attribute_values(self): |
| markup = '<a href="http://a.com?a=b&c=é">e</a>' |
| soup = self.soup(markup) |
| a = soup.a |
| |
| expect_minimal = '<a href="http://a.com?a=b&c=é">e</a>' |
| |
| self.assertEqual(expect_minimal, a.decode()) |
| self.assertEqual(expect_minimal, a.decode(formatter="minimal")) |
| |
| expect_html = '<a href="http://a.com?a=b&c=é">e</a>' |
| self.assertEqual(expect_html, a.decode(formatter="html")) |
| |
| self.assertEqual(markup, a.decode(formatter=None)) |
| expect_upper = '<a href="HTTP://A.COM?A=B&C=É">E</a>' |
| self.assertEqual(expect_upper, a.decode(formatter=lambda x: x.upper())) |
| |
| def test_formatter_skips_script_tag_for_html_documents(self): |
| doc = """ |
| <script type="text/javascript"> |
| console.log("< < hey > > "); |
| </script> |
| """ |
| encoded = BeautifulSoup(doc, 'html.parser').encode() |
| self.assertTrue(b"< < hey > >" in encoded) |
| |
| def test_formatter_skips_style_tag_for_html_documents(self): |
| doc = """ |
| <style type="text/css"> |
| console.log("< < hey > > "); |
| </style> |
| """ |
| encoded = BeautifulSoup(doc, 'html.parser').encode() |
| self.assertTrue(b"< < hey > >" in encoded) |
| |
| def test_prettify_leaves_preformatted_text_alone(self): |
| soup = self.soup("<div> foo <pre> \tbar\n \n </pre> baz ") |
| # Everything outside the <pre> tag is reformatted, but everything |
| # inside is left alone. |
| self.assertEqual( |
| '<div>\n foo\n <pre> \tbar\n \n </pre>\n baz\n</div>', |
| soup.div.prettify()) |
| |
| def test_prettify_accepts_formatter(self): |
| soup = BeautifulSoup("<html><body>foo</body></html>", 'html.parser') |
| pretty = soup.prettify(formatter = lambda x: x.upper()) |
| self.assertTrue("FOO" in pretty) |
| |
| def test_prettify_outputs_unicode_by_default(self): |
| soup = self.soup("<a></a>") |
| self.assertEqual(str, type(soup.prettify())) |
| |
| def test_prettify_can_encode_data(self): |
| soup = self.soup("<a></a>") |
| self.assertEqual(bytes, type(soup.prettify("utf-8"))) |
| |
| def test_html_entity_substitution_off_by_default(self): |
| markup = "<b>Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!</b>" |
| soup = self.soup(markup) |
| encoded = soup.b.encode("utf-8") |
| self.assertEqual(encoded, markup.encode('utf-8')) |
| |
| def test_encoding_substitution(self): |
| # Here's the <meta> tag saying that a document is |
| # encoded in Shift-JIS. |
| meta_tag = ('<meta content="text/html; charset=x-sjis" ' |
| 'http-equiv="Content-type"/>') |
| soup = self.soup(meta_tag) |
| |
| # Parse the document, and the charset apprears unchanged. |
| self.assertEqual(soup.meta['content'], 'text/html; charset=x-sjis') |
| |
| # Encode the document into some encoding, and the encoding is |
| # substituted into the meta tag. |
| utf_8 = soup.encode("utf-8") |
| self.assertTrue(b"charset=utf-8" in utf_8) |
| |
| euc_jp = soup.encode("euc_jp") |
| self.assertTrue(b"charset=euc_jp" in euc_jp) |
| |
| shift_jis = soup.encode("shift-jis") |
| self.assertTrue(b"charset=shift-jis" in shift_jis) |
| |
| utf_16_u = soup.encode("utf-16").decode("utf-16") |
| self.assertTrue("charset=utf-16" in utf_16_u) |
| |
| def test_encoding_substitution_doesnt_happen_if_tag_is_strained(self): |
| markup = ('<head><meta content="text/html; charset=x-sjis" ' |
| 'http-equiv="Content-type"/></head><pre>foo</pre>') |
| |
| # Beautiful Soup used to try to rewrite the meta tag even if the |
| # meta tag got filtered out by the strainer. This test makes |
| # sure that doesn't happen. |
| strainer = SoupStrainer('pre') |
| soup = self.soup(markup, parse_only=strainer) |
| self.assertEqual(soup.contents[0].name, 'pre') |
| |
| class TestEncoding(SoupTest): |
| """Test the ability to encode objects into strings.""" |
| |
| def test_unicode_string_can_be_encoded(self): |
| html = "<b>\N{SNOWMAN}</b>" |
| soup = self.soup(html) |
| self.assertEqual(soup.b.string.encode("utf-8"), |
| "\N{SNOWMAN}".encode("utf-8")) |
| |
| def test_tag_containing_unicode_string_can_be_encoded(self): |
| html = "<b>\N{SNOWMAN}</b>" |
| soup = self.soup(html) |
| self.assertEqual( |
| soup.b.encode("utf-8"), html.encode("utf-8")) |
| |
| def test_encoding_substitutes_unrecognized_characters_by_default(self): |
| html = "<b>\N{SNOWMAN}</b>" |
| soup = self.soup(html) |
| self.assertEqual(soup.b.encode("ascii"), b"<b>☃</b>") |
| |
| def test_encoding_can_be_made_strict(self): |
| html = "<b>\N{SNOWMAN}</b>" |
| soup = self.soup(html) |
| self.assertRaises( |
| UnicodeEncodeError, soup.encode, "ascii", errors="strict") |
| |
| def test_decode_contents(self): |
| html = "<b>\N{SNOWMAN}</b>" |
| soup = self.soup(html) |
| self.assertEqual("\N{SNOWMAN}", soup.b.decode_contents()) |
| |
| def test_encode_contents(self): |
| html = "<b>\N{SNOWMAN}</b>" |
| soup = self.soup(html) |
| self.assertEqual( |
| "\N{SNOWMAN}".encode("utf8"), soup.b.encode_contents( |
| encoding="utf8")) |
| |
| def test_deprecated_renderContents(self): |
| html = "<b>\N{SNOWMAN}</b>" |
| soup = self.soup(html) |
| self.assertEqual( |
| "\N{SNOWMAN}".encode("utf8"), soup.b.renderContents()) |
| |
| def test_repr(self): |
| html = "<b>\N{SNOWMAN}</b>" |
| soup = self.soup(html) |
| if PY3K: |
| self.assertEqual(html, repr(soup)) |
| else: |
| self.assertEqual(b'<b>\\u2603</b>', repr(soup)) |
| |
| class TestNavigableStringSubclasses(SoupTest): |
| |
| def test_cdata(self): |
| # None of the current builders turn CDATA sections into CData |
| # objects, but you can create them manually. |
| soup = self.soup("") |
| cdata = CData("foo") |
| soup.insert(1, cdata) |
| self.assertEqual(str(soup), "<![CDATA[foo]]>") |
| self.assertEqual(soup.find(text="foo"), "foo") |
| self.assertEqual(soup.contents[0], "foo") |
| |
| def test_cdata_is_never_formatted(self): |
| """Text inside a CData object is passed into the formatter. |
| |
| But the return value is ignored. |
| """ |
| |
| self.count = 0 |
| def increment(*args): |
| self.count += 1 |
| return "BITTER FAILURE" |
| |
| soup = self.soup("") |
| cdata = CData("<><><>") |
| soup.insert(1, cdata) |
| self.assertEqual( |
| b"<![CDATA[<><><>]]>", soup.encode(formatter=increment)) |
| self.assertEqual(1, self.count) |
| |
| def test_doctype_ends_in_newline(self): |
| # Unlike other NavigableString subclasses, a DOCTYPE always ends |
| # in a newline. |
| doctype = Doctype("foo") |
| soup = self.soup("") |
| soup.insert(1, doctype) |
| self.assertEqual(soup.encode(), b"<!DOCTYPE foo>\n") |
| |
| def test_declaration(self): |
| d = Declaration("foo") |
| self.assertEqual("<?foo?>", d.output_ready()) |
| |
| class TestSoupSelector(TreeTest): |
| |
| HTML = """ |
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" |
| "http://www.w3.org/TR/html4/strict.dtd"> |
| <html> |
| <head> |
| <title>The title</title> |
| <link rel="stylesheet" href="blah.css" type="text/css" id="l1"> |
| </head> |
| <body> |
| <custom-dashed-tag class="dashed" id="dash1">Hello there.</custom-dashed-tag> |
| <div id="main" class="fancy"> |
| <div id="inner"> |
| <h1 id="header1">An H1</h1> |
| <p>Some text</p> |
| <p class="onep" id="p1">Some more text</p> |
| <h2 id="header2">An H2</h2> |
| <p class="class1 class2 class3" id="pmulti">Another</p> |
| <a href="http://bob.example.org/" rel="friend met" id="bob">Bob</a> |
| <h2 id="header3">Another H2</h2> |
| <a id="me" href="http://simonwillison.net/" rel="me">me</a> |
| <span class="s1"> |
| <a href="#" id="s1a1">span1a1</a> |
| <a href="#" id="s1a2">span1a2 <span id="s1a2s1">test</span></a> |
| <span class="span2"> |
| <a href="#" id="s2a1">span2a1</a> |
| </span> |
| <span class="span3"></span> |
| <custom-dashed-tag class="dashed" id="dash2"/> |
| <div data-tag="dashedvalue" id="data1"/> |
| </span> |
| </div> |
| <x id="xid"> |
| <z id="zida"/> |
| <z id="zidab"/> |
| <z id="zidac"/> |
| </x> |
| <y id="yid"> |
| <z id="zidb"/> |
| </y> |
| <p lang="en" id="lang-en">English</p> |
| <p lang="en-gb" id="lang-en-gb">English UK</p> |
| <p lang="en-us" id="lang-en-us">English US</p> |
| <p lang="fr" id="lang-fr">French</p> |
| </div> |
| |
| <div id="footer"> |
| </div> |
| """ |
| |
| def setUp(self): |
| self.soup = BeautifulSoup(self.HTML, 'html.parser') |
| |
| def assertSelects(self, selector, expected_ids): |
| el_ids = [el['id'] for el in self.soup.select(selector)] |
| el_ids.sort() |
| expected_ids.sort() |
| self.assertEqual(expected_ids, el_ids, |
| "Selector %s, expected [%s], got [%s]" % ( |
| selector, ', '.join(expected_ids), ', '.join(el_ids) |
| ) |
| ) |
| |
| assertSelect = assertSelects |
| |
| def assertSelectMultiple(self, *tests): |
| for selector, expected_ids in tests: |
| self.assertSelect(selector, expected_ids) |
| |
| def test_one_tag_one(self): |
| els = self.soup.select('title') |
| self.assertEqual(len(els), 1) |
| self.assertEqual(els[0].name, 'title') |
| self.assertEqual(els[0].contents, ['The title']) |
| |
| def test_one_tag_many(self): |
| els = self.soup.select('div') |
| self.assertEqual(len(els), 4) |
| for div in els: |
| self.assertEqual(div.name, 'div') |
| |
| el = self.soup.select_one('div') |
| self.assertEqual('main', el['id']) |
| |
| def test_select_one_returns_none_if_no_match(self): |
| match = self.soup.select_one('nonexistenttag') |
| self.assertEqual(None, match) |
| |
| |
| def test_tag_in_tag_one(self): |
| els = self.soup.select('div div') |
| self.assertSelects('div div', ['inner', 'data1']) |
| |
| def test_tag_in_tag_many(self): |
| for selector in ('html div', 'html body div', 'body div'): |
| self.assertSelects(selector, ['data1', 'main', 'inner', 'footer']) |
| |
| def test_tag_no_match(self): |
| self.assertEqual(len(self.soup.select('del')), 0) |
| |
| def test_invalid_tag(self): |
| self.assertRaises(ValueError, self.soup.select, 'tag%t') |
| |
| def test_select_dashed_tag_ids(self): |
| self.assertSelects('custom-dashed-tag', ['dash1', 'dash2']) |
| |
| def test_select_dashed_by_id(self): |
| dashed = self.soup.select('custom-dashed-tag[id=\"dash2\"]') |
| self.assertEqual(dashed[0].name, 'custom-dashed-tag') |
| self.assertEqual(dashed[0]['id'], 'dash2') |
| |
| def test_dashed_tag_text(self): |
| self.assertEqual(self.soup.select('body > custom-dashed-tag')[0].text, 'Hello there.') |
| |
| def test_select_dashed_matches_find_all(self): |
| self.assertEqual(self.soup.select('custom-dashed-tag'), self.soup.find_all('custom-dashed-tag')) |
| |
| def test_header_tags(self): |
| self.assertSelectMultiple( |
| ('h1', ['header1']), |
| ('h2', ['header2', 'header3']), |
| ) |
| |
| def test_class_one(self): |
| for selector in ('.onep', 'p.onep', 'html p.onep'): |
| els = self.soup.select(selector) |
| self.assertEqual(len(els), 1) |
| self.assertEqual(els[0].name, 'p') |
| self.assertEqual(els[0]['class'], ['onep']) |
| |
| def test_class_mismatched_tag(self): |
| els = self.soup.select('div.onep') |
| self.assertEqual(len(els), 0) |
| |
| def test_one_id(self): |
| for selector in ('div#inner', '#inner', 'div div#inner'): |
| self.assertSelects(selector, ['inner']) |
| |
| def test_bad_id(self): |
| els = self.soup.select('#doesnotexist') |
| self.assertEqual(len(els), 0) |
| |
| def test_items_in_id(self): |
| els = self.soup.select('div#inner p') |
| self.assertEqual(len(els), 3) |
| for el in els: |
| self.assertEqual(el.name, 'p') |
| self.assertEqual(els[1]['class'], ['onep']) |
| self.assertFalse(els[0].has_attr('class')) |
| |
| def test_a_bunch_of_emptys(self): |
| for selector in ('div#main del', 'div#main div.oops', 'div div#main'): |
| self.assertEqual(len(self.soup.select(selector)), 0) |
| |
| def test_multi_class_support(self): |
| for selector in ('.class1', 'p.class1', '.class2', 'p.class2', |
| '.class3', 'p.class3', 'html p.class2', 'div#inner .class2'): |
| self.assertSelects(selector, ['pmulti']) |
| |
| def test_multi_class_selection(self): |
| for selector in ('.class1.class3', '.class3.class2', |
| '.class1.class2.class3'): |
| self.assertSelects(selector, ['pmulti']) |
| |
| def test_child_selector(self): |
| self.assertSelects('.s1 > a', ['s1a1', 's1a2']) |
| self.assertSelects('.s1 > a span', ['s1a2s1']) |
| |
| def test_child_selector_id(self): |
| self.assertSelects('.s1 > a#s1a2 span', ['s1a2s1']) |
| |
| def test_attribute_equals(self): |
| self.assertSelectMultiple( |
| ('p[class="onep"]', ['p1']), |
| ('p[id="p1"]', ['p1']), |
| ('[class="onep"]', ['p1']), |
| ('[id="p1"]', ['p1']), |
| ('link[rel="stylesheet"]', ['l1']), |
| ('link[type="text/css"]', ['l1']), |
| ('link[href="blah.css"]', ['l1']), |
| ('link[href="no-blah.css"]', []), |
| ('[rel="stylesheet"]', ['l1']), |
| ('[type="text/css"]', ['l1']), |
| ('[href="blah.css"]', ['l1']), |
| ('[href="no-blah.css"]', []), |
| ('p[href="no-blah.css"]', []), |
| ('[href="no-blah.css"]', []), |
| ) |
| |
| def test_attribute_tilde(self): |
| self.assertSelectMultiple( |
| ('p[class~="class1"]', ['pmulti']), |
| ('p[class~="class2"]', ['pmulti']), |
| ('p[class~="class3"]', ['pmulti']), |
| ('[class~="class1"]', ['pmulti']), |
| ('[class~="class2"]', ['pmulti']), |
| ('[class~="class3"]', ['pmulti']), |
| ('a[rel~="friend"]', ['bob']), |
| ('a[rel~="met"]', ['bob']), |
| ('[rel~="friend"]', ['bob']), |
| ('[rel~="met"]', ['bob']), |
| ) |
| |
| def test_attribute_startswith(self): |
| self.assertSelectMultiple( |
| ('[rel^="style"]', ['l1']), |
| ('link[rel^="style"]', ['l1']), |
| ('notlink[rel^="notstyle"]', []), |
| ('[rel^="notstyle"]', []), |
| ('link[rel^="notstyle"]', []), |
| ('link[href^="bla"]', ['l1']), |
| ('a[href^="http://"]', ['bob', 'me']), |
| ('[href^="http://"]', ['bob', 'me']), |
| ('[id^="p"]', ['pmulti', 'p1']), |
| ('[id^="m"]', ['me', 'main']), |
| ('div[id^="m"]', ['main']), |
| ('a[id^="m"]', ['me']), |
| ('div[data-tag^="dashed"]', ['data1']) |
| ) |
| |
| def test_attribute_endswith(self): |
| self.assertSelectMultiple( |
| ('[href$=".css"]', ['l1']), |
| ('link[href$=".css"]', ['l1']), |
| ('link[id$="1"]', ['l1']), |
| ('[id$="1"]', ['data1', 'l1', 'p1', 'header1', 's1a1', 's2a1', 's1a2s1', 'dash1']), |
| ('div[id$="1"]', ['data1']), |
| ('[id$="noending"]', []), |
| ) |
| |
| def test_attribute_contains(self): |
| self.assertSelectMultiple( |
| # From test_attribute_startswith |
| ('[rel*="style"]', ['l1']), |
| ('link[rel*="style"]', ['l1']), |
| ('notlink[rel*="notstyle"]', []), |
| ('[rel*="notstyle"]', []), |
| ('link[rel*="notstyle"]', []), |
| ('link[href*="bla"]', ['l1']), |
| ('[href*="http://"]', ['bob', 'me']), |
| ('[id*="p"]', ['pmulti', 'p1']), |
| ('div[id*="m"]', ['main']), |
| ('a[id*="m"]', ['me']), |
| # From test_attribute_endswith |
| ('[href*=".css"]', ['l1']), |
| ('link[href*=".css"]', ['l1']), |
| ('link[id*="1"]', ['l1']), |
| ('[id*="1"]', ['data1', 'l1', 'p1', 'header1', 's1a1', 's1a2', 's2a1', 's1a2s1', 'dash1']), |
| ('div[id*="1"]', ['data1']), |
| ('[id*="noending"]', []), |
| # New for this test |
| ('[href*="."]', ['bob', 'me', 'l1']), |
| ('a[href*="."]', ['bob', 'me']), |
| ('link[href*="."]', ['l1']), |
| ('div[id*="n"]', ['main', 'inner']), |
| ('div[id*="nn"]', ['inner']), |
| ('div[data-tag*="edval"]', ['data1']) |
| ) |
| |
| def test_attribute_exact_or_hypen(self): |
| self.assertSelectMultiple( |
| ('p[lang|="en"]', ['lang-en', 'lang-en-gb', 'lang-en-us']), |
| ('[lang|="en"]', ['lang-en', 'lang-en-gb', 'lang-en-us']), |
| ('p[lang|="fr"]', ['lang-fr']), |
| ('p[lang|="gb"]', []), |
| ) |
| |
| def test_attribute_exists(self): |
| self.assertSelectMultiple( |
| ('[rel]', ['l1', 'bob', 'me']), |
| ('link[rel]', ['l1']), |
| ('a[rel]', ['bob', 'me']), |
| ('[lang]', ['lang-en', 'lang-en-gb', 'lang-en-us', 'lang-fr']), |
| ('p[class]', ['p1', 'pmulti']), |
| ('[blah]', []), |
| ('p[blah]', []), |
| ('div[data-tag]', ['data1']) |
| ) |
| |
| def test_unsupported_pseudoclass(self): |
| self.assertRaises( |
| NotImplementedError, self.soup.select, "a:no-such-pseudoclass") |
| |
| self.assertRaises( |
| NotImplementedError, self.soup.select, "a:nth-of-type(a)") |
| |
| |
| def test_nth_of_type(self): |
| # Try to select first paragraph |
| els = self.soup.select('div#inner p:nth-of-type(1)') |
| self.assertEqual(len(els), 1) |
| self.assertEqual(els[0].string, 'Some text') |
| |
| # Try to select third paragraph |
| els = self.soup.select('div#inner p:nth-of-type(3)') |
| self.assertEqual(len(els), 1) |
| self.assertEqual(els[0].string, 'Another') |
| |
| # Try to select (non-existent!) fourth paragraph |
| els = self.soup.select('div#inner p:nth-of-type(4)') |
| self.assertEqual(len(els), 0) |
| |
| # Pass in an invalid value. |
| self.assertRaises( |
| ValueError, self.soup.select, 'div p:nth-of-type(0)') |
| |
| def test_nth_of_type_direct_descendant(self): |
| els = self.soup.select('div#inner > p:nth-of-type(1)') |
| self.assertEqual(len(els), 1) |
| self.assertEqual(els[0].string, 'Some text') |
| |
| def test_id_child_selector_nth_of_type(self): |
| self.assertSelects('#inner > p:nth-of-type(2)', ['p1']) |
| |
| def test_select_on_element(self): |
| # Other tests operate on the tree; this operates on an element |
| # within the tree. |
| inner = self.soup.find("div", id="main") |
| selected = inner.select("div") |
| # The <div id="inner"> tag was selected. The <div id="footer"> |
| # tag was not. |
| self.assertSelectsIDs(selected, ['inner', 'data1']) |
| |
| def test_overspecified_child_id(self): |
| self.assertSelects(".fancy #inner", ['inner']) |
| self.assertSelects(".normal #inner", []) |
| |
| def test_adjacent_sibling_selector(self): |
| self.assertSelects('#p1 + h2', ['header2']) |
| self.assertSelects('#p1 + h2 + p', ['pmulti']) |
| self.assertSelects('#p1 + #header2 + .class1', ['pmulti']) |
| self.assertEqual([], self.soup.select('#p1 + p')) |
| |
| def test_general_sibling_selector(self): |
| self.assertSelects('#p1 ~ h2', ['header2', 'header3']) |
| self.assertSelects('#p1 ~ #header2', ['header2']) |
| self.assertSelects('#p1 ~ h2 + a', ['me']) |
| self.assertSelects('#p1 ~ h2 + [rel="me"]', ['me']) |
| self.assertEqual([], self.soup.select('#inner ~ h2')) |
| |
| def test_dangling_combinator(self): |
| self.assertRaises(ValueError, self.soup.select, 'h1 >') |
| |
| def test_sibling_combinator_wont_select_same_tag_twice(self): |
| self.assertSelects('p[lang] ~ p', ['lang-en-gb', 'lang-en-us', 'lang-fr']) |
| |
| # Test the selector grouping operator (the comma) |
| def test_multiple_select(self): |
| self.assertSelects('x, y', ['xid', 'yid']) |
| |
| def test_multiple_select_with_no_space(self): |
| self.assertSelects('x,y', ['xid', 'yid']) |
| |
| def test_multiple_select_with_more_space(self): |
| self.assertSelects('x, y', ['xid', 'yid']) |
| |
| def test_multiple_select_duplicated(self): |
| self.assertSelects('x, x', ['xid']) |
| |
| def test_multiple_select_sibling(self): |
| self.assertSelects('x, y ~ p[lang=fr]', ['xid', 'lang-fr']) |
| |
| def test_multiple_select_tag_and_direct_descendant(self): |
| self.assertSelects('x, y > z', ['xid', 'zidb']) |
| |
| def test_multiple_select_direct_descendant_and_tags(self): |
| self.assertSelects('div > x, y, z', ['xid', 'yid', 'zida', 'zidb', 'zidab', 'zidac']) |
| |
| def test_multiple_select_indirect_descendant(self): |
| self.assertSelects('div x,y, z', ['xid', 'yid', 'zida', 'zidb', 'zidab', 'zidac']) |
| |
| def test_invalid_multiple_select(self): |
| self.assertRaises(ValueError, self.soup.select, ',x, y') |
| self.assertRaises(ValueError, self.soup.select, 'x,,y') |
| |
| def test_multiple_select_attrs(self): |
| self.assertSelects('p[lang=en], p[lang=en-gb]', ['lang-en', 'lang-en-gb']) |
| |
| def test_multiple_select_ids(self): |
| self.assertSelects('x, y > z[id=zida], z[id=zidab], z[id=zidb]', ['xid', 'zidb', 'zidab']) |
| |
| def test_multiple_select_nested(self): |
| self.assertSelects('body > div > x, y > z', ['xid', 'zidb']) |
| |
| |
| |