Initial commit

skills/argparse-patterns/templates/basic-parser.py

@@ -0,0 +1,93 @@
+#!/usr/bin/env python3
+"""
+Basic argparse parser with common argument types.
+
+Usage:
+    python basic-parser.py --help
+    python basic-parser.py deploy app1 --env production --force
+    python basic-parser.py deploy app2 --env staging --timeout 60
+"""
+
+import argparse
+import sys
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description='Deploy application to specified environment',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog='''
+Examples:
+  %(prog)s deploy my-app --env production
+  %(prog)s deploy my-app --env staging --force
+  %(prog)s deploy my-app --env dev --timeout 120
+        '''
+    )
+
+    # Version info
+    parser.add_argument(
+        '--version',
+        action='version',
+        version='%(prog)s 1.0.0'
+    )
+
+    # Required positional argument
+    parser.add_argument(
+        'action',
+        help='Action to perform'
+    )
+
+    parser.add_argument(
+        'app_name',
+        help='Name of the application to deploy'
+    )
+
+    # Optional arguments with different types
+    parser.add_argument(
+        '--env', '-e',
+        default='development',
+        help='Deployment environment (default: %(default)s)'
+    )
+
+    parser.add_argument(
+        '--timeout', '-t',
+        type=int,
+        default=30,
+        help='Timeout in seconds (default: %(default)s)'
+    )
+
+    # Boolean flag
+    parser.add_argument(
+        '--force', '-f',
+        action='store_true',
+        help='Force deployment without confirmation'
+    )
+
+    # Verbose flag (count occurrences)
+    parser.add_argument(
+        '--verbose', '-v',
+        action='count',
+        default=0,
+        help='Increase verbosity (-v, -vv, -vvv)'
+    )
+
+    # Parse arguments
+    args = parser.parse_args()
+
+    # Use parsed arguments
+    print(f"Action: {args.action}")
+    print(f"App Name: {args.app_name}")
+    print(f"Environment: {args.env}")
+    print(f"Timeout: {args.timeout}s")
+    print(f"Force: {args.force}")
+    print(f"Verbosity Level: {args.verbose}")
+
+    # Example validation
+    if args.timeout < 1:
+        parser.error("Timeout must be at least 1 second")
+
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())