Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

testscript: add kill command #243

Merged
merged 1 commit into from Apr 15, 2024
Merged

testscript: add kill command #243

merged 1 commit into from Apr 15, 2024

Conversation

kortschak
Copy link
Contributor

This allows sending a termination signal to backgrounded commands.

Please take a look.

Closes #242

if bg == nil {
ts.Fatalf("unknown background process %q", bgName)
}
signal := os.Interrupt

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Might be more generic to be able to choose the signal? (hup vs int vs kill...)

Copy link
Contributor Author

@kortschak kortschak Dec 30, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I was thinking that. I was wondering about the API for that. Would you be happy with kill [-SIG] [name]? (SIG would be numeric only in the first instance on second thought, named signal would be better). With that, the default would probably be SIGKILL.

@kortschak
Copy link
Contributor Author

ping

As noted in the slack conversation about this PR, if adding a kill command is too much, an alternative would be to expose TestScript.findBackground so that client code can build the command within its test code.

Copy link
Collaborator

@mvdan mvdan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know @rogpeppe isn't sure whether this is the perfect solution, but I'm perfectly comfortable to choose a solution that's good enough over no solution at all :)

testscript/doc.go Outdated Show resolved Hide resolved
! exec sleep 5 &

kill -KILL test_sleep
wait test_sleep
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can you please add failure test cases? in particular:

  • trying to kill a running background process that was started with & rather than &word& (i.e. using a background process name that doesn't exist)
  • trying to kill a background process that already stopped or was already killed

Please also cover the kill and kill name forms, as otherwise we can't be sure they will keep working in the future.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These negated tests are not currently possible since the kill command is not negatable. This is consistent with wait.

The positive tests for without name are possible.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for adding more tests!

I see your point about consistency with wait not being negatable. I personally think both should be, and both should fail if given an unknown/exited process, but we can always add that later - especially once we have ? to ignore the result of a command.

testscript/testdata/kill.txt Show resolved Hide resolved
@mvdan
Copy link
Collaborator

mvdan commented Apr 11, 2024

As noted in the slack conversation about this PR, if adding a kill command is too much, an alternative would be to expose TestScript.findBackground so that client code can build the command within its test code.

I would personally also be fine with this, but given that the majority of users would presumably use that to write their own kill commands, I'm fine with adding the command directly. We can always choose to expose the Go API later as well.

This allows sending a termination signal to backgrounded commands.
Copy link
Collaborator

@mvdan mvdan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! LGTM

@mvdan mvdan merged commit 2af95f2 into rogpeppe:master Apr 15, 2024
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add "kill" command to terminate background exec
3 participants