services: validate-reinstall by oliver-sanders · Pull Request #746 · cylc/cylc-uiserver

oliver-sanders · 2025-10-29T11:47:36Z

Closes #526

I somehow forgot that we have cylc vr support in the Tui, but not the GUI!

Trivial to add support. Supporting the cylc install command is also possible, however, that will require #512.

Check List

I have read CONTRIBUTING.md and added my name as a Code Contributor.
Contains logically grouped changes (else tidy your branch by rebase).
Does not contain off-topic changes (use other PRs for other changes).
Applied any dependency changes to both setup.cfg (and conda-environment.yml if present).
Tests are included (or explain why tests are not needed).
Changelog entry included if this is a change that can affect users
Cylc-Doc pull request opened if required at cylc/cylc-doc/pull/XXXX.
If this is a bug fix, PR should be raised against the relevant ?.?.x branch.

oliver-sanders · 2025-10-30T15:32:17Z

        args: Dict[str, Any],
-        workflows_mgr: 'WorkflowsManager',
        log: 'Logger',
-    ) -> List[Union[bool, str]]:


Changed from list[bool | str] to tuple[bool, str] as this is safer for the way we are trying to use it (('msg', False) would have been acceptable before).

oliver-sanders · 2025-10-30T15:32:49Z

+                try:
+                    ret_code = proc.wait(timeout=timeout)
+                except TimeoutExpired as exc:
+                    proc.kill()
+                    ret_code = 124  # mimic `timeout` command error code
+                    # NOTE: preserve any stderr that the command produced this
+                    # far as this may help with debugging
+                    out, err = proc.communicate()
+                    err = str(exc) + (('\n' + err) if err else '')


So, it turns out this timeout logic was bunk. You have to actually .kill() to process if you want it to stop.

https://docs.python.org/3/library/subprocess.html#subprocess.Popen.communicate

Additionally, this will now log the command's stderr which might be useful in the event of a timeout.

oliver-sanders · 2025-10-30T15:34:22Z


        if command == 'clean':  # noqa: SIM116
            return await Services.clean(
+                self.workflows_mgr,


Switched arg order for consistency.

oliver-sanders · 2025-10-30T16:01:39Z

FYI: style tests will fail until #748

wxtim

Read Code
Tried in practice.

n.b. I think that VR should be on the shortened list of commands, but that's a Cylc UI change

oliver-sanders · 2025-11-03T16:09:35Z

n.b. I think that VR should be on the shortened list of commands, but that's a Cylc UI change

There'll be a cylc-ui and cylc-doc counterpart.

oliver-sanders · 2025-11-03T16:31:29Z

@wxtim, since last review:

Fixed tests (hopefully)
Added support for the "global" option (BoM might want to use this)

* The `reload` mutation isn't the most helpful command post `cylc install`. * Swap it out in the workflow command shortlist for the [newly added](cylc/cylc-uiserver#746) `validateReinstall` mutation which has wider scope.

oliver-sanders · 2025-11-05T13:00:16Z

(drafting whilst I look at how hard it will be to combine ALL play and reload opts)

* Closes cylc#526 * Add basic support for the `cylc vr` command.

* We were applying a timeout to the `Popen.wait` method, however, this doesn't actually kill the process (as one might expect) when the timeout elapses, it just stops waiting for it?!

oliver-sanders

This is now the "full" solution which should support all relevant usages/args.

Reviewers, please give attention to the newly-added arguments to ensure they are working as intended:

https://github.com/cylc/cylc-uiserver/pull/746/changes#r2833158708

oliver-sanders · 2026-02-20T13:17:44Z

+                Set the Cylc version that the workflow starts with.
+            ''')
+        )
+        # cylc-rose


Cylc-rose arguments (all new):

opt_conf_key

clear_rose_install_options

define

rose_template_variable

oliver-sanders · 2026-02-20T13:18:49Z

+        ''')
+        resolver = partial(mutator, command='validate_reinstall')
+
+    class Arguments(Reinstall.Arguments, Reload.Arguments):


