Initial commit

skills/argparse-patterns/scripts/validate-parser.sh

@@ -0,0 +1,173 @@
+#!/usr/bin/env bash
+# Validate argparse parser structure and completeness
+
+set -euo pipefail
+
+usage() {
+    cat <<EOF
+Validate argparse parser structure
+
+Usage: $(basename "$0") PARSER_FILE
+
+Checks:
+    - Valid Python syntax
+    - Imports argparse
+    - Creates ArgumentParser
+    - Has main() function
+    - Calls parse_args()
+    - Has proper shebang
+    - Has help text
+    - Has version info
+
+Examples:
+    $(basename "$0") mycli.py
+    $(basename "$0") ../templates/basic-parser.py
+EOF
+    exit 1
+}
+
+if [ $# -eq 0 ]; then
+    usage
+fi
+
+PARSER_FILE="$1"
+
+if [ ! -f "$PARSER_FILE" ]; then
+    echo "Error: File not found: $PARSER_FILE"
+    exit 1
+fi
+
+echo "Validating argparse parser: $PARSER_FILE"
+echo ""
+
+ERRORS=0
+WARNINGS=0
+
+# Check shebang
+if head -n1 "$PARSER_FILE" | grep -q '^#!/usr/bin/env python'; then
+    echo "✓ Has proper Python shebang"
+else
+    echo "✗ Missing or invalid shebang"
+    ((ERRORS++))
+fi
+
+# Check syntax
+if python3 -m py_compile "$PARSER_FILE" 2>/dev/null; then
+    echo "✓ Valid Python syntax"
+else
+    echo "✗ Invalid Python syntax"
+    ((ERRORS++))
+fi
+
+# Check imports
+if grep -q "import argparse" "$PARSER_FILE"; then
+    echo "✓ Imports argparse"
+else
+    echo "✗ Does not import argparse"
+    ((ERRORS++))
+fi
+
+# Check ArgumentParser creation
+if grep -q "ArgumentParser(" "$PARSER_FILE"; then
+    echo "✓ Creates ArgumentParser"
+else
+    echo "✗ Does not create ArgumentParser"
+    ((ERRORS++))
+fi
+
+# Check main function
+if grep -q "^def main(" "$PARSER_FILE"; then
+    echo "✓ Has main() function"
+else
+    echo "⚠ No main() function found"
+    ((WARNINGS++))
+fi
+
+# Check parse_args call
+if grep -q "\.parse_args()" "$PARSER_FILE"; then
+    echo "✓ Calls parse_args()"
+else
+    echo "✗ Does not call parse_args()"
+    ((ERRORS++))
+fi
+
+# Check version
+if grep -q "action='version'" "$PARSER_FILE"; then
+    echo "✓ Has version info"
+else
+    echo "⚠ No version info found"
+    ((WARNINGS++))
+fi
+
+# Check help text
+if grep -q "help=" "$PARSER_FILE"; then
+    echo "✓ Has help text for arguments"
+else
+    echo "⚠ No help text found"
+    ((WARNINGS++))
+fi
+
+# Check description
+if grep -q "description=" "$PARSER_FILE"; then
+    echo "✓ Has parser description"
+else
+    echo "⚠ No parser description"
+    ((WARNINGS++))
+fi
+
+# Check if executable
+if [ -x "$PARSER_FILE" ]; then
+    echo "✓ File is executable"
+else
+    echo "⚠ File is not executable (run: chmod +x $PARSER_FILE)"
+    ((WARNINGS++))
+fi
+
+# Check subparsers if present
+if grep -q "add_subparsers(" "$PARSER_FILE"; then
+    echo "✓ Has subparsers"
+
+    # Check if dest is set
+    if grep -q "add_subparsers(.*dest=" "$PARSER_FILE"; then
+        echo "  ✓ Subparsers have dest set"
+    else
+        echo "  ⚠ Subparsers missing dest parameter"
+        ((WARNINGS++))
+    fi
+fi
+
+# Check for choices
+if grep -q "choices=" "$PARSER_FILE"; then
+    echo "✓ Uses choices for validation"
+fi
+
+# Check for type coercion
+if grep -q "type=" "$PARSER_FILE"; then
+    echo "✓ Uses type coercion"
+fi
+
+# Check for argument groups
+if grep -q "add_argument_group(" "$PARSER_FILE"; then
+    echo "✓ Uses argument groups"
+fi
+
+# Check for mutually exclusive groups
+if grep -q "add_mutually_exclusive_group(" "$PARSER_FILE"; then
+    echo "✓ Uses mutually exclusive groups"
+fi
+
+# Summary
+echo ""
+echo "Validation Summary:"
+echo "  Errors: $ERRORS"
+echo "  Warnings: $WARNINGS"
+
+if [ $ERRORS -eq 0 ]; then
+    echo ""
+    echo "✓ Parser validation passed"
+    exit 0
+else
+    echo ""
+    echo "✗ Parser validation failed"
+    exit 1
+fi