// Package mastodon provides functions and structs for accessing the mastodon API. package mastodon import ( "context" "encoding/json" "errors" "fmt" "io" "net/http" "net/url" "path" "strings" "time" linkheader "git.gutmet.org/linkheader.git" ) type Config struct { Server string ClientID string ClientSecret string AccessToken string } type Client struct { http.Client Config *Config UserAgent string } var client *Client func checkInit() { if client == nil { panic("Well, guess who didn't read the manual.") } } func Initialize(config *Config) { client = newClient(config) } func doAPI(method string, uri string, params interface{}, res interface{}, pg *Pagination) error { checkInit() c := client ctx := context.Background() u, err := url.Parse(c.Config.Server) if err != nil { return err } u.Path = path.Join(u.Path, uri) var req *http.Request ct := "application/x-www-form-urlencoded" if values, ok := params.(url.Values); ok { var body io.Reader if method == http.MethodGet { if pg != nil { values = pg.setValues(values) } u.RawQuery = values.Encode() } else { body = strings.NewReader(values.Encode()) } req, err = http.NewRequest(method, u.String(), body) if err != nil { return err } } else if media, ok := params.(*Media); ok { r, contentType, err := media.bodyAndContentType() if err != nil { return err } req, err = http.NewRequest(method, u.String(), r) if err != nil { return err } ct = contentType } else { if method == http.MethodGet && pg != nil { u.RawQuery = pg.toValues().Encode() } req, err = http.NewRequest(method, u.String(), nil) if err != nil { return err } } req = req.WithContext(ctx) req.Header.Set("Authorization", "Bearer "+c.Config.AccessToken) if params != nil { req.Header.Set("Content-Type", ct) } if c.UserAgent != "" { req.Header.Set("User-Agent", c.UserAgent) } var resp *http.Response backoff := time.Second for { resp, err = c.Do(req) if err != nil { return err } defer resp.Body.Close() // handle status code 429, which indicates the server is throttling // our requests. Do an exponential backoff and retry the request. if resp.StatusCode == 429 { if backoff > time.Hour { break } select { case <-time.After(backoff): case <-ctx.Done(): return ctx.Err() } backoff = time.Duration(1.5 * float64(backoff)) continue } break } if resp.StatusCode != http.StatusOK { return parseAPIError("bad request", resp) } else if res == nil { return nil } else if pg != nil { if lh := resp.Header.Get("Link"); lh != "" { pg2, err := newPagination(lh) if err != nil { return err } *pg = *pg2 } } return json.NewDecoder(resp.Body).Decode(&res) } func newClient(config *Config) *Client { return &Client{ Client: *http.DefaultClient, Config: config, } } const ( VisibilityPublic = "public" VisibilityUnlisted = "unlisted" VisibilityFollowersOnly = "private" VisibilityDirectMessage = "direct" ) type Toot struct { Status string `json:"status"` InReplyToID ID `json:"in_reply_to_id"` MediaIDs []ID `json:"media_ids"` Sensitive bool `json:"sensitive"` SpoilerText string `json:"spoiler_text"` Visibility string `json:"visibility"` Language string `json:"language"` ScheduledAt *time.Time `json:"scheduled_at,omitempty"` Poll *TootPoll `json:"poll"` } type TootPoll struct { Options []string `json:"options"` ExpiresInSeconds int64 `json:"expires_in"` Multiple bool `json:"multiple"` HideTotals bool `json:"hide_totals"` } type Mention struct { URL string `json:"url"` Username string `json:"username"` Acct string `json:"acct"` ID ID `json:"id"` } type Tag struct { Name string `json:"name"` URL string `json:"url"` History []History `json:"history"` } type History struct { Day string `json:"day"` Uses string `json:"uses"` Accounts string `json:"accounts"` } type Attachment struct { ID ID `json:"id"` Type string `json:"type"` URL string `json:"url"` RemoteURL string `json:"remote_url"` PreviewURL string `json:"preview_url"` TextURL string `json:"text_url"` Description string `json:"description"` Meta AttachmentMeta `json:"meta"` } type AttachmentMeta struct { Original AttachmentSize `json:"original"` Small AttachmentSize `json:"small"` } type AttachmentSize struct { Width int64 `json:"width"` Height int64 `json:"height"` Size string `json:"size"` Aspect float64 `json:"aspect"` } type Emoji struct { ShortCode string `json:"shortcode"` StaticURL string `json:"static_url"` URL string `json:"url"` VisibleInPicker bool `json:"visible_in_picker"` } type Results struct { Accounts []*Account `json:"accounts"` Statuses []*Status `json:"statuses"` Hashtags []*Tag `json:"hashtags"` } // Pagination is a struct for specifying the get range. type Pagination struct { MaxID ID SinceID ID MinID ID Limit int64 } func newPagination(rawlink string) (*Pagination, error) { if rawlink == "" { return nil, errors.New("empty link header") } p := &Pagination{} for _, link := range linkheader.Parse(rawlink) { switch link.Rel { case "next": maxID, err := getPaginationID(link.URL, "max_id") if err != nil { return nil, err } p.MaxID = maxID case "prev": sinceID, err := getPaginationID(link.URL, "since_id") if err != nil { return nil, err } p.SinceID = sinceID minID, err := getPaginationID(link.URL, "min_id") if err != nil { return nil, err } p.MinID = minID } } return p, nil } func getPaginationID(rawurl, key string) (ID, error) { u, err := url.Parse(rawurl) if err != nil { return "", err } return ID(u.Query().Get(key)), nil } func (p *Pagination) toValues() url.Values { return p.setValues(url.Values{}) } func (p *Pagination) setValues(params url.Values) url.Values { if p.MaxID != "" { params.Set("max_id", string(p.MaxID)) } if p.SinceID != "" { params.Set("since_id", string(p.SinceID)) } if p.MinID != "" { params.Set("min_id", string(p.MinID)) } if p.Limit > 0 { params.Set("limit", fmt.Sprint(p.Limit)) } return params }