autoverse-cli 0.25.1__py3-none-any.whl → 0.26.0__py3-none-any.whl

{autoverse_cli-0.25.1.dist-info → autoverse_cli-0.26.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autoverse-cli
-Version: 0.25.1
+Version: 0.26.0
 Summary: The Autoverse CLI
 Author-email: Dan Kamrath <dan.kamrath@autonomalabs.com>
 License: # End-User License Agreement (EULA) of the Autonoma AutoVerse CLI
@@ -43,8 +43,49 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: boto3
 Requires-Dist: cantools
+Requires-Dist: argcomplete
 Dynamic: license-file
 
 # Autoverse CLI
 
 The new implementation of the Autoverse CLI
+
+## Installation
+
+```bash
+pip install autoverse-cli
+```
+
+## Shell Completion
+
+To enable tab completion for the `avrs` command, run:
+
+```bash
+avrs --install-completion
+```
+
+Then reload your shell:
+
+```bash
+source ~/.bashrc  # or ~/.zshrc, ~/.config/fish/config.fish, etc.
+```
+
+For full details, see [SHELL_COMPLETION.md](SHELL_COMPLETION.md).
+
+### Supported Shells
+
+- Bash
+- Zsh
+- Fish
+- Tcsh
+
+### Quick Usage Examples
+
+```bash
+# List all available commands
+avrs <TAB>
+
+# Complete subcommand arguments
+avrs launcher <TAB>
+avrs restart <TAB>
+```

{autoverse_cli-0.25.1.dist-info → autoverse_cli-0.26.0.dist-info}/RECORD

@@ -1,8 +1,8 @@
-autoverse_cli-0.25.1.dist-info/licenses/LICENSE,sha256=d4eWXho-u18HkBsX4K21uHX_bBb2UXZSrJdsb7Z_JlM,2647
+autoverse_cli-0.26.0.dist-info/licenses/LICENSE,sha256=d4eWXho-u18HkBsX4K21uHX_bBb2UXZSrJdsb7Z_JlM,2647
 avrs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-avrs/app_version.py,sha256=2sBfA7DAmJHuyITvNdre0lXwh1mMU29hvS8bqyR3e0Y,856
+avrs/app_version.py,sha256=UUvS1I1VuMQg2VBP8WWwCCptM3e6LCz2PKJqw5Zt-TY,856
 avrs/argparse_help.py,sha256=EoEaohGXZXqJvs1dFEzbo9vh47CYdHdSY2Im2Ps2iFo,945
-avrs/avrs.py,sha256=SrsLChcmXOmLq81ry3XoGh1Kvc1xVZeLpRz_7XtM9xM,5050
+avrs/avrs.py,sha256=pQHc8KLAD0hCxpBoNbXOgj2Et3qiqxSMKyAXFLwWFjE,5787
 avrs/can_tool.py,sha256=IBoctKobBJ3wCq4ZdtuXuXH4AMEUxazCfYT6YP0Luw8,7161
 avrs/can_tool_util.py,sha256=G3q21dTGMLc09SDq_RieoW7kSn-kXPkXxPDjavPh4hQ,7710
 avrs/cfg.py,sha256=kMn08Z4Ms1PAu2-U1QI8weEJeIVEppP4A4_tFfwnjtg,2924
@@ -13,6 +13,7 @@ avrs/race_cloud_bridge_can.py,sha256=K3is7GFzWo2KBojr6V65kz138UfkVFXXofVxSAziArY
 avrs/race_cloud_cfg_util.py,sha256=TF_gsP7c_39MKs1CyzeXkTH-Fwyd8wLkFkMbqQVmdeo,12066
 avrs/race_cloud_fwd_api.py,sha256=jB4kt6Shu9Pj96WPVjK790PZjucYxmuHjjVKczQfyZI,1620
 avrs/race_cloud_util.py,sha256=g1gCxmK-8n32aNj0NWEiZr79s1rB0EYbGmNLabsIW0U,14297
+avrs/shell_completion.py,sha256=_IM85ADKQHYNMlTa1_nhnYWsgdOzRQ7tIFHxAT6EWWA,4298
 avrs/simconfig.py,sha256=UZc4FrxVHUkk2e9IglSpuojXkaL_nPrJW7trbEGgOOo,2907
 avrs/simconfig_util.py,sha256=EDsIwMZeoOm-oyiktVgvKRKjTZtnFyPDc3dMFug7LH0,6044
 avrs/tests.py,sha256=3JeYBjn0tRqHXERDROfzmYuW1KXeCcKur5Bw-EIegto,153
@@ -43,8 +44,8 @@ avrs/requests/toggle_hud.py,sha256=sV5t5QZc4uvRihPVk8jEKZiQNsyF9tsUwq5b4jjZplc,3
 avrs/requests/vd.py,sha256=Rd0mCc89m2yKjftVf0cMHMFbJG4iFd09KzrI-DsCLgI,2606
 avrs/requests/vehicle_input.py,sha256=R1b1xkRtOBkwyU6OSN4bWVlYsIUroZG0WKbYbc4pEH8,729
 avrs/requests/vehicle_replay.py,sha256=7HPfVLjSLNbOyzU77Bz29qpHqRsMUAIWvnwvnNiw2nk,15026
-autoverse_cli-0.25.1.dist-info/METADATA,sha256=iKZVJW4ZyKpEzbJa7oJGLfW8Za6TogklCbzjwS04ZRY,3364
-autoverse_cli-0.25.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-autoverse_cli-0.25.1.dist-info/entry_points.txt,sha256=Cb9qsUyU5AKkklehCcvtfT0-N3SXbUEqvjze4iEU5kE,40
-autoverse_cli-0.25.1.dist-info/top_level.txt,sha256=-AJO2e4MCVej6hY0U84pu5NfMeMW5qaAPSMisDT5rmA,5
-autoverse_cli-0.25.1.dist-info/RECORD,,
+autoverse_cli-0.26.0.dist-info/METADATA,sha256=bZb69UQraajrTSExXiQiXJN0KOSYivme3MNklu2stl4,3935
+autoverse_cli-0.26.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+autoverse_cli-0.26.0.dist-info/entry_points.txt,sha256=Cb9qsUyU5AKkklehCcvtfT0-N3SXbUEqvjze4iEU5kE,40
+autoverse_cli-0.26.0.dist-info/top_level.txt,sha256=-AJO2e4MCVej6hY0U84pu5NfMeMW5qaAPSMisDT5rmA,5
+autoverse_cli-0.26.0.dist-info/RECORD,,

avrs/app_version.py

@@ -2,7 +2,7 @@ import http.client
 import json
 
 def get_app_version():
-    return '0.25.1'
+    return '0.26.0'
 
 def check_app_is_latest():
     pass

avrs/avrs.py

@@ -2,6 +2,7 @@
 import logging
 import argparse
 import os
+import argcomplete
 
 from argparse import RawDescriptionHelpFormatter
 from argparse import RawTextHelpFormatter
@@ -12,6 +13,7 @@ from avrs.launcher import *
 from avrs.can_tool import *
 from avrs.race_cloud import *
 from avrs.argparse_help import *
+from avrs.shell_completion import install_completion, uninstall_completion
 
 from avrs.requests.move_to_landmark import MoveToLandmarkRequest
 from avrs.requests.restart import Restart
@@ -99,14 +101,23 @@ def main():
         action='store_true',
         help='request verbose output')
 
