sakuga-go-sdk

An unofficial go SDK for the Sakugabooru API

Installation

go get github.com/ctiller15/sakuga-go-sdk@latest

Quickstart

api := sakugaapi.NewAPI()

opts := sakugamodels.PostsListOptions{
	Limit: 10,
}
apiResult, err := api.Posts.List(&opts)

if err != nil {
	log.Fatal(err)
}
// Do something with the data

Usage

// Get a random video with each request
api := sakugaapi.NewAPI()

opts := sakugamodels.PostListOptions{
	Limit: 1,
	Random: True,
	Tags: []string{"fighting"}
}

apiResult, err := api.Posts.List(&opts)

if err != nil {
	log.Fatal(err)
}

videoURL := apiResult[0].fileURL

Contributing

Clone the repository

git clone https://github.com/ctiller15/sakuga-go-sdk.git
cd sakuga-go-sdk

Run the tests

go test ./...

Submit a pull request

To contribute, fork the repo and open a pull request to main

Currently supported api routes:

1. Posts - List
2. Tags - List
3. Tags - Related
4. Artists - List
5. Comments - Show
6. Wiki - List
7. Notes - List
8. Notes - Search
9. Notes - History
10. Users - Search
11. Forum - List
12. Pools - List Pools
13. Pools - List Posts
14. Favorites - List Users

Sakugabooru is a fantastic resource for animation. If you like their site, this SDK, (which relies entirely on their good graces), or animation in general it would be awesome if you supported their patreon.

Future Plans:

• Add intentional support for meta-tags