package lemmy import ( "bytes" "context" "encoding/json" "errors" "fmt" "io" "net/http" "net/url" "github.com/google/go-querystring/query" ) // ErrNoToken is an error returned by ClientLogin if the server sends a null or empty token var ErrNoToken = errors.New("the server didn't provide a token value in its response") // Client is a client for Lemmy's HTTP API type Client struct { client *http.Client baseURL *url.URL Token string } // New creates a new Lemmy client with the default HTTP client. func New(baseURL string) (*Client, error) { return NewWithClient(baseURL, http.DefaultClient) } // NewWithClient creates a new Lemmy client with the given HTTP client func NewWithClient(baseURL string, client *http.Client) (*Client, error) { u, err := url.Parse(baseURL) if err != nil { return nil, err } u = u.JoinPath("/api/v3") return &Client{baseURL: u, client: client}, nil } // ClientLogin logs in to Lemmy by calling the login endpoint, and // stores the returned token in the Token field for use in future requests. // // The Token field can be set manually if you'd like to persist the // token somewhere. func (c *Client) ClientLogin(ctx context.Context, data Login) error { lr, err := c.Login(ctx, data) if err != nil { return err } token, ok := lr.JWT.Value() if !ok || token == "" { return ErrNoToken } c.Token = token return nil } // req makes a request to the server func (c *Client) req(ctx context.Context, method string, path string, data, resp any) (*http.Response, error) { var r io.Reader if data != nil { jsonData, err := json.Marshal(data) if err != nil { return nil, err } r = bytes.NewReader(jsonData) } req, err := http.NewRequestWithContext( ctx, method, c.baseURL.JoinPath(path).String(), r, ) if err != nil { return nil, err } req.Header.Add("Content-Type", "application/json") if c.Token != "" { req.Header.Add("Authorization", "Bearer "+c.Token) } res, err := c.client.Do(req) if err != nil { return nil, err } defer res.Body.Close() err = json.NewDecoder(res.Body).Decode(resp) if err == io.EOF { return res, nil } else if err != nil { return nil, err } return res, nil } // getReq makes a get request to the Lemmy server. // It's separate from req() because it uses query // parameters rather than a JSON request body. func (c *Client) getReq(ctx context.Context, method string, path string, data, resp any) (*http.Response, error) { getURL := c.baseURL.JoinPath(path) if data != nil { vals, err := query.Values(data) if err != nil { return nil, err } getURL.RawQuery = vals.Encode() } req, err := http.NewRequestWithContext( ctx, method, getURL.String(), nil, ) if err != nil { return nil, err } if c.Token != "" { req.Header.Add("Authorization", "Bearer "+c.Token) } res, err := c.client.Do(req) if err != nil { return nil, err } defer res.Body.Close() err = json.NewDecoder(res.Body).Decode(resp) if err == io.EOF { return res, nil } else if err != nil { return nil, err } return res, nil } // Error represents an error returned by the Lemmy API type Error struct { ErrStr string Code int } func (le Error) Error() string { if le.ErrStr != "" { return fmt.Sprintf("%d %s: %s", le.Code, http.StatusText(le.Code), le.ErrStr) } else { return fmt.Sprintf("%d %s", le.Code, http.StatusText(le.Code)) } } // emptyResponse is a response without any fields. // It has an Error field to capture any errors. type emptyResponse struct { Error Optional[string] `json:"error"` } // resError checks if the response contains an error, and if so, returns // a Go error representing it. func resError(res *http.Response, err Optional[string]) error { if errstr, ok := err.Value(); ok { return Error{ Code: res.StatusCode, ErrStr: errstr, } } else if res.StatusCode != http.StatusOK { return Error{ Code: res.StatusCode, } } else { return nil } }