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
|
#!/usr/bin/env python
from pyfunkwhale.client import Client
class Funkwhale(object):
def __init__(self, client_name, redirect_uri, client_id,
client_secret, scopes, username, password, domain,
authorization_endpoint, token_endpoint, token_filename):
self.client = Client(
client_name, redirect_uri, client_id, client_secret,
scopes, username, password, domain, authorization_endpoint,
token_endpoint, token_filename)
def _build_params(self, arguments):
"""
Build params dict for python-requests. Not that all key who start
with an underscore are treated as par of the endpoint uri and are not
as uri parameters.
"""
params = {}
for k, v in arguments.items():
if k != 'self' and v is not None and not k.startswith("_"):
params[k] = v
return params
def artists(self, q: str = None, ordering: str = None,
playable: bool = None, page: int = None,
page_size: int = None) -> dict:
"""
List artists
"""
arguments = locals()
ordering_field = ['creation_date', 'id', 'name']
if ordering is not None and ordering not in ordering_field:
raise ValueError("The ordering field {} is not in the ordering"
"fields accepted".format(ordering))
params = self._build_params(arguments)
return self.client.call('/artists/', 'get', params).json()
def artist(self, _id: int, refresh: bool = False):
"""
Retrieve a single artist
"""
arguments = locals()
params = self._build_params(arguments)
return self.client.call(f'/artists/{_id}', 'get', params).json()
def artist_libraries(self, _id: int, page: int = None,
page_size: int = None):
"""
List available user libraries containing work from this artist
"""
arguments = locals()
params = self._build_params(arguments)
return self.client.call(
f'/artists/{_id}/libraries/', 'get', params).json()
def albums(self, q: str = None, artist: int = None, ordering: str = None,
playable: bool = None, page: int = None,
page_size: int = None) -> dict:
"""
List albums
"""
arguments = locals()
ordering_field = ['creation_date', 'release_date', 'title']
if ordering is not None and ordering not in ordering_field:
raise ValueError("The ordering field {} is not in the ordering"
"fields accepted".format(ordering))
params = self._build_params(arguments)
return self.client.call('/albums/', 'get', params).json()
def album(self, _id: int, refresh: bool = False):
"""
Retrieve a single album
"""
arguments = locals()
params = self._build_params(arguments)
return self.client.call(f'/albums/{_id}', 'get', params).json()
def album_libraries(self, _id: int, page: int = None,
page_size: int = None):
"""
List available user libraries containing work from this album
"""
arguments = locals()
params = self._build_params(arguments)
return self.client.call(
f'/albums/{_id}/libraries/', 'get', params).json()
|
