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/CliException.kt

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

src/commonMain/kotlin/com/infendro/cli/exception/build/ArgumentOrderException.kt

@@ -1,3 +0,0 @@
-package com.infendro.cli.exception.build
-
-class ArgumentOrderException : Exception()

src/commonMain/kotlin/com/infendro/cli/exception/build/BuildException.kt

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

src/commonMain/kotlin/com/infendro/cli/exception/build/DuplicateCommand.kt

@@ -0,0 +1,5 @@
+package com.infendro.cli.exception.build
+
+class DuplicateCommand(
+    val command: String,
+) : BuildException()

src/commonMain/kotlin/com/infendro/cli/exception/build/DuplicateCommandException.kt

@@ -1,5 +0,0 @@
-package com.infendro.cli.exception.build
-
-class DuplicateCommandException(
-    val command: String?,
-) : Exception()

src/commonMain/kotlin/com/infendro/cli/exception/build/DuplicateExecute.kt

@@ -1,3 +1,3 @@
 package com.infendro.cli.exception.build
 
-class CommandOrderException : Exception()
+class DuplicateExecute : BuildException()

src/commonMain/kotlin/com/infendro/cli/exception/build/DuplicateExecuteException.kt

@@ -1,3 +0,0 @@
-package com.infendro.cli.exception.build
-
-class DuplicateExecuteException : Exception()

src/commonMain/kotlin/com/infendro/cli/exception/build/DuplicateOption.kt

@@ -1,5 +1,5 @@
 package com.infendro.cli.exception.build
 
-class DuplicateOptionException(
+class DuplicateOption(
     val name: String,
-) : Exception()
+) : BuildException()

src/commonMain/kotlin/com/infendro/cli/exception/build/InvalidArgument.kt

@@ -1,5 +1,5 @@
 package com.infendro.cli.exception.build
 
-class IllegalOptionNameException(
+class InvalidArgument(
     val name: String,
-) : Exception()
+) : BuildException()

src/commonMain/kotlin/com/infendro/cli/exception/build/InvalidArgumentOrder.kt

@@ -0,0 +1,3 @@
+package com.infendro.cli.exception.build
+
+class InvalidArgumentOrder : BuildException()

src/commonMain/kotlin/com/infendro/cli/exception/build/InvalidCommand.kt

@@ -1,5 +1,5 @@
 package com.infendro.cli.exception.build
 
-class IllegalCommandNameException(
+class InvalidCommand(
     val name: String,
-) : Exception()
+) : BuildException()

src/commonMain/kotlin/com/infendro/cli/exception/build/InvalidCommandOrder.kt

@@ -0,0 +1,3 @@
+package com.infendro.cli.exception.build
+
+class InvalidCommandOrder : BuildException()

src/commonMain/kotlin/com/infendro/cli/exception/build/InvalidFallback.kt

@@ -0,0 +1,3 @@
+package com.infendro.cli.exception.build
+
+class InvalidFallback : BuildException()

src/commonMain/kotlin/com/infendro/cli/exception/build/InvalidFallbackException.kt

@@ -1,3 +0,0 @@
-package com.infendro.cli.exception.build
-
-class InvalidFallbackException : Exception()

src/commonMain/kotlin/com/infendro/cli/exception/build/InvalidOption.kt

@@ -0,0 +1,5 @@
+package com.infendro.cli.exception.build
+
+class InvalidOption(
+    val name: String,
+) : BuildException()

src/commonMain/kotlin/com/infendro/cli/exception/build/InvalidRange.kt

@@ -0,0 +1,3 @@
+package com.infendro.cli.exception.build
+
+class InvalidRange : BuildException()

src/commonMain/kotlin/com/infendro/cli/exception/build/MissingOptionName.kt

@@ -0,0 +1,3 @@
+package com.infendro.cli.exception.build
+
+class MissingOptionName : BuildException()

src/commonMain/kotlin/com/infendro/cli/exception/build/MissingOptionNameException.kt

@@ -1,3 +0,0 @@
-package com.infendro.cli.exception.build
-
-class MissingOptionNameException : Exception()

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""""
 }