aboutsummaryrefslogtreecommitdiff
path: root/bdep/ci.cli
diff options
context:
space:
mode:
Diffstat (limited to 'bdep/ci.cli')
-rw-r--r--bdep/ci.cli18
1 files changed, 18 insertions, 0 deletions
diff --git a/bdep/ci.cli b/bdep/ci.cli
index 8befd82..a45828c 100644
--- a/bdep/ci.cli
+++ b/bdep/ci.cli
@@ -79,6 +79,12 @@ namespace bdep
hierarchically so that the \cb{build-{include,exclude\}} overrides don't
affect the \cb{builds} values.
+ If supported by the CI service, a package can be tested interactively
+ in a specific build configuration using the \c{\b{--interactive}|\b{-i}}
+ option. In this mode the CI service provides the login information for
+ the execution environment and pauses the testing at the specified
+ breakpoint.
+
While the exact interpretation of the CI request depends on the specific
service, normally, the CI server will respond with a reference that can
be used to query the results. See \l{brep#ci Package CI} for details on
@@ -95,6 +101,18 @@ namespace bdep
"Don't prompt for confirmation before submitting."
}
+ string --interactive|-i
+ {
+ "<cf>[/<bp>]",
+ "Test the package interactively in the specified build configuration,
+ pausing the execution at the specified breakpoint. Valid breakpoint
+ values are \cb{error} (stop after first error), \cb{warning} (stop
+ after first warning), as well as the CI service-specific step ids
+ in which case the execution stops before performing the specified
+ step (see \l{bbot#arch-worker \cb{bbot} worker step ids}). If no
+ breakpoint is specified, then \cb{error} is assumed."
+ }
+
url --server
{
"<url>",