deprecate old getCompletions signature

Author: goatshriek

CHANGELOG.md

@@ -5,12 +5,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
-## [4.2.0] - 2025-02-13
+## [4.2.0] - 2025-02-14
 ### Changed
  - Upgrade to JRuby 9.4.12.0 (Ruby 3.1.4)
  - Upgrade to Groovy 4.0.25
  - Upgrade to Kotlin 2.1.10
 
+### Deprecated
+ - `DragonPlugin.getCompletions(String cmd)` in favor of
+   `DragonPlugin.getCompletions(String cmd, int caretPos)`. This mirrors the
+   deprecation of the same method in
+   `ghidra.app.plugin.core.interpreter.InterpreterConnection`.
+
 
 ## [4.1.0] - 2024-11-08
 ### Changed
@@ -34,6 +40,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
  - Warnings and `launch.properties` files for broken JRuby support in older
    versions of Ghidra.
 
+
 ## [3.3.0] - 2024-03-28
 ### Changed
  - Upgrade to JRuby 9.4.6.0 (Ruby 3.1.4)

src/main/java/com/goatshriek/rubydragon/DragonPlugin.java

@@ -67,7 +67,7 @@ public abstract class DragonPlugin extends ProgramPlugin implements InterpreterC
 	 * @since 2.2.0
 	 */
 	public static final String OPTION_CATEGORY_NAME = "Ruby Dragon Interpreters";
-	
+
 	/**
 	 * The name of the plugin category used by DragonPlugins.
 	 *
@@ -197,12 +197,30 @@ public String getAutoImportOptionName() {
 	 * @param cmd The command to try to complete.
 	 *
 	 * @return A list of possible code completions.
+	 *
+	 * @deprecated Move to using {@link #getCompletions(String, int)}.
 	 */
-	@Override
+	@Deprecated
 	public List<CodeCompletion> getCompletions(String cmd) {
 		return getInterpreter().getCompletions(cmd);
 	}
 
+	/**
+	 * Gets a {@link List} of {@link CodeCompletion code completions} for the given
+	 * command relative to the given caret position.
+	 *
+	 * @param cmd      The command to get code completions for
+	 * @param caretPos The position of the caret in the input string 'cmd'. It
+	 *                 should satisfy the constraint
+	 *                 {@literal "0 <= caretPos <= cmd.length()"}
+	 * @return A {@link List} of {@link CodeCompletion code completions} for the
+	 *         given command
+	 */
+	@Override
+	public List<CodeCompletion> getCompletions(String cmd, int caretPos) {
+		return getInterpreter().getCompletions(cmd.substring(0, caretPos));
+	}
+
 	/**
 	 * The icon for this plugin.
 	 */