Reload arguments (all new):

reload_global

* The `reload` mutation isn't the most helpful command post `cylc install`. * Swap it out in the workflow command shortlist for the [newly added](cylc/cylc-uiserver#746) `validateReinstall` mutation which has wider scope.

MetRonnie

I tried adding opt conf keys in the command form but they were not passed to the cylc reinstall command

MetRonnie · 2026-02-24T12:09:52Z

+        cylc_version = CylcVersion(
+            description=sstrip('''
+                Set the Cylc version that the workflow starts with.
+            ''')
+        )


I don't think this applies to reinstall, surely?

Suggested change

cylc_version = CylcVersion(

description=sstrip('''

Set the Cylc version that the workflow starts with.

''')

)

It is implemented for all commands, see def run_command.

But why? I can't see the need to do this for reinstall?

It's not just for reinstall (which isn't actually implemented), the cylc vr command will also (re)start a stopped workflow, so the CYLC_VERSION argument is just as important here as for the Play mutation.

But vr/ReinstallReload inherits Play's options which includes cylc_version

oliver-sanders · 2026-02-25T13:13:49Z

https://github.com/cylc/cylc-uiserver/compare/2dbceab899de0bdcef9b5a097c2d364dc4781ea0..57b44ec5ab8d24e46f2b811ceb11c81d81b5a474

Hardcoded mappings from the GraphQL (plural) to CLI (singular) fields.
Renamed field.
Applied requested docs changes.

c8523a1

Prefix Rose fields with rose_.

* Provide full coverage for the `cylc vr` command. * Separate the command into two GraphQL mutations: * [validate-]reinstall-reload. * [validate-]reinstall-restart.

oliver-sanders · 2026-04-22T14:08:12Z

(tests should pass now)

MetRonnie

