feat(completions): switch to shtab static completions\n\n- Expose get_parser() for shtab\n- Add --print-completion via shtab when available\n- Rework Detected shell: zsh

# Install shtab (once, in your environment):
python -m pip install shtab

# Generate static zsh completion for 'struct':
mkdir -p ~/.zfunc
python -m shtab struct_module.main:get_parser -s zsh -o ~/.zfunc/_struct

# Ensure zsh loads user functions/completions (append to ~/.zshrc if needed):
echo "fpath=(~/.zfunc $fpath)" >> ~/.zshrc
echo "autoload -U compinit && compinit" >> ~/.zshrc

# Apply now (or open a new shell):
exec zsh

Tip: You can also print completion directly via: struct --print-completion <shell> to generate static files for zsh/bash/fish\n- Replace argcomplete with shtab in requirements.txt

Author: httpdss

requirements.txt

@@ -4,7 +4,7 @@ openai
 python-dotenv
 jinja2
 PyGithub
-argcomplete
+shtab
 colorlog
 boto3
 google-cloud

struct_module/commands/completion.py

@@ -6,7 +6,7 @@
 class CompletionCommand(Command):
   def __init__(self, parser):
     super().__init__(parser)
-    parser.description = "Manage CLI shell completions for struct (argcomplete)"
+    parser.description = "Manage CLI shell completions for struct (shtab-generated)"
     sub = parser.add_subparsers(dest="action")
 
     install = sub.add_parser("install", help="Print the commands to enable completion for your shell")
@@ -29,32 +29,37 @@ def _install(self, args):
     print(f"Detected shell: {shell}")
 
     if shell == "bash":
-      print("\n# One-time dependency (if not installed):")
-      print("python -m pip install argcomplete")
-      print("\n# Enable completion for 'struct' in bash (append to ~/.bashrc):")
-      print('echo "eval \"$(register-python-argcomplete struct)\"" >> ~/.bashrc')
-      print("\n# Apply now:")
+      print("\n# Install shtab (once, in your environment):")
+      print("python -m pip install shtab")
+      print("\n# Generate static bash completion for 'struct':")
+      print("mkdir -p ~/.local/share/bash-completion/completions")
+      print("python -m shtab struct_module.main:get_parser -s bash -o ~/.local/share/bash-completion/completions/struct")
+      print("\n# Apply now (or open a new shell):")
       print("source ~/.bashrc")
 
     elif shell == "zsh":
-      print("\n# One-time dependency (if not installed):")
-      print("python -m pip install argcomplete")
-      print("\n# Enable completion for 'struct' in zsh (append to ~/.zshrc):")
-      print('echo "eval \"$(register-python-argcomplete --shell zsh struct)\"" >> ~/.zshrc')
-      print("\n# Apply now:")
-      print("source ~/.zshrc")
+      print("\n# Install shtab (once, in your environment):")
+      print("python -m pip install shtab")
+      print("\n# Generate static zsh completion for 'struct':")
+      print("mkdir -p ~/.zfunc")
+      print("python -m shtab struct_module.main:get_parser -s zsh -o ~/.zfunc/_struct")
+      print("\n# Ensure zsh loads user functions/completions (append to ~/.zshrc if needed):")
+      print('echo "fpath=(~/.zfunc $fpath)" >> ~/.zshrc')
+      print('echo "autoload -U compinit && compinit" >> ~/.zshrc')
+      print("\n# Apply now (or open a new shell):")
+      print("exec zsh")
 
     elif shell == "fish":
-      print("\n# One-time dependency (if not installed):")
-      print("python -m pip install argcomplete")
-      print("\n# Install fish completion file for 'struct':")
+      print("\n# Install shtab (once, in your environment):")
+      print("python -m pip install shtab")
+      print("\n# Generate static fish completion for 'struct':")
       print('mkdir -p ~/.config/fish/completions')
-      print('register-python-argcomplete --shell fish struct > ~/.config/fish/completions/struct.fish')
+      print('python -m shtab struct_module.main:get_parser -s fish -o ~/.config/fish/completions/struct.fish')
       print("\n# Apply now:")
       print("fish -c 'source ~/.config/fish/completions/struct.fish'")
 
     else:
       self.logger.error(f"Unsupported shell: {shell}. Supported: {', '.join(SUPPORTED_SHELLS)}")
       return
 
-    print("\nTip: If 'register-python-argcomplete' is not found, try:\n  python -m argcomplete.shellintegration <shell>")
+    print("\nTip: You can also print completion directly via: struct --print-completion <shell>")

struct_module/main.py

@@ -1,4 +1,4 @@
-import argparse, argcomplete
+import argparse
 import logging
 from dotenv import load_dotenv
 from struct_module.utils import read_config_file, merge_configs
@@ -10,11 +10,15 @@
 from struct_module.commands.mcp import MCPCommand
 from struct_module.logging_config import configure_logging
 
-
+# Optional dependency: shtab for static shell completion generation
+try:
+    import shtab  # type: ignore
+except Exception:  # pragma: no cover - optional at runtime
+    shtab = None
 
 load_dotenv()
 
-def main():
+def get_parser():
     parser = argparse.ArgumentParser(
       description="Generate project structure from YAML configuration.",
       prog="struct",
@@ -35,11 +39,19 @@ def main():
     from struct_module.commands.init import InitCommand
     InitCommand(subparsers.add_parser('init', help='Initialize a basic .struct.yaml in the target directory'))
 
-    # completion installer
+    # completion manager
     from struct_module.commands.completion import CompletionCommand
     CompletionCommand(subparsers.add_parser('completion', help='Manage shell completions'))
 
-    argcomplete.autocomplete(parser)
+    # Add shtab completion printing flags if available
+    if shtab is not None:
+        # Adds --print-completion and --shell flags
+        shtab.add_argument_to(parser)
+
+    return parser
+
+def main():
+    parser = get_parser()
 
     args = parser.parse_args()
 
@@ -49,14 +61,13 @@ def main():
       parser.exit()
 
     # Read config file if provided
-    if args.config_file:
+    if getattr(args, 'config_file', None):
       file_config = read_config_file(args.config_file)
       args = argparse.Namespace(**merge_configs(file_config, args))
 
-    logging_level = getattr(logging, args.log.upper(), logging.INFO)
-
-    configure_logging(level=logging_level, log_file=args.log_file)
+    logging_level = getattr(logging, getattr(args, 'log', 'INFO').upper(), logging.INFO)
 
+    configure_logging(level=logging_level, log_file=getattr(args, 'log_file', None))
 
     args.func(args)