使用 Python argparse 构建强大的 CLI 命令行工具

import sysfilename = sys.argv[1]  # 如果没有传参会抛出 IndexErrorcount = int(sys.argv[2])  # 如果传入非数字字符串会抛出 ValueError

import argparse# 创建参数解析器parser = argparse.ArgumentParser(description="我的命令行工具")# 添加参数定义（这里省略具体的参数配置）# 解析命令行参数args = parser.parse_args()# 使用解析后的参数# print(args.filename)

parser.add_argument("filename", help="输入文件路径")parser.add_argument("count", help="处理数量")

python script.py data.txt 10

# 完整参数名 + 短别名 + 默认值parser.add_argument("--output", "-o", default="output.txt", help="输出文件路径")

# 出现参数时为 True，不出现时为 Falseparser.add_argument("--verbose", "-v", action="store_true", help="显示详细日志")

# 整数类型校验parser.add_argument("--count", type=int, default=10)# 浮点数类型校验parser.add_argument("--rate", type=float, default=1.5)

parser.add_argument("--format", choices=["json", "csv", "txt"], default="json")

python script.py input.txt --output result.txt -v --count 20 --format json

parser.add_argument("--title", required=True, help="文章标题（必填）")

# 接收一个或多个值parser.add_argument("--tags", nargs="+", help="标签列表")# 使用：--tags python cli tutorial# 接收零个或多个值（可以为空）parser.add_argument("--files", nargs="*")# 使用后直接得到 Python 列表for tag in args.tags:    print(tag)

parser = argparse.ArgumentParser(description="发布队列管理工具")subparsers = parser.add_subparsers(dest="command", required=True)# 定义 list 子命令list_parser = subparsers.add_parser("list", help="显示队列内容")# 定义 add 子命令add_parser = subparsers.add_parser("add", help="添加新项目")add_parser.add_argument("--title", required=True, help="项目标题")# 定义 delete 子命令delete_parser = subparsers.add_parser("delete", help="删除项目")delete_parser.add_argument("--id", required=True, help="项目ID")

python publish.py listpython publish.py add --title "我的文章"python publish.py delete --id 123

import loggingparser.add_argument("--verbose", "-v", action="store_true", help="启用详细日志")args = parser.parse_args()# 根据参数设置日志级别logging.basicConfig(    level=logging.DEBUG if args.verbose else logging.INFO,    format='%(asctime)s - %(levelname)s - %(message)s')

#!/usr/bin/env python3"""文件处理器 CLI 工具"""import argparseimport loggingimport sysdef main():    parser = argparse.ArgumentParser(        description="高级文件处理工具",        epilog="示例: python file_processor.py input.txt --output result.txt --verbose"    )    # 位置参数    parser.add_argument("input_file", help="输入文件路径")    # 可选参数    parser.add_argument("--output", "-o", default="output.txt",                        help="输出文件路径 (默认: output.txt)")    parser.add_argument("--count", type=int, default=10,                        help="处理数量 (默认: 10)")    parser.add_argument("--format", choices=["json", "csv", "txt"],                        default="txt", help="输出格式 (默认: txt)")    parser.add_argument("--verbose", "-v", action="store_true",                        help="显示详细日志信息")    # 必需参数    parser.add_argument("--operation", required=True,                        choices=["process", "validate", "convert"],                       help="指定操作类型")    # 多值参数    parser.add_argument("--tags", nargs="*", default=[],                       help="附加标签列表")    args = parser.parse_args()    # 设置日志级别    logging.basicConfig(        level=logging.DEBUG if args.verbose else logging.INFO,        format='%(asctime)s - %(levelname)s - %(message)s'    )    # 执行主要逻辑    process_files(args)def process_files(args):    """处理文件的主要逻辑"""    logging.info(f"开始处理文件: {args.input_file}")    logging.info(f"输出格式: {args.format}, 数量: {args.count}")    if args.tags:        logging.info(f"标签: {', '.join(args.tags)}")    # 这里添加实际的文件处理逻辑    logging.info("文件处理完成!")if __name__ == "__main__":    main()