breakcheck checks exported values, types and function declarations in your working tree for potential breaking changes against a given git reference.
$ breakcheck --help
Example usage:
breakcheck # compares working tree against git head
breakcheck --base=v1.0.0 # compares against tag v1.0.0
Flags:
-base string
git reference to compare against (default "head")
-private
include exported methods with private receivers
-v enable verbose mode
Below is an example output from running breakcheck against the datadog-agent repository:
$ breakcheck --base=HEAD~40
pkg/logs/config:
• Removed:
< integration_config.go:17@HEAD~40:
const ContainerdType
pkg/util/clusteragent:
• Struct field "ClusterAgentAPIEndpoint" removed in struct "DCAClient":
< clusteragent.go:42@HEAD~40:
struct DCAClient
> clusteragent.go:57:
struct DCAClient
• Struct field "ClusterAgentVersion" type changed from "string" to "version.Version":
< clusteragent.go:42@HEAD~40:
struct DCAClient
• Function return value (0) type changed from "*DCAClient" to "DCAClientInterface":
< clusteragent.go:60@HEAD~40:
func GetClusterAgentClient() (*DCAClient, error)
> clusteragent.go:75:
func GetClusterAgentClient() (DCAClientInterface, error)
- If a function's argument is changed to an alias of the same type, breakcheck will fail to detect this and will report it as a change. Technically this is not a breaking change.
- Detecting changes in exported package level value declarations is limited to their name and type (when known).
Contributions and feedback are very welcome, but please open an issue to discuss ideas before submitting to any work.