掌握 Python 命令行界面 (CLI):综合指南

千晨同学_9954

千晨同学_9954

2024-09-15

1445人浏览

转载

掌握 python 命令行界面 (cli):综合指南

介绍

python 以其多功能性和易用性而闻名,尤其是在构建命令行界面 (cli) 应用程序时。无论您是想自动执行日常任务、构建开发人员工具还是创建灵活的脚本,python 丰富的生态系统都提供了各种库来高效处理 cli。

在这篇博文中,我们将深入探讨如何使用 python 中的 cli,涵盖以下内容:

  • 为什么要构建 cli?
  • 用于构建 cli 的 python 模块
  • 命令行参数的基础知识
  • 使用 argparse 的高级功能
  • 通过单击构建 cli 工具
  • cli 工具中的错误处理
  • 打包 cli 工具进行分发

在这篇文章结束时,您将能够创建强大且用户友好的命令行应用程序。


为什么要构建 cli?

cli 广泛用于系统管理、数据处理和软件开发,因为它们提供:

  1. 自动化:编写重复任务脚本以节省时间并减少错误。
  2. 简单性:通过几次按键即可运行复杂的命令。
  3. 可移植性:一个精心构建的 cli 工具可以在任何没有 gui 的机器上使用。
  4. 开发者工具:许多开发工具(如 git、npm 和 pip)都是基于 cli 的。

用于 cli 开发的 python 模块

python 提供了多个库来构建 cli 工具:

  1. sys.argv:直接访问命令行参数,适合小型、简单的脚本。
  2. argparse:用于处理命令行参数并自动生成帮助的内置模块。
  3. click:一个强大而灵活的库,用于创建复杂的 cli 应用程序。
  4. typer:一个基于 click 构建的现代库,它使用 python 类型提示以方便使用。

使用 sys.argv

sys.argv 是访问命令行参数的基本方法。它将命令行参数存储为列表,其中第一个元素始终是脚本名称。

import sys

# command-line arguments
print(f"script name: {sys.argv[0]}")
print(f"arguments: {sys.argv[1:]}")

运行脚本:

$ python script.py arg1 arg2 arg3
script name: script.py
arguments: ['arg1', 'arg2', 'arg3']

sys.argv 的限制:

  • 无类型检查:所有输入都被视为字符串。
  • 没有内置帮助消息:您需要手动验证输入并显示使用信息。

使用 argparse 构建 cli

argparse 模块是用于创建 cli 的 python 标准库。它提供比 sys.argv 更多的控制,并自动生成帮助消息和错误处理。

基本示例:

import argparse

parser = argparse.argumentparser(description="a simple cli tool")
parser.add_argument("name", help="your name")
parser.add_argument("--greet", help="custom greeting", default="hello")

args = parser.parse_args()

print(f"{args.greet}, {args.name}!")

运行脚本:

$ python script.py alice
hello, alice!

$ python script.py alice --greet hi
hi, alice!

argparse 的主要特性:

  1. 位置和可选参数:轻松定义必需和可选参数。
  2. 类型检查:确保用户提供正确的数据类型。
  3. 选择:使用choices参数将输入限制为特定值。
  4. 帮助消息:使用 -h 或 --help 标志自动生成帮助。

类型检查和选择示例:

parser.add_argument("age", type=int, help="your age")
parser.add_argument("--format", choices=["json", "xml"], help="output format")

运行脚本:

$ python script.py alice 30 --format json

点击即可使用高级 cli 工具

click 是一个用于创建命令行界面的更高级的库。它提供了一种基于装饰器的方法来定义命令、子命令和选项。

为什么要使用点击?

  • 更好的可读性:更pythonic、基于装饰器的语法。
  • 自动参数验证:确保参数得到正确验证。
  • 可重用组件:命令、选项和参数可以在应用程序的不同部分轻松重用。

使用点击的基本示例:

import click

@click.command()
@click.option('--name', prompt='your name', help='the person to greet.')
@click.option('--greet', default="hello", help='greeting to use.')
def greet(name, greet):
    """simple program that greets name with a greet."""
    click.echo(f'{greet}, {name}!')

if __name__ == '__main__':
    greet()

运行脚本:

$ python greet.py --name alice --greet hi
hi, alice!

点击子命令:

您可以使用多个子命令创建更复杂的 cli 工具。

使用 Claude Agent SDK 将绑定的 Claude 代码会话嵌入到 Python 自动化中
使用 Claude Agent SDK 将绑定的 Claude 代码会话嵌入到 Python 自动化中

