Salt扩展用于APC UPS

与APC UPS交互的Salt扩展

安全

如果您发现安全漏洞，请参阅Salt的安全指南。

用户文档

有关设置和使用说明，请参阅用户文档。

贡献

saltext-apcups项目欢迎任何人的贡献！

Salt扩展指南提供了关于Salt扩展开发的全面说明，包括编写测试、运行测试、编写文档和生成文档。

快速入门

要开始贡献，首先克隆此存储库（或您的分支）

# Clone the repo
git clone --origin upstream git@github.com:salt-extensions/saltext-apcups.git

# Change to the repo dir
cd saltext-apcups

自动

如果您已安装 direnv，允许项目中的 .envrc 存在，确保了合适的开发环境存在并且虚拟环境是活跃的。

没有 direnv，您仍然可以显式运行自动化

python3 tools/initialize.py
source .venv/bin/activate

手动

请遵循 第一步，跳过仓库初始化和第一次提交。

拉取请求

总是在功能分支中进行更改

git switch -c my-feature-branch

要 提交拉取请求，您需要在自己的 GitHub 账户中有一个此仓库的分支。如果您遵循了上面的说明，现在将您的分支设置为 origin 远程。

git remote add origin git@github.com:<your_fork>.git

确保您遵循了 第一步 并提交您的更改，修复任何失败的 pre-commit 钩子。然后将功能分支推送到您的分支并提交 PR。

贡献方式

贡献有多种形式，它们都很宝贵！以下是您可以帮助的方式，而无需编写代码

• 文档：特别是展示如何使用此项目解决特定问题的示例。
• 问题分类：帮助管理 问题 并参与 讨论。
• 审查 拉取请求：我们特别欣赏使用 常规注释 的审查。

您还可以通过以下方式贡献

• 撰写博客文章
• 在社交媒体上分享您使用 Salt + APC UPS 的经验
• 在会议上发表演讲
• 发布视频
• 参与 IRC、Discord 或电子邮件组

这些对于我们的社区来说都非常有价值，我们真诚地感谢每一份贡献！