Add partial support for QuickBMSver statements

Author: ExcaliburZero

README.md

@@ -21,7 +21,8 @@ These are the currently supported language server endpoints.
 ## QuickBMS commands
 The following QuickBMS commands are currently supported by the langauge server.
 
-* [ ] `QuickBMSver VERSION`
+* [x] `QuickBMSver VERSION`
+    * [ ] Support version numbers that are not specified as strings
 * [x] `FindLoc VAR TYPE STRING [FILENUM] [ERR_VALUE] [END_OFF]`
 * [x] `For [VAR] [OP] [VALUE] [COND] [VAR]`
     * [ ] Support all operators

src/server/keyword_docs.rs

@@ -53,6 +53,7 @@ pub fn get_keyword_docs() -> HashMap<String, String> {
         keyword!("while", "keyword_docs/do.txt"),
         keyword!("short", "keyword_docs/short.txt"),
         keyword!("open", "keyword_docs/open.txt"),
+        keyword!("quickbmsver", "keyword_docs/quickbmsver.txt"),
     ]
     .iter()
     .cloned()

src/server/keyword_docs/quickbmsver.txt

@@ -0,0 +1,37 @@
+QuickBMSver VERSION
+
+    Checks if the current version of QuickBMS is recent enough to
+    support the script. Mainly for scripts created after the
+    introduction of a new feature or an important fix.
+    The instruction also enables some command-line options.
+
+    Arguments:
+      VERSION   Oldest version of QuickBMS for which the script was
+                created the script, it's just the version displayed
+                at runtime by the tool.
+                It's possible to add some command-line options too:
+                  -64   force quickbms_4gb_files.exe
+                  -9    disable the safe memory allocator
+                  -I    makes the variables case sensitive
+                  -.    useful in reimport mode with data builders
+                  -N    decimal names: 00000000.dat -> 0.dat
+                  -q    quiet
+                  -T    keep the temporary file if generated
+                  -d    useful with some formats and scripts
+                  -D    useful with some formats and scripts
+                  -e    doesn't quit if compression fails
+                  -J    all the strings are considered cstring
+                  -32   checks if the user is using quickbms.exe
+                  -F    filter the input files
+                  -x    hexadecimal notation in myitoa (debug)
+                  -j    force UTF16 output in some functions
+                  -b C  use C (char or hex) as filler in reimport
+                        if the new file is smaller
+                  -c    this is NOT related to the -c option at
+                        command-line, it's a way to avoid being
+                        prompted when using C structures in the bms
+
+    Examples:
+      QuickBMSver 0.2.4
+      QuickBMSver "0.5.14 -9"
+      QuickBMSver "-I -9"

tree-sitter-quickbms/grammar.js

@@ -52,6 +52,7 @@ module.exports = grammar({
       $.getdstring_statement,
       $.do_statement,
       $.open_statement,
+      $.quickbmsver_statement,
     ),
     set_statement: $ => seq(
       $.set,
@@ -311,6 +312,10 @@ module.exports = grammar({
         ),
       )),
     ),
+    quickbmsver_statement: $ => seq(
+      $.quickbmsver,
+      field("version", $._expression),
+    ),
     comparison: $ => choice(
       "<",
       ">",
@@ -459,6 +464,7 @@ module.exports = grammar({
     do: $ => /[Dd][Oo]/,
     while: $ => /[Ww][Hh][Ii][Ll][Ee]/,
     open: $ => /[Oo][Pp][Ee][Nn]/,
+    quickbmsver: $ => /[Qq][Uu][Ii][Cc][Kk][Bb][Mm][Ss][Vv][Ee][Rr]/,
     question_mark: $ => /\?/,
 
     identifier: $ => /[a-zA-Z_\\\.\/]+[a-zA-Z0-9_\-\\\.\/]*/,

tree-sitter-quickbms/test/corpus/quickbmsver.bms

@@ -0,0 +1,18 @@
+================================================================================
+QuickBMSver statements
+================================================================================
+
+# QuickBMSver 0.2.4
+QuickBMSver "0.5.14 -9"
+QuickBMSver "-I -9"
+
+--------------------------------------------------------------------------------
+
+(source_file
+  (comment)
+  (quickbmsver_statement
+    (quickbmsver)
+    (string_literal))
+  (quickbmsver_statement
+    (quickbmsver)
+    (string_literal)))