我们有一些方法可以做出Python的命令行式app。我试过它们,不过它们大都有自己的痛点和烦恼。所以我到社区里去寻找一种更好的方法。

ipython 添加命令 命令行编写python_根目录

什么是CLI?

CLI 意味着命令行界面(command line interface)。它是一类用命令行/终端调用的app。作为开发人员,更是一个少用鼠标,多用键盘党,我一直使用CLI应用。当我需要一些为自己服务的定制软件时,CLI就能满足我的需求,而python是一门能够快速生产CLI应用的伟大语言。

文件系统结构pycli/

├── README.md
├── install.sh
├── pycli
├── __init__.py
├── __main__.py
├── classmodule.py
└── funcmodule.py
└── setup.py

正如你所见,该项目的根目录被我命名为pycli。该应用也将在setup.py中被设置为以名称pycli被调用。

ipython 添加命令 命令行编写python_根目录

CLI子目录

在该CLI根目录下只有一个子目录。它的名字和CLI应用同名,但是在更复杂的CLI应用中,你需要有多个包。每个子目录是每个包的容器。在我的简单案例中,只有单个包,也就是单个子目录。

__init__.py

这个文件(空文件)放在这里是告诉Python这个目录是一个包。它可以是空的,只是做个关于包的简单提示;也可以包含实际代码,在包自身初始化时会被运行。

__main__.py

这是重要部分,是我们CLI应用的入口,根目录下的setup.py中的安装配置会指示它。这里只是放些简单的代码在这里表明它起作用了。import sysfrom .classmodule import MyClassfrom .funcmodule import my_functiondef main(): # 以下内容中的参数解析方式并不好,这里只是为了简单# 最好使用argparse或者click模块做这方面的工具

print('in main')
args = sys.argv[1:]
print('count of args :: {}'.format(len(args))) for arg in args:
print('passed argument :: {}'.format(arg))
my_function('hello world')
my_object = MyClass('Thomas')
my_object.say_name()#以下无关于包安装,只是为了本文件的测试if __name__ == '__main__':
main()

上面所做的只是引入一些其它模块,分析被传入CLI的命令行参数,然后使用导入模块的成员(一个简单的函数和一个简单的类)。

classmodule.py

一个被导入__main__.py并被实例化的极简的类(也没啥用)。这里是为了说明如何从同一个包里的其它模块中引入一个类。class MyClass():

def __init__(self, name): self.name = name def say_name(self):
print('name is {}'.format(self.name))
funcmodule.py
classmodule.py展示如何为__main__.py定义一个可以导入的类,funcmodule.py则展示了如何定义一个简单的函数让__main__.py导入并调用。def my_function(text_to_display):
print('text from my_function :: {}'.format(text_to_display))
setup.py

现在让我们回到CLI源码的根目录。setup.py文件将所有东西联系在一起并告诉Python如何处理它们。from setuptools import setup

setup(
name = 'pycli',
version = '0.1.0',
packages = ['pycli'],
entry_points = { 'console_scripts': [ 'pycli = pycli.__main__:main'
]
})

第一眼看上去可能觉得很复杂。但是全部工作只是从setuptools库导入setup函数,并传入一些参数来调用它。其中大部分是不言自明的。packages参数是根目录下所有包的列表。

entry_points是重要部分。它用字符串表明当前应用该以什么名称被调用,以及被运行时真正调用的是什么。这里写的是pycli = pycli.__main__:main,也就是说,该应用被叫做pycli,当执行该应用时它会调用pycli包下的__main__模块的main函数。就是这样!

install.sh

安装你的Python CLI应用的最佳方式是使用pip(python3则是pip3)。在CLI源码的根目录下运行pip3 install . 将会使用setup.py作为"指令"安装这个应用,同样,使用pip3 uninstall pycli会卸载这个应用。

写在脚本中即是pip3 uninstall pycli -y # 标签-y意味着确认卸载pip3 install .

这样会安装到python Lib的site-packages中,或者更简洁的是pip3 install -e .

这样是在当前根目录下生成了egg-info文件,而在site-packages文件夹中生成一个egg-link链接,如下图

ipython 添加命令 命令行编写python_根目录

这样,就可以直接运行install.sh以现有的CLI源码来更新原来的CLI应用了。

总结

掌握了简单的流程,用python编写命令行程序是简洁高效的。使用结果如首图。

作者:treelake