102 lines
2.5 KiB
Go
102 lines
2.5 KiB
Go
package client
|
|
|
|
import (
|
|
"encoding/json"
|
|
"fmt"
|
|
"io"
|
|
"net/http"
|
|
)
|
|
|
|
var (
|
|
defaultAPI = "https://openlibrary.org/api/books"
|
|
)
|
|
|
|
// Client
|
|
type Client struct {
|
|
httpClient http.Client
|
|
apipath string
|
|
}
|
|
|
|
// NewClient returns a new Client struct using http.DefaultClient and default api path.
|
|
func NewClient() (*Client, error) {
|
|
return &Client{
|
|
apipath: defaultAPI,
|
|
}, nil
|
|
}
|
|
|
|
// SetHTTPClient updates the httpClient on the client with a manually-configured one.
|
|
// If unset, the client will fall back to using http.DefaultClient.
|
|
func (c *Client) SetHTTPClient(h http.Client) {
|
|
c.httpClient = h
|
|
}
|
|
|
|
// SetAPIPath updates the hostname and path to the API; the default is "https://openlibrary.org/api/books".
|
|
// If APIPath is set to an empty string, the client will fall back to the default option.
|
|
func (c *Client) SetAPIPath(p string) {
|
|
c.apipath = p
|
|
}
|
|
|
|
// GetByISBN fetches details for a book based on its ISBN10 or ISBN13.
|
|
func (c *Client) GetByISBN(k string) (*BookDetails, error) {
|
|
key := "ISBN:" + k
|
|
return c.fetch(key)
|
|
}
|
|
|
|
// GetByOCLC fetches details for a book based on its WorldCat OCLC number.
|
|
func (c *Client) GetByOCLC(k string) (*BookDetails, error) {
|
|
key := "OCLC:" + k
|
|
return c.fetch(key)
|
|
}
|
|
|
|
// GetByLCCN fetches details for a book based on its Library of Congress Control Number.
|
|
func (c *Client) GetByLCCN(k string) (*BookDetails, error) {
|
|
key := "LCCN:" + k
|
|
return c.fetch(key)
|
|
}
|
|
|
|
// GetByOLID fetches details for a book based on its OpenLibrary ID number.
|
|
func (c *Client) GetByOLID(k string) (*BookDetails, error) {
|
|
key := "OLID:" + k
|
|
return c.fetch(key)
|
|
}
|
|
|
|
// GetByRawKey fetches details for a book based on an arbitrary key; this method is provided
|
|
// as a future-proof fallback in case the OpenLibrary API adds more "bibkey" request types in the future.
|
|
// Most users should use one of the other lookup functions.
|
|
func (c *Client) GetByRawKey(k string) (*BookDetails, error) {
|
|
return c.fetch(k)
|
|
}
|
|
|
|
func (c *Client) fetch(key string) (*BookDetails, error) {
|
|
path := c.apipath
|
|
if path == "" {
|
|
path = defaultAPI
|
|
}
|
|
|
|
resp, err := c.httpClient.Get(path + "?bibkeys=%s&jscmd=data&format=json")
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
defer resp.Body.Close()
|
|
|
|
if resp.StatusCode != http.StatusOK {
|
|
return nil, fmt.Errorf("received non-200 status code: %d", resp.StatusCode)
|
|
}
|
|
|
|
var result response
|
|
b, err := io.ReadAll(resp.Body)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
if err = json.Unmarshal(b, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
details, ok := result[key]
|
|
if !ok {
|
|
return nil, fmt.Errorf("book not found")
|
|
}
|
|
|
|
return &details, nil
|
|
}
|