Add support for java.time.Duration

docs/args.md

@@ -74,6 +74,10 @@ Args.integer(name)
 
 ### Date/Time Args
 The following methods produce `Args` whose type parameter is a Date/Time type of the `java.time` library.
+- Produces `Args[java.time.Duration]`. The input must be a time-based amount of time in the ISO-8601 format, such as 'P1DT2H3M'.
+```scala mdoc:silent
+Args.duration(name)
+```
 - Produces `Args[java.time.Instant]`. The input must be an instant in time in UTC format, such as 2007-12-03T10:15:30.00Z.
 ```scala mdoc:silent
 Args.instant(name)

docs/options.md

@@ -85,6 +85,10 @@ Options.integer(name)
 
 ### Date/Time Options
 The following methods produce `Options` whose type parameter is a Date/Time type of the `java.time` library.
+- Produces `Options[java.time.Duration]`. The input must be a time-based amount of time in the ISO-8601 format, such as 'P1DT2H3M'.
+```scala mdoc:silent
+Options.duration(name)
+```
 - Produces `Options[java.time.Instant]`. The input must be an instant in time in UTC format, such as 2007-12-03T10:15:30.00Z.
 ```scala mdoc:silent
 Options.instant(name)

zio-cli/jvm/src/test/scala/zio/cli/PrimTypeSpec.scala

@@ -125,6 +125,7 @@ object PrimTypeSpec extends ZIOSpecDefault {
       Gen.bigDecimal(BigDecimal("1.41421356237309504880168"), BigDecimal("50.4")),
       "BigDecimal"
     ),
+    simplePrimTypeSuite(PrimType.Duration, anyDuration, "Duration"),
     simplePrimTypeSuite(PrimType.Integer, anyBigInt, "Integer"),
     simplePrimTypeSuite(PrimType.Instant, Gen.instant, "Instant"),
     simplePrimTypeSuite(PrimType.LocalDateTime, anyLocalDateTime, "LocalDateTime"),
@@ -180,6 +181,7 @@ object PrimTypeSpec extends ZIOSpecDefault {
   val anyBigInt: Gen[Any, BigInt] = Gen.long(0, Long.MaxValue).map(BigInt(_))
   val anyBoolean: Gen[Any, Boolean] =
     Gen.fromIterable(List(true, false))
+  val anyDuration = Gen.finiteDuration
   val anyInstant = Gen.instant.map(_.atZone(ZoneOffset.UTC))
   val anyPeriod = for {
     first  <- Gen.localDateTime.map(_.toLocalDate)

zio-cli/shared/src/main/scala/zio/cli/Args.scala

@@ -4,6 +4,7 @@ import zio._
 import zio.cli.HelpDoc.{Span, p}
 
 import java.time.{
+  Duration => JDuration,
   Instant => JInstant,
   LocalDate => JLocalDate,
   LocalDateTime => JLocalDateTime,
@@ -325,6 +326,23 @@ object Args extends ArgsPlatformSpecific {
   val decimal: Args[BigDecimal] =
     Single(None, PrimType.Decimal)
 
+  /**
+   * Creates a duration argument with a custom argument name
+   *
+   * @param name
+   *   Argument name
+   * @return
+   *   Duration argument
+   */
+  def duration(name: String): Args[JDuration] =
+    Single(Some(name), PrimType.Duration)
+
+  /**
+   * Creates a duration argument with 'duration' as argument name
+   */
+  val duration: Args[JDuration] =
+    Single(None, PrimType.Duration)
+
   /**
    * Creates an integer argument with a custom argument name
    *

zio-cli/shared/src/main/scala/zio/cli/Options.scala

@@ -6,6 +6,7 @@ import zio.{IO, UIO, ZIO, Zippable}
 import zio.cli.oauth2._
 
 import java.time.{
+  Duration => JDuration,
   Instant => JInstant,
   LocalDate => JLocalDate,
   LocalDateTime => JLocalDateTime,
@@ -811,6 +812,12 @@ object Options extends OptionsPlatformSpecific {
   def decimal(name: String): Options[BigDecimal] =
     Single(name, Vector.empty, PrimType.Decimal)
 
+  /**
+   * Creates a parameter excepting a date-based amount of time in the ISO-8601 format, such as 'P1DT2H3M'.
+   */
+  def duration(name: String): Options[JDuration] =
+    Single(name, Vector.empty, PrimType.Duration)
+
   /**
    * Creates a parameter expecting an integer.
    */

zio-cli/shared/src/main/scala/zio/cli/PrimType.scala

@@ -5,6 +5,7 @@ import zio.cli.HelpDoc.Span.text
 import zio.cli.files.FileSystem
 
 import java.time.{
+  Duration => JDuration,
   Instant => JInstant,
   LocalDate => JLocalDate,
   LocalDateTime => JLocalDateTime,
@@ -205,6 +206,23 @@ object PrimType extends PathPlatformSpecific {
     lazy val FalseValues: Set[String] = Set("false", "0", "n", "no", "off")
   }
 
+  /**
+   * Type representing a time-based amount of time in the ISO-8601 format, such as 'P1DT2H3M'.
+   */
+  case object Duration extends PrimType[JDuration] { self =>
+    lazy val isBool: Boolean = false
+
+    lazy val typeName: String = "duration"
+
+    lazy val choices: Option[String] = None
+
+    def validate(value: Option[String], conf: CliConfig): IO[String, JDuration] =
+      attempt(value, JDuration.parse, self.typeName)
+
+    lazy val helpDoc: HelpDoc.Span =
+      text("A time-based amount of time in the ISO-8601 format, such as 'P1DT2H3M'.")
+  }
+
   /**
    * Type representing parameter for instant in time in UTC format, such as 2007-12-03T10:15:30.00Z.
    */

zio-cli/shared/src/main/scala/zio/cli/completion/PrimTypeCompletion.scala

@@ -14,6 +14,8 @@ object PrimTypeCompletion {
         ZIO.succeed(Set("true", "false").filter(_.startsWith(prefix))).map(appendSpaces)
       case PrimType.Decimal =>
         ZIO.succeed(Set.empty)
+      case PrimType.Duration =>
+        ZIO.succeed(Set.empty)
       case PrimType.Enumeration(cases @ _*) =>
         ZIO
           .succeed(cases.collect {