Introducing the ability to skip empty text nodes in LexborNode!

[pygarap]

This pull request enhances the LexborNode API in selectolax by introducing the ability to skip empty text nodes in traversal, iter, text, and by adding a property to check for empty text nodes. These changes improve control over HTML parsing, especially when handling whitespace or empty nodes. The update also includes expanded documentation and tests to ensure the new behaviors are correct.

API Enhancements for Skipping Empty Text Nodes:

• Added a skip_empty parameter to the text, iter, and traverse methods in LexborNode, allowing users to exclude empty text nodes (as determined by lxb_dom_node_is_empty) from results. [1] [2] [3] [4] [5] [6] [7] [8] [9]
• Updated the C extension interface to expose the lxb_dom_node_is_empty function for use in Python code.

New Property for Node Emptiness:

• Introduced the is_empty_text_node property on LexborNode, providing a convenient way to check if a node is a text node and considered empty by the underlying DOM implementation. [1] [2]

Documentation and Usability Improvements:

• Expanded docstrings for text, iter, and traverse methods to clearly describe new parameters and behaviors, improving developer understanding and usability. [1] [2] [3] [4] [5] [6]
• Added __iter__ and __next__ methods for better iterator protocol support.

Testing:

• Added new tests to verify the correct behavior of the skip_empty flag in text, iter, and traverse methods, and to check the is_empty_text_node property.

[rushter]

Thanks.