Public get text action

cursorless-talon-dev/src/cursorless_test.talon

@@ -7,10 +7,20 @@ test api command <user.cursorless_target>:
     user.cursorless_command("setSelection", cursorless_target)
 test api command bring <user.cursorless_target>:
     user.cursorless_command("replaceWithTarget", cursorless_target)
+test api get text <user.cursorless_target>:
+    user.cursorless_get_text(cursorless_target)
+test api get text list on <user.cursorless_target>:
+    user.cursorless_get_text_list(cursorless_target)
+test api get text hide decorations <user.cursorless_target>:
+    user.cursorless_get_text(cursorless_target, 1)
+test api get text hide decorations list on <user.cursorless_target>:
+    user.cursorless_get_text_list(cursorless_target, 1)
+
 test api insert <user.word> <user.cursorless_destination>:
     user.cursorless_insert(cursorless_destination, word)
 test api insert <user.word> and <user.word> <user.cursorless_destination>:
     user.cursorless_insert(cursorless_destination, word_list)
+
 test api insert snippet:
     user.cursorless_insert_snippet("Hello, $foo!  My name is $bar!")
 test api insert snippet <user.cursorless_destination> :

cursorless-talon/src/actions/get_text.py

@@ -1,9 +1,36 @@
 from typing import Optional
 
-from talon import actions
+from talon import Module, actions
 
 from ..targets.target_types import CursorlessTarget
 
+mod = Module()
+
+
+@mod.action_class
+class Actions:
+    def cursorless_get_text(
+        target: CursorlessTarget,
+        hide_decorations: bool = False,
+    ) -> str:
+        """Get target text. If silent, don't show decorations"""
+        return cursorless_get_text_action(
+            target,
+            show_decorations=not hide_decorations,
+            ensure_single_target=True,
+        )[0]
+
+    def cursorless_get_text_list(
+        target: CursorlessTarget,
+        hide_decorations: bool = False,
+    ) -> list[str]:
+        """Get texts for multiple targets. If silent, don't show decorations"""
+        return cursorless_get_text_action(
+            target,
+            show_decorations=not hide_decorations,
+            ensure_single_target=False,
+        )
+
 
 def cursorless_get_text_action(
     target: CursorlessTarget,

docs/user/customization.md

@@ -117,6 +117,10 @@ Cursorless exposes a couple talon actions and captures that you can use to defin
 - `user.cursorless_ide_command(command_id: str, target: cursorless_target)`:
   Performs a built-in IDE command on the given target
   eg: `user.cursorless_ide_command("editor.action.addCommentLine", cursorless_target)`
+- `user.cursorless_get_text(target: CursorlessTarget, silent: bool = False) -> str`
+  Get text from target. If `silent` is `true`, will not show decorations.
+- `user.cursorless_get_text_list(target: CursorlessTarget, silent: bool = False) -> list[str]`
+  Get texts from multiple targets. If `silent` is `true`, will not show decorations.
 - `user.cursorless_insert(destination: CursorlessDestination, text: Union[str, List[str]])`:
   Insert text at destination.
   eg: `user.cursorless_insert(cursorless_destination, "hello")`

packages/cursorless-engine/src/test/fixtures/talonApi.fixture.ts

@@ -1,8 +1,9 @@
 import {
   ActionDescriptor,
+  GetTextActionOptions,
   PartialPrimitiveTargetDescriptor,
 } from "@cursorless/common";
-import { spokenFormTest } from "./spokenFormTest";
+import { multiActionSpokenFormTest, spokenFormTest } from "./spokenFormTest";
 
 // See cursorless-talon-dev/src/cursorless_test.talon
 const setSelectionAction: ActionDescriptor = {
@@ -97,6 +98,14 @@ const parseTreeAction: ActionDescriptor = {
   target: decoratedPrimitiveTarget("a"),
 };
 
+function getTextAction(options: GetTextActionOptions): ActionDescriptor {
+  return {
+    name: "getText",
+    options,
+    target: decoratedPrimitiveTarget("a"),
+  };
+}
+
 /**
  * These test our Talon api using dummy spoken forms defined in
  * cursorless-talon-dev/src/cursorless_test.talon
@@ -121,6 +130,26 @@ export const talonApiFixture = [
     wrapWithSnippetByNameAction,
   ),
   spokenFormTest("parse tree air", parseTreeAction),
+  multiActionSpokenFormTest(
+    "test api get text air",
+    [getTextAction({ showDecorations: true, ensureSingleTarget: true })],
+    ["apple"],
+  ),
+  multiActionSpokenFormTest(
+    "test api get text list on air",
+    [getTextAction({ showDecorations: true, ensureSingleTarget: false })],
+    ["apple"],
+  ),
+  multiActionSpokenFormTest(
+    "test api get text hide decorations air",
+    [getTextAction({ showDecorations: false, ensureSingleTarget: true })],
+    ["apple"],
+  ),
+  multiActionSpokenFormTest(
+    "test api get text hide decorations list on air",
+    [getTextAction({ showDecorations: false, ensureSingleTarget: false })],
+    ["apple"],
+  ),
 ];
 
 function decoratedPrimitiveTarget(