-    sps = parser.add_subparsers(required=True, help='sub-command help')
+    parser.add_argument(
+        '--install-completion',
+        action='store_true',
+        help='install shell completion for avrs CLI')
+
+    parser.add_argument(
+        '--uninstall-completion',
+        action='store_true',
+        help='uninstall shell completion for avrs CLI')
+
+    sps = parser.add_subparsers(required=False, help='sub-command help')
 
     cfg = load_cfg('avrs')
     check_app_is_latest()
 
     AvrsLauncher(sps, cfg)
 
-
     MoveToLandmarkRequest(sps, cfg)
     Restart(sps, cfg)
     ResetToTrack(sps, cfg)
@@ -150,8 +161,23 @@ def main():
     if os.environ.get('AVRS_GEN_DOCS', '0') == '1':
         generate_argparse_docs(parser)
 
+    argcomplete.autocomplete(parser)
     args = parser.parse_args()
-    args.func(args)
+    
+    # Handle completion installation/uninstallation
+    if args.install_completion:
+        install_completion()
+        return
+    
+    if args.uninstall_completion:
+        uninstall_completion()
+        return
+    
+    # Handle subcommands
+    if hasattr(args, 'func'):
+        args.func(args)
+    else:
+        parser.print_help()
 
 if __name__ == '__main__':
     main()

