| // Copyright 2026 The Go Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style |
| // license that can be found in the LICENSE file. |
| |
| package command |
| |
| import "context" |
| |
| // An Action is a side effect a command returns instead of performing: talking |
| // to the client, or changing the workspace. The caller performs it once the |
| // computation has succeeded, so a command can be run for its result alone |
| // without taking effect. |
| // |
| // The snapshot is gone by then, so an Action must hold values, not the means |
| // to recompute them. |
| // |
| // Examples: |
| // |
| // applyEdits{changes} // change the user's files |
| // showDocument{uri, &rng} // reveal a location |
| // showMessage{protocol.Info, msg} // tell the user something |
| // actions{applyEdits{…}, showDocument{…}} // perform in order |
| // |
| // A nil Action means the command has no effect. |
| type Action interface { |
| Perform(context.Context) error |
| } |
