{"id":38033488,"url":"https://github.com/themakers/bdd","last_synced_at":"2026-01-16T19:47:20.973Z","repository":{"id":57570016,"uuid":"345419802","full_name":"themakers/bdd","owner":"themakers","description":"(alpha) Simple but expressive BDD-flavoured testing framework","archived":false,"fork":false,"pushed_at":"2021-03-16T11:14:30.000Z","size":9,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-06-20T12:02:10.189Z","etag":null,"topics":["bdd","bdd-framework","bdd-style","bdd-style-testing-framework","bdd-tests","golang","test","testing","testing-tools","tests"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/themakers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-03-07T18:18:10.000Z","updated_at":"2024-06-20T12:02:10.190Z","dependencies_parsed_at":"2022-09-10T17:40:42.005Z","dependency_job_id":null,"html_url":"https://github.com/themakers/bdd","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/themakers/bdd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themakers%2Fbdd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themakers%2Fbdd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themakers%2Fbdd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themakers%2Fbdd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/themakers","download_url":"https://codeload.github.com/themakers/bdd/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themakers%2Fbdd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28481951,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bdd","bdd-framework","bdd-style","bdd-style-testing-framework","bdd-tests","golang","test","testing","testing-tools","tests"],"created_at":"2026-01-16T19:47:20.315Z","updated_at":"2026-01-16T19:47:20.962Z","avatar_url":"https://github.com/themakers.png","language":"Go","readme":"# BDD\n\n[![codecov](https://codecov.io/gh/themakers/bdd/branch/master/graph/badge.svg)](https://codecov.io/gh/themakers/bdd)\n[![GoDoc](https://img.shields.io/badge/pkg.go.dev-doc-blue)](http://pkg.go.dev/github.com/themakers/bdd)\n\nPackage bdd is a very simple but expressive BDD-flavoured testing framework\n\nDocumentation is incomplete\nRefer to [bdd_test.go](bdd_test.go) for usage\n\n## Rationale\n\nThe most of present Golang BDD-style testing frameworks are:\n1) too big =\u003e hard to maintain\n2) overcomplicated =\u003e same here\n3) bloated =\u003e goes against golang philosophy\n4) unsupported\n5) not enough expressive\n6) provides less control of execution order\n\nThis one is:\n1) dead-simple\n2) easy to maintain\n3) more expressive\n4) better control of test blocks execution order\n\n## The Goal\n\n1) Be minimalistic, yet expressive and fully functional\n2) Stay within 500LOC\n3) Be easily maintainable\n4) Be compatible with all the popular ecosystem tools (without sacrificing the above)\n\nNo matcher library provided; There are plenty of them.\ni.e.: [github.com/stretchr/testify/assert]([https://github.com/stretchr/testify/tree/master/assert](https://github.com/stretchr/testify/tree/master/assert))\n\n## Functions\n\n### func [Act](/bdd.go#L308)\n\n`func Act(t *testing.T, name string, fn BlockFunc)`\n\nAct is just a structural block; You use it to make your test structure\nmore readable and explanatory\n\n### func [Fork](/bdd.go#L321)\n\n`func Fork(t *testing.T, branches ...BranchConstructorFunc)`\n\nFork comes into a business when you want a separate sub-scenarios in your tests.\nFor each Branch in a Fork the framework will reexecute all the blocks\ndefined prior to the fork\n\nTODO: Rewrite this shame\n\n### func [Scenario](/bdd.go#L281)\n\n`func Scenario(t *testing.T, title string, fn ScenarioFunc)`\n\nScenario is a root of your scenario.\nScenario blocks can not be nested.\n\n### func [Test](/bdd.go#L340)\n\n`func Test(t *testing.T, what string, fn BlockFunc)`\n\nTest is a block where you write your actual test code and run your assertions.\nRemember: you write ALL the logic in Test blocks,\nexcept for some error-free-by-default initializations\nTest blocks can be nested.\nTest blocks can NOT contain other block types.\n\n---\nReadme created from Go doc with [goreadme](https://github.com/posener/goreadme)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthemakers%2Fbdd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthemakers%2Fbdd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthemakers%2Fbdd/lists"}