跳转到主要内容

Idem-ai通过pop-ml插件扩展了idem,通过翻译日志、状态注释和rend输出,实现了多语言基础设施管理。

项目描述

Made with pop, a Python implementation of Plugin Oriented Programming Made with idem, a Python implementation of Plugin Oriented Programming Documentation is published with Sphinx on docs.idemproject.io Made with Python

idem-ai通过从pop-ml插件中添加翻译功能扩展了idem,从而在基础设施管理流程中实现多语言支持。

关于

idem-ai通过添加从pop-ml插件中获得的翻译功能扩展了idem,这是一个强大的基础设施和配置管理工具。使用idem-ai,您可以在您的基础设施管理流程中启用多语言支持。

将idem-ai集成到您的idem环境中,您将获得访问更多合约和功能,这些功能可以支持idem的各个方面的翻译。来自idem-ai的附加合约提供对日志、状态注释和rend输出的翻译功能。这意味着您可以翻译日志消息、状态中的注释以及命令的渲染输出,以便在多种语言中促进沟通。

idem-ai还引入了一个ml.translate执行模块,允许您使用pop-ml进行即时翻译。此模块可以在SLS中的Jinja中使用,或者直接在命令行中调用,这为您在idem环境中翻译文本提供了灵活性。

借助idem-ai,您可以轻松管理多语言环境,确保在基础设施管理工作流程中跨越语言障碍进行清晰和一致的沟通。

什么是POP?

该项目使用pop构建,它是基于Python的插件导向编程(POP)实现。POP旨在以新的方式结合计算机历史的理念和智慧来解决现代计算机问题。

更多信息

入门指南

先决条件

  • Python 3.8+

  • git (如果从源代码安装或为项目做出贡献)

安装

如果您想使用idem-ai,您可以通过从PyPI安装或从源代码安装来使用它。

从PyPI安装

pip install idem-ai

从源代码安装

# clone repo
git clone git@gitlab.com/vmware/idem/idem-ai.git
cd idem-ai

# Setup venv
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

用法

要使用idem-ai,您需要创建一个YAML配置文件,该文件定义了翻译的行为。

以下是一个示例YAML配置文件

idem:
  translate_output: False
  translate_comments: False
  translate_docs: False
  translate_logs: False
pop_ml:
  source_lang: en
  dest_lang: es

此配置文件包含各种选项,用于控制翻译行为

  • translate_output:如果设置为True,则执行输出将进行翻译。默认值为False。

  • translate_comments:如果设置为True,则状态和执行模块的注释将进行翻译。默认值为False。

  • translate_logs:如果设置为True,则日志消息将进行翻译。默认值为False。

  • dest_lang:翻译的目的语言。默认值为“es”。

  • source_lang:翻译的源语言。默认值为“en”。

必须提供dest_lang参数才能进行翻译。它应该是两个字母的语言代码。

您可以根据需求修改这些选项。

示例

以下是一些示例命令,展示了idem-ai的用法

使用ml.translate执行模块进行文本翻译

idem exec ml.translate "Hello World!" dest_lang=es

使用–translate-logs选项进行日志翻译

idem -c my_config.cfg exec test.ping --translate-logs --log-level=debug

在此示例中,–translate-logs选项启用pop-ml对日志的翻译。这会将日志消息翻译成指定的目标语言。

使用–translate-state-comments选项进行状态注释翻译

idem -c my_config.cfg state my_state.sls --translate-state-comments

在此示例中,–translate-state-comments选项启用对状态注释的翻译。这会将运行中状态输出的注释翻译成指定的目标语言。

使用–translate-output选项进行rend输出翻译

idem -c my_config.cfg exec test.ping --translate-output

在此示例中,–translate-output选项启用对doc子命令rend输出的翻译。但是请注意,启用此选项可能会对CLI程序产生不可预测的行为。建议谨慎使用。

使用–translate-docs选项将idem doc中的docstrings进行翻译

idem -c my_config.cfg doc exec.test.ping --translate-docs

在此示例中,–translate-docs选项启用了对exec.test.ping命令的文档翻译。这会将与指定命令关联的文档翻译成指定的目标语言,而不翻译键、路径、引用和其他与文档无关的值。

路线图

参考开放问题以获取建议的功能(和已知问题)列表。

致谢

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分布

idem-ai-0.1.0.tar.gz (8.5 kB 查看哈希值)

上传时间

构建分布

idem_ai-0.1.0-py3-none-any.whl (7.8 kB 查看哈希值)

上传时间 Python 3

由以下支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面