# 沒有參數(shù)
python main.py

# 有參數(shù)
python main.py --debug --batch_size 32 --lr 0.001

python my_script.py --input data.txt --verbose --output results.json

import argparse

# 創(chuàng)建 ArgumentParser 對(duì)象，description 參數(shù)用于描述程序的功能，會(huì)顯示在幫助信息中。
parser = argparse.ArgumentParser(description='這是一個(gè)處理文件的示例程序。')

# 添加一個(gè)位置參數(shù) ‘filename'
parser.add_argument('filename', help='要處理的輸入文件') # help 參數(shù)用于生成幫助信息

# 添加一個(gè)可選參數(shù) ‘--output' (短選項(xiàng) ‘-o‘)
parser.add_argument('-o', '--output', help='輸出文件的路徑')

# 添加一個(gè)布爾標(biāo)志，action=‘store_true' 表示如果指定了這個(gè)參數(shù)，其值為 True，否則為 False。
parser.add_argument('-v', '--verbose', action='store_true', help='顯示詳細(xì)處理信息')

# 指定參數(shù)類型，比如整數(shù)
parser.add_argument('-n', '--number', type=int, help='一個(gè)數(shù)字參數(shù)', default=1) # default 指定默認(rèn)值

# 限制參數(shù)的選擇范圍
parser.add_argument('--mode', choices=['fast', 'slow', 'debug'], default='fast', help='程序運(yùn)行模式')

# store_true: 如果指定了該參數(shù)，就存儲(chǔ) True，否則存儲(chǔ) False
parser.add_argument('--debug', action='store_true')
# python script.py --debug  →  args.debug = True
# python script.py          →  args.debug = False

# store_const: 存儲(chǔ)一個(gè)固定值
parser.add_argument('--mode', action='store_const', const='fast')
# python script.py --mode  →  args.mode = 'fast'

# store: 存儲(chǔ)提供的值（默認(rèn)動(dòng)作）
parser.add_argument('--name', type=str)
# python script.py --name Alice  →  args.name = 'Alice'

# append: 將多個(gè)值收集到列表中
parser.add_argument('--add', action='append')
# python script.py --add a --add b  →  args.add = ['a', 'b']

args = parser.parse_args()
# 現(xiàn)在，你可以通過 args.參數(shù)名 來訪問每個(gè)參數(shù)的值

print(f"正在處理文件： {args.filename}")
if args.verbose:
    print("詳細(xì)模式已開啟。")
if args.output:
    print(f"結(jié)果將輸出到： {args.output}")
print(f"運(yùn)行模式為： {args.mode}")
print(f"數(shù)字參數(shù)是： {args.number}")

import argparse

# 1. 創(chuàng)建解析器
parser = argparse.ArgumentParser(description='一個(gè)強(qiáng)大的文件處理工具。')

# 2. 添加參數(shù)
parser.add_argument('filename', help='輸入文件的名稱')
parser.add_argument('-o', '--output', help='輸出文件的路徑')
parser.add_argument('-v', '--verbose', action='store_true', help='開啟詳細(xì)輸出')
parser.add_argument('-n', '--number', type=int, default=1, help='處理的次數(shù) (默認(rèn)： 1)')
parser.add_argument('--mode', choices=['fast', 'slow', 'debug'], default='fast', help='選擇運(yùn)行模式')

# 3. 解析參數(shù)
args = parser.parse_args()

# 4. 使用參數(shù)
print(f"輸入文件: {args.filename}")

if args.verbose:
    print("狀態(tài)： 詳細(xì)模式已激活。")
    print(f"正在以 '{args.mode}' 模式運(yùn)行。")
    print(f"將處理 {args.number} 次。")

if args.output:
    print(f"輸出將保存至: {args.output}")

# ... 這里是你實(shí)際的程序邏輯，例如讀寫文件等 ...

import argparse

def main():
    # 1. 創(chuàng)建解析器
    parser = argparse.ArgumentParser(
        description='一個(gè)簡(jiǎn)單的文件處理程序',
        epilog='示例: python script.py input.txt --verbose --output result.txt'
    )
    
    # 2. 添加位置參數(shù)（必須提供）
    parser.add_argument('input_file', help='要處理的輸入文件')
    
    # 3. 添加可選參數(shù)
    parser.add_argument('--output', '-o', 
                       type=str, 
                       default='output.txt',
                       help='輸出文件名（默認(rèn): output.txt）')
    
    parser.add_argument('--verbose', '-v',
                       action='store_true',
                       help='顯示詳細(xì)處理信息')
    
    parser.add_argument('--count', '-c',
                       type=int,
                       default=1,
                       choices=[1, 2, 3, 4, 5],
                       help='處理次數(shù)（1-5，默認(rèn): 1）')
    
    # 4. 解析參數(shù)
    args = parser.parse_args()
    
    # 5. 使用參數(shù)
    print(f"輸入文件: {args.input_file}")
    print(f"輸出文件: {args.output}")
    print(f"詳細(xì)模式: {args.verbose}")
    print(f"處理次數(shù): {args.count}")
    
    # 模擬處理邏輯
    if args.verbose:
        print("開始處理文件...")
        print(f"正在處理: {args.input_file}")
        print(f"將保存到: {args.output}")
        print(f"將處理 {args.count} 次")

if __name__ == '__main__':
    main()

# 查看幫助
python script.py -h
# 輸出：
# usage: script.py [-h] [--output OUTPUT] [--verbose] [--count COUNT] input_file
# 
# 一個(gè)簡(jiǎn)單的文件處理程序
# 
# positional arguments:
#   input_file           要處理的輸入文件
# 
# optional arguments:
#   -h, --help           show this help message and exit
#   --output OUTPUT, -o OUTPUT
#                        輸出文件名（默認(rèn): output.txt）
#   --verbose, -v        顯示詳細(xì)處理信息
#   --count COUNT, -c COUNT
#                        處理次數(shù)（1-5，默認(rèn): 1）
# 
# 示例: python script.py input.txt --verbose --output result.txt

# 正常運(yùn)行
python script.py data.txt --verbose --output result.txt --count 3
# 輸出：
# 輸入文件: data.txt
# 輸出文件: result.txt
# 詳細(xì)模式: True
# 處理次數(shù): 3
# 開始處理文件...
# 正在處理: data.txt
# 將保存到: result.txt
# 將處理 3 次

parser.add_argument('--required_arg', required=True, help='這個(gè)參數(shù)必須提供')