summaryrefslogtreecommitdiff
path: root/Userland/Applications/Assistant/FuzzyMatch.h
diff options
context:
space:
mode:
authorSpencer Dixon <spencercdixon@gmail.com>2021-06-16 21:55:44 -0400
committerAndreas Kling <kling@serenityos.org>2021-06-28 16:29:02 +0200
commit66c13edb984ca811e1d38713748b282afb561bbf (patch)
tree2ec12a107547ef6eb38ade0cc48e47c05470f19a /Userland/Applications/Assistant/FuzzyMatch.h
parentd16db6a67c5a758cf28a91e8d3886032acb385c4 (diff)
downloadserenity-66c13edb984ca811e1d38713748b282afb561bbf.zip
Userland: Add new app called Assistant
'Assistant' is similar to macOS spotlight where you can quickly open a text input, start typing, and hit 'enter' to launch apps or open directories.
Diffstat (limited to 'Userland/Applications/Assistant/FuzzyMatch.h')
-rw-r--r--Userland/Applications/Assistant/FuzzyMatch.h29
1 files changed, 29 insertions, 0 deletions
diff --git a/Userland/Applications/Assistant/FuzzyMatch.h b/Userland/Applications/Assistant/FuzzyMatch.h
new file mode 100644
index 0000000000..9a471a322a
--- /dev/null
+++ b/Userland/Applications/Assistant/FuzzyMatch.h
@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2021, Spencer Dixon <spencercdixon@gmail.com>
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#pragma once
+
+#include <AK/String.h>
+#include <AK/Tuple.h>
+
+namespace Assistant {
+
+struct FuzzyMatchResult {
+ bool matched { false };
+ int score { 0 };
+};
+
+// This fuzzy_match algorithm is based off a similar algorithm used by Sublime Text. The key insight is that instead
+// of doing a total in the distance between characters (I.E. Levenshtein Distance), we apply some meaningful heuristics
+// related to our dataset that we're trying to match to build up a score. Scores can then be sorted and displayed
+// with the highest at the top.
+//
+// Scores are not normalized between any values and have no particular meaning. The starting value is 100 and when we
+// detect good indicators of a match we add to the score. When we detect bad indicators, we penalize the match and subtract
+// from its score. Therefore, the longer the needle/haystack the greater the range of scores could be.
+FuzzyMatchResult fuzzy_match(String needle, String haystack);
+
+}