selectors.css

Submodules

• selectors.css.api
  • SoupsieveApi
    • SoupsieveApi.__init__()
    • SoupsieveApi.select()
  • CSSSelectApi
    • CSSSelectApi.__init__()
    • CSSSelectApi.select()
  • SeleniumCSSApi
    • SeleniumCSSApi.select()
  • PlaywrightCSSApi
    • PlaywrightCSSApi.select()
• selectors.css.selectors
  • Classes
  • CSSSoupSelector
    • CSSSoupSelector.SELECTOR
    • CSSSoupSelector.__init__()
    • CSSSoupSelector.css
    • CSSSoupSelector.find_all()
  • OnlyChild
    • OnlyChild.SELECTOR
  • Empty
    • Empty.SELECTOR
  • FirstChild
    • FirstChild.SELECTOR
  • LastChild
    • LastChild.SELECTOR
  • NthBaseSelector
    • NthBaseSelector.__init__()
    • NthBaseSelector.SELECTOR
  • NthChild
    • NthChild.SELECTOR
  • NthLastChild
    • NthLastChild.SELECTOR
  • FirstOfType
    • FirstOfType.SELECTOR
  • LastOfType
    • LastOfType.SELECTOR
  • NthOfType
    • NthOfType.SELECTOR
  • NthLastOfType
    • NthLastOfType.SELECTOR
  • OnlyOfType
    • OnlyOfType.SELECTOR
  • CSS
    • CSS.SELECTOR
    • CSS.__init__()

Content

Package with classes for searching based on CSS selectors.

Contains implementation of basic CSS pseudo-classes like :only-child, :empty, :nth-child().

They can be used in combination with other SoupSelector objects to create more complex search procedures.

Classes

• OnlyChild

• Empty

• FirstChild

• LastChild

• NthChild

• NthLastChild

• FirstOfType

• LastOfType

• NthOfType

• NthLastOfType

• OnlyOfType

• CSS - wrapper for simple search with CSS selectors

class CSS(css: str)

Bases: CSSSoupSelector

Selector for finding elements based on any provided CSS selector. soupsieve adapter, that allows any supported css selector to be used with other soupsavvy components.

Example

>>> CSS("div.menu")

Would match:

Example

>>> <div class="widget"> ❌
...    <div class="menu">Hello World</div> ✔️
... </div>
... <div class="menu_main"> ❌
...    <a class="menu">Hello World</a> ❌
... </div>
... <div class="menu"></div> ✔️

Notes

Implemented selectors may vary between implementations, as each of them uses specific compatible libraries for css selection.

SELECTOR: str = '{}'

__init__(css: str) → None

Initializes the selector with the provided css selector.

Parameters

cssstr

CSS selector to be used for selecting elements.

class Empty

Bases: CSSSoupSelector

Selector for finding empty elements, i.e., that have no children. Counterpart of the CSS selector :empty pseudo-class.

Example

>>> <div class="widget"> ❌
...    <div class="menu"></div> ✔️
... </div>

Any text node is considered as a child and makes the element non-empty.

Example

>>> <div class="widget">Hello World</div> ❌
... <div class="widget"> </div> ❌

These elements are not empty and do not match the selector.

Notes

For more information on the :empty selector, see:

https://developer.mozilla.org/en-US/docs/Web/CSS/:empty

SELECTOR: str = ':empty'

class FirstChild

Bases: CSSSoupSelector

Selector for finding elements, that are the first child of their parent. Counterpart of the CSS selector :first-child pseudo-class.

Example

>>> <div class="widget"> ✔️
...    <div class="menu">Hello World</div> ✔️
... </div>
... <div class="widget"> ❌
...    <div class="menu">Hello World</div> ✔️
...    <div class="menu">Hello World 2 </div> ❌
... </div>

Notes

FirstChild object is essentially the same as NthChild(“1”).

For more information on the :first-child selector, see:

https://developer.mozilla.org/en-US/docs/Web/CSS/:first-child

SELECTOR: str = ':first-child'

class FirstOfType

Bases: CSSSoupSelector

Selector for finding elements, that are the first of their type in their parent. Counterpart of the CSS selector :first-of-type pseudo-class.

Example

>>> <div class="widget"> ✔️
...    <div class="menu">Hello World</div> ✔️
... </div>
... <div class="widget"> ❌
...    <div class="menu">Hello World</div> ✔️
...    <span class="menu">Hello World 2 </span> ✔️
...    <div class="menu">Hello World 3 </div> ❌
... </div>

Notes

For this selector the first element of any type is selected, which in case of finding single element is equivalent to FirstChild results.

For more information on the formula, see:

https://developer.mozilla.org/en-US/docs/Web/CSS/:first-of-type

SELECTOR: str = ':first-of-type'

class LastChild

