文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

如何在go中实现CLI命令的单元测试

2024-04-05 00:03

关注

小伙伴们对Golang编程感兴趣吗?是否正在学习相关知识点?如果是,那么本文《如何在go中实现CLI命令的单元测试》,就很适合你,本篇文章讲解的知识点主要包括。在之后的文章中也会多多分享相关知识点,希望对大家的知识积累有所帮助!

问题内容

我正在启动一个利用 spf13/cobra 的新 OSS CLI 工具。作为 golang 新手,我很难找出单独测试命令的最佳方法。有人能给我一个如何测试命令的例子吗?一些注意事项:

  1. 您无法从 init 函数返回 cobra.Command
  2. cmd 目录中不能有 get_test.go...我的印象是 golang 最佳实践。
  3. 我是 golang 新手,请慢慢来:sweat_smile:

如有错误,请指正。

这是我尝试测试的 cmd:https://github.com/sahellebusch/raider/blob/3-add-get-alerts/cmd/get.go。

接受想法、建议、批评等等。


解决方案


使用 go 实现 cli 的方法有多种。这是我开发的 cli 的基本结构,主要受 docker cli 的影响,并且我还添加了单元测试。

您需要的第一件事是使用 cli 作为界面。这将位于名为“cli”的包内。

package cli

type cli interface {
     // have interface functions here
     sayhello() error
}

这将由 2 个 cli 实现:hellocli(我们真正的 cli)和 mockcli(用于单元测试)

package cli

type hellocli struct {
}

func newhellocli() *hellocli {
    cli := &hellocli{
    }
    return cli
}

这里hellocli将实现sayhello函数,如下所示。

package cli

func (cli *hellocli) sayhello() error {
    // implement here
}

类似地,名为 test 的包中会有一个模拟 cli,它将实现 cli 接口,并且还将实现 sayhello 函数。

package test

type mockcli struct {
    }

    func newmockcli() *hellocli {
        cli := &mockcli{
        }
        return cli
    }

func (cli *mockcli) sayhello() error {
        // mock implementation here
    }

现在我将展示如何添加该命令。首先,我将拥有主包,这是我添加所有新命令的地方。

package main

func newclicommand(cli cli.cli) *cobra.command {
    cmd := &cobra.command{
        use:   "foo <command>"
    }

    cmd.addcommand(
        newhellocommand(cli),
    )
    return cmd
}

func main() {
    hellocli := cli.newhellocli()
    cmd := newclicommand(hellocli)
    if err := cmd.execute(); err != nil {
        // do something here if execution fails
    }
}

func newhellocommand(cli cli.cli) *cobra.command {
    cmd := &cobra.command{
        use:   "hello",
        short: "prints hello",
        run: func(cmd *cobra.command, args []string) {
            if err := pkg.runhello(cli, args[0]); err != nil {
                // do something if command fails
            }
        },
        example: "  foo hello",
    }
    return cmd
}

这里,我有一个名为 hello 的命令。接下来,我将在一个名为“pkg”的单独包中实现。

package pkg

func runhello(cli cli.cli) error {
    // do something in this function
    cli.sayhello()
    return nil
}

单元测试也将包含在此包中名为 hello_test 的文件中。

package pkg

func TestRunHello(t *testing.T) {
    mockCli := test.NewMockCli()

    tests := []struct {
        name     string
    }{
        {
            name:     "my test 1",
        },
        {
            name:     "my test 2"
        },
    }
    for _, tst := range tests {
        t.Run(tst.name, func(t *testing.T) {
            err := SayHello(mockCli)
            if err != nil {
                t.Errorf("error in SayHello, %v", err)
            }
        })
    }
}

当您执行 foo hello 时,hellocli 将被传递给 sayhello() 函数,当您运行单元测试时,mockcli 将被传递。

您可以检查 cobra 本身是如何执行此操作的 - https://github.com/spf13/cobra/blob/master/command_test.go

基本上,您可以将实际的命令逻辑(运行函数)重构为单独的函数并测试该函数。您可能想要正确命名您的函数,而不是仅仅将其命名为 run

以上就是本文的全部内容了,是否有顺利帮助你解决问题?若是能给你带来学习上的帮助,请大家多多支持编程网!更多关于Golang的相关知识,也可关注编程网公众号。

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     807人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     351人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     314人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     433人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     221人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