DnD
![codecov](https://codecov.io/gh/brittonhayes/dnd/branch/main/graph/badge.svg?token=VN11FU4LBW)
![](https://repository-images.githubusercontent.com/328138488/50a49700-522a-11eb-85be-7d8244592f86)
A Go Client for the Dungeons and Dragons 5e SRD REST API
Installation
Install with the go get command
go get github.com/brittonhayes/dnd
Documentation
View the full docs on pkg.go.dev
View the API here https://www.dnd5eapi.co/
Usage
Using the package is as easy as create client, pick the endpoint, and run the method. This applies across every data
type, so it is consistent across the board. Here's a simple example of how to fetch a rule from the DnD 5e ruleset.
func main() {
c := dnd.NewClient()
r, _ := c.Rules.Find("adventuring")
fmt.Println("Name", r.Name)
}
Examples
For example uses of the package, check out the example directory
Development
If you'd like to contribute to DnD, make sure you have mage installed: https://magefile.org
# Download dependencies and run tests
go run main.go download
go test ./...
Social image by Ashley Mcnamara https://twitter.com/ashleymcnamara 💖