php中文网

TOML 文件和远程分支管理的实用方法

php中文网

本周我有机会处理 toml 配置文件,并通过从项目的分支本地提取更改来审查对我的存储库所做的更改

什么是 toml 文件

toml(tom's obvious minimal language)是一种配置文件格式,它使用简单的键值对来定义要在程序中使用的配置变量

toml 文件可能如下所示


[dependencies]
requests = ">=2.25.0"
flask = { version = "2.0.1", optional = true }


[database]
type = "postgres"
host = "localhost"
port = 5432
username = "admin"
password = "password123"

[database.settings]
pool_size = 5
timeout = 30



这些文件的工作方式是使用解析器解析 toml 文件中的内容,然后在程序中使用变量

它比 json 或 yaml 更受青睐的原因是它易于人类编写和理解,并且在配置管理方面取得了成功。

我的 toml 用例

本周我有机会参与一个很棒的项目,addcom,这是一个 cli 工具,它接收示例文件并为文件生成内联注释,它利用 groq api 为文件生成注释

现在,在调用 cli 工具时,用户可以定义一些可选参数,这些参数可以在向 groq 发出 api 请求时使用,如下

  • model - 用于 groq api 的模型
  • 流 - 这是一个布尔值,用于指定是否应该对输出进行流式传输
  • api_key- 用于 groq
  • 的 api 密钥
  • context- 将为 llm 提供上下文的文件路径

现在,用户在 cli 工具中一次又一次指定相同的参数值确实令人沮丧,为了避免这种情况,我实现了一个 toml 文件,其中包含要使用的所有配置设置和值,这样就可以了与重复指定配置设置相比,程序只需查看 toml 文件并应用相关设置即可。

程序的逻辑流程如下

1) cli 工具将在终端中调用
2) 如果没有参数,则将使用 toml 文件中的变量
3)如果toml文件中的变量错误则不会被使用,程序将退出并返回错误代码0
4) 如果用户提供命令行参数以及 toml 文件,则将使用命令行参数
5) 使用正确的参数执行操作

要查找我在存储库中提出的问题的描述性概述,请单击此处

此外,要查找相同的相关 pr,请点击此处

使用 git 远程

到目前为止,每当我需要合并 pr 时,我都必须通过 github 来完成,但这一次我发现了一种非常令人兴奋的方法来在本地执行相同的操作

我有人致力于为我的 cli 工具实现一个功能,同一个人创建了我的代码库的一个分支并开始实现该功能,一旦实现,他们将代码推送到其分支上的主题分支。

现在,在我批准更改之前,我必须检查代码更改并确保它们正常工作并且不会导致任何前所未有的问题

为了实现这一目标,我实施了以下步骤


git remote add <user_name><user_name></user_name></user_name>

上面的命令会将远程连接添加到我的代码库的分支


git fetch <user_name></user_name>

这将从远程存储库获取所有新分支并更新我的本地 .git 文件夹


git checkout -b review-change <user_name></user_name>

这将创建一个名为 review-change 的新分支,该分支将构建在主题分支之上,以便能够审核该人所做的更改

审核完更改后,我将执行以下操作


git checkout main
git merge review-change


这将执行快进合并,因为我的本地主目录没有进行任何更改


git push origin main


将执行此命令以将合并的更改推送到我的远程存储库,然后远程存储库将自动关闭该人打开的 pr。

结论

本周,我获得了使用 toml 配置文件和管理代码贡献的 git 工作流程的宝贵经验。实施 toml 允许用户为 addcom 项目定义可重用的配置设置,从而简化 cli 工具的使用并增强用户便利性。此外,我还学习了如何通过添加远程存储库、获取更改以及执行快进合并来在本地查看和合并来自贡献者分支的更改。

以上就是TOML 文件和远程分支管理的实用方法的详细内容,更多请关注php中文网其它相关文章!