1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
// Copyright (C) 2019 Luiz de Milon (kori)
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
// You should have received a copy of the GNU General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.
package listenbrainz
import (
"bytes"
"encoding/json"
"errors"
"net/http"
)
// Submission is a struct for marshalling the JSON payload
type Submission struct {
ListenType string `json:"listen_type"`
Payloads []Payload `json:"payload"`
}
// Payloads is a helper struct for marshalling the JSON payload
type Payloads []Payload
// Payload is a helper struct for marshalling the JSON payload
type Payload struct {
ListenedAt int64 `json:"listened_at,omitempty"`
Track `json:"track_metadata"`
}
// Track is a helper struct for marshalling the JSON payload
type Track struct {
Title string `json:"track_name"`
Artist string `json:"artist_name"`
Album string `json:"release_name"`
}
// FormatPlayingNow formats a Track as a playing_now Submission.
func FormatPlayingNow(track Track) Submission {
return Submission{
ListenType: "playing_now",
Payloads: Payloads{
Payload{
Track: track,
},
},
}
}
// FormatSingle formats a Track as a single Submission.
func FormatSingle(track Track, time int64) Submission {
return Submission{
ListenType: "single",
Payloads: Payloads{
Payload{
ListenedAt: time,
Track: track,
},
},
}
}
// GetSubmissionTime returns the number of seconds after which a track
// should be submitted.
func GetSubmissionTime(length int) (int, error) {
if length < 0 {
return 0, errors.New("Length can't be negative.")
}
// get halfway point
p := int(float64(length / 2.0))
// source: https://listenbrainz.readthedocs.io/en/latest/dev/api.html
// Listens should be submitted for tracks when the user has listened to
// half the track or 4 minutes of the track, whichever is lower. If the
// user hasn’t listened to 4 minutes or half the track, it doesn’t fully
// count as a listen and should not be submitted.
if p > 240 {
return 240, nil
}
return p, nil
}
// SubmitRequest creates and executes a request containing the JSON that's passed,
// to the account delineated by the token.
func SubmitRequest(json []byte, token string) (*http.Response, error) {
url := "https://api.listenbrainz.org/1/submit-listens"
req, err := http.NewRequest("POST", url, bytes.NewBuffer(json))
if err != nil {
return nil, err
}
req.Header.Set("Authorization", "Token "+token)
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
return client.Do(req)
}
// SubmitPlayingNow posts the given track to ListenBrainz as what's playing now.
func SubmitPlayingNow(track Track, token string) (*http.Response, error) {
json, err := json.Marshal(FormatPlayingNow(track))
if err != nil {
return nil, err
}
return SubmitRequest(json, token)
}
// SubmitSingle posts the given track to ListenBrainz as a single listen
// with the given time.
func SubmitSingle(track Track, token string, time int64) (*http.Response, error) {
json, err := json.Marshal(FormatSingle(track, time))
if err != nil {
return nil, err
}
return SubmitRequest(json, token)
}
|
