stratis-cli 3.6.2

介绍

stratis-cli是一个提供与Stratis守护程序（stratisd）交互的命令行界面（CLI）的工具。stratis-cli通过D-Bus与stratisd交互。它用Python 3编写。

stratis-cli是无状态的，包含最小的存储相关逻辑。其代码主要包含从命令行解析参数、调用Stratis D-Bus API中的方法，然后处理和显示结果。

安装

您可以直接从stratis-cli项目仓库安装stratis-cli。

stratis-cli 包含一些可能尚未安装的依赖项。您可以选择允许安装脚本从 PyPi 安装任何缺失的依赖项，或者您可能更喜欢使用您发行版的包管理器来安装依赖项。所有 stratis-cli 的直接依赖项都列在 stratis-cli 的 setup.py 文件中的 install_requires 字段中。如果您选择使用安装的包管理器安装依赖项，请在运行 setup.py 脚本之前这样做。

最后，以以下方式运行 setup.py 脚本：

> python setup.py install

运行

安装后，运行需要调用脚本，如下所示：

> stratis --help

或

> stratis --version

要运行而不安装，请检查源代码，切换到顶级目录，并将 PYTHONPATH 环境变量设置为包含库依赖项。例如（如果使用 bash shell）

> export PYTHONPATH="src:../dbus-client-gen/src:../dbus-python-client-gen/src:../into-dbus-python/src:../dbus-signature-pyparsing/src"
> ./bin/stratis --help

由于 stratis 使用 stratisd 的 API，除非您也运行了 Stratis 守护进程，否则大多数操作都会失败。

测试

使用各种测试模式来验证 stratis 的各种属性。有关更多信息，请参阅 tests 子目录中的 README 文件。

该项目已经并且将继续保持 100% 的代码覆盖率。

内部软件架构

stratis 是通过两部分实现的

• parser 包处理配置命令行解析器，该解析器使用 Python argparse 包。

• actions 包接收来自解析器包的有效命令并执行它们，在需要时调用 D-Bus API。解析器使用 Namespace 对象将用户提供的命令行参数传递给 actions 包中的方法。

Python 编码风格

stratis 遵循由 black 格式化工具强制执行的 PEP-8 风格指南。

Tab 补全

偶尔，我们的外部贡献者为各种不同的外壳添加了对 tab-completion 的支持。这些文件包含在 stratis-cli GitHub 发布中，但它们不受 Stratis 项目的支持。我们欢迎对这些文件进行进一步贡献，并将继续将它们包含在内，只要它们对我们用户来说似乎有用。