#Python 命令行参数解析教程

import sys

print("接收到的完整命令行参数列表：", sys.argv)

import argparse

# 第一步：搭收纳箱
parser = argparse.ArgumentParser(
    prog="my_cli_tool",          # 工具的正式名称（帮助文档用）
    description="这是一个示例工具的简介",  # 开头的说明
    epilog="© 202X 我的开发笔记"  # 帮助文档结尾的版权/补充信息
)

# 第二步：塞参数（后面会详细讲）
parser.add_argument("file_path", help="要操作的文件路径")

# 第三步：解析+用
if __name__ == "__main__":
    args = parser.parse_args()
    print(f"开始处理文件：{args.file_path}")

parser.add_argument(
    "outfile", 
    help="数据库备份的输出文件路径"  # 必须加 help！！
)

parser.add_argument(
    "-u", "--user",           # 可以只写短/只写长，也可以都写
    required=True,            # 可选参数也可以强制要求填！
    help="登录数据库的用户名"
)

parser.add_argument(
    "--host",
    default="localhost",
    help="MySQL 主机地址"
)

# 直接转 int
parser.add_argument(
    "--port",
    type=int,
    default=3306,
    help="MySQL 端口号"
)

# 自定义验证（比如要求端口在1-65535之间）
def check_port(port_str):
    port = int(port_str)
    if 1 <= port <= 65535:
        return port
    raise argparse.ArgumentTypeError(f"端口必须在 1-65535 之间，你输入的是 {port}")

parser.add_argument(
    "--safe-port",
    type=check_port,
    default=3306,
    help="安全的 MySQL 端口号"
)

# 出现 --gz 就设为 True
parser.add_argument(
    "-g", "--gz",
    action="store_true",
    help="是否启用 GZIP 压缩备份文件"
)

# 出现 --no-color 就设为 False（默认 True）
parser.add_argument(
    "--no-color",
    action="store_false",
    dest="enable_color",  # dest可以修改解析后对象的属性名
    default=True,
    help="是否禁用彩色输出"
)

parser.add_argument(
    "--format",
    choices=["json", "xml", "csv"],
    default="json",
    help="备份文件的输出格式"
)

import argparse

def backup_database(outfile, host, port, user, password, database, gz):
    """模拟数据库备份的核心逻辑"""
    print(f"✅ 开始准备备份任务")
    print(f"📁 输出文件：{outfile}{'.gz' if gz else ''}")
    print(f"🔗 连接信息：{user}@{host}:{port}/{database}")
    if gz:
        print("📦 GZIP 压缩已启用")

if __name__ == "__main__":
    # 1. 搭收纳箱
    parser = argparse.ArgumentParser(
        prog="db_backup",
        description="轻量级 MySQL 数据库本地备份工具",
        epilog="⚠️ 使用前请确保已安装 mysqldump"
    )

    # 2. 塞所有参数
    parser.add_argument("outfile", help="备份文件的本地路径（不带.gz后缀）")
    parser.add_argument("--host", default="localhost", help="MySQL 主机地址")
    
    def check_port(port_str):
        port = int(port_str)
        if 1 <= port <= 65535:
            return port
        raise argparse.ArgumentTypeError(f"端口必须在 1-65535 之间")
    parser.add_argument("--port", type=check_port, default=3306, help="MySQL 端口号")
    
    parser.add_argument("-u", "--user", required=True, help="登录用户名")
    parser.add_argument("-p", "--password", required=True, help="登录密码")
    parser.add_argument("--database", required=True, help="要备份的数据库名")
    parser.add_argument("-g", "--gz", action="store_true", help="启用 GZIP 压缩")

    # 3. 解析+运行
    args = parser.parse_args()
    backup_database(
        args.outfile,
        args.host,
        args.port,
        args.user,
        args.password,
        args.database,
        args.gz
    )

# 分组1：连接配置
conn_group = parser.add_argument_group("连接配置", "关于 MySQL 服务器的设置")
conn_group.add_argument("--host", default="localhost")
conn_group.add_argument("--port", type=int, default=3306)
conn_group.add_argument("-u", "--user", required=True)
conn_group.add_argument("-p", "--password", required=True)

# 分组2：备份配置
backup_group = parser.add_argument_group("备份配置", "关于备份文件的设置")
backup_group.add_argument("outfile")
backup_group.add_argument("--format", choices=["sql", "csv"], default="sql")
backup_group.add_argument("-g", "--gz", action="store_true")

import argparse

if __name__ == "__main__":
    parser = argparse.ArgumentParser(prog="db_tool", description="MySQL 管理工具集")
    # 必须加 dest='command'，这样解析后才能知道用户选了哪个子命令
    subparsers = parser.add_subparsers(dest="command", required=True, help="可用的子命令")

    # --------------------------
    # 子命令1：backup
    # --------------------------
    backup_parser = subparsers.add_parser("backup", help="备份数据库到本地")
    backup_parser.add_argument("outfile", help="输出文件路径")
    # 这里可以复用之前的分组/参数...

    # --------------------------
    # 子命令2：restore
    # --------------------------
    restore_parser = subparsers.add_parser("restore", help="从本地文件恢复数据库")
    restore_parser.add_argument("infile", help="输入的备份文件路径")
    # 同样可以复用...

    args = parser.parse_args()
    if args.command == "backup":
        print("执行备份逻辑")
    elif args.command == "restore":
        print("执行恢复逻辑")

import click

@click.command()
@click.argument("outfile")
@click.option("--host", default="localhost", help="MySQL 主机")
@click.option("--port", default=3306, type=int, help="MySQL 端口")
@click.option("-u", "--user", required=True, help="用户名")
@click.password_option("-p", "--password", help="密码")  # 自带密码隐藏功能！
@click.option("-g", "--gz", is_flag=True, help="启用压缩")
def db_backup(outfile, host, port, user, password, gz):
    click.echo(f"备份到 {outfile}")

if __name__ == "__main__":
    db_backup()

import typer

app = typer.Typer()

@app.command()
def backup(
    outfile: str,
    host: str = "localhost",
    port: int = 3306,
    user: str = typer.Option(..., help="用户名"),  # ...表示必填
    password: str = typer.Option(..., prompt=True, hide_input=True, help="密码"),  # 交互式输入密码
    gz: bool = typer.Option(False, "--gz", "-g", help="启用压缩")
):
    typer.echo(f"✅ 备份到 {outfile}")

if __name__ == "__main__":
    app()