Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vburenin/ifacemaker
Generate interfaces from structure methods.
https://github.com/vburenin/ifacemaker
Last synced: 3 months ago
JSON representation
Generate interfaces from structure methods.
- Host: GitHub
- URL: https://github.com/vburenin/ifacemaker
- Owner: vburenin
- License: apache-2.0
- Created: 2016-05-27T07:39:28.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-12-17T08:45:02.000Z (11 months ago)
- Last Synced: 2024-07-05T02:59:44.657Z (4 months ago)
- Language: Go
- Homepage:
- Size: 2.61 MB
- Stars: 319
- Watchers: 4
- Forks: 43
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- go-awesome - ifacemaker - generates an interface based on the structure method (Open source library / Code Generation)
README
# ifacemaker [](https://travis-ci.com/vburenin/ifacemaker)
This is a development helper program that generates a Golang interface by inspecting
the structure methods of an existing `.go` file. The primary use case is to generate
interfaces for gomock, so that gomock can generate mocks from those interfaces. This
makes unit testing easier.
## Install
```
go install github.com/vburenin/ifacemaker@latest
```
## Usage
Here is the help output of ifacemaker:
```
$ ifacemaker --help
Usage:
ifacemaker [OPTIONS]
Application Options:
-f, --file= Go source file to read, either filename or glob
-s, --struct= Generate an interface for this structure name
-i, --iface= Name of the generated interface
-p, --pkg= Package name for the generated interface
-y, --iface-comment= Comment for the interface, default is '// ...'
-d, --doc= Copy docs from methods (default: true)
-D, --type-doc Copy type doc from struct
-c, --comment= Append comment to top, default is '// Code generated by ifacemaker; DO NOT EDIT.'
-o, --output= Output file name. If not provided, result will be printed to stdout.
Help Options:
-h, --help Show this help message
$
```
As an example, let's say you wanted to generate an interface for the Human structure
in this sample code:
```
package main
import "fmt"
type Human struct {
name string
age int
}
// Returns the name of our Human.
func (h *Human) GetName() string {
return h.name
}
// Our Human just had a birthday! Increase its age.
func (h *Human) Birthday() {
h.age += 1
fmt.Printf("I am now %d years old!\n", h.age)
}
// Make the Human say hello.
func (h *Human) SayHello() {
fmt.Printf("Hello, my name is %s, and I am %d years old.\n", h.name, h.age)
}
func main() {
human := &Human{name: "Bob", age: 30}
human.GetName()
human.SayHello()
human.Birthday()
}
```
The ifacemaker helper program can generate this interface for you:
```
$ ifacemaker -f human.go -s Human -i HumanIface -p humantest -y "HumanIface makes human interaction easy" -c "DONT EDIT: Auto generated"
// DONT EDIT: Auto generated
package humantest
// HumanIface makes human interaction easy
type HumanIface interface {
// Returns the name of our Human.
GetName() string
// Our Human just had a birthday! Increase its age.
Birthday()
// Make the Human say hello.
SayHello()
}
$
```
In the above example, ifacemaker inspected the structure methods of the Human struct
and generated an interface called HumanIface in the humantest package. Note that the
ifacemaker program preserves docstrings by default.
You can tell ifacemaker to write its output to a file, versus stdout, using the `-o`
parameter:
```
$ ifacemaker -f human.go -s Human -i HumanIface -p humantest -y "HumanIface makes human interaction easy" -c "DONT EDIT: Auto generated" -o humaniface.go
$
```
You can also run it with `Docker`:
```
$ docker run --rm -v $(pwd):/tmp/ vburenin/ifacemaker -f /tmp/human.go -s Human -i HumanIface -p humantest -y "HumanIface makes human interaction easy" -c "DONT EDIT: Auto generated" -o /tmp/humaniface.go
$
```