avrs/shell_completion.py

@@ -0,0 +1,121 @@
+import os
+import sys
+import subprocess
+from pathlib import Path
+
+def get_shell_name():
+    """Detect the current shell from SHELL environment variable or parent process."""
+    shell = os.environ.get('SHELL', '')
+    if shell:
+        return os.path.basename(shell)
+    
+    # Fallback: try to get parent shell
+    try:
+        parent_pid = os.getppid()
+        with open(f'/proc/{parent_pid}/comm', 'r') as f:
+            return f.read().strip()
+    except:
+        return 'bash'
+
+def get_shell_config_file():
+    """Get the config file path for the detected shell."""
+    shell = get_shell_name()
+    home = str(Path.home())
+    
+    if 'zsh' in shell:
+        return os.path.join(home, '.zshrc')
+    elif 'fish' in shell:
+        return os.path.join(home, '.config/fish/config.fish')
+    elif 'tcsh' in shell:
+        return os.path.join(home, '.tcshrc')
+    else:  # bash and others
+        return os.path.join(home, '.bashrc')
+
+def get_completion_command():
+    """Get the shell-specific completion registration command."""
+    shell = get_shell_name()
+    
+    # Try to use register-python-argcomplete if available, fall back to register-python-argcomplete3
+    # This makes it compatible with both pip-installed and system-package versions
+    register_cmd = "register-python-argcomplete"
+    
+    if 'zsh' in shell:
+        return f'eval "$({register_cmd} --shell zsh avrs 2>/dev/null || {register_cmd}3 --shell zsh avrs)"'
+    elif 'fish' in shell:
+        return f'{register_cmd} --shell fish avrs 2>/dev/null | source || {register_cmd}3 --shell fish avrs | source'
+    elif 'tcsh' in shell:
+        return f'eval "$({register_cmd} --shell tcsh avrs 2>/dev/null || {register_cmd}3 --shell tcsh avrs)"'
+    else:  # bash
+        return f'eval "$({register_cmd} avrs 2>/dev/null || {register_cmd}3 avrs)"'
+
+def install_completion():
+    """Install shell completion for the avrs CLI."""
+    shell = get_shell_name()
+    config_file = get_shell_config_file()
+    completion_command = get_completion_command()
+    
+    print(f"Installing shell completion for {shell}...")
+    
+    # Check if completion already installed
+    if os.path.exists(config_file):
+        with open(config_file, 'r') as f:
+            content = f.read()
+            if 'register-python-argcomplete' in content and 'avrs' in content:
+                print(f"✓ Completion already installed in {config_file}")
+                return True
+    
+    # Ensure config file exists
+    Path(config_file).parent.mkdir(parents=True, exist_ok=True)
+    
+    # Append completion command
+    try:
+        with open(config_file, 'a') as f:
+            f.write('\n\n# avrs CLI completion\n')
+            f.write(completion_command + '\n')
+        print(f"✓ Completion installed successfully!")
+        print(f"✓ Added to {config_file}")
+        print(f"\nTo activate completion in current shell, run:")
+        print(f"  source {config_file}")
+        return True
+    except Exception as e:
+        print(f"✗ Error installing completion: {e}")
+        print(f"\nManually add this line to {config_file}:")
+        print(f"  {completion_command}")
+        return False
+
+def uninstall_completion():
+    """Remove shell completion for the avrs CLI."""
+    shell = get_shell_name()
+    config_file = get_shell_config_file()
+    
+    print(f"Uninstalling shell completion from {config_file}...")
+    
+    if not os.path.exists(config_file):
+        print("Config file not found.")
+        return False
+    
+    try:
+        with open(config_file, 'r') as f:
+            lines = f.readlines()
+        
+        # Filter out avrs completion lines
+        new_lines = [
+            line for line in lines 
+            if 'register-python-argcomplete' not in line or 'avrs' not in line
+        ]
+        
+        # Also remove the comment line if it's there
+        filtered_lines = []
+        for i, line in enumerate(new_lines):
+            if line.strip() == '# avrs CLI completion':
+                continue
+            filtered_lines.append(line)
+        
+        with open(config_file, 'w') as f:
+            f.writelines(filtered_lines)
+        
+        print(f"✓ Completion uninstalled successfully!")
+        return True
+    except Exception as e:
+        print(f"✗ Error uninstalling completion: {e}")
+        return False