Bases: CSSSoupSelector

Selector for finding elements, that are the last child of their parent. Counterpart of the CSS selector :last-child pseudo-class.

Example

>>> <div class="widget"> ❌
...    <div class="menu">Hello World</div> ✔️
... </div>
... <div class="widget"> ✔️
...    <div class="menu">Hello World</div> ❌
...    <div class="menu">Hello World 2 </div> ✔️
... </div>

Notes

LastChild object is essentially the same as NthLastChild(“1”). Element that is the first and only child is matched as well.

For more information on the :last-child selector, see:

https://developer.mozilla.org/en-US/docs/Web/CSS/:last-child

SELECTOR: str = ':last-child'

class LastOfType

Bases: CSSSoupSelector

Selector for finding elements, that are the last of their type in their parent. Counterpart of the CSS selector :last-of-type pseudo-class.

Example

>>> <div class="widget"> ❌
...    <div class="menu">Hello World</div> ✔️
... </div>
... <div class="widget"> ✔️
...    <div class="menu">Hello World</div> ❌
...    <span class="menu">Hello World 2 </span> ✔️
...    <div class="menu">Hello World 3 </div> ✔️
... </div>

Notes

For this selector the last element of any type is selected, which in case of finding single element is the equivalent to LastChild results.

For more information on the formula, see:

https://developer.mozilla.org/en-US/docs/Web/CSS/:last-of-type

SELECTOR: str = ':last-of-type'

class NthChild(nth: str)

Bases: NthBaseSelector

Selector for finding elements, that are the nth child of their parent. Counterpart of the CSS selector :nth-child(n).

Example

>>> NthChild("2").selector
:nth-child(2)
>>> NthChild("2n+1").selector
:nth-child(2n+1)
>>> NthChild("odd").selector
:nth-child(odd)

Notes

For more information on the formula, see:

https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-child

SELECTOR: str = ':nth-child({})'

class NthLastChild(nth: str)

Bases: NthBaseSelector

Selector for finding elements, that are the nth last child of their parent. Counterpart of the CSS selector :nth-last-child(n).

Example

>>> NthLastChild("2").selector
:nth-last-child(2)
>>> NthLastChild("2n+1").selector
:nth-last-child(2n+1)
>>> NthLastChild("odd").selector
:nth-last-child(odd)

Notes

For more information on the formula, see:

https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-last-child

SELECTOR: str = ':nth-last-child({})'

class NthLastOfType(nth: str)

Bases: NthBaseSelector

Selector for finding elements, that are the nth last of their type in their parent. Counterpart of the CSS selector :nth-last-of-type(n).

Example

>>> NthLastOfType("2").selector
:nth-last-of-type(2)
>>> NthLastOfType("2n+1").selector
:nth-last-of-type(2n+1)
>>> NthLastOfType("even").selector
:nth-last-of-type(even)

Notes

For more information on the formula, see:

https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-last-of-type

SELECTOR: str = ':nth-last-of-type({})'

class NthOfType(nth: str)

Bases: NthBaseSelector

Selector for finding elements, that are the nth of their type in their parent. Counterpart of the CSS selector :nth-of-type(n).

Example

>>> NthOfType("2").selector
:nth-of-type(2)
>>> NthOfType("2n+1").selector
:nth-of-type(2n+1)
>>> NthOfType("even").selector
:nth-of-type(even)

Notes

For more information on the formula, see:

https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-of-type

SELECTOR: str = ':nth-of-type({})'

class OnlyChild

Bases: CSSSoupSelector

Selector for finding elements, that do not have any siblings. Counterpart of the CSS selector :only-child pseudo-class.

Example

>>> <div class="widget"> ❌
...    <div class="menu">Hello World</div> ✔️
... </div>
... <div class="widget"> ❌
...    <div class="menu">Hello World</div> ❌
...    <div class="menu">Hello World 2 </div> ❌
... </div>

Notes

For more information on the :only-child pseudo-class, see:

https://developer.mozilla.org/en-US/docs/Web/CSS/:only-child

SELECTOR: str = ':only-child'

class OnlyOfType

Bases: CSSSoupSelector

Selector for finding elements, that don’t have siblings of the same type. Counterpart of the CSS selector :only-of-type pseudo-class.

Example

>>> <div class="widget"> ❌
...    <div class="menu">Hello World</div> ✔️
... </div>
... <div class="widget"> ❌
...    <div class="menu">Hello World</div> ✔️
...    <span class="menu">Hello World 2 </span> ❌
...    <span class="menu">Hello World 3 </span> ❌
... </div>
... <a class="widget"></a> ✔️

Notes

For more information on the :only-of-type selector, see:

https://developer.mozilla.org/en-US/docs/Web/CSS/:only-of-type

SELECTOR: str = ':only-of-type'