SITE: test and fix command-related scripts (#2547)

Author: dwdougherty

build/add_cmds.py

@@ -92,7 +92,6 @@ def generate_command_frontmatter(command_name: str, command_data: dict, all_comm
         'title': full_command_name,
         'linkTitle': full_command_name,
         'description': command_data.get('summary'),
-        'syntax_str': str(c),
         'syntax_fmt': c.syntax(),
         'hidden': False  # Default to not hidden
     })

build/update_cmds.py

@@ -1,12 +1,12 @@
 #!/usr/bin/env python3
 import argparse
+import glob
 import json
 import logging
 import os
-import glob
 
-from components.syntax import Command
 from components.markdown import Markdown
+from components.syntax import Command
 
 
 def parse_args() -> argparse.Namespace:
@@ -21,6 +21,7 @@ def parse_args() -> argparse.Namespace:
                         help='Directory to save railroad diagram SVG files')
     return parser.parse_args()
 
+
 def generate_railroad_diagrams(commands_data: dict, output_dir: str) -> None:
     """Generate railroad diagrams for all commands."""
     try:
@@ -63,10 +64,35 @@ def generate_railroad_diagrams(commands_data: dict, output_dir: str) -> None:
         force=True  # Force reconfiguration in case logging was already configured
     )
 
-    # Load all commands_*.json files
+    # Load all commands_core.json and filter out stubbed commands
     all_commands = {}
-    command_files = glob.glob('data/commands_*.json')
 
+    FILTER_PREFIXES = [
+    "BF.",
+    "CF.",
+    "CMS.",
+    "JSON.",
+    "FT.",
+    "_FT.",
+    "SEARCH.",
+    "TDIGEST.",
+    "TIMESERIES.",
+    "TOPK.",
+    "TS.",
+    ]
+
+    logging.info("Loading commands from data/commands_core.json")
+    with open('data/commands_core.json', 'r') as f:
+        data = json.load(f)
+        
+    filtered = {
+        key: value
+        for key, value in data.items()
+        if not key.startswith(tuple(FILTER_PREFIXES))
+    }
+    all_commands.update(filtered)
+
+    command_files = glob.glob('data/commands_r*.json')
     for command_file in command_files:
         logging.info(f"Loading commands from {command_file}")
         with open(command_file, 'r') as f:
@@ -95,7 +121,6 @@ def generate_railroad_diagrams(commands_data: dict, output_dir: str) -> None:
             md.fm_data['railroad_diagram'] = railroad_file.replace('static/', '/')
 
         md.fm_data.update({
-            'syntax_str': str(c),
             'syntax_fmt': sf,
         })
         md.persist()

content/commands/acl-cat.md

@@ -30,7 +30,6 @@ railroad_diagram: /images/railroad/acl-cat.svg
 since: 6.0.0
 summary: Lists the ACL categories, or the commands inside a category.
 syntax_fmt: ACL CAT [category]
-syntax_str: ''
 title: ACL CAT
 ---
 The command shows the available ACL categories if called without arguments.

content/commands/acl-deluser.md

@@ -36,7 +36,6 @@ railroad_diagram: /images/railroad/acl-deluser.svg
 since: 6.0.0
 summary: Deletes ACL users, and terminates their connections.
 syntax_fmt: ACL DELUSER username [username ...]
-syntax_str: ''
 title: ACL DELUSER
 ---
 Delete all the specified ACL users and terminate all the connections that are

content/commands/acl-dryrun.md

@@ -41,7 +41,6 @@ railroad_diagram: /images/railroad/acl-dryrun.svg
 since: 7.0.0
 summary: Simulates the execution of a command by a user, without executing the command.
 syntax_fmt: ACL DRYRUN username command [arg [arg ...]]
-syntax_str: command [arg [arg ...]]
 title: ACL DRYRUN
 ---
 Simulate the execution of a given command by a given user.

content/commands/acl-genpass.md

@@ -32,7 +32,6 @@ since: 6.0.0
 summary: Generates a pseudorandom, secure password that can be used to identify ACL
   users.
 syntax_fmt: ACL GENPASS [bits]
-syntax_str: ''
 title: ACL GENPASS
 ---
 ACL users need a solid password in order to authenticate to the server without

content/commands/acl-getuser.md

@@ -39,7 +39,6 @@ railroad_diagram: /images/railroad/acl-getuser.svg
 since: 6.0.0
 summary: Lists the ACL rules of a user.
 syntax_fmt: ACL GETUSER username
-syntax_str: ''
 title: ACL GETUSER
 ---
 The command returns all the rules defined for an existing ACL user.

content/commands/acl-help.md

@@ -24,7 +24,6 @@ railroad_diagram: /images/railroad/acl-help.svg
 since: 6.0.0
 summary: Returns helpful text about the different subcommands.
 syntax_fmt: ACL HELP
-syntax_str: ''
 title: ACL HELP
 ---
 The `ACL HELP` command returns a helpful text describing the different subcommands.

content/commands/acl-list.md

@@ -28,7 +28,6 @@ railroad_diagram: /images/railroad/acl-list.svg
 since: 6.0.0
 summary: Dumps the effective rules in ACL file format.
 syntax_fmt: ACL LIST
-syntax_str: ''
 title: ACL LIST
 ---
 The command shows the currently active ACL rules in the Redis server. Each

content/commands/acl-load.md

@@ -28,7 +28,6 @@ railroad_diagram: /images/railroad/acl-load.svg
 since: 6.0.0
 summary: Reloads the rules from the configured ACL file.
 syntax_fmt: ACL LOAD
-syntax_str: ''
 title: ACL LOAD
 ---
 When Redis is configured to use an ACL file (with the `aclfile` configuration