def ws_cli(service_cls, service_docstr, *args, **kwargs):
"""Parse command line, start/stop ad-hoc server.
service_cls - Class to launch web service. Must have the constants
service_cls.NS and service_cls.UTIL. *args and **kwargs are
passed to its constructor.
"""
parser = COP(service_docstr,
argdoc=[("[start [PORT]]",
"Start ad-hoc web service server."),
("[stop]", "Stop ad-hoc web service server.")])
parser.add_option(
"--non-interactive",
"--yes",
"-y",
help="Switch off interactive prompting i.e. answer yes to everything"
" (for stop only).",
action="store_true",
default=False,
dest="non_interactive")
parser.add_option(
"--service-root",
"-R",
help="Include web service name under root of URL (for start only).",
action="store_true",
default=False,
dest="service_root_mode")
opts, args = parser.parse_args(
remove_opts=['--host', '--user', '--verbose', '--debug'])
arg = None
if args:
arg = args[0]
status = _get_server_status(service_cls)
if arg == "start":
port = None
if args[1:]:
port = args[1]
_ws_init(service_cls, port, opts.service_root_mode, *args, **kwargs)
elif not status:
print "No %s service server running." % service_cls.TITLE
else:
for key, value in sorted(status.items()):
print "%s=%s" % (key, value)
if (arg == "stop" and status.get("pid") and
(opts.non_interactive
or raw_input("Stop server via termination? y/n (default=n)")
== "y")):
try:
os.killpg(int(status["pid"]), signal.SIGTERM)
except OSError:
print "Termination signal failed."
def parse_commandline(is_restart):
"""Parse CLI for "cylc run" or "cylc restart"."""
if is_restart:
parser = COP(RESTART_DOC, jset=True, argdoc=[SUITE_NAME_ARG_DOC])
else:
parser = COP(
RUN_DOC, jset=True,
argdoc=[SUITE_NAME_ARG_DOC, START_POINT_ARG_DOC])
parser.add_option(
"--non-daemon", help="(deprecated: use --no-detach)",
action="store_true", default=False, dest="no_detach")
parser.add_option(
"-n", "--no-detach", help="Do not daemonize the suite",
action="store_true", default=False, dest="no_detach")
parser.add_option(
"-a", "--no-auto-shutdown", help="Do not shut down"
" the suite automatically when all tasks have finished."
" This flag overrides the corresponding suite config item.",
action="store_true", default=False, dest="no_auto_shutdown")
parser.add_option(
"--profile", help="Output profiling (performance) information",
action="store_true", default=False, dest="profile_mode")
if is_restart:
parser.add_option(
"--checkpoint",
help="Specify the ID of a checkpoint to restart from",
metavar="CHECKPOINT-ID", action="store", dest="checkpoint")
parser.add_option(
"--ignore-final-cycle-point",
help=(
"Ignore the final cycle point in the suite run database. " +
"If one is specified in the suite definition it will " +
"be used, however."),
action="store_true", default=False, dest="ignore_stop_point")
parser.add_option(
"--ignore-initial-cycle-point",
help=(
"Ignore the initial cycle point in the suite run database. " +
"If one is specified in the suite definition it will " +
"be used, however."),
action="store_true", default=False, dest="ignore_start_point")
else:
parser.add_option(
"-w", "--warm",
help="Warm start the suite. "
"The default is to cold start.",
action="store_true", default=False, dest="warm")
parser.add_option(
"--ict",
help="Does nothing, option for backward compatibility only",
action="store_true", default=False, dest="set_ict")
parser.add_option(
"--until",
help=("Shut down after all tasks have PASSED " +
"this cycle point."),
metavar="CYCLE_POINT", action="store", dest="final_point_string")
parser.add_option(
"--hold",
help="Hold (don't run tasks) immediately on starting.",
action="store_true", default=False, dest="start_held")
parser.add_option(
"--hold-after",
help="Hold (don't run tasks) AFTER this cycle point.",
metavar="CYCLE_POINT", action="store", dest="hold_point_string")
parser.add_option(
"-m", "--mode",
help="Run mode: live, dummy, dummy-local, simulation (default live).",
metavar="STRING", action="store", default='live', dest="run_mode",
choices=["live", "dummy", "dummy-local", "simulation"])
parser.add_option(
"--reference-log",
help="Generate a reference log for use in reference tests.",
action="store_true", default=False, dest="genref")
parser.add_option(
"--reference-test",
help="Do a test run against a previously generated reference log.",
action="store_true", default=False, dest="reftest")
parser.add_option(
"--source", "-S",
help="Specify the suite source.",
metavar="SOURCE", action="store", dest="source")
options, args = parser.parse_args()
if not is_restart and options.warm and len(args) < 2:
# Warm start must have a start point
sys.exit(parser.get_usage())
return options, args
def parse_commandline(is_restart):
"""Parse CLI for "cylc run" or "cylc restart"."""
if is_restart:
parser = COP(RESTART_DOC, jset=True, argdoc=[SUITE_NAME_ARG_DOC])
else:
parser = COP(
RUN_DOC, jset=True,
argdoc=[SUITE_NAME_ARG_DOC, START_POINT_ARG_DOC])
parser.add_option(
"--non-daemon", help="(deprecated: use --no-detach)",
action="store_true", default=False, dest="no_detach")
parser.add_option(
"-n", "--no-detach", help="Do not daemonize the suite",
action="store_true", default=False, dest="no_detach")
parser.add_option(
"-a", "--no-auto-shutdown", help="Do not shut down"
" the suite automatically when all tasks have finished."
" This flag overrides the corresponding suite config item.",
action="store_true", default=False, dest="no_auto_shutdown")
parser.add_option(
"--profile", help="Output profiling (performance) information",
action="store_true", default=False, dest="profile_mode")
if is_restart:
parser.add_option(
"--checkpoint",
help="Specify the ID of a checkpoint to restart from",
metavar="CHECKPOINT-ID", action="store", dest="checkpoint")
parser.add_option(
"--ignore-final-cycle-point",
help=(
"Ignore the final cycle point in the suite run database. " +
"If one is specified in the suite definition it will " +
"be used, however."),
action="store_true", default=False, dest="ignore_stop_point")
parser.add_option(
"--ignore-initial-cycle-point",
help=(
"Ignore the initial cycle point in the suite run database. " +
"If one is specified in the suite definition it will " +
"be used, however."),
action="store_true", default=False, dest="ignore_start_point")
else:
parser.add_option(
"-w", "--warm",
help="Warm start the suite. "
"The default is to cold start.",
action="store_true", default=False, dest="warm")
parser.add_option(
"--ict",
help="Does nothing, option for backward compatibility only",
action="store_true", default=False, dest="set_ict")
parser.add_option(
"--until",
help=("Shut down after all tasks have PASSED " +
"this cycle point."),
metavar="CYCLE_POINT", action="store", dest="final_point_string")
parser.add_option(
"--hold",
help="Hold (don't run tasks) immediately on starting.",
action="store_true", default=False, dest="start_held")
parser.add_option(
"--hold-after",
help="Hold (don't run tasks) AFTER this cycle point.",
metavar="CYCLE_POINT", action="store", dest="hold_point_string")
parser.add_option(
"-m", "--mode",
help="Run mode: live, dummy, dummy-local, simulation (default live).",
metavar="STRING", action="store", default='live', dest="run_mode",
choices=["live", "dummy", "dummy-local", "simulation"])
parser.add_option(
"--reference-log",
help="Generate a reference log for use in reference tests.",
action="store_true", default=False, dest="genref")
parser.add_option(
"--reference-test",
help="Do a test run against a previously generated reference log.",
action="store_true", default=False, dest="reftest")
parser.add_option(
"--source", "-S",
help="Specify the suite source.",
metavar="SOURCE", action="store", dest="source")
options, args = parser.parse_args()
if not is_restart and options.warm and len(args) < 2:
# Warm start must have a start point
sys.exit(parser.get_usage())
return options, args