Allow filepath autocompletion in plugins

closes #858

2 files changed, 21 insertions, 0 deletions

diff --git a/apidocs/c/profapi.h b/apidocs/c/profapi.h
index 6e625f2c..5a8a11cb 100644
--- a/apidocs/c/profapi.h
+++ b/apidocs/c/profapi.h
@@ -94,6 +94,13 @@ Remove all values from autocompletion for a command, or command argument.
 void prof_completer_clear(const char *key);
 
 /**
+Add filepath autocompletion for a command, or command argument.
+
+@param prefix the prefix from which filepath autocompletion will be triggered
+*/
+void prof_filepath_completer_add(const char *prefix);
+
+/**
 Send a desktop notification.
 @param message the message to display in the notification
 @param timeout_ms the length of time before the notification disappears in milliseconds
diff --git a/apidocs/python/src/prof.py b/apidocs/python/src/prof.py
index 789e1f3e..69d5aaea 100644
--- a/apidocs/python/src/prof.py
+++ b/apidocs/python/src/prof.py
@@ -182,6 +182,20 @@ def completer_clear(key):
     pass
 
 
+def filepath_completer_add(prefix):
+    """Add filepath autocompletion for a command, or command argument.
+
+    :param prefix: the prefix from which filepath autocompletion will be triggered
+
+    Examples:
+    ::
+        prof.filepath_completer_add("/filecmd")
+
+        prof.filepath_completer_add("/mycommand open")
+    """
+    pass
+
+
 def send_line(line): 
     """Send a line of input to Profanity to execute.