Change names per discussion

Author: pokey

cursorless-talon/src/snippets.py

@@ -81,7 +81,7 @@ def private_cursorless_insert_snippet_with_phrase(
             },
         )
 
-    def cursorless_insert_named_snippet(name: str):
+    def cursorless_insert_snippet_by_name(name: str):
         """Inserts a named snippet"""
         actions.user.cursorless_implicit_target_command(
             "insertSnippet",
@@ -91,7 +91,7 @@ def cursorless_insert_named_snippet(name: str):
             },
         )
 
-    def cursorless_insert_custom_snippet(body: str):
+    def cursorless_insert_snippet(body: str):
         """Inserts a custom snippet"""
         actions.user.cursorless_implicit_target_command(
             "insertSnippet",
@@ -101,7 +101,9 @@ def cursorless_insert_custom_snippet(body: str):
             },
         )
 
-    def cursorless_wrap_with_named_snippet(name: str, variable_name: str, target: dict):
+    def cursorless_wrap_with_snippet_by_name(
+        name: str, variable_name: str, target: dict
+    ):
         """Wrap target with a named snippet"""
         actions.user.cursorless_single_target_command_with_arg_list(
             "wrapWithSnippet",
@@ -115,7 +117,7 @@ def cursorless_wrap_with_named_snippet(name: str, variable_name: str, target: di
             ],
         )
 
-    def cursorless_wrap_with_custom_snippet(
+    def cursorless_wrap_with_snippet(
         body: str,
         target: dict,
         variable_name: Optional[str] = None,

docs/user/customization.md

@@ -123,10 +123,10 @@ Cursorless exposes a couple talon actions and captures that you can use to defin
 
 See [snippets](./experimental/snippets.md) for more information about Cursorless snippets.
 
-- `user.cursorless_insert_named_snippet(name: str)`: Insert a snippet with the given name, eg `functionDeclaration`
-- `user.cursorless_insert_custom_snippet(body: str)`: Insert a snippet with the given body defined using our snippet body syntax (see the [snippet format docs](./experimental/snippet-format.md)). The body should be a single string, which could contain newline `\n` characters, rather than a list of strings as is expected in our snippet json representation.
-- `user.cursorless_wrap_with_named_snippet(name: str, variable_name: str, target: dict)`: Wrap the given target with a snippet with the given name, eg `functionDeclaration`. Note that `variable_name` should be one of the variables defined in the named snippet. Eg, if the named snippet has a variable `$foo`, you can pass in `"foo"` for `variable_name`, and `target` will be inserted into the position of `$foo` in the given named snippet.
-- `user.cursorless_wrap_with_custom_snippet(body, target, variable_name, scope)`: Wrap the given target with a snippet with the given body defined using our snippet body syntax (see the [snippet format docs](./experimental/snippet-format.md)). The body should be a single string, which could contain newline `\n` characters, rather than a list of strings as is expected in our snippet json representation. Note that `variable_name` should be one of the variables defined in `body`. Eg, if `body` has a variable `$foo`, you can pass in `"foo"` for `variable_name`, and `target` will be inserted into the position of `$foo` in the given named snippet. The `scope` variable can be used to automatically expand the target to the given scope type, eg `"line"`.
+- `user.cursorless_insert_snippet_by_name(name: str)`: Insert a snippet with the given name, eg `functionDeclaration`
+- `user.cursorless_insert_snippet(body: str)`: Insert a snippet with the given body defined using our snippet body syntax (see the [snippet format docs](./experimental/snippet-format.md)). The body should be a single string, which could contain newline `\n` characters, rather than a list of strings as is expected in our snippet json representation.
+- `user.cursorless_wrap_with_snippet_by_name(name: str, variable_name: str, target: dict)`: Wrap the given target with a snippet with the given name, eg `functionDeclaration`. Note that `variable_name` should be one of the variables defined in the named snippet. Eg, if the named snippet has a variable `$foo`, you can pass in `"foo"` for `variable_name`, and `target` will be inserted into the position of `$foo` in the given named snippet.
+- `user.cursorless_wrap_with_snippet(body, target, variable_name, scope)`: Wrap the given target with a snippet with the given body defined using our snippet body syntax (see the [snippet format docs](./experimental/snippet-format.md)). The body should be a single string, which could contain newline `\n` characters, rather than a list of strings as is expected in our snippet json representation. Note that `variable_name` should be one of the variables defined in `body`. Eg, if `body` has a variable `$foo`, you can pass in `"foo"` for `variable_name`, and `target` will be inserted into the position of `$foo` in the given named snippet. The `scope` variable can be used to automatically expand the target to the given scope type, eg `"line"`.
 
 ### Example of combining capture and action