Skip to content

Latest commit

 

History

History
56 lines (35 loc) · 1.66 KB

README.md

File metadata and controls

56 lines (35 loc) · 1.66 KB

go-spiget

go-spiget is a Go client library for accessing the Spiget API v2.

Installation

go-spiget is compatible with modern Go releases in module mode, with Go installed:

go get github.com/sunxyw/go-spiget

will resolve and add the package to the current development module, along with its dependencies.

Alternatively the same can be achieved if you use import in a package:

import "github.com/sunxyw/go-spiget"

and run go get without parameters.

Usage/Examples

Construct a new Spiget client, then use the various services on the client to access different parts of the Spiget API. For example:

client := spiget.NewClient(nil)

// Get resource with ID 6245, PlaceholderAPI
resource, _, err := client.Resources.Get(context.Background(), 6245)

Some API methods have optional parameters that can be passed. For example:

opt := &spiget.ResourceSearchOptions{
    Field: "name",
}
resources, _, err := client.Resources.Search(context.Background(), "PlaceholderAPI", opt)

The services of a client divide the API ito logical chunks and correspond to the structure of the Spiget API documentation at https://spiget.org/documentation .

NOTE: Using the context package, one can easily pass cancelation signals and deadlines to various services of the client for handling a request. In case there is no context available, then context.Background() can be used as a starting point.

For more sample code snippets, head over to the example directory.

License

MIT