guidellm.schemas.scheduler.constraints.request

@ConstraintArgs.register("max_duration")
class MaxDurationConstraintArgs(ConstraintArgs):
    """
    Arguments for maximum duration constraint.

    Limits benchmark execution time per strategy.

    :cvar kind: Always "max_duration"
    """

    kind: Literal["max_duration"] = Field(
        default="max_duration",
        description="Constraint type discriminator",
    )
    seconds: PositiveNumOrList = Field(
        description="Maximum duration in seconds before stopping execution",
    )

@ConstraintArgs.register("max_requests")
class MaxRequestsConstraintArgs(ConstraintArgs):
    """
    Arguments for maximum request count constraint.

    Limits the number of requests processed per strategy.

    :cvar kind: Always "max_requests"
    """

    kind: Literal["max_requests"] = Field(
        default="max_requests",
        description="Constraint type discriminator",
    )
    count: PositiveNumOrList = Field(
        description="Maximum number of requests before stopping execution",
    )

@ConstraintArgs.register("min_requests")
class MinRequestsConstraintArgs(ConstraintArgs):
    """
    Arguments for minimum processed request count constraint.

    Stops execution once the given number of requests have been processed.
    Unlike ``max_requests``, queuing continues until processing reaches the
    limit, which avoids throughput tail-off at the end of a benchmark.

    :cvar kind: Always "min_requests"
    """

    kind: Literal["min_requests"] = Field(
        default="min_requests",
        description="Constraint type discriminator",
    )
    count: PositiveNumOrList = Field(
        description="Number of processed requests required before stopping execution",
    )