Kids python命令行库
项目描述
kids.cmd 是一个Python库,提供在Python中编写命令行实用程序的辅助工具。
它是“Kids”(即保持简单)库的一部分。
成熟度
此代码处于alpha阶段。它未在Windows上进行测试。API可能会更改。这更像是一个持续反思的草案。
我还应该加上这可能还没有准备好展示。尽管如此,这些功能中的许多每天都在我的项目中使用,而且每次都要为每个项目重写它们,让我感到厌烦。
特性
使用 kids.cmd
利用 docopt 库,让您只需编写一次帮助和用法文档,解析将自动从这个相同的描述中完成。
使用 kids.ansi 提供漂亮的彩色输出。
具有内置菜单的简洁用户输入,一键或多键。
这些假设在代码中
您不想与命令行解析纠缠,并将使用与 docopt 命令行兼容的标准命令行。
您喜欢有一个非常简单的范例,默认行为可以在之后学习。
兼容性
此代码适用于python2和python3。它未在Windows上进行测试。
安装
由于 kids.cmd 可在PyPI上获取,因此您无需下载代码的GIT版本。因此,您应该能够运行
pip install kids.cmd
如果您已下载GIT源,则可以通过传统方式安装当前版本
python setup.py install
如果您没有GIT源但希望从GitHub获取最新的master或分支,您也可以
pip install git+https://github.com/0k/kids.cmd
或者甚至选择一个特定的修订版本(分支/标签/提交)
pip install git+https://github.com/0k/kids.cmd@master
用法
待定
贡献
任何建议或问题都欢迎。非常欢迎提交拉取请求,请查看指南。
拉取请求指南
您可以发送任何代码。我会查看它,并自行将其集成到代码库中,并保留您为作者。这个过程可能需要时间,如果您遵循以下指南,则所需时间会更短。
使用PEP8或pylint检查您的代码。尽量保持80列宽。
按最小关注点分开提交。
每个提交都应该通过测试(以便容易进行二分查找)
每个功能/错误修复提交应包含代码、测试和文档。
优先处理带有印刷或代码外观更改的较小提交。这些应在提交摘要中使用!minor标记。
提交信息应遵循gitchangelog规则(检查git日志以获取示例)
如果提交修复了问题或完成了功能的实现,请在摘要中提及。
如果您对这里未解答的指南有任何疑问,请查看当前的git日志,您可能会找到以前的提交,这会向您展示如何处理您的问题。
许可协议
版权(c)2018 Valentin Lab。
在BSD许可证下许可。
变更日志
0.0.5 (2018-09-25)
新增
支持复杂的\*_DEBUG值以调整日志。 [Valentin Lab]
<exname>_DEBUG中的环境变量现在支持字符串,如:“my.module:DEBUG,my.other.module:WARN”。当然,日志消息应使用python logging模块。
修复
更好的命名空间方案。 [Valentin Lab]
之前的版本会导入pkg_resources,这可能会根据安装的包的数量花费一些线性时间。
其他
Pkg: fix: 包含LICENSE在最终包中。 [Valentin Lab]
0.0.4 (2016-03-03)
新增
[cmd] 支持在通过命令入口点调用时找到模块。 [Valentin Lab]
[cmd] 在pkg_resources eggs中支持发现模块命令。 [Valentin Lab]
以前,如果您的命令被打包到一个单独的文件zip egg中,则不会发现命令。
0.0.3 (2015-03-12)
新增
[cmd] 将exname添加到发送到子命令的__env__参数中。 [Valentin Lab]
[cmd] 捕获未捕获的异常,并隐藏完整的跟踪信息,除非设置了调试环境变量。 [Valentin Lab]
变更
[cmd] .cfg 提供对配置文件的读写访问。 [Valentin Lab]
修复
[menu] 行调用会失败,因为对 kids.ansi 的调用不正确。 [Valentin Lab]
修复了关于参数分配的一系列错误。 [Valentin Lab]
对该功能进行了彻底的测试。
0.0.2 (2015-02-06)
首次导入。 [Valentin Lab]
项目详情
下载文件
下载适合您平台的应用程序。如果您不确定要选择哪个,请了解更多关于安装包的信息。
源分布
构建分布
kids.cmd-0.0.5.tar.gz 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 80e33ac2e8fd08bac19c5d6ca9271e990ab04491f87fd579337aae2b6519d9b0 |
|
MD5 | e414e79302589620f12e8e87ab5181c7 |
|
BLAKE2b-256 | 78cfde61c524f69935b2560fa912a0bca559ddcee5a20e05fd859e4cee36e227 |
kids.cmd-0.0.5-py2-none-any.whl 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 79b773c88aaa0973a7a12474e898c7c704a8600ac2d19b689610aa90e0283e20 |
|
MD5 | ff009e0675382e19dcca6e8a0931f271 |
|
BLAKE2b-256 | 138b6708ed137c62a48af528928d16889e03b50ee91e3b7fda3f9ad38156cd03 |