当现有的脚本或服务需要将作用域化的仓库工作委托给 Claude Code 并以编程方式消费结构化响应时,请使用 Claude Agent SDK for Python。

下载
import click

@click.group()
def cli():
    pass

@cli.command()
def start():
    click.echo("starting the application...")

@cli.command()
def stop():
    click.echo("stopping the application...")

if __name__ == '__main__':
    cli()

运行脚本:

$ python app.py start
starting the application...

$ python app.py stop
stopping the application...

cli 工具中的错误处理

无论您使用哪个库,错误处理对于提供流畅的用户体验都至关重要。

argparse 中的示例:

如果缺少必需的参数,argparse 将抛出错误并显示使用说明:

$ python script.py
usage: script.py [-h] name
script.py: error: the following arguments are required: name

点击错误处理:

在单击中,您可以使用装饰器引发自定义异常并优雅地处理错误。

@click.command()
@click.option('--count', type=int, help='number of repetitions')
def repeat(count):
    if count is none or count <hr><h3>
  
  
  <strong>将 argparse 和 click 与其他库结合</strong>
</h3><p>要扩展 cli 功能,您可以将 argparse 或 click 与其他库(如操作系统、子进程,甚至自定义库)结合起来。</p><h4>
  
  
  <strong>示例:将 argparse 与 os 结合</strong>
</h4><pre class="brush:php;toolbar:false;">import os
import argparse

parser = argparse.argumentparser(description="file operations cli")
parser.add_argument("filename", help="name of the file to check")
parser.add_argument("--create", action="store_true", help="create the file if it does not exist")

args = parser.parse_args()

if os.path.exists(args.filename):
    print(f"{args.filename} already exists.")
else:
    if args.create:
        with open(args.filename, 'w') as f:
            f.write("new file created.")
        print(f"{args.filename} created.")
    else:
        print(f"{args.filename} does not exist.")

运行脚本:

$ python filecli.py example.txt --create
example.txt created.

打包您的 cli 工具

要分发 cli 工具,您可以使用 setuptools 对其进行打包,并使其在任何系统上均可全局访问。

第1步:创建setup.py文件

from setuptools import setup

setup(
    name='greet-cli',
    version='0.1',
    py_modules=['greet'],
    install_requires=[
        'click',
    ],
    entry_points='''
        [console_scripts]
        greet=greet:greet
    ''',
)

第 2 步:在本地安装 cli

$ pip install --editable .

现在,greet 命令在全球可用:

$ greet --name alice
hello, alice!

在 pypi 上分发

要公开分发您的工具,请创建一个 pypi 帐户并按照以下步骤上传您的包:

  1. 构建包:
   python setup.py sdist bdist_wheel
  1. 上传包:
   twine upload dist/*

构建 cli 的最佳实践

  1. 提供清晰的帮助消息:始终包含 --help 来指导用户。
  2. 验证输入:使用类型检查并优雅地处理异常。
  3. 设计直观的命令:确保您的命令结构符合逻辑且易于使用。
  4. 使用边缘情况进行测试:即使输入无效,也确保您的 cli 工具正常运行。
  5. 模块化您的代码:将命令行逻辑与核心功能分开,以便于测试和维护。

结论

python 提供了一个用于构建命令行界面 (cli) 应用程序的优秀工具包。无论您使用内置的 argparse 模块还是功能更丰富的 click,您都可以创建功能强大、用户友好的工具,这些工具可以自动化工作流程、处理数据并提高生产力。

现在您已经了解了在 python 中使用 cli 的基础知识和高级功能,是时候将其付诸实践了。构建您自己的工具,分享它,甚至在全球范围内分发它!


如有问题或建议,请随时联系:

  • 领英
  • github

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python git 标准库

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2023.10.09

3750

5

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

2024.12.20

8503

6

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

2024.12.23

10262

11

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

2025.07.23

5447

16

数据类型有哪几种
数据类型有哪几种

数据类型有整型、浮点型、字符型、字符串型、布尔型、数组、结构体和枚举等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.31

3671

5

php数据类型
php数据类型

本专题整合了php数据类型相关内容,阅读专题下面的文章了解更多详细内容。

2025.10.31

574

9

c语言 数据类型
c语言 数据类型

本专题整合了c语言数据类型相关内容,阅读专题下面的文章了解更多详细内容。

2026.02.12

622

19

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1978

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3324

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程