closes #66 (#67)

* closes #66

Author: nachg

.github/badges/jacoco.svg

@@ -182,4 +182,13 @@ internal fun Any.getInnerClassMember(): Any? {
     }
     f?.isAccessible = true
     return f?.get(this)
+}
+
+/**
+ * Sets the <pre>base</pre> to the [BaseSelector] via reflection
+ */
+internal fun <T : BaseSelector> T.setAnnotations(annotations: Collection<Annotation>): T {
+    SelectorReflection(this)
+        .setAnnotations(annotations)
+    return this
 }

src/main/kotlin/org/xpathqs/core/reflection/ReflectionExtensions.kt

@@ -30,7 +30,7 @@ import org.xpathqs.core.selector.base.ISelector
 /**
  * Class for initializing Selectors names and structure via Reflection
  * @sample org.xpathqs.core.reflection.parser.ObjectWithBaseTest
- * @sample org.xpathqs.core.reflection.parser.ObjectWithoutBase
+ * @sample org.xpathqs.core.reflection.parser.ObjectWithoutBaseTest
  * @sample org.xpathqs.core.reflection.parser.ObjectWithBaseAndInnerObjectTest
  */
 internal class SelectorParser(
@@ -48,15 +48,17 @@ internal class SelectorParser(
 
         rootObj.setBase(base)
         rootObj.setName(baseName + rootObj::class.simpleName!!)
+        rootObj.setAnnotations(rootObj::class.annotations.toList())
         rootObj.freeze()
 
         rootObj.children = srf.innerSelectors
 
         srf.innerSelectorFields.forEach {
             it.isAccessible = true
             val sel = it.get(rootObj) as BaseSelector
-            sel.setName(rootObj.name + "." + it.name)
             sel.setBase(rootObj)
+            sel.setName(rootObj.name + "." + it.name)
+            sel.setAnnotations(it.annotations.toList())
             sel.freeze()
 
             if (sel is Block) {

src/main/kotlin/org/xpathqs/core/reflection/SelectorParser.kt

@@ -57,17 +57,17 @@ internal class SelectorReflection(
     /**
      * Set <pre>name</pre> field of the [obj]
      */
-    fun setName(value: String) = setProp("name", value)
+    fun setName(value: String) = setProp(BaseSelector::name.name, value)
 
     /**
      * Set <pre>base</pre> field of the [obj]
      */
-    fun setBase(value: ISelector) = setProp("base", value)
+    fun setBase(value: ISelector) = setProp(BaseSelector::base.name, value)
 
     /**
      * Set <pre>props</pre> field of the [obj]
      */
-    fun setProps(value: BaseSelectorProps) = setProp("props", value)
+    fun setProps(value: BaseSelectorProps) = setProp(BaseSelector::props.name, value)
 
     /**
      * Set <pre>props.args</pre> field of the [obj]
@@ -77,10 +77,17 @@ internal class SelectorReflection(
     /**
      * Mark [obj] as freeze
      */
-    fun freeze() = setProp("state", SelectorState.FREEZE)
+    fun freeze() = setProp(BaseSelector::state.name, SelectorState.FREEZE)
 
     /**
      * Mark [obj] as cloned
      */
-    fun cloned() = setProp("state", SelectorState.CLONED)
+    fun cloned() = setProp(BaseSelector::state.name, SelectorState.CLONED)
+
+    /**
+     * Set [BaseSelector.annotations] field of the [BaseSelector]
+     * @param annotations collection of annotation classes provided via reflection
+     */
+    fun setAnnotations(annotations: Collection<Annotation>)
+        = setProp(BaseSelector::annotations.name, annotations)
 }

src/main/kotlin/org/xpathqs/core/reflection/SelectorReflection.kt

@@ -30,6 +30,7 @@ import org.xpathqs.core.selector.NullSelector
  * @param base link to the root element
  * @param name name of the selector (used for logging purposes)
  * @param props properties for building xpath queries
+ * @param annotations list of annotations for selector
  */
 abstract class BaseSelector(
     internal val state: SelectorState = SelectorState.INIT,
@@ -38,6 +39,7 @@ abstract class BaseSelector(
     override val name: String = "",
 
     internal open val props: BaseSelectorProps = BaseSelectorProps(),
+    val annotations: Collection<Annotation> = emptyList()
 ) : ISelector {
 
     /**

src/main/kotlin/org/xpathqs/core/selector/base/BaseSelector.kt

@@ -56,6 +56,7 @@ fun <T : BaseSelector> T.deepClone(): T {
 
     newObj.setName(this.name)
     newObj.setBase(this.base)
+    newObj.setAnnotations(this.annotations)
     newObj.setProps(this.props.clone())
 
     newObj.cloned()

src/main/kotlin/org/xpathqs/core/selector/extensions/SelectorCoreExtensions.kt

@@ -0,0 +1,97 @@
+/*
+ * Copyright (c) 2021 Nikita A. Chegodaev
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package org.xpathqs.core.reflection
+
+import assertk.assertThat
+import assertk.assertions.hasSize
+import org.junit.jupiter.api.BeforeAll
+import org.junit.jupiter.api.Test
+import org.xpathqs.core.selector.Block
+import org.xpathqs.core.selector.extensions.get
+import org.xpathqs.core.util.SelectorFactory.tagSelector
+
+@Target(
+    AnnotationTarget.CLASS,
+    AnnotationTarget.FIELD
+)
+@Retention(AnnotationRetention.RUNTIME)
+annotation class TestAnnotation1
+
+@Target(
+    AnnotationTarget.CLASS,
+    AnnotationTarget.FIELD
+)
+@Retention(AnnotationRetention.RUNTIME)
+annotation class TestAnnotation2
+
+@TestAnnotation1
+object PageWithAnnotations : Block() {
+    @TestAnnotation2
+    val s1 = tagSelector()
+    val s2 = tagSelector()
+
+    @TestAnnotation2
+    @TestAnnotation1
+    val s3 = tagSelector()
+}
+
+class SelectorAnnotationsTest {
+
+    @Test
+    fun checkBlock() {
+        assertThat(PageWithAnnotations.annotations)
+            .hasSize(1)
+    }
+
+    @Test
+    fun checkSelector() {
+        assertThat(PageWithAnnotations.s1.annotations)
+            .hasSize(1)
+    }
+
+    @Test
+    fun checkSelectorWithoutAnnotation() {
+        assertThat(PageWithAnnotations.s2.annotations)
+            .hasSize(0)
+    }
+
+    @Test
+    fun checkSelectorWithTwoAnnotation() {
+        assertThat(PageWithAnnotations.s3.annotations)
+            .hasSize(2)
+    }
+
+    @Test
+    fun annotationsShouldBeCloned() {
+        assertThat(PageWithAnnotations.s3[2].annotations)
+            .hasSize(2)
+    }
+
+    companion object {
+        @JvmStatic
+        @BeforeAll
+        fun init() {
+            SelectorParser(PageWithAnnotations).parse()
+        }
+    }
+}

src/test/kotlin/org/xpathqs/core/reflection/SelectorAnnotationsTest.kt

@@ -25,11 +25,18 @@ package org.xpathqs.core.reflection
 import assertk.assertThat
 import assertk.assertions.containsExactlyInAnyOrder
 import org.junit.jupiter.api.Test
+import org.xpathqs.core.selector.base.BaseSelector
 import org.xpathqs.core.selector.selector.Selector
 
 internal class SelectorReflectionFieldsTest {
 
-    private val selectorFields = arrayOf("state", "base", "props", "name")
+    private val selectorFields = arrayOf(
+        BaseSelector::state.name,
+        BaseSelector::base.name,
+        BaseSelector::props.name,
+        BaseSelector::name.name,
+        BaseSelector::annotations.name,
+    )
 
     @Test
     fun declaredFieldsForSelector() {