golang BDD testcase framework.

BDD

What is Behaviour Driven Development and why should I care?

Behaviour Driven Development (BDD) is a testing methodology that has evolved from Test Driven Development (TDD). BDD is a useful way to describe your test cases from the perspective of the user. It uses a Given-When-Then format that is cognitively easy to parse. The output can be debugged and understood by both technology & business stakeholders. If you have used Behat, Cucumber etc in the past, this would be familiar to you.

Given: The user name is ABCD and the password is PWD
When:  the user inputs these credentials and Clicks on enter
Then: the user should be logged in

Go ships with a fantastic testing library. More often than not, that testing library suffices the requirements. But, at Exotel, we’ve adopted the BDD methodology simply because it gives more user-readable expressions and some of the constraints imposed by the framework force developers to avoid cryptic error messages. Also, the long-term goal was to let the QA team or the business owners themselves to add test cases as and when they see something failing.

There are a bunch of decent BDD frameworks written for Go: Ginkgo , Goblin & GoConvey . We use Ginkgo heavily within our applications. Now, let’s get to the interesting part and show you how to use Ginkgo in your next application.

Popular Frameworks 

• ginkgo
• godog  
• GoSpec 
• gospecify 
• GoConvey
• goblin

ginkgo

prepare

$ go get github.com/onsi/ginkgo/ginkgo
$ go get github.com/onsi/gomega

$ cd book
$ ginkgo init # https://stackoverflow.com/questions/25879473/how-do-i-set-up-a-ginkgo-test-suitee
$ ginkgo bootstrap

$ cat book.go

package book

import (
        _ "fmt"
)

type Book struct {
        Title  string
        Author string
        Pages  uint
}

func (b *Book) CategoryByLength() string {
        if b.Pages >= 300 {
                return "NOVEL"
        }
        return "SHORT STORY"
}

 $ cat src_suite_test.go

package book_test

import (
        . "github.com/onsi/ginkgo"
        . "github.com/onsi/gomega"

        "testing"
)

func TestSrc(t *testing.T) {
        RegisterFailHandler(Fail)
        RunSpecs(t, "Src Suite")
}

$ cat book_test.go

package book_test

import (
        . "book"

        . "github.com/onsi/ginkgo"
        . "github.com/onsi/gomega"
)

var _ = Describe("Book", func() {
        var (
                longBook  Book
                shortBook Book
        )

        BeforeEach(func() {
                longBook = Book{
                        Title:  "Les Miserables",
                        Author: "Victor Hugo",
                        Pages:  1488,
                }

                shortBook = Book{
                        Title:  "Fox In Socks",
                        Author: "Dr. Seuss",
                        Pages:  24,
                }
        })

        Describe("Categorizing book length", func() {
                PContext("With more than 300 pages", func() {
                        It("should be a novel", func() {
                                Expect(longBook.CategoryByLength()).To(Equal("NOVEL"))
                        })
                })

                Context("With fewer than 300 pages", func() {
                        It("should be a short story", func() {
                                Expect(shortBook.CategoryByLength()).To(Equal("SHORT STORY"))
                        })
                })

                Context("Do panics test", func() {

                        It("panics in a goroutine", func(done Done) {
                                go func() {
                                        defer GinkgoRecover()

                                        Ω(func() bool { return true }()).Should(BeTrue())

                                        close(done)
                                }()
                        })
                })
        })
})


 

Run Test  

I try  $ ginkgo to run the test. no any response. so I use:

$ go test -ginkgo.v

Pending/Skip some test case

 You do this by adding a P or an X in front of your Describe, Context, It, and Measure:

only test some case： 

by adding an F in front of your Describe, Context, and It.

convey

Good to explain BDD with GO

https://semaphoreci.com/community/tutorials/getting-started-with-bdd-in-go-using-ginkgo

https://blog.codeship.com/implementing-a-bdd-workflow-in-go/