implement optional variable argument/option ranges, refactor exception handling

adapt required/optional argument handling
implement bounded/unbounded variable argument handling

src/commonMain/kotlin/com/infendro/cli/exception/run/CliException.kt

@@ -1,3 +0,0 @@
-package com.infendro.cli.exception.run
-
-abstract class CliException : Exception()

src/commonMain/kotlin/com/infendro/cli/exception/run/DuplicateOptionException.kt

@@ -1,8 +0,0 @@
-package com.infendro.cli.exception.run
-
-class DuplicateOptionException(
-    val option: String,
-) : CliException() {
-    override val message: String
-        get() = """duplicate option "$option""""
-}

src/commonMain/kotlin/com/infendro/cli/exception/run/ExecuteException.kt

@@ -1,5 +0,0 @@
-package com.infendro.cli.exception.run
-
-class ExecuteException(
-    override val message: String,
-) : CliException()

src/commonMain/kotlin/com/infendro/cli/exception/run/InvalidArgumentCount.kt

@@ -0,0 +1,18 @@
+package com.infendro.cli.exception.run
+
+import com.infendro.cli.command.Argument
+
+class InvalidArgumentCount(
+    val argument: Argument<*>,
+    val count: Int,
+) : RunException() {
+    override val message: String
+        get() {
+            val expected = when {
+                argument.min == argument.max -> "${argument.min}"
+                argument.unbounded -> "at least ${argument.min}"
+                else -> "${argument.min} to ${argument.max}"
+            }
+            return """invalid number of values for argument "${argument.name}": expected $expected but found $count"""
+        }
+}

src/commonMain/kotlin/com/infendro/cli/exception/run/InvalidOptionCount.kt

@@ -0,0 +1,18 @@
+package com.infendro.cli.exception.run
+
+import com.infendro.cli.command.Option
+
+class InvalidOptionCount(
+    val option: Option<*>,
+    val count: Int,
+) : RunException() {
+    override val message: String
+        get() {
+            val expected = when {
+                option.min == option.max -> "${option.min}"
+                option.unbounded -> "at least ${option.min}"
+                else -> "${option.min} to ${option.max}"
+            }
+            return """invalid number of values passed for option "${option.name}": expected $expected but found $count"""
+        }
+}

src/commonMain/kotlin/com/infendro/cli/exception/run/InvalidValue.kt

@@ -0,0 +1,11 @@
+package com.infendro.cli.exception.run
+
+import kotlin.reflect.KClass
+
+class InvalidValue(
+    val value: String,
+    val type: KClass<*>,
+) : RunException() {
+    override val message: String
+        get() = """"$value" cannot be converted to ${type.simpleName}"""
+}

src/commonMain/kotlin/com/infendro/cli/exception/run/MalformedOption.kt

@@ -1,8 +1,8 @@
 package com.infendro.cli.exception.run
 
-class MalformedOptionException(
+class MalformedOption(
     val option: String,
-) : CliException() {
+) : RunException() {
     override val message: String
         get() = """malformed option "$option""""
 }

src/commonMain/kotlin/com/infendro/cli/exception/run/MissingArgumentException.kt

@@ -1,6 +0,0 @@
-package com.infendro.cli.exception.run
-
-class MissingArgumentException : CliException() {
-    override val message: String
-        get() = """missing argument"""
-}

src/commonMain/kotlin/com/infendro/cli/exception/run/MissingOptionException.kt

@@ -1,8 +0,0 @@
-package com.infendro.cli.exception.run
-
-class MissingOptionException(
-    val option: String,
-) : CliException() {
-    override val message: String
-        get() = """missing option "$option""""
-}

src/commonMain/kotlin/com/infendro/cli/exception/run/MissingOptionValue.kt

@@ -0,0 +1,10 @@
+package com.infendro.cli.exception.run
+
+import com.infendro.cli.command.Option
+
+class MissingOptionValue(
+    val option: Option<*>,
+) : RunException() {
+    override val message: String
+        get() = """no value provided for option "${option.name}""""
+}

src/commonMain/kotlin/com/infendro/cli/exception/run/MissingOptionValueException.kt

@@ -1,8 +0,0 @@
-package com.infendro.cli.exception.run
-
-class MissingOptionValueException(
-    val option: String,
-) : CliException() {
-    override val message: String
-        get() = """no value provided for option "$option""""
-}

src/commonMain/kotlin/com/infendro/cli/exception/run/ParseException.kt

@@ -1,9 +0,0 @@
-package com.infendro.cli.exception.run
-
-class ParseException(
-    val text: String?,
-    val type: String,
-) : CliException() {
-    override val message: String
-        get() = """"$text" cannot be converted to $type"""
-}

src/commonMain/kotlin/com/infendro/cli/exception/run/RunException.kt

@@ -0,0 +1,5 @@
+package com.infendro.cli.exception.run
+
+import com.infendro.cli.exception.CliException
+
+abstract class RunException : CliException()

src/commonMain/kotlin/com/infendro/cli/exception/run/TooManyArgumentsException.kt

@@ -1,6 +0,0 @@
-package com.infendro.cli.exception.run
-
-class TooManyArgumentsException : CliException() {
-    override val message: String
-        get() = """too many arguments"""
-}

src/commonMain/kotlin/com/infendro/cli/exception/run/UnexpectedArgument.kt

@@ -0,0 +1,6 @@
+package com.infendro.cli.exception.run
+
+class UnexpectedArgument : RunException() {
+    override val message: String
+        get() = """unexpected argument"""
+}

src/commonMain/kotlin/com/infendro/cli/exception/run/UnknownCommand.kt

@@ -1,8 +1,8 @@
 package com.infendro.cli.exception.run
 
-class UnknownCommandException(
+class UnknownCommand(
     val command: String,
-) : CliException() {
+) : RunException() {
     override val message: String
         get() = """unknown command "$command""""
 }

src/commonMain/kotlin/com/infendro/cli/exception/run/UnknownOption.kt

@@ -1,8 +1,8 @@
 package com.infendro.cli.exception.run
 
-class UnknownOptionException(
+class UnknownOption(
     val option: String,
-) : CliException() {
+) : RunException() {
     override val message: String
         get() = """unknown option "$option""""
 }