Add spec.Segment.IsDescendent

Author: theory

CHANGELOG.md

@@ -9,13 +9,19 @@ All notable changes to this project will be documented in this file. It uses the
 
 ## [v0.1.3] — Unreleased
 
+### ⚡ Improvements
+
+*   Added `spec.Filter.Eval` to allow public evaluation of a single JSON node.
+    Used internally by `spec.FilterSelector.Select`.
+*   Added `spec.Segment.IsDescendent` to tell wether a segments selects just
+    from the current child node or also recursively selects from all of its
+    descendants.
+
 ### 📔 Notes
 
 *   Made `spec.SliceSelector.Bounds` public.
 *   Made the underlying struct defining `spec.Wildcard` public, named it
     `spec.WildcardSelector`.
-*   Added `spec.Filter.Eval` to allow public evaluation of a single JSON node.
-    Used internally by `spec.FilterSelector.Select`.
 
   [v0.1.3]: https://github.com/theory/jsonpath/compare/v0.1.2...v0.1.3
 

spec/segment.go

@@ -85,3 +85,7 @@ func (s *Segment) isSingular() bool {
 	}
 	return s.selectors[0].isSingular()
 }
+
+// IsDescendent returns true if the segment is a descendent selector that
+// recursively select the children of a JSON value.
+func (s *Segment) IsDescendent() bool { return s.descendant }

spec/segment_test.go

@@ -83,6 +83,7 @@ func TestSegmentString(t *testing.T) {
 			t.Parallel()
 			a.Equal(tc.str, tc.seg.String())
 			a.Equal(tc.sing, tc.seg.isSingular())
+			a.Equal(tc.seg.descendant, tc.seg.IsDescendent())
 		})
 	}
 }
@@ -237,6 +238,7 @@ func TestSegmentQuery(t *testing.T) {
 			t.Parallel()
 			a.Equal(tc.seg.selectors, tc.seg.Selectors())
 			a.Equal(tc.sing, tc.seg.isSingular())
+			a.Equal(tc.seg.descendant, tc.seg.IsDescendent())
 			if tc.rand {
 				a.ElementsMatch(tc.exp, tc.seg.Select(tc.src, nil))
 			} else {
@@ -433,6 +435,7 @@ func TestDescendantSegmentQuery(t *testing.T) {
 		t.Run(tc.name, func(t *testing.T) {
 			t.Parallel()
 			a.False(tc.seg.isSingular())
+			a.True(tc.seg.IsDescendent())
 			if tc.rand {
 				a.ElementsMatch(tc.exp, tc.seg.Select(tc.src, nil))
 			} else {