summaryrefslogtreecommitdiff
path: root/bs4/element.py
diff options
context:
space:
mode:
authorLeonard Richardson <leonardr@segfault.org>2020-03-09 22:15:57 -0400
committerLeonard Richardson <leonardr@segfault.org>2020-03-09 22:15:57 -0400
commit542d5d3d3bd33661d593e224f62ed4950949ce60 (patch)
tree69ad5d01c6723ddf895a78a4d36ebee890eca75f /bs4/element.py
parent180b6fddd104eea276a92806e6d44962a37093fa (diff)
Make find() methods return a union type of the two most common PageElements, rather than PageElement itself.
Diffstat (limited to 'bs4/element.py')
-rw-r--r--bs4/element.py20
1 files changed, 10 insertions, 10 deletions
diff --git a/bs4/element.py b/bs4/element.py
index 059e0de..9c6d3cc 100644
--- a/bs4/element.py
+++ b/bs4/element.py
@@ -487,7 +487,7 @@ class PageElement(object):
:param text: A filter for a NavigableString with specific text.
:kwargs: A dictionary of filters on attribute values.
:return: A PageElement.
- :rtype: bs4.element.PageElement
+ :rtype: Union[bs4.element.Tag, bs4.element.NavigableString]
"""
return self._find_one(self.find_all_next, name, attrs, text, **kwargs)
findNext = find_next # BS3
@@ -523,7 +523,7 @@ class PageElement(object):
:param text: A filter for a NavigableString with specific text.
:kwargs: A dictionary of filters on attribute values.
:return: A PageElement.
- :rtype: bs4.element.PageElement
+ :rtype: Union[bs4.element.Tag, bs4.element.NavigableString]
"""
return self._find_one(self.find_next_siblings, name, attrs, text,
**kwargs)
@@ -562,7 +562,7 @@ class PageElement(object):
:param text: A filter for a NavigableString with specific text.
:kwargs: A dictionary of filters on attribute values.
:return: A PageElement.
- :rtype: bs4.element.PageElement
+ :rtype: Union[bs4.element.Tag, bs4.element.NavigableString]
"""
return self._find_one(
self.find_all_previous, name, attrs, text, **kwargs)
@@ -601,7 +601,7 @@ class PageElement(object):
:param text: A filter for a NavigableString with specific text.
:kwargs: A dictionary of filters on attribute values.
:return: A PageElement.
- :rtype: bs4.element.PageElement
+ :rtype: Union[bs4.element.Tag, bs4.element.NavigableString]
"""
return self._find_one(self.find_previous_siblings, name, attrs, text,
**kwargs)
@@ -640,7 +640,7 @@ class PageElement(object):
:kwargs: A dictionary of filters on attribute values.
:return: A PageElement.
- :rtype: bs4.element.PageElement
+ :rtype: Union[bs4.element.Tag, bs4.element.NavigableString]
"""
# NOTE: We can't use _find_one because findParents takes a different
# set of arguments.
@@ -663,7 +663,7 @@ class PageElement(object):
:kwargs: A dictionary of filters on attribute values.
:return: A PageElement.
- :rtype: bs4.element.PageElement
+ :rtype: Union[bs4.element.Tag, bs4.element.NavigableString]
"""
return self._find_all(name, attrs, None, limit, self.parents,
**kwargs)
@@ -675,7 +675,7 @@ class PageElement(object):
"""The PageElement, if any, that was parsed just after this one.
:return: A PageElement.
- :rtype: bs4.element.PageElement
+ :rtype: Union[bs4.element.Tag, bs4.element.NavigableString]
"""
return self.next_element
@@ -684,7 +684,7 @@ class PageElement(object):
"""The PageElement, if any, that was parsed just before this one.
:return: A PageElement.
- :rtype: bs4.element.PageElement
+ :rtype: Union[bs4.element.Tag, bs4.element.NavigableString]
"""
return self.previous_element
@@ -1690,7 +1690,7 @@ class Tag(PageElement):
:param limit: Stop looking after finding this many results.
:kwargs: A dictionary of filters on attribute values.
:return: A PageElement.
- :rtype: bs4.element.PageElement
+ :rtype: Union[bs4.element.Tag, bs4.element.NavigableString]
"""
r = None
l = self.find_all(name, attrs, recursive, text, 1, **kwargs)
@@ -1764,7 +1764,7 @@ class Tag(PageElement):
soupsieve.select() method.
:return: A PageElement.
- :rtype: bs4.element.PageElement
+ :rtype: Union[bs4.element.Tag, bs4.element.NavigableString]
"""
value = self.select(selector, namespaces, 1, **kwargs)
if value: