Migrate snippets support to community snippets, support multiple snippets (#2804)

#2353

The Cursorless side of talonhub/community#1718

Will allow Cursorless to fetch multiple snippets from community and
decide which one to use.

## Release notes
Cursorless can now get multiple snippets from community. One for each
language. Cursorless can then pick the correct snippet for the document
language regardless of which document is focused at the moment.

---------

Co-authored-by: Phillip Cohen <[email protected]>

Author: AndreasArvidsson

cursorless-talon-dev/src/cursorless_test.talon

@@ -25,12 +25,8 @@ test api insert snippet:
     user.cursorless_insert_snippet("Hello, $foo!  My name is $bar!")
 test api insert snippet <user.cursorless_destination> :
     user.cursorless_insert_snippet("Hello, $foo!  My name is $bar!", cursorless_destination, "statement")
-test api insert snippet by name:
-    user.cursorless_insert_snippet_by_name("functionDeclaration")
 test api wrap with snippet <user.cursorless_target>:
     user.cursorless_wrap_with_snippet("Hello, $foo!  My name is $bar!", cursorless_target, "foo", "statement")
-test api wrap with snippet by name <user.cursorless_target>:
-    user.cursorless_wrap_with_snippet_by_name("functionDeclaration", "body", cursorless_target)
 test api extract decorated marks <user.cursorless_target>:
     user.private_cursorless_test_extract_decorated_marks(cursorless_target)
 test api alternate highlight nothing:

cursorless-talon-dev/src/spoken_form_test.py

@@ -39,8 +39,6 @@
 
 mockedGetValue = ""
 
-community_snippets_tag_name = "user.cursorless_use_community_snippets"
-
 
 @ctx.action_class("user")
 class UserActions:
@@ -99,20 +97,6 @@ def private_cursorless_spoken_form_test_mode(enable: bool):  # pyright: ignore [
                 "Cursorless spoken form tests are done. Talon microphone is re-enabled."
             )
 
-    def private_cursorless_use_community_snippets(enable: bool):  # pyright: ignore [reportGeneralTypeIssues]
-        """Enable/disable cursorless community snippets in test mode"""
-        if enable:
-            tags = set(ctx.tags)
-            tags.add(community_snippets_tag_name)
-            ctx.tags = list(tags)
-        else:
-            tags = set(ctx.tags)
-            tags.remove(community_snippets_tag_name)
-            ctx.tags = list(tags)
-        # Note: Test harness hangs if we don't print anything because it's
-        # waiting for stdout
-        print(f"Set community snippet enablement to {enable}")
-
     def private_cursorless_spoken_form_test(
         phrase: str,  # pyright: ignore [reportGeneralTypeIssues]
         mockedGetValue_: Optional[str],

cursorless-talon/src/actions/generate_snippet.py

@@ -1,17 +1,12 @@
 import glob
 from pathlib import Path
 
-from talon import Context, Module, actions, registry, settings
+from talon import Module, actions, registry, settings
 
 from ..targets.target_types import CursorlessExplicitTarget
 
 mod = Module()
 
-ctx = Context()
-ctx.matches = r"""
-tag: user.cursorless_use_community_snippets
-"""
-
 
 @mod.action_class
 class Actions:
@@ -33,17 +28,6 @@ def private_cursorless_migrate_snippets():
 
     def private_cursorless_generate_snippet_action(target: CursorlessExplicitTarget):  # pyright: ignore [reportGeneralTypeIssues]
         """Generate a snippet from the given target"""
-        actions.user.private_cursorless_command_no_wait(
-            {
-                "name": "generateSnippet",
-                "target": target,
-            }
-        )
-
-
-@ctx.action_class("user")
-class UserActions:
-    def private_cursorless_generate_snippet_action(target: CursorlessExplicitTarget):  # pyright: ignore [reportGeneralTypeIssues]
         actions.user.private_cursorless_command_no_wait(
             {
                 "name": "generateSnippet",

cursorless-talon/src/check_community_repo.py

@@ -9,6 +9,7 @@
 
 required_actions = [
     "user.homophones_get",
+    "user.insert_snippet_by_name",
     "user.reformat_text",
 ]
 

cursorless-talon/src/snippet_cursorless.talon

@@ -0,0 +1,77 @@
+from dataclasses import dataclass
+
+from .targets.target_types import CursorlessDestination, CursorlessTarget
+
+
+@dataclass
+class ScopeType:
+    type: str
+
+
+# Insertion snippets
+
+
+@dataclass
+class CustomInsertionSnippet:
+    type = "custom"
+    body: str
+    scopeTypes: list[ScopeType] | None
+    languages: list[str] | None
+    substitutions: dict[str, str] | None
+
+
+@dataclass
+class ListInsertionSnippet:
+    type = "list"
+    substitutions: dict[str, str] | None
+    snippets: list[CustomInsertionSnippet]
+
+
+@dataclass
+class InsertSnippetAction:
+    name = "insertSnippet"
+    snippetDescription: CustomInsertionSnippet | ListInsertionSnippet
+    destination: CursorlessDestination
+
+
+# Wrapper snippets
+
+
+@dataclass
+class CustomWrapperSnippet:
+    type = "custom"
+    body: str
+    variableName: str | None
+    scopeType: ScopeType | None
+    languages: list[str] | None
+
+
+@dataclass
+class ListWrapperSnippet:
+    type = "list"
+    snippets: list[CustomWrapperSnippet]
+
+
+@dataclass
+class WrapperSnippetAction:
+    name = "wrapWithSnippet"
+    snippetDescription: CustomWrapperSnippet | ListWrapperSnippet
+    target: CursorlessTarget
+
+
+# Community types
+
+
+@dataclass
+class CommunityInsertionSnippet:
+    body: str
+    languages: list[str] | None = None
+    scopes: list[str] | None = None
+
+
+@dataclass
+class CommunityWrapperSnippet:
+    body: str
+    variable_name: str
+    languages: list[str] | None
+    scope: str | None