Add settings

Adds settings files to the plugin.
Adds a new setting: "disabled" which allows to disable the plugin.

Author: DWand

Main.sublime-menu

@@ -0,0 +1,38 @@
+[
+	{
+		"caption": "Preferences",
+		"id": "preferences",
+		"mnemonic": "n",
+		"children":
+		[
+			{
+				"caption": "Package Settings",
+				"id": "package-settings",
+				"mnemonic": "P",
+				"children":
+				[
+					{
+						"caption": "apiDoc Autocompletion",
+						"children":
+						[
+							{
+								"caption": "Settings – Default",
+								"command": "open_file", "args":
+								{
+									"file": "${packages}/apiDoc Autocompletion/apiDocAutocompletion.sublime-settings"
+								}
+							},
+							{
+								"caption": "Settings – User",
+								"command": "open_file", "args":
+								{
+									"file": "${packages}/User/apiDocAutocompletion.sublime-settings"
+								}
+							}
+						]
+					}
+				]
+			}
+		]
+	}
+]

apiDocAutocompletion.py

@@ -6,6 +6,8 @@
 import sublime
 import sublime_plugin
 
+SETTINGS_FILENAME = 'apiDocAutocompletion.sublime-settings'
+
 class apiDocAutocompletion(sublime_plugin.EventListener):
     _suggestions = [
         ("@api\tapiDoc", "@api {${1:method}} ${2:path} ${3:[title]}"),
@@ -44,6 +46,11 @@ class apiDocAutocompletion(sublime_plugin.EventListener):
     ]
 
     def on_query_completions(self, view, prefix, locations):
+        settings = sublime.load_settings(SETTINGS_FILENAME)
+
+        plugin_disabled = settings.get('disabled', False)
+        if plugin_disabled:
+            return None
 
         # Block comment scopes:
         # C#:
@@ -86,4 +93,4 @@ def on_query_completions(self, view, prefix, locations):
         if any(scope in current_scope for scope in target_scopes) == True:
             return apiDocAutocompletion._suggestions
         else:
-            return []
+            return None

apiDocAutocompletion.sublime-settings

@@ -0,0 +1,4 @@
+{
+    // Disables the plugin
+    "disabled": false,
+}