Sansan
f7619baf34
Closes #38, #39 and #40; adds the client side of #41. - Every request goes to /api/v1. MusicServerClient gets a token with Settings.api_password the first time one is needed, reuses it, and on a 401 gets a new one and sends the request once more. Switching server gets a new token too. Callers never see the token. - Sync is started with POST, as MusicServer 5.0 requires. - The client has every endpoint in the server's OpenAPI spec, including statistics, soundtracks and songs by UUID, version, downloads and tokens. - tools/generate_api_types.gd generates a typed class per schema in server/openapi.json into server/generated/. Song info, statistics and versions are passed to callers as these classes. A list the server sends as null is an empty list. - FakeHttpTransport hands out tokens and answers 401 without one, so every test goes through the token flow. New tests cover the token handling, every endpoint and each generated class.
40 lines
1.7 KiB
GDScript
40 lines
1.7 KiB
GDScript
# Generated by tools/generate_api_types.gd from server/openapi.json.
|
|
# Do not edit; change the server and generate again.
|
|
class_name StatisticsSummary
|
|
extends RefCounted
|
|
## The [code]StatisticsSummary[/code] schema of the MusicServer API.
|
|
|
|
var avg_soundtrack_plays: float
|
|
var max_soundtrack_plays: int
|
|
var min_soundtrack_plays: int
|
|
var never_played_soundtracks: int
|
|
var played_soundtracks: int
|
|
var total_soundtrack_plays: int
|
|
var total_soundtracks: int
|
|
|
|
|
|
## Reads the fields from parsed JSON. Missing fields keep their defaults.
|
|
static func from_dict(data: Dictionary) -> StatisticsSummary:
|
|
var result: StatisticsSummary = StatisticsSummary.new()
|
|
result.avg_soundtrack_plays = ApiJson.get_float(data, "avg_soundtrack_plays", 0.0)
|
|
result.max_soundtrack_plays = ApiJson.get_int(data, "max_soundtrack_plays", 0)
|
|
result.min_soundtrack_plays = ApiJson.get_int(data, "min_soundtrack_plays", 0)
|
|
result.never_played_soundtracks = ApiJson.get_int(data, "never_played_soundtracks", 0)
|
|
result.played_soundtracks = ApiJson.get_int(data, "played_soundtracks", 0)
|
|
result.total_soundtrack_plays = ApiJson.get_int(data, "total_soundtrack_plays", 0)
|
|
result.total_soundtracks = ApiJson.get_int(data, "total_soundtracks", 0)
|
|
return result
|
|
|
|
|
|
## Returns the fields under their JSON names, ready for [method JSON.stringify].
|
|
func to_dict() -> Dictionary:
|
|
return {
|
|
"avg_soundtrack_plays": avg_soundtrack_plays,
|
|
"max_soundtrack_plays": max_soundtrack_plays,
|
|
"min_soundtrack_plays": min_soundtrack_plays,
|
|
"never_played_soundtracks": never_played_soundtracks,
|
|
"played_soundtracks": played_soundtracks,
|
|
"total_soundtrack_plays": total_soundtrack_plays,
|
|
"total_soundtracks": total_soundtracks,
|
|
}
|