package client import ( "encoding/json" "fmt" "io" "net/http" "net/url" ) var ( defaultAPI = "https://openlibrary.org/api/books" ) // Client type Client struct { httpClient http.Client apipath string } // 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) { if k == "" { return nil, fmt.Errorf("ISBN cannot be empty") } else if len(k) != 10 && len(k) != 13 { return nil, fmt.Errorf("ISBN must be either 10 or 13 digits") } 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) { if k == "" { return nil, fmt.Errorf("OCLC cannot be empty") } 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) { if k == "" { return nil, fmt.Errorf("LCCN cannot be empty") } 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) { if k == "" { return nil, fmt.Errorf("OLID cannot be empty") } 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) { h := c.apipath if h == "" { h = defaultAPI } u, err := url.Parse(h) if err != nil { return nil, err } u.RawQuery = url.Values{ "bibkeys": []string{key}, "jscmd": []string{"data"}, "format": []string{"json"}, }.Encode() resp, err := c.httpClient.Get(u.String()) 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 }