def get_option_parser(): parser = COP(__doc__, jset=True, prep=True, icp=True) parser.add_option( "--strict", help="Fail any use of unsafe or experimental features. " "Currently this just means naked dummy tasks (tasks with no " "corresponding runtime section) as these may result from " "unintentional typographic errors in task names.", action="store_true", default=False, dest="strict") parser.add_option( "--output", "-o", help="Specify a file name to dump the processed flow.cylc.", metavar="FILENAME", action="store", dest="output") parser.add_option( "--profile", help="Output profiling (performance) information", action="store_true", default=False, dest="profile_mode") parser.add_option( "-u", "--run-mode", help="Validate for run mode.", action="store", default="live", dest="run_mode", choices=['live', 'dummy', 'dummy-local', 'simulation']) parser.set_defaults(is_validate=True) return parser
def get_option_parser(): parser = COP(__doc__, jset=True, prep=True, icp=True) parser.add_option( "--check-circular", help="Check for circular dependencies in graphs when the number of " "tasks is greater than 100 (smaller graphs are always checked). " "This can be slow when the number of " "tasks is high.", action="store_true", default=False, dest="check_circular") parser.add_option( "--output", "-o", help="Specify a file name to dump the processed flow.cylc.", metavar="FILENAME", action="store", dest="output") parser.add_option( "--profile", help="Output profiling (performance) information", action="store_true", default=False, dest="profile_mode") parser.add_option( "-u", "--run-mode", help="Validate for run mode.", action="store", default="live", dest="run_mode", choices=['live', 'dummy', 'dummy-local', 'simulation']) parser.set_defaults(is_validate=True) return parser
def get_option_parser(): parser = COP(__doc__, jset=True, icp=True, argdoc=[("REG", "Suite name"), ("TASK [...]", "Family or task ID (%s)" % TaskID.SYNTAX)]) parser.set_defaults(sched=False, dry_run=False) parser.add_option( "-d", "--dry-run", help="Generate the job script for the task, but don't submit it.", action="store_true", dest="dry_run") return parser
def get_option_parser(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, icp=True, jset=True, argdoc=[SUITE_NAME_ARG_DOC, START_POINT_ARG_DOC]) parser.add_option( "-n", "--no-detach", "--non-daemon", help="Do not daemonize the suite", action="store_true", 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", dest="no_auto_shutdown") parser.add_option( "--auto-shutdown", help="Shut down" " the suite automatically when all tasks have finished." " This flag overrides the corresponding suite config item.", action="store_false", dest="no_auto_shutdown") parser.add_option( "--profile", help="Output profiling (performance) information", action="store_true", 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-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", dest="ignore_icp") 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", dest="ignore_fcp") parser.add_option( "--ignore-start-cycle-point", help="Ignore the start cycle point in the suite run database.", action="store_true", dest="ignore_startcp") parser.add_option( "--ignore-stop-cycle-point", help="Ignore the stop cycle point in the suite run database.", action="store_true", dest="ignore_stopcp") parser.set_defaults(icp=None, startcp=None, warm=None) else: parser.add_option( "-w", "--warm", help="Warm start the suite. The default is to cold start.", action="store_true", dest="warm") parser.add_option( "--start-cycle-point", "--start-point", help=( "Set the start cycle point. Implies --warm." "(Not to be confused with the initial cycle point.)" ), metavar="CYCLE_POINT", action="store", dest="startcp") parser.add_option( "--final-cycle-point", "--final-point", "--until", "--fcp", help="Set the final cycle point.", metavar="CYCLE_POINT", action="store", dest="fcp") parser.add_option( "--stop-cycle-point", "--stop-point", help=( "Set stop point. " "Shut down after all tasks have PASSED this cycle point. " "(Not to be confused with the final cycle point.)" ), metavar="CYCLE_POINT", action="store", dest="stopcp") parser.add_option( "--hold", help="Hold suite immediately on starting.", action="store_true", dest="hold_start") parser.add_option( "--hold-point", "--hold-after", help=( "Set hold cycle point. " "Hold suite AFTER all tasks have PASSED this cycle point." ), metavar="CYCLE_POINT", action="store", dest="holdcp") parser.add_option( "-m", "--mode", help="Run mode: live, dummy, dummy-local, simulation (default live).", metavar="STRING", action="store", 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") # Override standard parser option for specific help description. parser.add_option( "--host", help=( "Specify the host on which to start-up the suite. " "If not specified, a host will be selected using " "the 'suite servers' global config." ), metavar="HOST", action="store", dest="host") parser.set_defaults(stop_point_string=None) return parser
def get_option_parser(is_restart, add_std_opts=False): """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, icp=True, jset=True, argdoc=[SUITE_NAME_ARG_DOC, START_POINT_ARG_DOC]) parser.add_option( "-n", "--no-detach", "--non-daemon", help="Do not daemonize the suite (infers --format=plain)", action="store_true", 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", dest="no_auto_shutdown") parser.add_option( "--auto-shutdown", help="Shut down" " the suite automatically when all tasks have finished." " This flag overrides the corresponding suite config item.", action="store_false", dest="no_auto_shutdown") parser.add_option("--profile", help="Output profiling (performance) information", action="store_true", 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-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", dest="ignore_icp") 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", dest="ignore_fcp") parser.add_option( "--ignore-start-cycle-point", help="Ignore the start cycle point in the suite run database.", action="store_true", dest="ignore_startcp") parser.add_option( "--ignore-stop-cycle-point", help="Ignore the stop cycle point in the suite run database.", action="store_true", dest="ignore_stopcp") parser.set_defaults(icp=None, startcp=None, warm=None, ignore_stopcp=None) else: parser.add_option( "-w", "--warm", help="Warm start the suite. The default is to cold start.", action="store_true", dest="warm") parser.add_option( "--start-cycle-point", "--start-point", help=("Set the start cycle point. Implies --warm." "(Not to be confused with the initial cycle point.)"), metavar="CYCLE_POINT", action="store", dest="startcp") parser.add_option("--final-cycle-point", "--final-point", "--until", "--fcp", help="Set the final cycle point.", metavar="CYCLE_POINT", action="store", dest="fcp") parser.add_option( "--stop-cycle-point", "--stop-point", help=("Set stop point. " "Shut down after all tasks have PASSED this cycle point. " "(Not to be confused with the final cycle point.)" "Adding this command line option over-rides the workflow" "config option [scheduling]stop after cycle point"), metavar="CYCLE_POINT", action="store", dest="stopcp") parser.add_option("--hold", help="Hold suite immediately on starting.", action="store_true", dest="hold_start") parser.add_option( "--hold-point", "--hold-after", help=("Set hold cycle point. " "Hold suite AFTER all tasks have PASSED this cycle point."), metavar="CYCLE_POINT", action="store", dest="holdcp") parser.add_option( "-m", "--mode", help="Run mode: live, dummy, dummy-local, simulation (default live).", metavar="STRING", action="store", 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") # Override standard parser option for specific help description. parser.add_option("--host", help=("Specify the host on which to start-up the suite. " "If not specified, a host will be selected using " "the 'suite servers' global config."), metavar="HOST", action="store", dest="host") parser.add_option( "--format", help="The format of the output: 'plain'=human readable, 'json'", choices=("plain", "json"), default="plain") parser.add_option( "--main-loop", help=("Specify an additional plugin to run in the main loop." " These are used in combination with those specified in" " [cylc][main loop]plugins. Can be used multiple times"), metavar="PLUGIN_NAME", action="append", dest="main_loop") parser.add_option( "--abort-if-any-task-fails", help="If set workflow will abort with status 1 if any task fails.", action="store_true", default=False, dest="abort_if_any_task_fails") parser.set_defaults(stop_point_string=None) if add_std_opts: # This is for the API wrapper for integration tests. Otherwise (CLI # use) "standard options" are added later in options.parse_args(). # They should really be added in options.__init__() but that requires a # bit of refactoring because option clashes are handled bass-ackwards # ("overrides" are added before standard options). parser.add_std_options() return parser