Still have the duplicated cylc version option (#746 (comment)) but otherwise I think this is all good

MetRonnie · 2026-04-23T16:06:51Z

+class ReinstallReload(graphene.Mutation):
+    class Meta:
+        description = sstrip('''
+            Validate, reinstall, then reload workflows.


To match how other commands are written in the schema

Suggested change

Validate, reinstall, then reload workflows.

Validate, reinstall, then reload the workflow.

This mutation can operate on multiple workflows right?

Yes, but singular would be consistent with all other mutations' descriptions

MetRonnie · 2026-04-23T16:22:05Z

+class ReinstallRestart(graphene.Mutation):
+    class Meta:
+        description = sstrip('''
+            Validate, reinstall, then restart workflows.


Suggested change

Validate, reinstall, then restart workflows.

Validate, reinstall, then restart the workflow.

This mutation can operate on multiple workflows right?

oliver-sanders marked this pull request as draft October 29, 2025 12:01

oliver-sanders force-pushed the 526 branch from 37adf28 to 6c34368 Compare October 30, 2025 11:29

oliver-sanders added this to the 1.9.0 milestone Oct 30, 2025

oliver-sanders self-assigned this Oct 30, 2025

oliver-sanders requested a review from MetRonnie October 30, 2025 14:35

oliver-sanders force-pushed the 526 branch from 6c34368 to b9d5f22 Compare October 30, 2025 15:30

oliver-sanders commented Oct 30, 2025

View reviewed changes

oliver-sanders force-pushed the 526 branch from b9d5f22 to 1ecb5e4 Compare October 30, 2025 15:54

oliver-sanders force-pushed the 526 branch from 1ecb5e4 to 1804eb6 Compare October 30, 2025 16:03

oliver-sanders marked this pull request as ready for review October 30, 2025 16:03

oliver-sanders requested a review from wxtim October 30, 2025 16:03

wxtim reviewed Nov 3, 2025

View reviewed changes

Comment thread cylc/uiserver/schema.py Outdated

wxtim approved these changes Nov 3, 2025

View reviewed changes

oliver-sanders force-pushed the 526 branch 2 times, most recently from f8f0f51 to f6a6e5e Compare November 3, 2025 16:31

oliver-sanders mentioned this pull request Nov 3, 2025

aotf: replace "reload" with validateReinstall cylc/cylc-ui#2347

Open

8 tasks

oliver-sanders force-pushed the 526 branch from f6a6e5e to c83eb10 Compare November 3, 2025 16:46

wxtim approved these changes Nov 4, 2025

View reviewed changes

MetRonnie reviewed Nov 4, 2025

View reviewed changes

Comment thread cylc/uiserver/resolvers.py

Comment thread cylc/uiserver/schema.py

Comment thread cylc/uiserver/schema.py Outdated

Comment thread cylc/uiserver/tests/test_resolvers.py Outdated

oliver-sanders marked this pull request as draft November 5, 2025 13:00

oliver-sanders added 2 commits February 20, 2026 11:09

services: validate-reinstall

a647851

* Closes cylc#526 * Add basic support for the `cylc vr` command.

services - play: fix timeout implementation

913496c

* We were applying a timeout to the `Popen.wait` method, however, this doesn't actually kill the process (as one might expect) when the timeout elapses, it just stops waiting for it?!

oliver-sanders force-pushed the 526 branch from c83eb10 to 4a52c18 Compare February 20, 2026 13:15

oliver-sanders commented Feb 20, 2026

View reviewed changes

oliver-sanders force-pushed the 526 branch 2 times, most recently from e1ea902 to 2dbceab Compare February 20, 2026 13:33

oliver-sanders requested review from MetRonnie and wxtim February 20, 2026 13:43

oliver-sanders marked this pull request as ready for review February 20, 2026 13:43

wxtim reviewed Feb 23, 2026

View reviewed changes

Comment thread cylc/uiserver/resolvers.py Outdated

Comment thread cylc/uiserver/resolvers.py Outdated

Comment thread cylc/uiserver/schema.py

Comment thread cylc/uiserver/schema.py Outdated

MetRonnie requested changes Feb 24, 2026

View reviewed changes

oliver-sanders force-pushed the 526 branch from 2dbceab to 57b44ec Compare February 25, 2026 13:13

services: validate-reinstall - cover all arguments

01f1a0f

* Provide full coverage for the `cylc vr` command. * Separate the command into two GraphQL mutations: * [validate-]reinstall-reload. * [validate-]reinstall-restart.

oliver-sanders force-pushed the 526 branch from c8523a1 to 01f1a0f Compare April 22, 2026 14:07

oliver-sanders requested a review from MetRonnie April 22, 2026 14:07

MetRonnie reviewed Apr 23, 2026

View reviewed changes

oliver-sanders modified the milestones: 1.9.0, 1.10.0 May 6, 2026

	Validate, reinstall, then reload workflows.
	Validate, reinstall, then reload the workflow.

	Validate, reinstall, then restart workflows.
	Validate, reinstall, then restart the workflow.

Conversation

oliver-sanders commented Oct 29, 2025 • edited by MetRonnie Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

oliver-sanders Oct 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

oliver-sanders commented Oct 30, 2025

Uh oh!

Uh oh!

wxtim left a comment

Choose a reason for hiding this comment

Uh oh!

oliver-sanders commented Nov 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

oliver-sanders commented Nov 3, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

oliver-sanders commented Nov 5, 2025

Uh oh!

oliver-sanders left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

MetRonnie left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

oliver-sanders Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

oliver-sanders commented Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

oliver-sanders commented Apr 22, 2026

Uh oh!

MetRonnie left a comment

Choose a reason for hiding this comment

Uh oh!

MetRonnie Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

oliver-sanders commented Oct 29, 2025 •

edited by MetRonnie

Loading

oliver-sanders Oct 30, 2025 •

edited

Loading

oliver-sanders commented Nov 3, 2025 •

edited

Loading

oliver-sanders Feb 25, 2026 •

edited

Loading

oliver-sanders commented Feb 25, 2026 •

edited

Loading

MetRonnie Apr 23, 2026 •

edited

Loading