[Fix #40] add parent and ancestor selectors #90
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Implements
parent
andancestor
selectors, should close #40. These functions act as natural counterparts to bothchild
anddescendant
:child
returns the node at the end of a direct chain of direct child relationships,parent
returns the node at the start of a direct chain of direct child relationships.descendant
returns the node at the end of a chain of descendant relationships,ancestor
returns the node at the start of a chain of descendant relationships.Three additional functions were added:
compose-unary
,parent
, andancestor
. Thecompose-unary
function implements the functionality utilized by the latter two functions. I added tests forparent
andancestor
.compose-unary
Takes a unary selector function, such as
has-child
orhas-descendant
, and any number of selectors. Each of the selectors are composed together usingand
and the provided unary selector function. For example, running(compose-unary has-child (tag :div) (class :foo) (attr :disabled))
produces the equivalent of:parent
andancestor
Given any number of selectors, applies
compose-unary
to the selectors usinghas-child
andhas-descendant
respectively, that is:Examples
These examples are those contained in the docstrings and tests.
parent
(parent (tag :div) (class :foo) (attr :disabled))
will select the div in the first but not the second.ancestor
(ancestor (tag :div) (class :foo) (attr :disabled))
will select the div in both.