implements runByBuilder & dslMarker for explicit receiver and hightlighting

Author: skydoves

README.md

@@ -24,7 +24,7 @@ An easy way to persistence and run block codes only as many times as necessary o
 And add a dependency code to your **module**'s `build.gradle` file.
 ```gradle
 dependencies {
-    implementation "com.github.skydoves:only:1.0.0"
+    implementation "com.github.skydoves:only:1.0.1"
 }
 ```
 

dependencies.gradle

@@ -1,8 +1,8 @@
 ext.versions = [
     minSdk             : 15,
     compileSdk         : 29,
-    versionCode        : 1,
-    versionName        : '1.0.0',
+    versionCode        : 2,
+    versionName        : '1.0.1',
 
     gradleBuildTool    : '3.4.1',
     spotlessGradle     : '3.22.0',

only/src/main/java/com/skydoves/only/Only.kt

@@ -27,23 +27,26 @@ import androidx.annotation.VisibleForTesting
 annotation class OnlyDsl
 
 /** Run [Only] by [Only.Builder] using kotlin dsl. */
+@OnlyDsl
 fun only(name: String, times: Int, block: Only.Builder.() -> Unit): Unit =
   Only.Builder(name, times).apply(block).run()
 
 /** Run only once [Only] by [Only.Builder] using kotlin dsl. */
+@OnlyDsl
 fun onlyOnce(name: String, times: Int = 1, block: Only.Builder.() -> Unit): Unit =
   Only.Builder(name, times).apply(block).run()
 
 /** Run only twice [Only] by [Only.Builder] using kotlin dsl. */
+@OnlyDsl
 fun onlyTwice(name: String, times: Int = 2, block: Only.Builder.() -> Unit): Unit =
   Only.Builder(name, times).apply(block).run()
 
 /** Run only thrice [Only] by [Only.Builder] using kotlin dsl. */
+@OnlyDsl
 fun onlyThrice(name: String, times: Int = 3, block: Only.Builder.() -> Unit): Unit =
   Only.Builder(name, times).apply(block).run()
 
 /** Easy way to run block codes only as many times as necessary. */
-@OnlyDsl
 object Only {
 
   @JvmStatic
@@ -70,6 +73,11 @@ object Only {
     return this@Only
   }
 
+  /** run onDo using [Only.Builder]. */
+  private fun runByBuilder(builder: Builder) {
+    onDo(builder.name, builder.times, builder.onDo, builder.onDone, builder.version)
+  }
+
   /** check debugging mode. */
   fun onlyOnDoDebugMode(ignore: Boolean): Only {
     this.doOnDebugMode = ignore
@@ -238,9 +246,10 @@ object Only {
   }
 
   /** Builder class for creating [Only]. */
+  @OnlyDsl
   class Builder(
-    private val name: String,
-    private val times: Int = 1
+    val name: String,
+    val times: Int = 1
   ) {
 
     @JvmField
@@ -255,7 +264,7 @@ object Only {
     fun version(version: String): Builder = apply { this.version = version }
 
     fun run() {
-      onDo(name, times, onDo, onDone, version)
+      Only.runByBuilder(this@Builder)
     }
   }
 }