From 5f0d0cc00832ae2368e4804289bd6c7b764d5ac7 Mon Sep 17 00:00:00 2001 From: Tim Van Holder Date: Fri, 29 Dec 2023 14:47:55 +0100 Subject: [PATCH 1/8] Update `MetaBrainz.Build.Sdk` to v3.1.2 --- MetaBrainz.MusicBrainz/MetaBrainz.MusicBrainz.csproj | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/MetaBrainz.MusicBrainz/MetaBrainz.MusicBrainz.csproj b/MetaBrainz.MusicBrainz/MetaBrainz.MusicBrainz.csproj index 7b37c6f..a7f941f 100644 --- a/MetaBrainz.MusicBrainz/MetaBrainz.MusicBrainz.csproj +++ b/MetaBrainz.MusicBrainz/MetaBrainz.MusicBrainz.csproj @@ -1,7 +1,7 @@  - + Zastai From b4ff7e51ef8d1f3253db759211b39a1c1b0bc479 Mon Sep 17 00:00:00 2001 From: Tim Van Holder Date: Fri, 29 Dec 2023 16:27:14 +0100 Subject: [PATCH 2/8] Update `MetaBrainz.Common` to v3.0.0 --- Directory.Packages.props | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Directory.Packages.props b/Directory.Packages.props index 1868a11..dc06dc1 100644 --- a/Directory.Packages.props +++ b/Directory.Packages.props @@ -4,7 +4,7 @@ - + From 020378bc653acdb14ed3026c4decc22023a00f25 Mon Sep 17 00:00:00 2001 From: Tim Van Holder Date: Fri, 29 Dec 2023 16:27:51 +0100 Subject: [PATCH 3/8] Update `MetaBrainz.Common.Json` to v6.0.1 --- Directory.Packages.props | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Directory.Packages.props b/Directory.Packages.props index dc06dc1..827553b 100644 --- a/Directory.Packages.props +++ b/Directory.Packages.props @@ -5,7 +5,7 @@ - + From b2a42047d083691e01d551f169cd42cce654b134 Mon Sep 17 00:00:00 2001 From: Tim Van Holder Date: Fri, 29 Dec 2023 16:40:46 +0100 Subject: [PATCH 4/8] Drop `QueryException` `MusicBrainz.Common.HttpError` is used instead. --- MetaBrainz.MusicBrainz/Json/Converters.cs | 3 +- .../Json/Readers/AuthorizationErrorReader.cs | 48 ++++++++ ...eOrErrorReader.cs => ErrorResultReader.cs} | 13 +- .../Json/Readers/MessageResultReader.cs | 43 +++++++ MetaBrainz.MusicBrainz/OAuth2.cs | 77 ++++++++---- .../Objects/AuthorizationError.cs | 11 ++ MetaBrainz.MusicBrainz/Objects/ErrorResult.cs | 11 ++ .../Objects/MessageOrError.cs | 13 -- .../Objects/MessageResult.cs | 9 ++ MetaBrainz.MusicBrainz/Query.Internals.cs | 92 +++++++------- MetaBrainz.MusicBrainz/QueryException.cs | 114 ------------------ .../MetaBrainz.MusicBrainz.net6.0.cs.md | 20 --- .../MetaBrainz.MusicBrainz.net8.0.cs.md | 20 --- 13 files changed, 232 insertions(+), 242 deletions(-) create mode 100644 MetaBrainz.MusicBrainz/Json/Readers/AuthorizationErrorReader.cs rename MetaBrainz.MusicBrainz/Json/Readers/{MessageOrErrorReader.cs => ErrorResultReader.cs} (71%) create mode 100644 MetaBrainz.MusicBrainz/Json/Readers/MessageResultReader.cs create mode 100644 MetaBrainz.MusicBrainz/Objects/AuthorizationError.cs create mode 100644 MetaBrainz.MusicBrainz/Objects/ErrorResult.cs delete mode 100644 MetaBrainz.MusicBrainz/Objects/MessageOrError.cs create mode 100644 MetaBrainz.MusicBrainz/Objects/MessageResult.cs delete mode 100644 MetaBrainz.MusicBrainz/QueryException.cs diff --git a/MetaBrainz.MusicBrainz/Json/Converters.cs b/MetaBrainz.MusicBrainz/Json/Converters.cs index b6c9e63..e04fb82 100644 --- a/MetaBrainz.MusicBrainz/Json/Converters.cs +++ b/MetaBrainz.MusicBrainz/Json/Converters.cs @@ -35,7 +35,8 @@ internal static class Converters { yield return SearchResultsReader.Instance; yield return TagReader.Instance; // Other objects we deserialize - yield return MessageOrErrorReader.Instance; + yield return ErrorResultReader.Instance; + yield return MessageResultReader.Instance; } } diff --git a/MetaBrainz.MusicBrainz/Json/Readers/AuthorizationErrorReader.cs b/MetaBrainz.MusicBrainz/Json/Readers/AuthorizationErrorReader.cs new file mode 100644 index 0000000..5ec6dbd --- /dev/null +++ b/MetaBrainz.MusicBrainz/Json/Readers/AuthorizationErrorReader.cs @@ -0,0 +1,48 @@ +using System; +using System.Collections.Generic; +using System.Text.Json; + +using MetaBrainz.Common.Json; +using MetaBrainz.Common.Json.Converters; +using MetaBrainz.MusicBrainz.Objects; + +namespace MetaBrainz.MusicBrainz.Json.Readers; + +internal sealed class AuthorizationErrorReader : ObjectReader { + + public static readonly AuthorizationErrorReader Instance = new(); + + protected override AuthorizationError ReadObjectContents(ref Utf8JsonReader reader, JsonSerializerOptions options) { + string? error = null; + string? description = null; + Dictionary? rest = null; + while (reader.TokenType == JsonTokenType.PropertyName) { + var prop = reader.GetPropertyName(); + try { + reader.Read(); + switch (prop) { + case "error": + error = reader.GetString(); + break; + case "error_description": + description = reader.GetString(); + break; + default: + rest ??= new Dictionary(); + rest[prop] = reader.GetOptionalObject(options); + break; + } + } + catch (Exception e) { + throw new JsonException($"Failed to deserialize the '{prop}' property.", e); + } + reader.Read(); + } + return new AuthorizationError { + Error = error, + Description = description, + UnhandledProperties = rest + }; + } + +} diff --git a/MetaBrainz.MusicBrainz/Json/Readers/MessageOrErrorReader.cs b/MetaBrainz.MusicBrainz/Json/Readers/ErrorResultReader.cs similarity index 71% rename from MetaBrainz.MusicBrainz/Json/Readers/MessageOrErrorReader.cs rename to MetaBrainz.MusicBrainz/Json/Readers/ErrorResultReader.cs index 8cfe549..438d93b 100644 --- a/MetaBrainz.MusicBrainz/Json/Readers/MessageOrErrorReader.cs +++ b/MetaBrainz.MusicBrainz/Json/Readers/ErrorResultReader.cs @@ -8,14 +8,13 @@ namespace MetaBrainz.MusicBrainz.Json.Readers; -internal sealed class MessageOrErrorReader : ObjectReader { +internal sealed class ErrorResultReader : ObjectReader { - public static readonly MessageOrErrorReader Instance = new(); + public static readonly ErrorResultReader Instance = new(); - protected override MessageOrError ReadObjectContents(ref Utf8JsonReader reader, JsonSerializerOptions options) { + protected override ErrorResult ReadObjectContents(ref Utf8JsonReader reader, JsonSerializerOptions options) { string? error = null; string? help = null; - string? message = null; Dictionary? rest = null; while (reader.TokenType == JsonTokenType.PropertyName) { var prop = reader.GetPropertyName(); @@ -28,9 +27,6 @@ internal sealed class MessageOrErrorReader : ObjectReader { case "help": help = reader.GetString(); break; - case "message": - message = reader.GetString(); - break; default: rest ??= new Dictionary(); rest[prop] = reader.GetOptionalObject(options); @@ -42,10 +38,9 @@ internal sealed class MessageOrErrorReader : ObjectReader { } reader.Read(); } - return new MessageOrError { + return new ErrorResult { Error = error, Help = help, - Message = message, UnhandledProperties = rest }; } diff --git a/MetaBrainz.MusicBrainz/Json/Readers/MessageResultReader.cs b/MetaBrainz.MusicBrainz/Json/Readers/MessageResultReader.cs new file mode 100644 index 0000000..86331fa --- /dev/null +++ b/MetaBrainz.MusicBrainz/Json/Readers/MessageResultReader.cs @@ -0,0 +1,43 @@ +using System; +using System.Collections.Generic; +using System.Text.Json; + +using MetaBrainz.Common.Json; +using MetaBrainz.Common.Json.Converters; +using MetaBrainz.MusicBrainz.Objects; + +namespace MetaBrainz.MusicBrainz.Json.Readers; + +internal sealed class MessageResultReader : ObjectReader { + + public static readonly MessageResultReader Instance = new(); + + protected override MessageResult ReadObjectContents(ref Utf8JsonReader reader, JsonSerializerOptions options) { + string? message = null; + Dictionary? rest = null; + while (reader.TokenType == JsonTokenType.PropertyName) { + var prop = reader.GetPropertyName(); + try { + reader.Read(); + switch (prop) { + case "message": + message = reader.GetString(); + break; + default: + rest ??= new Dictionary(); + rest[prop] = reader.GetOptionalObject(options); + break; + } + } + catch (Exception e) { + throw new JsonException($"Failed to deserialize the '{prop}' property.", e); + } + reader.Read(); + } + return new MessageResult { + Message = message, + UnhandledProperties = rest + }; + } + +} diff --git a/MetaBrainz.MusicBrainz/OAuth2.cs b/MetaBrainz.MusicBrainz/OAuth2.cs index 56be494..86ec39a 100644 --- a/MetaBrainz.MusicBrainz/OAuth2.cs +++ b/MetaBrainz.MusicBrainz/OAuth2.cs @@ -63,7 +63,7 @@ public sealed class OAuth2 : IDisposable { private static string _defaultUrlScheme = "https"; - /// The default internet access protocol to use for requests. + /// The default URL scheme (internet access protocol) to use for requests. public static string DefaultUrlScheme { get => OAuth2._defaultUrlScheme; set { @@ -150,7 +150,7 @@ public sealed class OAuth2 : IDisposable { private string _urlScheme = OAuth2.DefaultUrlScheme; - /// The internet access protocol to use for requests. + /// The URL scheme (internet access protocol) to use for requests. public string UrlScheme { get => this._urlScheme; set { @@ -241,8 +241,6 @@ public IAuthorizationToken RefreshBearerToken(string refreshToken, string client #endregion - #region Internals - #region HttpClient / IDisposable private static readonly MediaTypeWithQualityHeaderValue AcceptHeader = new("application/json"); @@ -263,11 +261,15 @@ public IAuthorizationToken RefreshBearerToken(string refreshToken, string client private HttpClient Client { get { +#if NET6_0 if (this._disposed) { - throw new ObjectDisposedException(nameof(OAuth2)); + throw new ObjectDisposedException(typeof(OAuth2).FullName); } +#else + ObjectDisposedException.ThrowIf(this._disposed, typeof(OAuth2)); +#endif if (this._client is null) { - var client = this._clientCreation is not null ? this._clientCreation() : new HttpClient(); + var client = this._clientCreation?.Invoke() ?? new HttpClient(); this._clientConfiguration?.Invoke(client); this._client = client; } @@ -333,8 +335,10 @@ public IAuthorizationToken RefreshBearerToken(string refreshToken, string client #endregion + #region Internals + private static readonly JsonSerializerOptions JsonReaderOptions = - JsonUtils.CreateReaderOptions(AuthorizationTokenReader.Instance); + JsonUtils.CreateReaderOptions(AuthorizationTokenReader.Instance, AuthorizationErrorReader.Instance); private async Task PerformRequestAsync(Uri uri, HttpMethod method, HttpContent? body, CancellationToken cancellationToken) { @@ -349,26 +353,51 @@ public IAuthorizationToken RefreshBearerToken(string refreshToken, string client } request.Headers.UserAgent.Add(OAuth2.LibraryProductInfo); request.Headers.UserAgent.Add(OAuth2.LibraryComment); - Debug.Print($"[{DateTime.UtcNow}] => HEADERS: {TextUtils.FormatMultiLine(request.Headers.ToString())}"); + Debug.Print("[{0}] => HEADERS: {1}", DateTime.UtcNow, TextUtils.FormatMultiLine(request.Headers.ToString())); if (body is not null) { // FIXME: Should this include the actual body text too? - Debug.Print($"[{DateTime.UtcNow}] => BODY ({body.Headers.ContentType}): {body.Headers.ContentLength ?? 0} bytes"); + Debug.Print("[{0}] => BODY ({1}): {2} bytes", DateTime.UtcNow, body.Headers.ContentType, body.Headers.ContentLength ?? 0); } var response = await client.SendAsync(request, cancellationToken).ConfigureAwait(false); - Debug.Print($"[{DateTime.UtcNow}] WEB SERVICE RESPONSE: {(int) response.StatusCode}/{response.StatusCode} " + - $"'{response.ReasonPhrase}' (v{response.Version})"); - Debug.Print($"[{DateTime.UtcNow}] => HEADERS: {TextUtils.FormatMultiLine(response.Headers.ToString())}"); - Debug.Print($"[{DateTime.UtcNow}] => CONTENT ({response.Content.Headers.ContentType}): " + - $"{response.Content.Headers.ContentLength ?? 0} bytes"); - return response; + Debug.Print("[{0}] WEB SERVICE RESPONSE: {1}/{2} '{3}' (v{4})", DateTime.UtcNow, (int) response.StatusCode, response.StatusCode, + response.ReasonPhrase, response.Version); + Debug.Print("[{0}] => HEADERS: {1}", DateTime.UtcNow, TextUtils.FormatMultiLine(response.Headers.ToString())); + Debug.Print("[{0}] => CONTENT ({1}): {2} bytes", DateTime.UtcNow, response.Content.Headers.ContentType, + response.Content.Headers.ContentLength ?? 0); + try { + return await response.EnsureSuccessfulAsync(cancellationToken); + } + catch (HttpError error) { + if (!string.IsNullOrWhiteSpace(error.Content)) { + AuthorizationError? ae; + try { + ae = JsonSerializer.Deserialize(error.Content, OAuth2.JsonReaderOptions); + if (ae is null) { + throw new JsonException("Error response had null content."); + } + Debug.Print("[{0}] => ERROR '{1}' / '{2}'", DateTime.UtcNow, ae.Error, ae.Description); + // FIXME: What is the best way to compose this value? + if (ae.UnhandledProperties != null) { + foreach (var prop in ae.UnhandledProperties) { + Debug.Print("[{0}] => UNEXPECTED ERROR PROPERTY: {1} -> {2}", DateTime.UtcNow, prop.Key, prop.Value); + } + } + } + catch (Exception e) { + Debug.Print("[{0}] => FAILED TO PARSE ERROR RESPONSE CONTENT AS JSON: {1}", DateTime.UtcNow, e.Message); + ae = null; + } + if (ae != null) { + throw new HttpError(error.Status, ae.Error, response.Version, ae.Description, error); + } + } + throw; + } } private async Task PostAsync(HttpContent content, CancellationToken cancellationToken) { var uri = new UriBuilder(this.UrlScheme, this.Server, this.Port, OAuth2.TokenEndPoint).Uri; var response = await this.PerformRequestAsync(uri, HttpMethod.Post, content, cancellationToken).ConfigureAwait(false); - if (!response.IsSuccessStatusCode) { - throw await QueryException.FromResponseAsync(response, cancellationToken).ConfigureAwait(false); - } var jsonTask = JsonUtils.GetJsonContentAsync(response, OAuth2.JsonReaderOptions, cancellationToken); return await jsonTask.ConfigureAwait(false); } @@ -382,19 +411,19 @@ public IAuthorizationToken RefreshBearerToken(string refreshToken, string client return token; } - private async Task RefreshTokenAsync(string type, string codeOrToken, string clientSecret, - CancellationToken cancellationToken) { + private Task RefreshTokenAsync(string type, string codeOrToken, string clientSecret, + CancellationToken cancellationToken) { var body = new StringBuilder(); body.Append("client_id=").Append(Uri.EscapeDataString(this.ClientId)); body.Append("&client_secret=").Append(Uri.EscapeDataString(clientSecret)); body.Append("&token_type=").Append(Uri.EscapeDataString(type)); body.Append("&grant_type=refresh_token"); body.Append("&refresh_token=").Append(Uri.EscapeDataString(codeOrToken)); - return await this.PostAsync(type, body.ToString(), cancellationToken).ConfigureAwait(false); + return this.PostAsync(type, body.ToString(), cancellationToken); } - private async Task RequestTokenAsync(string type, string codeOrToken, string clientSecret, Uri redirectUri, - CancellationToken cancellationToken) { + private Task RequestTokenAsync(string type, string codeOrToken, string clientSecret, Uri redirectUri, + CancellationToken cancellationToken) { var body = new StringBuilder(); body.Append("client_id=").Append(Uri.EscapeDataString(this.ClientId)); body.Append("&client_secret=").Append(Uri.EscapeDataString(clientSecret)); @@ -402,7 +431,7 @@ public IAuthorizationToken RefreshBearerToken(string refreshToken, string client body.Append("&grant_type=authorization_code"); body.Append("&code=").Append(Uri.EscapeDataString(codeOrToken)); body.Append("&redirect_uri=").Append(Uri.EscapeDataString(redirectUri.ToString())); - return await this.PostAsync(type, body.ToString(), cancellationToken).ConfigureAwait(false); + return this.PostAsync(type, body.ToString(), cancellationToken); } private static IEnumerable ScopeStrings(AuthorizationScope scope) { diff --git a/MetaBrainz.MusicBrainz/Objects/AuthorizationError.cs b/MetaBrainz.MusicBrainz/Objects/AuthorizationError.cs new file mode 100644 index 0000000..4d91019 --- /dev/null +++ b/MetaBrainz.MusicBrainz/Objects/AuthorizationError.cs @@ -0,0 +1,11 @@ +using MetaBrainz.Common.Json; + +namespace MetaBrainz.MusicBrainz.Objects; + +internal sealed class AuthorizationError : JsonBasedObject { + + public string? Error { get; init; } + + public string? Description { get; init; } + +} diff --git a/MetaBrainz.MusicBrainz/Objects/ErrorResult.cs b/MetaBrainz.MusicBrainz/Objects/ErrorResult.cs new file mode 100644 index 0000000..f61d0f2 --- /dev/null +++ b/MetaBrainz.MusicBrainz/Objects/ErrorResult.cs @@ -0,0 +1,11 @@ +using MetaBrainz.Common.Json; + +namespace MetaBrainz.MusicBrainz.Objects; + +internal sealed class ErrorResult : JsonBasedObject { + + public string? Error { get; init; } + + public string? Help { get; init; } + +} diff --git a/MetaBrainz.MusicBrainz/Objects/MessageOrError.cs b/MetaBrainz.MusicBrainz/Objects/MessageOrError.cs deleted file mode 100644 index 587c27f..0000000 --- a/MetaBrainz.MusicBrainz/Objects/MessageOrError.cs +++ /dev/null @@ -1,13 +0,0 @@ -using MetaBrainz.Common.Json; - -namespace MetaBrainz.MusicBrainz.Objects; - -internal sealed class MessageOrError : JsonBasedObject { - - public string? Error; - - public string? Help; - - public string? Message; - -} diff --git a/MetaBrainz.MusicBrainz/Objects/MessageResult.cs b/MetaBrainz.MusicBrainz/Objects/MessageResult.cs new file mode 100644 index 0000000..6ffb25d --- /dev/null +++ b/MetaBrainz.MusicBrainz/Objects/MessageResult.cs @@ -0,0 +1,9 @@ +using MetaBrainz.Common.Json; + +namespace MetaBrainz.MusicBrainz.Objects; + +internal sealed class MessageResult : JsonBasedObject { + + public string? Message { get; init; } + +} diff --git a/MetaBrainz.MusicBrainz/Query.Internals.cs b/MetaBrainz.MusicBrainz/Query.Internals.cs index 315934b..91740a6 100644 --- a/MetaBrainz.MusicBrainz/Query.Internals.cs +++ b/MetaBrainz.MusicBrainz/Query.Internals.cs @@ -14,6 +14,7 @@ using MetaBrainz.Common.Json; using MetaBrainz.MusicBrainz.Interfaces.Submissions; using MetaBrainz.MusicBrainz.Json; +using MetaBrainz.MusicBrainz.Objects; namespace MetaBrainz.MusicBrainz; @@ -452,54 +453,39 @@ private Uri BuildUri(string path, string? extra = null) private static async Task ExtractMessageAsync(HttpResponseMessage response, CancellationToken cancellationToken) { string? message = null; try { - if (response.Content.Headers.ContentLength > 0) { - var body = await HttpUtils.GetStringContentAsync(response, cancellationToken).ConfigureAwait(false); - if (string.IsNullOrWhiteSpace(body)) { - Debug.Print($"[{DateTime.UtcNow}] => NO MESSAGE RESPONSE TEXT"); - } - else { - var handled = false; - var mediaType = response.Content.Headers.ContentType?.MediaType; - if (mediaType is not null) { - if (mediaType.StartsWith("application/json")) { - using var doc = JsonSerializer.Deserialize(body); - if (doc is not null && doc.RootElement.ValueKind == JsonValueKind.Object) { - // MusicBrainz message response: { "message": "this is a message" } - handled = true; - foreach (var prop in doc.RootElement.EnumerateObject()) { - switch (prop.Name) { - case "message": - message = prop.Value.GetString(); - break; - default: - handled = false; - break; - } - if (!handled) { - break; - } - } - if (handled && message is not null) { - Debug.Print($"[{DateTime.UtcNow}] => MESSAGE: '{message}'"); - } - } - } + var contents = await response.GetStringContentAsync(cancellationToken).ConfigureAwait(false); + if (!string.IsNullOrWhiteSpace(contents)) { + try { + var mr = JsonSerializer.Deserialize(contents, Query.JsonReaderOptions); + if (mr is null) { + throw new JsonException("Message response had null content."); } - if (!handled) { - Debug.Print($"[{DateTime.UtcNow}] => MESSAGE RESPONSE TEXT: {TextUtils.FormatMultiLine(body)}"); - message = body; + message = mr.Message; + if (mr.UnhandledProperties != null) { + foreach (var prop in mr.UnhandledProperties) { + Debug.Print("[{0}] => UNEXPECTED MESSAGE PROPERTY: {1} -> {2}", DateTime.UtcNow, prop.Key, prop.Value); + } } } + catch (Exception e) { + Debug.Print("[{0}] => FAILED TO PARSE MESSAGE RESPONSE CONTENT AS JSON: {1}", DateTime.UtcNow, e.Message); + message = null; + } + if (message is not null) { + Debug.Print("[{0}] => MESSAGE: '{1}'", DateTime.UtcNow, message); + } + else { + Debug.Print("[{0}] => MESSAGE RESPONSE CONTENT: '{1}'", DateTime.UtcNow, contents); + } } else { - Debug.Print($"[{DateTime.UtcNow}] => NO MESSAGE RESPONSE CONTENT"); + Debug.Print("[{0}] => NO MESSAGE RESPONSE CONTENT", DateTime.UtcNow); } - return message; } catch { // keep calm and fall through } - return null; + return message; } private async Task PerformRequestAsync(Uri uri, HttpMethod method, HttpContent? body, @@ -540,10 +526,34 @@ private Uri BuildUri(string path, string? extra = null) finally { this._rateLimitLock.ExitWriteLock(); } - if (!response.IsSuccessStatusCode) { - throw await QueryException.FromResponseAsync(response, cancellationToken).ConfigureAwait(false); + try { + return await response.EnsureSuccessfulAsync(cancellationToken); + } + catch (HttpError error) { + if (!string.IsNullOrWhiteSpace(error.Content)) { + ErrorResult? er; + try { + er = JsonSerializer.Deserialize(error.Content, Query.JsonReaderOptions); + if (er is null) { + throw new JsonException("Error response had null content."); + } + Debug.Print("[{0}] => ERROR '{1}' ({2})", DateTime.UtcNow, er.Error, er.Help); + if (er.UnhandledProperties != null) { + foreach (var prop in er.UnhandledProperties) { + Debug.Print("[{0}] => UNEXPECTED ERROR PROPERTY: {1} -> {2}", DateTime.UtcNow, prop.Key, prop.Value); + } + } + } + catch (Exception e) { + Debug.Print("[{0}] => FAILED TO PARSE ERROR RESPONSE CONTENT AS JSON: {1}", DateTime.UtcNow, e.Message); + er = null; + } + if (er != null) { + throw new HttpError(error.Status, er.Error, response.Version, er.Help, error); + } + } + throw; } - return response; } internal Task PerformRequestAsync(string entity, Guid id, string extra, CancellationToken cancellationToken) diff --git a/MetaBrainz.MusicBrainz/QueryException.cs b/MetaBrainz.MusicBrainz/QueryException.cs deleted file mode 100644 index bb75f5d..0000000 --- a/MetaBrainz.MusicBrainz/QueryException.cs +++ /dev/null @@ -1,114 +0,0 @@ -using System; -using System.Diagnostics; -using System.Net; -using System.Net.Http; -using System.Text.Json; -using System.Threading; -using System.Threading.Tasks; - -using JetBrains.Annotations; - -using MetaBrainz.Common; - -namespace MetaBrainz.MusicBrainz; - -/// An error reported by the MusicBrainz web service. -[PublicAPI] -public sealed class QueryException : Exception { - - /// The HTTP status code for the exception. - public readonly HttpStatusCode Code; - - /// The reason phrase for the exception, if available. - public readonly string? Reason; - - /// Creates a new query exception. - /// The HTTP message code for the error. - /// The reason phrase for the error. - /// A further error message. - /// The exception that caused the error (if any). - public QueryException(HttpStatusCode code, string? reason = null, string? message = null, - Exception? cause = null) : base(message ?? reason, cause) { - this.Code = code; - this.Reason = reason; - } - - /// Creates a new instance using the specified message and cause. - /// The message for the exception. - /// The exception that caused this one to be created. - public QueryException(string message, Exception? cause = null) : base(message, cause) { - this.Code = HttpStatusCode.BadRequest; - this.Reason = "Bad Request"; - } - - #region Creation Based on HTTP Response - - /// Creates a based on error information from an HTTP response. - /// The response to get error information from. - /// A newly created based on . - public static QueryException FromResponse(HttpResponseMessage response) - => AsyncUtils.ResultOf(QueryException.FromResponseAsync(response)); - - /// Creates a based on error information from an HTTP response. - /// The response to get error information from. - /// The cancellation token to cancel the operation. - /// A newly created based on . - public static async Task FromResponseAsync(HttpResponseMessage response, - CancellationToken cancellationToken = default) { - string? errorInfo = null; - if (response.Content.Headers.ContentLength > 0) { - errorInfo = await HttpUtils.GetStringContentAsync(response, cancellationToken).ConfigureAwait(false); - if (string.IsNullOrWhiteSpace(errorInfo)) { - Debug.Print($"[{DateTime.UtcNow}] => NO ERROR RESPONSE TEXT"); - errorInfo = null; - } - else { - var handled = false; - var mediaType = response.Content.Headers.ContentType?.MediaType; - if (mediaType is not null) { - if (mediaType.StartsWith("application/json")) { - using var doc = JsonSerializer.Deserialize(errorInfo); - if (doc is not null && doc.RootElement.ValueKind == JsonValueKind.Object) { - // MusicBrainz error response: { "error": "error_id", "help": "this is an error" } - // OAuth2 error response: { "error": "error_id", "error_description": "this is an error" } - string? error = null; - string? errorDescription = null; - handled = true; - foreach (var prop in doc.RootElement.EnumerateObject()) { - switch (prop.Name) { - case "error": - error = prop.Value.GetString(); - break; - case "error_description": - case "help": - errorDescription = prop.Value.GetString(); - break; - default: - handled = false; - break; - } - if (!handled) { - break; - } - } - if (handled && error is not null && errorDescription is not null) { - Debug.Print($"[{DateTime.UtcNow}] => ERROR: '{error}' DESCRIPTION/HELP: '{errorDescription}'"); - errorInfo = $"{error} ({errorDescription})"; - } - } - } - } - if (!handled) { - Debug.Print($"[{DateTime.UtcNow}] => ERROR RESPONSE TEXT: {TextUtils.FormatMultiLine(errorInfo)}"); - } - } - } - else { - Debug.Print($"[{DateTime.UtcNow}] => NO ERROR RESPONSE CONTENT"); - } - return new QueryException(response.StatusCode, response.ReasonPhrase, errorInfo); - } - - #endregion - -} diff --git a/public-api/MetaBrainz.MusicBrainz.net6.0.cs.md b/public-api/MetaBrainz.MusicBrainz.net6.0.cs.md index 0b90be1..6aac7a5 100644 --- a/public-api/MetaBrainz.MusicBrainz.net6.0.cs.md +++ b/public-api/MetaBrainz.MusicBrainz.net6.0.cs.md @@ -1724,26 +1724,6 @@ public sealed class Query : System.IDisposable { } ``` -### Type: QueryException - -```cs -public sealed class QueryException : System.Exception { - - public readonly System.Net.HttpStatusCode Code; - - public readonly string? Reason; - - public QueryException(System.Net.HttpStatusCode code, string? reason = null, string? message = null, System.Exception? cause = null); - - public QueryException(string message, System.Exception? cause = null); - - public static QueryException FromResponse(System.Net.Http.HttpResponseMessage response); - - public static System.Threading.Tasks.Task FromResponseAsync(System.Net.Http.HttpResponseMessage response, System.Threading.CancellationToken cancellationToken = default); - -} -``` - ### Type: ReleaseStatus ```cs diff --git a/public-api/MetaBrainz.MusicBrainz.net8.0.cs.md b/public-api/MetaBrainz.MusicBrainz.net8.0.cs.md index c647f81..52c3423 100644 --- a/public-api/MetaBrainz.MusicBrainz.net8.0.cs.md +++ b/public-api/MetaBrainz.MusicBrainz.net8.0.cs.md @@ -1724,26 +1724,6 @@ public sealed class Query : System.IDisposable { } ``` -### Type: QueryException - -```cs -public sealed class QueryException : System.Exception { - - public readonly System.Net.HttpStatusCode Code; - - public readonly string? Reason; - - public QueryException(System.Net.HttpStatusCode code, string? reason = null, string? message = null, System.Exception? cause = null); - - public QueryException(string message, System.Exception? cause = null); - - public static QueryException FromResponse(System.Net.Http.HttpResponseMessage response); - - public static System.Threading.Tasks.Task FromResponseAsync(System.Net.Http.HttpResponseMessage response, System.Threading.CancellationToken cancellationToken = default); - -} -``` - ### Type: ReleaseStatus ```cs From d3ae5bbcbba65d42823f0519d139574551bb8291 Mon Sep 17 00:00:00 2001 From: Tim Van Holder Date: Fri, 29 Dec 2023 16:42:31 +0100 Subject: [PATCH 5/8] Add exception documentation All methods that issue a web request are now properly documented as potentially throwing `HttpRequestException` or `HttpError`. --- .../Interfaces/IPagedQueryResults.cs | 19 +- .../Objects/Submissions/Submission.cs | 8 +- MetaBrainz.MusicBrainz/Query.Browse.Areas.cs | 26 +- .../Query.Browse.Artists.cs | 146 ++++----- .../Query.Browse.Collections.cs | 278 +++++++++--------- MetaBrainz.MusicBrainz/Query.Browse.Events.cs | 98 +++--- .../Query.Browse.Instruments.cs | 26 +- MetaBrainz.MusicBrainz/Query.Browse.Labels.cs | 74 ++--- MetaBrainz.MusicBrainz/Query.Browse.Places.cs | 50 ++-- .../Query.Browse.Recordings.cs | 74 ++--- .../Query.Browse.ReleaseGroups.cs | 62 ++-- .../Query.Browse.Releases.cs | 194 ++++++------ MetaBrainz.MusicBrainz/Query.Browse.Series.cs | 26 +- MetaBrainz.MusicBrainz/Query.Browse.Works.cs | 50 ++-- .../Query.Collections.Areas.cs | 114 +++---- .../Query.Collections.Artists.cs | 114 +++---- .../Query.Collections.Events.cs | 114 +++---- .../Query.Collections.Instruments.cs | 114 +++---- .../Query.Collections.Labels.cs | 114 +++---- .../Query.Collections.Places.cs | 114 +++---- .../Query.Collections.Recordings.cs | 114 +++---- .../Query.Collections.ReleaseGroups.cs | 114 +++---- .../Query.Collections.Releases.cs | 114 +++---- .../Query.Collections.Series.cs | 114 +++---- .../Query.Collections.Works.cs | 114 +++---- MetaBrainz.MusicBrainz/Query.Collections.cs | 113 ++++--- MetaBrainz.MusicBrainz/Query.Lookup.cs | 146 ++++----- .../Query.Search.Annotations.cs | 14 +- MetaBrainz.MusicBrainz/Query.Search.Areas.cs | 14 +- .../Query.Search.Artists.cs | 14 +- .../Query.Search.CdStubs.cs | 14 +- MetaBrainz.MusicBrainz/Query.Search.Events.cs | 14 +- .../Query.Search.Instruments.cs | 14 +- MetaBrainz.MusicBrainz/Query.Search.Labels.cs | 14 +- MetaBrainz.MusicBrainz/Query.Search.Places.cs | 14 +- .../Query.Search.Recordings.cs | 14 +- .../Query.Search.ReleaseGroups.cs | 14 +- .../Query.Search.Releases.cs | 14 +- MetaBrainz.MusicBrainz/Query.Search.Series.cs | 14 +- MetaBrainz.MusicBrainz/Query.Search.Tags.cs | 14 +- MetaBrainz.MusicBrainz/Query.Search.Urls.cs | 14 +- MetaBrainz.MusicBrainz/Query.Search.Works.cs | 14 +- 42 files changed, 1427 insertions(+), 1427 deletions(-) diff --git a/MetaBrainz.MusicBrainz/Interfaces/IPagedQueryResults.cs b/MetaBrainz.MusicBrainz/Interfaces/IPagedQueryResults.cs index 1e91f41..724205a 100644 --- a/MetaBrainz.MusicBrainz/Interfaces/IPagedQueryResults.cs +++ b/MetaBrainz.MusicBrainz/Interfaces/IPagedQueryResults.cs @@ -1,10 +1,11 @@ using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; using JetBrains.Annotations; +using MetaBrainz.Common; using MetaBrainz.Common.Json; namespace MetaBrainz.MusicBrainz.Interfaces; @@ -46,8 +47,8 @@ public interface IPagedQueryResults : IJsonBasedObject /// of results, based on and . /// /// This result set (with updated values). - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. TResults Next(); /// @@ -56,8 +57,8 @@ public interface IPagedQueryResults : IJsonBasedObject /// /// The cancellation token to cancel the operation. /// This result set (with updated values). - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. Task NextAsync(CancellationToken cancellationToken = default); /// @@ -77,8 +78,8 @@ public interface IPagedQueryResults : IJsonBasedObject /// of results, based on and . /// /// This result set (with updated values). - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. TResults Previous(); /// @@ -87,8 +88,8 @@ public interface IPagedQueryResults : IJsonBasedObject /// /// The cancellation token to cancel the operation. /// This result set (with updated values). - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. Task PreviousAsync(CancellationToken cancellationToken = default); /// The current results. diff --git a/MetaBrainz.MusicBrainz/Objects/Submissions/Submission.cs b/MetaBrainz.MusicBrainz/Objects/Submissions/Submission.cs index 0bf9aeb..0a6bcfc 100644 --- a/MetaBrainz.MusicBrainz/Objects/Submissions/Submission.cs +++ b/MetaBrainz.MusicBrainz/Objects/Submissions/Submission.cs @@ -20,15 +20,15 @@ public abstract class Submission : ISubmission { /// Submits the request. /// A message describing the result (usually "OK"). - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string Submit() => AsyncUtils.ResultOf(this.SubmitAsync()); /// Submits the request asynchronously. /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public async Task SubmitAsync(CancellationToken cancellationToken = default) => await this._query.PerformSubmissionAsync(this, cancellationToken).ConfigureAwait(false); diff --git a/MetaBrainz.MusicBrainz/Query.Browse.Areas.cs b/MetaBrainz.MusicBrainz/Query.Browse.Areas.cs index 57ec145..d5a50e4 100644 --- a/MetaBrainz.MusicBrainz/Query.Browse.Areas.cs +++ b/MetaBrainz.MusicBrainz/Query.Browse.Areas.cs @@ -1,5 +1,5 @@ using System; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -24,8 +24,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllAreas(ICollection collection, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseAreas(this, Query.BuildExtraText(inc, "collection", collection.Id), pageSize, offset).AsStream(); @@ -41,8 +41,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollectionAreas(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseAreas(this, Query.BuildExtraText(inc, "collection", mbid), pageSize, offset).AsStream(); @@ -53,8 +53,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseAreas(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseAreasAsync(collection, limit, offset, inc)); @@ -66,8 +66,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseAreasAsync(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseAreas(this, Query.BuildExtraText(inc, "collection", collection.Id), limit, offset).NextAsync(cancellationToken); @@ -78,8 +78,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollectionAreas(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseCollectionAreasAsync(mbid, limit, offset, inc)); @@ -90,8 +90,8 @@ public IBrowseResults BrowseCollectionAreas(Guid mbid, int? limit = null, /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionAreasAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) diff --git a/MetaBrainz.MusicBrainz/Query.Browse.Artists.cs b/MetaBrainz.MusicBrainz/Query.Browse.Artists.cs index 4370092..9c367f7 100644 --- a/MetaBrainz.MusicBrainz/Query.Browse.Artists.cs +++ b/MetaBrainz.MusicBrainz/Query.Browse.Artists.cs @@ -1,5 +1,5 @@ using System; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -24,8 +24,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllAreaArtists(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseArtists(this, Query.BuildExtraText(inc, "area", mbid), pageSize, offset).AsStream(); @@ -41,8 +41,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllArtists(IArea area, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseArtists(this, Query.BuildExtraText(inc, "area", area.Id), pageSize, offset).AsStream(); @@ -58,8 +58,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllArtists(ICollection collection, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseArtists(this, Query.BuildExtraText(inc, "collection", collection.Id), pageSize, offset).AsStream(); @@ -75,8 +75,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllArtists(IRecording recording, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseArtists(this, Query.BuildExtraText(inc, "recording", recording.Id), pageSize, offset).AsStream(); @@ -92,8 +92,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllArtists(IRelease release, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseArtists(this, Query.BuildExtraText(inc, "release", release.Id), pageSize, offset).AsStream(); @@ -109,8 +109,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllArtists(IReleaseGroup releaseGroup, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseArtists(this, Query.BuildExtraText(inc, "release-group", releaseGroup.Id), pageSize, offset).AsStream(); @@ -126,8 +126,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllArtists(IWork work, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseArtists(this, Query.BuildExtraText(inc, "work", work.Id), pageSize, offset).AsStream(); @@ -143,8 +143,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollectionArtists(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseArtists(this, Query.BuildExtraText(inc, "collection", mbid), pageSize, offset).AsStream(); @@ -160,8 +160,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllRecordingArtists(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseArtists(this, Query.BuildExtraText(inc, "recording", mbid), pageSize, offset).AsStream(); @@ -177,8 +177,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleaseArtists(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseArtists(this, Query.BuildExtraText(inc, "release", mbid), pageSize, offset).AsStream(); @@ -194,8 +194,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleaseGroupArtists(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseArtists(this, Query.BuildExtraText(inc, "release-group", mbid), pageSize, offset).AsStream(); @@ -211,8 +211,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllWorkArtists(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseArtists(this, Query.BuildExtraText(inc, "work", mbid), pageSize, offset).AsStream(); @@ -223,8 +223,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseAreaArtists(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseAreaArtistsAsync(mbid, limit, offset, inc)); @@ -235,8 +235,8 @@ public IBrowseResults BrowseAreaArtists(Guid mbid, int? limit = null, i /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseAreaArtistsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -248,8 +248,8 @@ public IBrowseResults BrowseAreaArtists(Guid mbid, int? limit = null, i /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseArtists(IArea area, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseArtistsAsync(area, limit, offset, inc)); @@ -259,8 +259,8 @@ public IBrowseResults BrowseArtists(IArea area, int? limit = null, int? /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseArtists(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseArtistsAsync(collection, limit, offset, inc)); @@ -271,8 +271,8 @@ public IBrowseResults BrowseArtists(IArea area, int? limit = null, int? /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseArtists(IRecording recording, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseArtistsAsync(recording, limit, offset, inc)); @@ -283,8 +283,8 @@ public IBrowseResults BrowseArtists(IArea area, int? limit = null, int? /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseArtists(IRelease release, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseArtistsAsync(release, limit, offset, inc)); @@ -294,8 +294,8 @@ public IBrowseResults BrowseArtists(IRelease release, int? limit = null /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseArtists(IReleaseGroup releaseGroup, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseArtistsAsync(releaseGroup, limit, offset, inc)); @@ -306,8 +306,8 @@ public IBrowseResults BrowseArtists(IRelease release, int? limit = null /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseArtists(IWork work, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseArtistsAsync(work, limit, offset, inc)); @@ -318,8 +318,8 @@ public IBrowseResults BrowseArtists(IWork work, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseArtistsAsync(IArea area, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseArtists(this, Query.BuildExtraText(inc, "area", area.Id), limit, offset).NextAsync(cancellationToken); @@ -331,8 +331,8 @@ public IBrowseResults BrowseArtists(IWork work, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseArtistsAsync(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseArtists(this, Query.BuildExtraText(inc, "collection", collection.Id), limit, offset).NextAsync(cancellationToken); @@ -344,8 +344,8 @@ public IBrowseResults BrowseArtists(IWork work, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseArtistsAsync(IRecording recording, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseArtists(this, Query.BuildExtraText(inc, "recording", recording.Id), limit, offset).NextAsync(cancellationToken); @@ -357,8 +357,8 @@ public IBrowseResults BrowseArtists(IWork work, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseArtistsAsync(IRelease release, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseArtists(this, Query.BuildExtraText(inc, "release", release.Id), limit, offset).NextAsync(cancellationToken); @@ -370,8 +370,8 @@ public IBrowseResults BrowseArtists(IWork work, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseArtistsAsync(IReleaseGroup releaseGroup, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) { @@ -386,8 +386,8 @@ public IBrowseResults BrowseArtists(IWork work, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseArtistsAsync(IWork work, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseArtists(this, Query.BuildExtraText(inc, "work", work.Id), limit, offset).NextAsync(cancellationToken); @@ -398,8 +398,8 @@ public IBrowseResults BrowseArtists(IWork work, int? limit = null, int? /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollectionArtists(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseCollectionArtistsAsync(mbid, limit, offset, inc)); @@ -411,8 +411,8 @@ public IBrowseResults BrowseArtists(IWork work, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionArtistsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -424,8 +424,8 @@ public IBrowseResults BrowseArtists(IWork work, int? limit = null, int? /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseRecordingArtists(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseRecordingArtistsAsync(mbid, limit, offset, inc)); @@ -437,8 +437,8 @@ public IBrowseResults BrowseArtists(IWork work, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseRecordingArtistsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -450,8 +450,8 @@ public IBrowseResults BrowseArtists(IWork work, int? limit = null, int? /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleaseArtists(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseReleaseArtistsAsync(mbid, limit, offset, inc)); @@ -462,8 +462,8 @@ public IBrowseResults BrowseReleaseArtists(Guid mbid, int? limit = null /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleaseArtistsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -475,8 +475,8 @@ public IBrowseResults BrowseReleaseArtists(Guid mbid, int? limit = null /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleaseGroupArtists(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseReleaseGroupArtistsAsync(mbid, limit, offset, inc)); @@ -488,8 +488,8 @@ public IBrowseResults BrowseReleaseArtists(Guid mbid, int? limit = null /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleaseGroupArtistsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -501,8 +501,8 @@ public IBrowseResults BrowseReleaseArtists(Guid mbid, int? limit = null /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseWorkArtists(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseWorkArtistsAsync(mbid, limit, offset, inc)); @@ -513,8 +513,8 @@ public IBrowseResults BrowseWorkArtists(Guid mbid, int? limit = null, i /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseWorkArtistsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) diff --git a/MetaBrainz.MusicBrainz/Query.Browse.Collections.cs b/MetaBrainz.MusicBrainz/Query.Browse.Collections.cs index be3820c..f6e2614 100644 --- a/MetaBrainz.MusicBrainz/Query.Browse.Collections.cs +++ b/MetaBrainz.MusicBrainz/Query.Browse.Collections.cs @@ -1,5 +1,5 @@ using System; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -23,8 +23,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllAreaCollections(Guid mbid, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("area", mbid), pageSize, offset).AsStream(); @@ -38,8 +38,8 @@ public IStreamingQueryResults BrowseAllAreaCollections(Guid mbid, i /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllArtistCollections(Guid mbid, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("artist", mbid), pageSize, offset).AsStream(); @@ -53,8 +53,8 @@ public IStreamingQueryResults BrowseAllArtistCollections(Guid mbid, /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollections(IArea area, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("area", area.Id), pageSize, offset).AsStream(); @@ -68,8 +68,8 @@ public IStreamingQueryResults BrowseAllCollections(IArea area, int? /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollections(IArtist artist, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("artist", artist.Id), pageSize, offset).AsStream(); @@ -83,8 +83,8 @@ public IStreamingQueryResults BrowseAllCollections(IArtist artist, /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollections(IEvent @event, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("event", @event.Id), pageSize, offset).AsStream(); @@ -98,8 +98,8 @@ public IStreamingQueryResults BrowseAllCollections(IEvent @event, i /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollections(IInstrument instrument, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("instrument", instrument.Id), pageSize, offset).AsStream(); @@ -113,8 +113,8 @@ public IStreamingQueryResults BrowseAllCollections(IInstrument inst /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollections(ILabel label, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("label", label.Id), pageSize, offset).AsStream(); @@ -128,8 +128,8 @@ public IStreamingQueryResults BrowseAllCollections(ILabel label, in /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollections(IPlace place, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("place", place.Id), pageSize, offset).AsStream(); @@ -143,8 +143,8 @@ public IStreamingQueryResults BrowseAllCollections(IPlace place, in /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollections(IRecording recording, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("recording", recording.Id), pageSize, offset).AsStream(); @@ -158,8 +158,8 @@ public IStreamingQueryResults BrowseAllCollections(IRecording recor /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollections(IRelease release, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("release", release.Id), pageSize, offset).AsStream(); @@ -173,8 +173,8 @@ public IStreamingQueryResults BrowseAllCollections(IRelease release /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollections(IReleaseGroup releaseGroup, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("release-group", releaseGroup.Id), pageSize, offset).AsStream(); @@ -189,8 +189,8 @@ public IStreamingQueryResults BrowseAllCollections(IRelease release /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollections(ISeries series, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("series", series.Id), pageSize, offset).AsStream(); @@ -204,8 +204,8 @@ public IStreamingQueryResults BrowseAllCollections(ISeries series, /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollections(IWork work, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("work", work.Id), pageSize, offset).AsStream(); @@ -219,8 +219,8 @@ public IStreamingQueryResults BrowseAllCollections(IWork work, int? /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllEditorCollections(string editor, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("editor", editor), pageSize, offset).AsStream(); @@ -234,8 +234,8 @@ public IStreamingQueryResults BrowseAllEditorCollections(string edi /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllEventCollections(Guid mbid, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("event", mbid), pageSize, offset).AsStream(); @@ -249,8 +249,8 @@ public IStreamingQueryResults BrowseAllEventCollections(Guid mbid, /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllInstrumentCollections(Guid mbid, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("instrument", mbid), pageSize, offset).AsStream(); @@ -264,8 +264,8 @@ public IStreamingQueryResults BrowseAllInstrumentCollections(Guid m /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllLabelCollections(Guid mbid, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("label", mbid), pageSize, offset).AsStream(); @@ -279,8 +279,8 @@ public IStreamingQueryResults BrowseAllLabelCollections(Guid mbid, /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllPlaceCollections(Guid mbid, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("place", mbid), pageSize, offset).AsStream(); @@ -294,8 +294,8 @@ public IStreamingQueryResults BrowseAllPlaceCollections(Guid mbid, /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllRecordingCollections(Guid mbid, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("recording", mbid), pageSize, offset).AsStream(); @@ -309,8 +309,8 @@ public IStreamingQueryResults BrowseAllRecordingCollections(Guid mb /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleaseCollections(Guid mbid, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("release", mbid), pageSize, offset).AsStream(); @@ -324,8 +324,8 @@ public IStreamingQueryResults BrowseAllReleaseCollections(Guid mbid /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleaseGroupCollections(Guid mbid, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("release-group", mbid), pageSize, offset).AsStream(); @@ -339,8 +339,8 @@ public IStreamingQueryResults BrowseAllReleaseGroupCollections(Guid /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllSeriesCollections(Guid mbid, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("series", mbid), pageSize, offset).AsStream(); @@ -354,8 +354,8 @@ public IStreamingQueryResults BrowseAllSeriesCollections(Guid mbid, /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllWorkCollections(Guid mbid, int? pageSize = null, int? offset = null) => new BrowseCollections(this, Query.BuildExtraText("work", mbid), pageSize, offset).AsStream(); @@ -364,8 +364,8 @@ public IStreamingQueryResults BrowseAllWorkCollections(Guid mbid, i /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseAreaCollections(Guid mbid, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseAreaCollectionsAsync(mbid, limit, offset)); @@ -375,8 +375,8 @@ public IBrowseResults BrowseAreaCollections(Guid mbid, int? limit = /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseAreaCollectionsAsync(Guid mbid, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("area", mbid), limit, offset).NextAsync(cancellationToken); @@ -386,8 +386,8 @@ public IBrowseResults BrowseAreaCollections(Guid mbid, int? limit = /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseArtistCollections(Guid mbid, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseArtistCollectionsAsync(mbid, limit, offset)); @@ -397,8 +397,8 @@ public IBrowseResults BrowseArtistCollections(Guid mbid, int? limit /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseArtistCollectionsAsync(Guid mbid, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("artist", mbid), limit, offset).NextAsync(cancellationToken); @@ -408,8 +408,8 @@ public IBrowseResults BrowseArtistCollections(Guid mbid, int? limit /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollections(IArea area, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseCollectionsAsync(area, limit, offset)); @@ -418,8 +418,8 @@ public IBrowseResults BrowseCollections(IArea area, int? limit = nu /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollections(IArtist artist, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseCollectionsAsync(artist, limit, offset)); @@ -428,8 +428,8 @@ public IBrowseResults BrowseCollections(IArtist artist, int? limit /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollections(IEvent @event, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseCollectionsAsync(@event, limit, offset)); @@ -438,8 +438,8 @@ public IBrowseResults BrowseCollections(IEvent @event, int? limit = /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollections(IInstrument instrument, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseCollectionsAsync(instrument, limit, offset)); @@ -448,8 +448,8 @@ public IBrowseResults BrowseCollections(IInstrument instrument, int /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollections(ILabel label, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseCollectionsAsync(label, limit, offset)); @@ -458,8 +458,8 @@ public IBrowseResults BrowseCollections(ILabel label, int? limit = /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollections(IPlace place, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseCollectionsAsync(place, limit, offset)); @@ -468,8 +468,8 @@ public IBrowseResults BrowseCollections(IPlace place, int? limit = /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollections(IRecording recording, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseCollectionsAsync(recording, limit, offset)); @@ -478,8 +478,8 @@ public IBrowseResults BrowseCollections(IRecording recording, int? /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollections(IRelease release, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseCollectionsAsync(release, limit, offset)); @@ -488,8 +488,8 @@ public IBrowseResults BrowseCollections(IRelease release, int? limi /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollections(IReleaseGroup releaseGroup, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseCollectionsAsync(releaseGroup, limit, offset)); @@ -498,8 +498,8 @@ public IBrowseResults BrowseCollections(IReleaseGroup releaseGroup, /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollections(ISeries series, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseCollectionsAsync(series, limit, offset)); @@ -508,8 +508,8 @@ public IBrowseResults BrowseCollections(ISeries series, int? limit /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollections(IWork work, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseCollectionsAsync(work, limit, offset)); @@ -519,8 +519,8 @@ public IBrowseResults BrowseCollections(IWork work, int? limit = nu /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionsAsync(IArea area, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("area", area.Id), limit, offset).NextAsync(cancellationToken); @@ -531,8 +531,8 @@ public IBrowseResults BrowseCollections(IWork work, int? limit = nu /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionsAsync(IArtist artist, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("artist", artist.Id), limit, offset).NextAsync(cancellationToken); @@ -543,8 +543,8 @@ public IBrowseResults BrowseCollections(IWork work, int? limit = nu /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionsAsync(IEvent @event, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("event", @event.Id), limit, offset).NextAsync(cancellationToken); @@ -555,8 +555,8 @@ public IBrowseResults BrowseCollections(IWork work, int? limit = nu /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionsAsync(IInstrument instrument, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("instrument", instrument.Id), limit, offset).NextAsync(cancellationToken); @@ -567,8 +567,8 @@ public IBrowseResults BrowseCollections(IWork work, int? limit = nu /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionsAsync(ILabel label, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("label", label.Id), limit, offset).NextAsync(cancellationToken); @@ -579,8 +579,8 @@ public IBrowseResults BrowseCollections(IWork work, int? limit = nu /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionsAsync(IPlace place, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("place", place.Id), limit, offset).NextAsync(cancellationToken); @@ -591,8 +591,8 @@ public IBrowseResults BrowseCollections(IWork work, int? limit = nu /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionsAsync(IRecording recording, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("recording", recording.Id), limit, offset).NextAsync(cancellationToken); @@ -603,8 +603,8 @@ public IBrowseResults BrowseCollections(IWork work, int? limit = nu /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionsAsync(IRelease release, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("release", release.Id), limit, offset).NextAsync(cancellationToken); @@ -615,8 +615,8 @@ public IBrowseResults BrowseCollections(IWork work, int? limit = nu /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionsAsync(IReleaseGroup releaseGroup, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) { var browse = new BrowseCollections(this, Query.BuildExtraText("release-group", releaseGroup.Id), limit, offset); @@ -629,8 +629,8 @@ public IBrowseResults BrowseCollections(IWork work, int? limit = nu /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionsAsync(ISeries series, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("series", series.Id), limit, offset).NextAsync(cancellationToken); @@ -641,8 +641,8 @@ public IBrowseResults BrowseCollections(IWork work, int? limit = nu /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionsAsync(IWork work, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("work", work.Id), limit, offset).NextAsync(cancellationToken); @@ -652,8 +652,8 @@ public IBrowseResults BrowseCollections(IWork work, int? limit = nu /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseEditorCollections(string editor, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseEditorCollectionsAsync(editor, limit, offset)); @@ -663,8 +663,8 @@ public IBrowseResults BrowseEditorCollections(string editor, int? l /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseEditorCollectionsAsync(string editor, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("editor", editor), limit, offset).NextAsync(cancellationToken); @@ -674,8 +674,8 @@ public IBrowseResults BrowseEditorCollections(string editor, int? l /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseEventCollections(Guid mbid, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseEventCollectionsAsync(mbid, limit, offset)); @@ -685,8 +685,8 @@ public IBrowseResults BrowseEventCollections(Guid mbid, int? limit /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseEventCollectionsAsync(Guid mbid, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("event", mbid), limit, offset).NextAsync(cancellationToken); @@ -696,8 +696,8 @@ public IBrowseResults BrowseEventCollections(Guid mbid, int? limit /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseInstrumentCollections(Guid mbid, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseInstrumentCollectionsAsync(mbid, limit, offset)); @@ -707,8 +707,8 @@ public IBrowseResults BrowseInstrumentCollections(Guid mbid, int? l /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseInstrumentCollectionsAsync(Guid mbid, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("instrument", mbid), limit, offset).NextAsync(cancellationToken); @@ -718,8 +718,8 @@ public IBrowseResults BrowseInstrumentCollections(Guid mbid, int? l /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseLabelCollections(Guid mbid, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseLabelCollectionsAsync(mbid, limit, offset)); @@ -729,8 +729,8 @@ public IBrowseResults BrowseLabelCollections(Guid mbid, int? limit /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseLabelCollectionsAsync(Guid mbid, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("label", mbid), limit, offset).NextAsync(cancellationToken); @@ -740,8 +740,8 @@ public IBrowseResults BrowseLabelCollections(Guid mbid, int? limit /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowsePlaceCollections(Guid mbid, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowsePlaceCollectionsAsync(mbid, limit, offset)); @@ -751,8 +751,8 @@ public IBrowseResults BrowsePlaceCollections(Guid mbid, int? limit /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowsePlaceCollectionsAsync(Guid mbid, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("place", mbid), limit, offset).NextAsync(cancellationToken); @@ -762,8 +762,8 @@ public IBrowseResults BrowsePlaceCollections(Guid mbid, int? limit /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseRecordingCollections(Guid mbid, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseRecordingCollectionsAsync(mbid, limit, offset)); @@ -773,8 +773,8 @@ public IBrowseResults BrowseRecordingCollections(Guid mbid, int? li /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseRecordingCollectionsAsync(Guid mbid, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("recording", mbid), limit, offset).NextAsync(cancellationToken); @@ -784,8 +784,8 @@ public IBrowseResults BrowseRecordingCollections(Guid mbid, int? li /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleaseCollections(Guid mbid, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseReleaseCollectionsAsync(mbid, limit, offset)); @@ -795,8 +795,8 @@ public IBrowseResults BrowseReleaseCollections(Guid mbid, int? limi /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleaseCollectionsAsync(Guid mbid, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("release", mbid), limit, offset).NextAsync(cancellationToken); @@ -806,8 +806,8 @@ public IBrowseResults BrowseReleaseCollections(Guid mbid, int? limi /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleaseGroupCollections(Guid mbid, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseReleaseGroupCollectionsAsync(mbid, limit, offset)); @@ -817,8 +817,8 @@ public IBrowseResults BrowseReleaseGroupCollections(Guid mbid, int? /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleaseGroupCollectionsAsync(Guid mbid, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("release-group", mbid), limit, offset).NextAsync(cancellationToken); @@ -828,8 +828,8 @@ public IBrowseResults BrowseReleaseGroupCollections(Guid mbid, int? /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseSeriesCollections(Guid mbid, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseSeriesCollectionsAsync(mbid, limit, offset)); @@ -839,8 +839,8 @@ public IBrowseResults BrowseSeriesCollections(Guid mbid, int? limit /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseSeriesCollectionsAsync(Guid mbid, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("series", mbid), limit, offset).NextAsync(cancellationToken); @@ -850,8 +850,8 @@ public IBrowseResults BrowseSeriesCollections(Guid mbid, int? limit /// The maximum number of results to return (1-100; default is 25). /// The offset at which to start (i.e. the number of results to skip). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseWorkCollections(Guid mbid, int? limit = null, int? offset = null) => AsyncUtils.ResultOf(this.BrowseWorkCollectionsAsync(mbid, limit, offset)); @@ -861,8 +861,8 @@ public IBrowseResults BrowseWorkCollections(Guid mbid, int? limit = /// The offset at which to start (i.e. the number of results to skip). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseWorkCollectionsAsync(Guid mbid, int? limit = null, int? offset = null, CancellationToken cancellationToken = default) => new BrowseCollections(this, Query.BuildExtraText("work", mbid), limit, offset).NextAsync(cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Browse.Events.cs b/MetaBrainz.MusicBrainz/Query.Browse.Events.cs index be46991..94a72a2 100644 --- a/MetaBrainz.MusicBrainz/Query.Browse.Events.cs +++ b/MetaBrainz.MusicBrainz/Query.Browse.Events.cs @@ -1,5 +1,5 @@ using System; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -24,8 +24,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllAreaEvents(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseEvents(this, Query.BuildExtraText(inc, "area", mbid), pageSize, offset).AsStream(); @@ -41,8 +41,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllArtistEvents(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseEvents(this, Query.BuildExtraText(inc, "artist", mbid), pageSize, offset).AsStream(); @@ -58,8 +58,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollectionEvents(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseEvents(this, Query.BuildExtraText(inc, "collection", mbid), pageSize, offset).AsStream(); @@ -75,8 +75,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllEvents(IArea area, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseEvents(this, Query.BuildExtraText(inc, "area", area.Id), pageSize, offset).AsStream(); @@ -92,8 +92,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllEvents(IArtist artist, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseEvents(this, Query.BuildExtraText(inc, "artist", artist.Id), pageSize, offset).AsStream(); @@ -109,8 +109,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllEvents(ICollection collection, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseEvents(this, Query.BuildExtraText(inc, "collection", collection.Id), pageSize, offset).AsStream(); @@ -126,8 +126,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllEvents(IPlace place, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseEvents(this, Query.BuildExtraText(inc, "place", place.Id), pageSize, offset).AsStream(); @@ -143,8 +143,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllPlaceEvents(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseEvents(this, Query.BuildExtraText(inc, "place", mbid), pageSize, offset).AsStream(); @@ -155,8 +155,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseAreaEvents(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseAreaEventsAsync(mbid, limit, offset, inc)); @@ -167,8 +167,8 @@ public IBrowseResults BrowseAreaEvents(Guid mbid, int? limit = null, int /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseAreaEventsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -180,8 +180,8 @@ public IBrowseResults BrowseAreaEvents(Guid mbid, int? limit = null, int /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseArtistEvents(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseArtistEventsAsync(mbid, limit, offset, inc)); @@ -192,8 +192,8 @@ public IBrowseResults BrowseArtistEvents(Guid mbid, int? limit = null, i /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseArtistEventsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -205,8 +205,8 @@ public IBrowseResults BrowseArtistEvents(Guid mbid, int? limit = null, i /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollectionEvents(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseCollectionEventsAsync(mbid, limit, offset, inc)); @@ -217,8 +217,8 @@ public IBrowseResults BrowseCollectionEvents(Guid mbid, int? limit = nul /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionEventsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -230,8 +230,8 @@ public IBrowseResults BrowseCollectionEvents(Guid mbid, int? limit = nul /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseEvents(IArea area, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseEventsAsync(area, limit, offset, inc)); @@ -241,8 +241,8 @@ public IBrowseResults BrowseEvents(IArea area, int? limit = null, int? o /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseEvents(IArtist artist, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseEventsAsync(artist, limit, offset, inc)); @@ -252,8 +252,8 @@ public IBrowseResults BrowseEvents(IArtist artist, int? limit = null, in /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseEvents(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseEventsAsync(collection, limit, offset, inc)); @@ -264,8 +264,8 @@ public IBrowseResults BrowseEvents(IArtist artist, int? limit = null, in /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseEvents(IPlace place, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseEventsAsync(place, limit, offset, inc)); @@ -276,8 +276,8 @@ public IBrowseResults BrowseEvents(IPlace place, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseEventsAsync(IArea area, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseEvents(this, Query.BuildExtraText(inc, "area", area.Id), limit, offset).NextAsync(cancellationToken); @@ -289,8 +289,8 @@ public IBrowseResults BrowseEvents(IPlace place, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseEventsAsync(IArtist artist, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseEvents(this, Query.BuildExtraText(inc, "artist", artist.Id), limit, offset).NextAsync(cancellationToken); @@ -302,8 +302,8 @@ public IBrowseResults BrowseEvents(IPlace place, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseEventsAsync(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseEvents(this, Query.BuildExtraText(inc, "collection", collection.Id), limit, offset).NextAsync(cancellationToken); @@ -315,8 +315,8 @@ public IBrowseResults BrowseEvents(IPlace place, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseEventsAsync(IPlace place, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseEvents(this, Query.BuildExtraText(inc, "place", place.Id), limit, offset).NextAsync(cancellationToken); @@ -327,8 +327,8 @@ public IBrowseResults BrowseEvents(IPlace place, int? limit = null, int? /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowsePlaceEvents(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowsePlaceEventsAsync(mbid, limit, offset, inc)); @@ -339,8 +339,8 @@ public IBrowseResults BrowsePlaceEvents(Guid mbid, int? limit = null, in /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowsePlaceEventsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) diff --git a/MetaBrainz.MusicBrainz/Query.Browse.Instruments.cs b/MetaBrainz.MusicBrainz/Query.Browse.Instruments.cs index b901a38..430d4f1 100644 --- a/MetaBrainz.MusicBrainz/Query.Browse.Instruments.cs +++ b/MetaBrainz.MusicBrainz/Query.Browse.Instruments.cs @@ -1,5 +1,5 @@ using System; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -24,8 +24,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllInstruments(ICollection collection, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseInstruments(this, Query.BuildExtraText(inc, "collection", collection.Id), pageSize, offset).AsStream(); @@ -41,8 +41,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollectionInstruments(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseInstruments(this, Query.BuildExtraText(inc, "collection", mbid), pageSize, offset).AsStream(); @@ -53,8 +53,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseInstruments(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseInstrumentsAsync(collection, limit, offset, inc)); @@ -66,8 +66,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseInstrumentsAsync(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) { @@ -81,8 +81,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollectionInstruments(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseCollectionInstrumentsAsync(mbid, limit, offset, inc)); @@ -94,8 +94,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionInstrumentsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) diff --git a/MetaBrainz.MusicBrainz/Query.Browse.Labels.cs b/MetaBrainz.MusicBrainz/Query.Browse.Labels.cs index 9acd5c5..7125cfc 100644 --- a/MetaBrainz.MusicBrainz/Query.Browse.Labels.cs +++ b/MetaBrainz.MusicBrainz/Query.Browse.Labels.cs @@ -1,5 +1,5 @@ using System; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -24,8 +24,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllAreaLabels(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseLabels(this, Query.BuildExtraText(inc, "area", mbid), pageSize, offset).AsStream(); @@ -41,8 +41,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollectionLabels(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseLabels(this, Query.BuildExtraText(inc, "collection", mbid), pageSize, offset).AsStream(); @@ -58,8 +58,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllLabels(IArea area, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseLabels(this, Query.BuildExtraText(inc, "area", area.Id), pageSize, offset).AsStream(); @@ -75,8 +75,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllLabels(ICollection collection, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseLabels(this, Query.BuildExtraText(inc, "collection", collection.Id), pageSize, offset).AsStream(); @@ -92,8 +92,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllLabels(IRelease release, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseLabels(this, Query.BuildExtraText(inc, "release", release.Id), pageSize, offset).AsStream(); @@ -109,8 +109,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleaseLabels(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseLabels(this, Query.BuildExtraText(inc, "release", mbid), pageSize, offset).AsStream(); @@ -121,8 +121,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseAreaLabels(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseAreaLabelsAsync(mbid, limit, offset, inc)); @@ -133,8 +133,8 @@ public IBrowseResults BrowseAreaLabels(Guid mbid, int? limit = null, int /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseAreaLabelsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -146,8 +146,8 @@ public IBrowseResults BrowseAreaLabels(Guid mbid, int? limit = null, int /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollectionLabels(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseCollectionLabelsAsync(mbid, limit, offset, inc)); @@ -158,8 +158,8 @@ public IBrowseResults BrowseCollectionLabels(Guid mbid, int? limit = nul /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionLabelsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -171,8 +171,8 @@ public IBrowseResults BrowseCollectionLabels(Guid mbid, int? limit = nul /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseLabels(IArea area, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseLabelsAsync(area, limit, offset, inc)); @@ -182,8 +182,8 @@ public IBrowseResults BrowseLabels(IArea area, int? limit = null, int? o /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseLabels(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseLabelsAsync(collection, limit, offset, inc)); @@ -194,8 +194,8 @@ public IBrowseResults BrowseLabels(IArea area, int? limit = null, int? o /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseLabels(IRelease release, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseLabelsAsync(release, limit, offset, inc)); @@ -206,8 +206,8 @@ public IBrowseResults BrowseLabels(IRelease release, int? limit = null, /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseLabelsAsync(IArea area, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseLabels(this, Query.BuildExtraText(inc, "area", area.Id), limit, offset).NextAsync(cancellationToken); @@ -219,8 +219,8 @@ public IBrowseResults BrowseLabels(IRelease release, int? limit = null, /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseLabelsAsync(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseLabels(this, Query.BuildExtraText(inc, "collection", collection.Id), limit, offset).NextAsync(cancellationToken); @@ -232,8 +232,8 @@ public IBrowseResults BrowseLabels(IRelease release, int? limit = null, /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseLabelsAsync(IRelease release, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseLabels(this, Query.BuildExtraText(inc, "release", release.Id), limit, offset).NextAsync(cancellationToken); @@ -244,8 +244,8 @@ public IBrowseResults BrowseLabels(IRelease release, int? limit = null, /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleaseLabels(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseReleaseLabelsAsync(mbid, limit, offset, inc)); @@ -256,8 +256,8 @@ public IBrowseResults BrowseReleaseLabels(Guid mbid, int? limit = null, /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleaseLabelsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) diff --git a/MetaBrainz.MusicBrainz/Query.Browse.Places.cs b/MetaBrainz.MusicBrainz/Query.Browse.Places.cs index 82ec5c1..ce46157 100644 --- a/MetaBrainz.MusicBrainz/Query.Browse.Places.cs +++ b/MetaBrainz.MusicBrainz/Query.Browse.Places.cs @@ -1,5 +1,5 @@ using System; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -24,8 +24,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllAreaPlaces(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowsePlaces(this, Query.BuildExtraText(inc, "area", mbid), pageSize, offset).AsStream(); @@ -41,8 +41,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollectionPlaces(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowsePlaces(this, Query.BuildExtraText(inc, "collection", mbid), pageSize, offset).AsStream(); @@ -58,8 +58,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllPlaces(IArea area, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowsePlaces(this, Query.BuildExtraText(inc, "area", area.Id), pageSize, offset).AsStream(); @@ -75,8 +75,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllPlaces(ICollection collection, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowsePlaces(this, Query.BuildExtraText(inc, "collection", collection.Id), pageSize, offset).AsStream(); @@ -87,8 +87,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseAreaPlaces(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseAreaPlacesAsync(mbid, limit, offset, inc)); @@ -99,8 +99,8 @@ public IBrowseResults BrowseAreaPlaces(Guid mbid, int? limit = null, int /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseAreaPlacesAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -112,8 +112,8 @@ public IBrowseResults BrowseAreaPlaces(Guid mbid, int? limit = null, int /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollectionPlaces(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseCollectionPlacesAsync(mbid, limit, offset, inc)); @@ -124,8 +124,8 @@ public IBrowseResults BrowseCollectionPlaces(Guid mbid, int? limit = nul /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionPlacesAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -137,8 +137,8 @@ public IBrowseResults BrowseCollectionPlaces(Guid mbid, int? limit = nul /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowsePlaces(IArea area, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowsePlacesAsync(area, limit, offset, inc)); @@ -148,8 +148,8 @@ public IBrowseResults BrowsePlaces(IArea area, int? limit = null, int? o /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowsePlaces(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowsePlacesAsync(collection, limit, offset, inc)); @@ -161,8 +161,8 @@ public IBrowseResults BrowsePlaces(IArea area, int? limit = null, int? o /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowsePlacesAsync(IArea area, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowsePlaces(this, Query.BuildExtraText(inc, "area", area.Id), limit, offset).NextAsync(cancellationToken); @@ -174,8 +174,8 @@ public IBrowseResults BrowsePlaces(IArea area, int? limit = null, int? o /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowsePlacesAsync(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowsePlaces(this, Query.BuildExtraText(inc, "collection", collection.Id), limit, offset).NextAsync(cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Browse.Recordings.cs b/MetaBrainz.MusicBrainz/Query.Browse.Recordings.cs index b713e0b..bd3529a 100644 --- a/MetaBrainz.MusicBrainz/Query.Browse.Recordings.cs +++ b/MetaBrainz.MusicBrainz/Query.Browse.Recordings.cs @@ -1,5 +1,5 @@ using System; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -24,8 +24,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllArtistRecordings(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseRecordings(this, Query.BuildExtraText(inc, "artist", mbid), pageSize, offset).AsStream(); @@ -41,8 +41,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollectionRecordings(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseRecordings(this, Query.BuildExtraText(inc, "collection", mbid), pageSize, offset).AsStream(); @@ -58,8 +58,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllRecordings(IArtist artist, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseRecordings(this, Query.BuildExtraText(inc, "artist", artist.Id), pageSize, offset).AsStream(); @@ -75,8 +75,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllRecordings(ICollection collection, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseRecordings(this, Query.BuildExtraText(inc, "collection", collection.Id), pageSize, offset).AsStream(); @@ -92,8 +92,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllRecordings(IRelease release, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseRecordings(this, Query.BuildExtraText(inc, "release", release.Id), pageSize, offset).AsStream(); @@ -109,8 +109,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleaseRecordings(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseRecordings(this, Query.BuildExtraText(inc, "release", mbid), pageSize, offset).AsStream(); @@ -121,8 +121,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseArtistRecordings(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseArtistRecordingsAsync(mbid, limit, offset, inc)); @@ -134,8 +134,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseArtistRecordingsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -147,8 +147,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollectionRecordings(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseCollectionRecordingsAsync(mbid, limit, offset, inc)); @@ -160,8 +160,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionRecordingsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -173,8 +173,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseRecordings(IArtist artist, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseRecordingsAsync(artist, limit, offset, inc)); @@ -185,8 +185,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseRecordings(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseRecordingsAsync(collection, limit, offset, inc)); @@ -197,8 +197,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseRecordings(IRelease release, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseRecordingsAsync(release, limit, offset, inc)); @@ -210,8 +210,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseRecordingsAsync(IArtist artist, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -224,8 +224,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseRecordingsAsync(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) { @@ -240,8 +240,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseRecordingsAsync(IRelease release, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -253,8 +253,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleaseRecordings(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseReleaseRecordingsAsync(mbid, limit, offset, inc)); @@ -266,8 +266,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleaseRecordingsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) diff --git a/MetaBrainz.MusicBrainz/Query.Browse.ReleaseGroups.cs b/MetaBrainz.MusicBrainz/Query.Browse.ReleaseGroups.cs index c2c78f1..d7a10b7 100644 --- a/MetaBrainz.MusicBrainz/Query.Browse.ReleaseGroups.cs +++ b/MetaBrainz.MusicBrainz/Query.Browse.ReleaseGroups.cs @@ -1,5 +1,5 @@ using System; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -25,8 +25,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllArtistReleaseGroups(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null) => new BrowseReleaseGroups(this, Query.BuildExtraText(inc, "artist", mbid, type), pageSize, offset).AsStream(); @@ -43,8 +43,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollectionReleaseGroups(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null) @@ -62,8 +62,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. /// /// Currently a release can only be part of a single release group, so assuming is valid, this should /// always return exactly one result. @@ -84,8 +84,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleaseGroups(IArtist artist, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null) => new BrowseReleaseGroups(this, Query.BuildExtraText(inc, "artist", artist.Id, type), pageSize, offset).AsStream(); @@ -102,8 +102,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleaseGroups(ICollection collection, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null) @@ -121,8 +121,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. /// /// Currently a release can only be part of a single release group, so this should always return exactly one result. /// @@ -143,8 +143,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseArtistReleaseGroupsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, CancellationToken cancellationToken = default) @@ -163,8 +163,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionReleaseGroupsAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, @@ -186,8 +186,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. /// /// Currently a release can only be part of a single release group, so assuming is valid, this should /// always return exactly one result. @@ -204,8 +204,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The release type to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleaseGroups(IArtist artist, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null) => AsyncUtils.ResultOf(this.BrowseReleaseGroupsAsync(artist, limit, offset, inc, type)); @@ -217,8 +217,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The release type to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleaseGroups(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null) => AsyncUtils.ResultOf(this.BrowseReleaseGroupsAsync(collection, limit, offset, inc, type)); @@ -230,8 +230,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The release type to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. /// /// Currently a release can only be part of a single release group, so this should always return exactly one result. /// @@ -247,8 +247,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleaseGroupsAsync(IArtist artist, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, CancellationToken cancellationToken = default) { @@ -264,8 +264,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleaseGroupsAsync(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, CancellationToken cancellationToken = default) { @@ -281,8 +281,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. /// /// Currently a release can only be part of a single release group, so this should always return exactly one result. /// diff --git a/MetaBrainz.MusicBrainz/Query.Browse.Releases.cs b/MetaBrainz.MusicBrainz/Query.Browse.Releases.cs index 7b0f098..2cd146c 100644 --- a/MetaBrainz.MusicBrainz/Query.Browse.Releases.cs +++ b/MetaBrainz.MusicBrainz/Query.Browse.Releases.cs @@ -1,5 +1,5 @@ using System; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -26,8 +26,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllAreaReleases(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -46,8 +46,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllArtistReleases(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -66,8 +66,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollectionReleases(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -86,8 +86,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllLabelReleases(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -106,8 +106,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllRecordingReleases(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -126,8 +126,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleaseGroupReleases(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -146,8 +146,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleases(IArea area, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -166,8 +166,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleases(IArtist artist, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -186,8 +186,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleases(ICollection collection, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -207,8 +207,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleases(ILabel label, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -227,8 +227,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleases(IRecording recording, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -247,8 +247,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleases(IReleaseGroup releaseGroup, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -268,8 +268,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllReleases(ITrack track, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -290,8 +290,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllTrackArtistReleases(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -312,8 +312,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllTrackArtistReleases(IArtist artist, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -332,8 +332,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllTrackReleases(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -347,8 +347,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseAreaReleases(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => AsyncUtils.ResultOf(this.BrowseAreaReleasesAsync(mbid, limit, offset, inc, type, status)); @@ -362,8 +362,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseAreaReleasesAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -378,8 +378,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseArtistReleases(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => AsyncUtils.ResultOf(this.BrowseArtistReleasesAsync(mbid, limit, offset, inc, type, status)); @@ -393,8 +393,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseArtistReleasesAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -411,8 +411,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollectionReleases(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -427,8 +427,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionReleasesAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -445,8 +445,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseLabelReleases(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => AsyncUtils.ResultOf(this.BrowseLabelReleasesAsync(mbid, limit, offset, inc, type, status)); @@ -460,8 +460,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseLabelReleasesAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -476,8 +476,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseRecordingReleases(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -492,8 +492,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseRecordingReleasesAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -510,8 +510,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleaseGroupReleases(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -526,8 +526,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleaseGroupReleasesAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -544,8 +544,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleases(IArea area, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => AsyncUtils.ResultOf(this.BrowseReleasesAsync(area, limit, offset, inc, type, status)); @@ -558,8 +558,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleases(IArtist artist, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => AsyncUtils.ResultOf(this.BrowseReleasesAsync(artist, limit, offset, inc, type, status)); @@ -572,8 +572,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleases(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => AsyncUtils.ResultOf(this.BrowseReleasesAsync(collection, limit, offset, inc, type, status)); @@ -586,8 +586,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleases(ILabel label, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => AsyncUtils.ResultOf(this.BrowseReleasesAsync(label, limit, offset, inc, type, status)); @@ -600,8 +600,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleases(IRecording recording, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => AsyncUtils.ResultOf(this.BrowseReleasesAsync(recording, limit, offset, inc, type, status)); @@ -614,8 +614,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleases(IReleaseGroup releaseGroup, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => new BrowseReleases(this, Query.BuildExtraText(inc, "release-group", releaseGroup.Id, type, status), limit, offset) @@ -629,8 +629,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseReleases(ITrack track, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => AsyncUtils.ResultOf(this.BrowseReleasesAsync(track, limit, offset, inc, type, status)); @@ -644,8 +644,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleasesAsync(IArea area, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -663,8 +663,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleasesAsync(IArtist artist, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -682,8 +682,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleasesAsync(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -701,8 +701,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleasesAsync(ILabel label, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -720,8 +720,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleasesAsync(IRecording recording, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -739,8 +739,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleasesAsync(IReleaseGroup releaseGroup, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -758,8 +758,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseReleasesAsync(ITrack track, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -778,8 +778,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseTrackArtistReleases(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -795,8 +795,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseTrackArtistReleases(IArtist artist, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) @@ -813,8 +813,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseTrackArtistReleasesAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -834,8 +834,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseTrackArtistReleasesAsync(IArtist artist, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, @@ -852,8 +852,8 @@ public sealed partial class Query { /// The release type to filter on (if any). /// The release status to filter on (if any). /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseTrackReleases(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => AsyncUtils.ResultOf(this.BrowseTrackReleasesAsync(mbid, limit, offset, inc, type, status)); @@ -867,8 +867,8 @@ public sealed partial class Query { /// The release status to filter on (if any). /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseTrackReleasesAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, diff --git a/MetaBrainz.MusicBrainz/Query.Browse.Series.cs b/MetaBrainz.MusicBrainz/Query.Browse.Series.cs index c6e54df..36844f2 100644 --- a/MetaBrainz.MusicBrainz/Query.Browse.Series.cs +++ b/MetaBrainz.MusicBrainz/Query.Browse.Series.cs @@ -1,5 +1,5 @@ using System; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -24,8 +24,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollectionSeries(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseSeries(this, Query.BuildExtraText(inc, "collection", mbid), pageSize, offset).AsStream(); @@ -41,8 +41,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllSeries(ICollection collection, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseSeries(this, Query.BuildExtraText(inc, "collection", collection.Id), pageSize, offset).AsStream(); @@ -53,8 +53,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollectionSeries(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseCollectionSeriesAsync(mbid, limit, offset, inc)); @@ -66,8 +66,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionSeriesAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -79,8 +79,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseSeries(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseSeriesAsync(collection, limit, offset, inc)); @@ -92,8 +92,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseSeriesAsync(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseSeries(this, Query.BuildExtraText(inc, "collection", collection.Id), limit, offset).NextAsync(cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Browse.Works.cs b/MetaBrainz.MusicBrainz/Query.Browse.Works.cs index f10ed7f..0c56c2e 100644 --- a/MetaBrainz.MusicBrainz/Query.Browse.Works.cs +++ b/MetaBrainz.MusicBrainz/Query.Browse.Works.cs @@ -1,5 +1,5 @@ using System; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -24,8 +24,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllArtistWorks(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseWorks(this, Query.BuildExtraText(inc, "artist", mbid), pageSize, offset).AsStream(); @@ -41,8 +41,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllCollectionWorks(Guid mbid, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseWorks(this, Query.BuildExtraText(inc, "collection", mbid), pageSize, offset).AsStream(); @@ -58,8 +58,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllWorks(IArtist artist, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseWorks(this, Query.BuildExtraText(inc, "artist", artist.Id), pageSize, offset).AsStream(); @@ -75,8 +75,8 @@ public sealed partial class Query { /// once: once at the end of a page, then again in the next page, if a new entry was inserted earlier in the sequence. Similarly, /// a result may be skipped if an item that was already returned is deleted (but deletions are far less likely). /// - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IStreamingQueryResults BrowseAllWorks(ICollection collection, int? pageSize = null, int? offset = null, Include inc = Include.None) => new BrowseWorks(this, Query.BuildExtraText(inc, "collection", collection.Id), pageSize, offset).AsStream(); @@ -87,8 +87,8 @@ public sealed partial class Query { /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseArtistWorks(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseArtistWorksAsync(mbid, limit, offset, inc)); @@ -99,8 +99,8 @@ public IBrowseResults BrowseArtistWorks(Guid mbid, int? limit = null, int /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseArtistWorksAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -112,8 +112,8 @@ public IBrowseResults BrowseArtistWorks(Guid mbid, int? limit = null, int /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseCollectionWorks(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseCollectionWorksAsync(mbid, limit, offset, inc)); @@ -124,8 +124,8 @@ public IBrowseResults BrowseCollectionWorks(Guid mbid, int? limit = null, /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseCollectionWorksAsync(Guid mbid, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) @@ -137,8 +137,8 @@ public IBrowseResults BrowseCollectionWorks(Guid mbid, int? limit = null, /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseWorks(IArtist artist, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseWorksAsync(artist, limit, offset, inc)); @@ -148,8 +148,8 @@ public IBrowseResults BrowseWorks(IArtist artist, int? limit = null, int? /// The offset at which to start (i.e. the number of results to skip). /// Additional information to include in the result. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IBrowseResults BrowseWorks(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None) => AsyncUtils.ResultOf(this.BrowseWorksAsync(collection, limit, offset, inc)); @@ -161,8 +161,8 @@ public IBrowseResults BrowseWorks(IArtist artist, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseWorksAsync(IArtist artist, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseWorks(this, Query.BuildExtraText(inc, "artist", artist.Id), limit, offset).NextAsync(cancellationToken); @@ -174,8 +174,8 @@ public IBrowseResults BrowseWorks(IArtist artist, int? limit = null, int? /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The browse request, including the initial results. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task> BrowseWorksAsync(ICollection collection, int? limit = null, int? offset = null, Include inc = Include.None, CancellationToken cancellationToken = default) => new BrowseWorks(this, Query.BuildExtraText(inc, "collection", collection.Id), limit, offset).NextAsync(cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Collections.Areas.cs b/MetaBrainz.MusicBrainz/Query.Collections.Areas.cs index 42268c7..9bbe1b2 100644 --- a/MetaBrainz.MusicBrainz/Query.Collections.Areas.cs +++ b/MetaBrainz.MusicBrainz/Query.Collections.Areas.cs @@ -1,6 +1,6 @@ using System; using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -23,8 +23,8 @@ public sealed partial class Query { /// The area to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IArea area) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, area)); @@ -38,8 +38,8 @@ public string AddToCollection(string client, Guid collection, IArea area) /// The areas to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, params IArea[] areas) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, areas)); @@ -53,8 +53,8 @@ public string AddToCollection(string client, Guid collection, params IArea[] are /// The areas to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IEnumerable areas) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, areas)); @@ -68,8 +68,8 @@ public string AddToCollection(string client, Guid collection, IEnumerable /// The area to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IArea area) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, area)); @@ -83,8 +83,8 @@ public string AddToCollection(string client, ICollection collection, IArea area) /// The areas to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, params IArea[] areas) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, areas)); @@ -98,8 +98,8 @@ public string AddToCollection(string client, ICollection collection, params IAre /// The areas to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEnumerable areas) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, areas)); @@ -114,8 +114,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The areas to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IArea[] areas) => this.AddToCollectionAsync(client, collection, EntityType.Area, areas, cancellationToken); @@ -131,8 +131,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IArea area, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Area, area, cancellationToken); @@ -147,8 +147,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The areas to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, params IArea[] areas) => this.AddToCollectionAsync(client, collection, EntityType.Area, areas); @@ -163,8 +163,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IEnumerable areas, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Area, areas, cancellationToken); @@ -180,8 +180,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The areas to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IArea[] areas) => this.AddToCollectionAsync(client, collection, EntityType.Area, areas, cancellationToken); @@ -197,8 +197,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IArea area, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Area, area, cancellationToken); @@ -213,8 +213,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The areas to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, params IArea[] areas) => this.AddToCollectionAsync(client, collection, EntityType.Area, areas); @@ -229,8 +229,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEnumerable areas, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Area, areas, cancellationToken); @@ -249,8 +249,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The area to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IArea area) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, area)); @@ -264,8 +264,8 @@ public string RemoveFromCollection(string client, Guid collection, IArea area) /// The areas to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, params IArea[] areas) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, areas)); @@ -279,8 +279,8 @@ public string RemoveFromCollection(string client, Guid collection, params IArea[ /// The areas to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IEnumerable areas) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, areas)); @@ -294,8 +294,8 @@ public string RemoveFromCollection(string client, Guid collection, IEnumerableThe area to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IArea area) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, area)); @@ -309,8 +309,8 @@ public string RemoveFromCollection(string client, ICollection collection, IArea /// The areas to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, params IArea[] areas) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, areas)); @@ -324,8 +324,8 @@ public string RemoveFromCollection(string client, ICollection collection, params /// The areas to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEnumerable areas) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, areas)); @@ -340,8 +340,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The areas to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IArea[] areas) => this.RemoveFromCollectionAsync(client, collection, EntityType.Area, areas, cancellationToken); @@ -357,8 +357,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IArea area, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Area, area, cancellationToken); @@ -373,8 +373,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The areas to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, params IArea[] areas) => this.RemoveFromCollectionAsync(client, collection, EntityType.Area, areas); @@ -389,8 +389,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IEnumerable areas, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Area, areas, cancellationToken); @@ -406,8 +406,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The areas to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IArea[] areas) => this.RemoveFromCollectionAsync(client, collection, EntityType.Area, areas, cancellationToken); @@ -423,8 +423,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IArea area, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Area, area, cancellationToken); @@ -439,8 +439,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The areas to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, params IArea[] areas) => this.RemoveFromCollectionAsync(client, collection, EntityType.Area, areas); @@ -455,8 +455,8 @@ public Task RemoveFromCollectionAsync(string client, ICollection collect /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEnumerable areas, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Area, areas, cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Collections.Artists.cs b/MetaBrainz.MusicBrainz/Query.Collections.Artists.cs index 65ae018..fc17d6b 100644 --- a/MetaBrainz.MusicBrainz/Query.Collections.Artists.cs +++ b/MetaBrainz.MusicBrainz/Query.Collections.Artists.cs @@ -1,6 +1,6 @@ using System; using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -23,8 +23,8 @@ public sealed partial class Query { /// The artist to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IArtist artist) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, artist)); @@ -38,8 +38,8 @@ public string AddToCollection(string client, Guid collection, IArtist artist) /// The artists to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, params IArtist[] artists) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, artists)); @@ -53,8 +53,8 @@ public string AddToCollection(string client, Guid collection, params IArtist[] a /// The artists to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IEnumerable artists) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, artists)); @@ -68,8 +68,8 @@ public string AddToCollection(string client, Guid collection, IEnumerableThe artist to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IArtist artist) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, artist)); @@ -83,8 +83,8 @@ public string AddToCollection(string client, ICollection collection, IArtist art /// The artists to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, params IArtist[] artists) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, artists)); @@ -98,8 +98,8 @@ public string AddToCollection(string client, ICollection collection, params IArt /// The artists to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEnumerable artists) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, artists)); @@ -114,8 +114,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The artists to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IArtist[] artists) => this.AddToCollectionAsync(client, collection, EntityType.Artist, artists, cancellationToken); @@ -131,8 +131,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IArtist artist, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Artist, artist, cancellationToken); @@ -147,8 +147,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The artists to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, params IArtist[] artists) => this.AddToCollectionAsync(client, collection, EntityType.Artist, artists); @@ -163,8 +163,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IEnumerable artists, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Artist, artists, cancellationToken); @@ -180,8 +180,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The artists to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IArtist[] artists) => this.AddToCollectionAsync(client, collection, EntityType.Artist, artists, cancellationToken); @@ -197,8 +197,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IArtist artist, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Artist, artist, cancellationToken); @@ -213,8 +213,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The artists to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, params IArtist[] artists) => this.AddToCollectionAsync(client, collection, EntityType.Artist, artists); @@ -229,8 +229,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEnumerable artists, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Artist, artists, cancellationToken); @@ -249,8 +249,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The artist to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IArtist artist) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, artist)); @@ -264,8 +264,8 @@ public string RemoveFromCollection(string client, Guid collection, IArtist artis /// The artists to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, params IArtist[] artists) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, artists)); @@ -279,8 +279,8 @@ public string RemoveFromCollection(string client, Guid collection, params IArtis /// The artists to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IEnumerable artists) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, artists)); @@ -294,8 +294,8 @@ public string RemoveFromCollection(string client, Guid collection, IEnumerableThe artist to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IArtist artist) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, artist)); @@ -309,8 +309,8 @@ public string RemoveFromCollection(string client, ICollection collection, IArtis /// The artists to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, params IArtist[] artists) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, artists)); @@ -324,8 +324,8 @@ public string RemoveFromCollection(string client, ICollection collection, params /// The artists to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEnumerable artists) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, artists)); @@ -340,8 +340,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The artists to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IArtist[] artists) => this.RemoveFromCollectionAsync(client, collection, EntityType.Artist, artists, cancellationToken); @@ -357,8 +357,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IArtist artist, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Artist, artist, cancellationToken); @@ -373,8 +373,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The artists to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, params IArtist[] artists) => this.RemoveFromCollectionAsync(client, collection, EntityType.Artist, artists); @@ -389,8 +389,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IEnumerable artists, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Artist, artists, cancellationToken); @@ -406,8 +406,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The artists to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IArtist[] artists) => this.RemoveFromCollectionAsync(client, collection, EntityType.Artist, artists, cancellationToken); @@ -423,8 +423,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IArtist artist, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Artist, artist, cancellationToken); @@ -439,8 +439,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The artists to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, params IArtist[] artists) => this.RemoveFromCollectionAsync(client, collection, EntityType.Artist, artists); @@ -455,8 +455,8 @@ public Task RemoveFromCollectionAsync(string client, ICollection collect /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEnumerable artists, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Artist, artists, cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Collections.Events.cs b/MetaBrainz.MusicBrainz/Query.Collections.Events.cs index c7889a3..2bedd8b 100644 --- a/MetaBrainz.MusicBrainz/Query.Collections.Events.cs +++ b/MetaBrainz.MusicBrainz/Query.Collections.Events.cs @@ -1,6 +1,6 @@ using System; using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -23,8 +23,8 @@ public sealed partial class Query { /// The event to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IEvent @event) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, @event)); @@ -38,8 +38,8 @@ public string AddToCollection(string client, Guid collection, IEvent @event) /// The events to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, params IEvent[] events) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, events)); @@ -53,8 +53,8 @@ public string AddToCollection(string client, Guid collection, params IEvent[] ev /// The events to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IEnumerable events) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, events)); @@ -68,8 +68,8 @@ public string AddToCollection(string client, Guid collection, IEnumerableThe event to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEvent @event) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, @event)); @@ -83,8 +83,8 @@ public string AddToCollection(string client, ICollection collection, IEvent @eve /// The events to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, params IEvent[] events) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, events)); @@ -98,8 +98,8 @@ public string AddToCollection(string client, ICollection collection, params IEve /// The events to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEnumerable events) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, events)); @@ -114,8 +114,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The events to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IEvent[] events) => this.AddToCollectionAsync(client, collection, EntityType.Event, events, cancellationToken); @@ -131,8 +131,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IEvent @event, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Event, @event, cancellationToken); @@ -147,8 +147,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The events to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, params IEvent[] events) => this.AddToCollectionAsync(client, collection, EntityType.Event, events); @@ -163,8 +163,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IEnumerable events, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Event, events, cancellationToken); @@ -180,8 +180,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The events to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IEvent[] events) => this.AddToCollectionAsync(client, collection, EntityType.Event, events, cancellationToken); @@ -197,8 +197,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEvent @event, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Event, @event, cancellationToken); @@ -213,8 +213,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The events to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, params IEvent[] events) => this.AddToCollectionAsync(client, collection, EntityType.Event, events); @@ -229,8 +229,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEnumerable events, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Event, events, cancellationToken); @@ -249,8 +249,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The event to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IEvent @event) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, @event)); @@ -264,8 +264,8 @@ public string RemoveFromCollection(string client, Guid collection, IEvent @event /// The events to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, params IEvent[] events) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, events)); @@ -279,8 +279,8 @@ public string RemoveFromCollection(string client, Guid collection, params IEvent /// The events to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IEnumerable events) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, events)); @@ -294,8 +294,8 @@ public string RemoveFromCollection(string client, Guid collection, IEnumerableThe event to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEvent @event) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, @event)); @@ -309,8 +309,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEvent /// The events to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, params IEvent[] events) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, events)); @@ -324,8 +324,8 @@ public string RemoveFromCollection(string client, ICollection collection, params /// The events to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEnumerable events) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, events)); @@ -340,8 +340,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The events to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IEvent[] events) => this.RemoveFromCollectionAsync(client, collection, EntityType.Event, events, cancellationToken); @@ -357,8 +357,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IEvent @event, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Event, @event, cancellationToken); @@ -373,8 +373,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The events to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, params IEvent[] events) => this.RemoveFromCollectionAsync(client, collection, EntityType.Event, events); @@ -389,8 +389,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IEnumerable events, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Event, events, cancellationToken); @@ -406,8 +406,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The events to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IEvent[] events) => this.RemoveFromCollectionAsync(client, collection, EntityType.Event, events, cancellationToken); @@ -423,8 +423,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEvent @event, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Event, @event, cancellationToken); @@ -439,8 +439,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The events to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, params IEvent[] events) => this.RemoveFromCollectionAsync(client, collection, EntityType.Event, events); @@ -455,8 +455,8 @@ public Task RemoveFromCollectionAsync(string client, ICollection collect /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEnumerable events, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Event, events, cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Collections.Instruments.cs b/MetaBrainz.MusicBrainz/Query.Collections.Instruments.cs index 833e185..d2d4733 100644 --- a/MetaBrainz.MusicBrainz/Query.Collections.Instruments.cs +++ b/MetaBrainz.MusicBrainz/Query.Collections.Instruments.cs @@ -1,6 +1,6 @@ using System; using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -23,8 +23,8 @@ public sealed partial class Query { /// The instrument to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IInstrument instrument) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, instrument)); @@ -38,8 +38,8 @@ public string AddToCollection(string client, Guid collection, IInstrument instru /// The instruments to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, params IInstrument[] instruments) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, instruments)); @@ -53,8 +53,8 @@ public string AddToCollection(string client, Guid collection, params IInstrument /// The instruments to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IEnumerable instruments) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, instruments)); @@ -68,8 +68,8 @@ public string AddToCollection(string client, Guid collection, IEnumerableThe instrument to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IInstrument instrument) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, instrument)); @@ -83,8 +83,8 @@ public string AddToCollection(string client, ICollection collection, IInstrument /// The instruments to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, params IInstrument[] instruments) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, instruments)); @@ -98,8 +98,8 @@ public string AddToCollection(string client, ICollection collection, params IIns /// The instruments to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEnumerable instruments) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, instruments)); @@ -114,8 +114,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The instruments to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IInstrument[] instruments) => this.AddToCollectionAsync(client, collection, EntityType.Instrument, instruments, cancellationToken); @@ -131,8 +131,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IInstrument instrument, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Instrument, instrument, cancellationToken); @@ -147,8 +147,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The instruments to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, params IInstrument[] instruments) => this.AddToCollectionAsync(client, collection, EntityType.Instrument, instruments); @@ -163,8 +163,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IEnumerable instruments, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Instrument, instruments, cancellationToken); @@ -180,8 +180,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The instruments to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IInstrument[] instruments) => this.AddToCollectionAsync(client, collection, EntityType.Instrument, instruments, cancellationToken); @@ -197,8 +197,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IInstrument instrument, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Instrument, instrument, cancellationToken); @@ -213,8 +213,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The instruments to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, params IInstrument[] instruments) => this.AddToCollectionAsync(client, collection, EntityType.Instrument, instruments); @@ -229,8 +229,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEnumerable instruments, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Instrument, instruments, cancellationToken); @@ -249,8 +249,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The instrument to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IInstrument instrument) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, instrument)); @@ -264,8 +264,8 @@ public string RemoveFromCollection(string client, Guid collection, IInstrument i /// The instruments to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, params IInstrument[] instruments) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, instruments)); @@ -279,8 +279,8 @@ public string RemoveFromCollection(string client, Guid collection, params IInstr /// The instruments to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IEnumerable instruments) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, instruments)); @@ -294,8 +294,8 @@ public string RemoveFromCollection(string client, Guid collection, IEnumerableThe instrument to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IInstrument instrument) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, instrument)); @@ -309,8 +309,8 @@ public string RemoveFromCollection(string client, ICollection collection, IInstr /// The instruments to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, params IInstrument[] instruments) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, instruments)); @@ -324,8 +324,8 @@ public string RemoveFromCollection(string client, ICollection collection, params /// The instruments to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEnumerable instruments) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, instruments)); @@ -340,8 +340,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The instruments to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IInstrument[] instruments) => this.RemoveFromCollectionAsync(client, collection, EntityType.Instrument, instruments, cancellationToken); @@ -357,8 +357,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IInstrument instrument, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Instrument, instrument, cancellationToken); @@ -373,8 +373,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The instruments to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, params IInstrument[] instruments) => this.RemoveFromCollectionAsync(client, collection, EntityType.Instrument, instruments); @@ -389,8 +389,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IEnumerable instruments, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Instrument, instruments, cancellationToken); @@ -406,8 +406,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The instruments to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IInstrument[] instruments) => this.RemoveFromCollectionAsync(client, collection, EntityType.Instrument, instruments, cancellationToken); @@ -423,8 +423,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IInstrument instrument, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Instrument, instrument, cancellationToken); @@ -439,8 +439,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The instruments to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, params IInstrument[] instruments) => this.RemoveFromCollectionAsync(client, collection, EntityType.Instrument, instruments); @@ -455,8 +455,8 @@ public Task RemoveFromCollectionAsync(string client, ICollection collect /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEnumerable instruments, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Instrument, instruments, cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Collections.Labels.cs b/MetaBrainz.MusicBrainz/Query.Collections.Labels.cs index 7a1287d..4a59ba1 100644 --- a/MetaBrainz.MusicBrainz/Query.Collections.Labels.cs +++ b/MetaBrainz.MusicBrainz/Query.Collections.Labels.cs @@ -1,6 +1,6 @@ using System; using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -23,8 +23,8 @@ public sealed partial class Query { /// The label to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, ILabel label) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, label)); @@ -38,8 +38,8 @@ public string AddToCollection(string client, Guid collection, ILabel label) /// The labels to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, params ILabel[] labels) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, labels)); @@ -53,8 +53,8 @@ public string AddToCollection(string client, Guid collection, params ILabel[] la /// The labels to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IEnumerable labels) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, labels)); @@ -68,8 +68,8 @@ public string AddToCollection(string client, Guid collection, IEnumerableThe label to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, ILabel label) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, label)); @@ -83,8 +83,8 @@ public string AddToCollection(string client, ICollection collection, ILabel labe /// The labels to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, params ILabel[] labels) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, labels)); @@ -98,8 +98,8 @@ public string AddToCollection(string client, ICollection collection, params ILab /// The labels to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEnumerable labels) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, labels)); @@ -114,8 +114,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The labels to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params ILabel[] labels) => this.AddToCollectionAsync(client, collection, EntityType.Label, labels, cancellationToken); @@ -131,8 +131,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, ILabel label, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Label, label, cancellationToken); @@ -147,8 +147,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The labels to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, params ILabel[] labels) => this.AddToCollectionAsync(client, collection, EntityType.Label, labels); @@ -163,8 +163,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IEnumerable labels, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Label, labels, cancellationToken); @@ -180,8 +180,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The labels to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params ILabel[] labels) => this.AddToCollectionAsync(client, collection, EntityType.Label, labels, cancellationToken); @@ -197,8 +197,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, ILabel label, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Label, label, cancellationToken); @@ -213,8 +213,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The labels to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, params ILabel[] labels) => this.AddToCollectionAsync(client, collection, EntityType.Label, labels); @@ -229,8 +229,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEnumerable labels, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Label, labels, cancellationToken); @@ -249,8 +249,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The label to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, ILabel label) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, label)); @@ -264,8 +264,8 @@ public string RemoveFromCollection(string client, Guid collection, ILabel label) /// The labels to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, params ILabel[] labels) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, labels)); @@ -279,8 +279,8 @@ public string RemoveFromCollection(string client, Guid collection, params ILabel /// The labels to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IEnumerable labels) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, labels)); @@ -294,8 +294,8 @@ public string RemoveFromCollection(string client, Guid collection, IEnumerableThe label to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, ILabel label) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, label)); @@ -309,8 +309,8 @@ public string RemoveFromCollection(string client, ICollection collection, ILabel /// The labels to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, params ILabel[] labels) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, labels)); @@ -324,8 +324,8 @@ public string RemoveFromCollection(string client, ICollection collection, params /// The labels to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEnumerable labels) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, labels)); @@ -340,8 +340,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The labels to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params ILabel[] labels) => this.RemoveFromCollectionAsync(client, collection, EntityType.Label, labels, cancellationToken); @@ -357,8 +357,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, ILabel label, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Label, label, cancellationToken); @@ -373,8 +373,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The labels to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, params ILabel[] labels) => this.RemoveFromCollectionAsync(client, collection, EntityType.Label, labels); @@ -389,8 +389,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IEnumerable labels, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Label, labels, cancellationToken); @@ -406,8 +406,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The labels to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params ILabel[] labels) => this.RemoveFromCollectionAsync(client, collection, EntityType.Label, labels, cancellationToken); @@ -423,8 +423,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, ILabel label, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Label, label, cancellationToken); @@ -439,8 +439,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The labels to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, params ILabel[] labels) => this.RemoveFromCollectionAsync(client, collection, EntityType.Label, labels); @@ -455,8 +455,8 @@ public Task RemoveFromCollectionAsync(string client, ICollection collect /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEnumerable labels, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Label, labels, cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Collections.Places.cs b/MetaBrainz.MusicBrainz/Query.Collections.Places.cs index 57d0786..a11d0f7 100644 --- a/MetaBrainz.MusicBrainz/Query.Collections.Places.cs +++ b/MetaBrainz.MusicBrainz/Query.Collections.Places.cs @@ -1,6 +1,6 @@ using System; using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -23,8 +23,8 @@ public sealed partial class Query { /// The place to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IPlace place) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, place)); @@ -38,8 +38,8 @@ public string AddToCollection(string client, Guid collection, IPlace place) /// The places to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, params IPlace[] places) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, places)); @@ -53,8 +53,8 @@ public string AddToCollection(string client, Guid collection, params IPlace[] pl /// The places to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IEnumerable places) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, places)); @@ -68,8 +68,8 @@ public string AddToCollection(string client, Guid collection, IEnumerableThe place to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IPlace place) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, place)); @@ -83,8 +83,8 @@ public string AddToCollection(string client, ICollection collection, IPlace plac /// The places to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, params IPlace[] places) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, places)); @@ -98,8 +98,8 @@ public string AddToCollection(string client, ICollection collection, params IPla /// The places to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEnumerable places) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, places)); @@ -114,8 +114,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The places to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IPlace[] places) => this.AddToCollectionAsync(client, collection, EntityType.Place, places, cancellationToken); @@ -131,8 +131,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IPlace place, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Place, place, cancellationToken); @@ -147,8 +147,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The places to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, params IPlace[] places) => this.AddToCollectionAsync(client, collection, EntityType.Place, places); @@ -163,8 +163,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IEnumerable places, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Place, places, cancellationToken); @@ -180,8 +180,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The places to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IPlace[] places) => this.AddToCollectionAsync(client, collection, EntityType.Place, places, cancellationToken); @@ -197,8 +197,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IPlace place, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Place, place, cancellationToken); @@ -213,8 +213,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The places to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, params IPlace[] places) => this.AddToCollectionAsync(client, collection, EntityType.Place, places); @@ -229,8 +229,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEnumerable places, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Place, places, cancellationToken); @@ -249,8 +249,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The place to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IPlace place) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, place)); @@ -264,8 +264,8 @@ public string RemoveFromCollection(string client, Guid collection, IPlace place) /// The places to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, params IPlace[] places) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, places)); @@ -279,8 +279,8 @@ public string RemoveFromCollection(string client, Guid collection, params IPlace /// The places to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IEnumerable places) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, places)); @@ -294,8 +294,8 @@ public string RemoveFromCollection(string client, Guid collection, IEnumerableThe place to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IPlace place) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, place)); @@ -309,8 +309,8 @@ public string RemoveFromCollection(string client, ICollection collection, IPlace /// The places to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, params IPlace[] places) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, places)); @@ -324,8 +324,8 @@ public string RemoveFromCollection(string client, ICollection collection, params /// The places to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEnumerable places) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, places)); @@ -340,8 +340,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The places to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IPlace[] places) => this.RemoveFromCollectionAsync(client, collection, EntityType.Place, places, cancellationToken); @@ -357,8 +357,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IPlace place, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Place, place, cancellationToken); @@ -373,8 +373,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The places to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, params IPlace[] places) => this.RemoveFromCollectionAsync(client, collection, EntityType.Place, places); @@ -389,8 +389,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IEnumerable places, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Place, places, cancellationToken); @@ -406,8 +406,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The places to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IPlace[] places) => this.RemoveFromCollectionAsync(client, collection, EntityType.Place, places, cancellationToken); @@ -423,8 +423,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IPlace place, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Place, place, cancellationToken); @@ -439,8 +439,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The places to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, params IPlace[] places) => this.RemoveFromCollectionAsync(client, collection, EntityType.Place, places); @@ -455,8 +455,8 @@ public Task RemoveFromCollectionAsync(string client, ICollection collect /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEnumerable places, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Place, places, cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Collections.Recordings.cs b/MetaBrainz.MusicBrainz/Query.Collections.Recordings.cs index 6f73def..5670ae3 100644 --- a/MetaBrainz.MusicBrainz/Query.Collections.Recordings.cs +++ b/MetaBrainz.MusicBrainz/Query.Collections.Recordings.cs @@ -1,6 +1,6 @@ using System; using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -23,8 +23,8 @@ public sealed partial class Query { /// The recording to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IRecording recording) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, recording)); @@ -38,8 +38,8 @@ public string AddToCollection(string client, Guid collection, IRecording recordi /// The recordings to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, params IRecording[] recordings) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, recordings)); @@ -53,8 +53,8 @@ public string AddToCollection(string client, Guid collection, params IRecording[ /// The recordings to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IEnumerable recordings) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, recordings)); @@ -68,8 +68,8 @@ public string AddToCollection(string client, Guid collection, IEnumerableThe recording to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IRecording recording) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, recording)); @@ -83,8 +83,8 @@ public string AddToCollection(string client, ICollection collection, IRecording /// The recordings to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, params IRecording[] recordings) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, recordings)); @@ -98,8 +98,8 @@ public string AddToCollection(string client, ICollection collection, params IRec /// The recordings to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEnumerable recordings) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, recordings)); @@ -114,8 +114,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The recordings to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IRecording[] recordings) => this.AddToCollectionAsync(client, collection, EntityType.Recording, recordings, cancellationToken); @@ -131,8 +131,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IRecording recording, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Recording, recording, cancellationToken); @@ -147,8 +147,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The recordings to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, params IRecording[] recordings) => this.AddToCollectionAsync(client, collection, EntityType.Recording, recordings); @@ -163,8 +163,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IEnumerable recordings, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Recording, recordings, cancellationToken); @@ -180,8 +180,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The recordings to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IRecording[] recordings) => this.AddToCollectionAsync(client, collection, EntityType.Recording, recordings, cancellationToken); @@ -197,8 +197,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IRecording recording, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Recording, recording, cancellationToken); @@ -213,8 +213,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The recordings to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, params IRecording[] recordings) => this.AddToCollectionAsync(client, collection, EntityType.Recording, recordings); @@ -229,8 +229,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEnumerable recordings, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Recording, recordings, cancellationToken); @@ -249,8 +249,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The recording to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IRecording recording) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, recording)); @@ -264,8 +264,8 @@ public string RemoveFromCollection(string client, Guid collection, IRecording re /// The recordings to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, params IRecording[] recordings) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, recordings)); @@ -279,8 +279,8 @@ public string RemoveFromCollection(string client, Guid collection, params IRecor /// The recordings to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IEnumerable recordings) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, recordings)); @@ -294,8 +294,8 @@ public string RemoveFromCollection(string client, Guid collection, IEnumerableThe recording to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IRecording recording) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, recording)); @@ -309,8 +309,8 @@ public string RemoveFromCollection(string client, ICollection collection, IRecor /// The recordings to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, params IRecording[] recordings) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, recordings)); @@ -324,8 +324,8 @@ public string RemoveFromCollection(string client, ICollection collection, params /// The recordings to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEnumerable recordings) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, recordings)); @@ -340,8 +340,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The recordings to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IRecording[] recordings) => this.RemoveFromCollectionAsync(client, collection, EntityType.Recording, recordings, cancellationToken); @@ -357,8 +357,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IRecording recording, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Recording, recording, cancellationToken); @@ -373,8 +373,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The recordings to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, params IRecording[] recordings) => this.RemoveFromCollectionAsync(client, collection, EntityType.Recording, recordings); @@ -389,8 +389,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IEnumerable recordings, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Recording, recordings, cancellationToken); @@ -406,8 +406,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The recordings to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IRecording[] recordings) => this.RemoveFromCollectionAsync(client, collection, EntityType.Recording, recordings, cancellationToken); @@ -423,8 +423,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IRecording recording, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Recording, recording, cancellationToken); @@ -439,8 +439,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The recordings to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, params IRecording[] recordings) => this.RemoveFromCollectionAsync(client, collection, EntityType.Recording, recordings); @@ -455,8 +455,8 @@ public Task RemoveFromCollectionAsync(string client, ICollection collect /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEnumerable recordings, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Recording, recordings, cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Collections.ReleaseGroups.cs b/MetaBrainz.MusicBrainz/Query.Collections.ReleaseGroups.cs index f4dfdc7..88fbe48 100644 --- a/MetaBrainz.MusicBrainz/Query.Collections.ReleaseGroups.cs +++ b/MetaBrainz.MusicBrainz/Query.Collections.ReleaseGroups.cs @@ -1,6 +1,6 @@ using System; using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -23,8 +23,8 @@ public sealed partial class Query { /// The release group to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IReleaseGroup releaseGroup) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, releaseGroup)); @@ -38,8 +38,8 @@ public string AddToCollection(string client, Guid collection, IReleaseGroup rele /// The release groups to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, params IReleaseGroup[] releaseGroups) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, releaseGroups)); @@ -53,8 +53,8 @@ public string AddToCollection(string client, Guid collection, params IReleaseGro /// The release groups to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IEnumerable releaseGroups) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, releaseGroups)); @@ -68,8 +68,8 @@ public string AddToCollection(string client, Guid collection, IEnumerableThe release group to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IReleaseGroup releaseGroup) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, releaseGroup)); @@ -83,8 +83,8 @@ public string AddToCollection(string client, ICollection collection, IReleaseGro /// The release groups to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, params IReleaseGroup[] releaseGroups) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, releaseGroups)); @@ -98,8 +98,8 @@ public string AddToCollection(string client, ICollection collection, params IRel /// The release groups to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEnumerable releaseGroups) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, releaseGroups)); @@ -114,8 +114,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The release groups to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IReleaseGroup[] releaseGroups) => this.AddToCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroups, cancellationToken); @@ -131,8 +131,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IReleaseGroup releaseGroup, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroup, cancellationToken); @@ -147,8 +147,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The release groups to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, params IReleaseGroup[] releaseGroups) => this.AddToCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroups); @@ -163,8 +163,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IEnumerable releaseGroups, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroups, cancellationToken); @@ -180,8 +180,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The release groups to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IReleaseGroup[] releaseGroups) => this.AddToCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroups, cancellationToken); @@ -197,8 +197,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IReleaseGroup releaseGroup, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroup, cancellationToken); @@ -213,8 +213,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The release groups to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, params IReleaseGroup[] releaseGroups) => this.AddToCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroups); @@ -229,8 +229,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEnumerable releaseGroups, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroups, cancellationToken); @@ -249,8 +249,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The release group to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IReleaseGroup releaseGroup) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, releaseGroup)); @@ -264,8 +264,8 @@ public string RemoveFromCollection(string client, Guid collection, IReleaseGroup /// The release groups to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, params IReleaseGroup[] releaseGroups) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, releaseGroups)); @@ -279,8 +279,8 @@ public string RemoveFromCollection(string client, Guid collection, params IRelea /// The release groups to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IEnumerable releaseGroups) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, releaseGroups)); @@ -294,8 +294,8 @@ public string RemoveFromCollection(string client, Guid collection, IEnumerableThe release group to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IReleaseGroup releaseGroup) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, releaseGroup)); @@ -309,8 +309,8 @@ public string RemoveFromCollection(string client, ICollection collection, IRelea /// The release groups to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, params IReleaseGroup[] releaseGroups) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, releaseGroups)); @@ -324,8 +324,8 @@ public string RemoveFromCollection(string client, ICollection collection, params /// The release groups to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEnumerable releaseGroups) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, releaseGroups)); @@ -340,8 +340,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The release groups to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IReleaseGroup[] releaseGroups) => this.RemoveFromCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroups, cancellationToken); @@ -357,8 +357,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IReleaseGroup releaseGroup, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroup, cancellationToken); @@ -373,8 +373,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The release groups to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, params IReleaseGroup[] releaseGroups) => this.RemoveFromCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroups); @@ -389,8 +389,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IEnumerable releaseGroups, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroups, cancellationToken); @@ -406,8 +406,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The release groups to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IReleaseGroup[] releaseGroups) => this.RemoveFromCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroups, cancellationToken); @@ -423,8 +423,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IReleaseGroup releaseGroup, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroup, cancellationToken); @@ -439,8 +439,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The release groups to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, params IReleaseGroup[] releaseGroups) => this.RemoveFromCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroups); @@ -455,8 +455,8 @@ public Task RemoveFromCollectionAsync(string client, ICollection collect /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEnumerable releaseGroups, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.ReleaseGroup, releaseGroups, cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Collections.Releases.cs b/MetaBrainz.MusicBrainz/Query.Collections.Releases.cs index a42d9d1..fd3b84e 100644 --- a/MetaBrainz.MusicBrainz/Query.Collections.Releases.cs +++ b/MetaBrainz.MusicBrainz/Query.Collections.Releases.cs @@ -1,6 +1,6 @@ using System; using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -23,8 +23,8 @@ public sealed partial class Query { /// The release to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IRelease release) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, release)); @@ -38,8 +38,8 @@ public string AddToCollection(string client, Guid collection, IRelease release) /// The releases to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, params IRelease[] releases) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, releases)); @@ -53,8 +53,8 @@ public string AddToCollection(string client, Guid collection, params IRelease[] /// The releases to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IEnumerable releases) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, releases)); @@ -68,8 +68,8 @@ public string AddToCollection(string client, Guid collection, IEnumerableThe release to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IRelease release) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, release)); @@ -83,8 +83,8 @@ public string AddToCollection(string client, ICollection collection, IRelease re /// The releases to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, params IRelease[] releases) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, releases)); @@ -98,8 +98,8 @@ public string AddToCollection(string client, ICollection collection, params IRel /// The releases to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEnumerable releases) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, releases)); @@ -114,8 +114,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The releases to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IRelease[] releases) => this.AddToCollectionAsync(client, collection, EntityType.Release, releases, cancellationToken); @@ -131,8 +131,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IRelease release, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Release, release, cancellationToken); @@ -147,8 +147,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The releases to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, params IRelease[] releases) => this.AddToCollectionAsync(client, collection, EntityType.Release, releases); @@ -163,8 +163,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IEnumerable releases, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Release, releases, cancellationToken); @@ -180,8 +180,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The releases to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IRelease[] releases) => this.AddToCollectionAsync(client, collection, EntityType.Release, releases, cancellationToken); @@ -197,8 +197,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IRelease release, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Release, release, cancellationToken); @@ -213,8 +213,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The releases to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, params IRelease[] releases) => this.AddToCollectionAsync(client, collection, EntityType.Release, releases); @@ -229,8 +229,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEnumerable releases, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Release, releases, cancellationToken); @@ -249,8 +249,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The release to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IRelease release) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, release)); @@ -264,8 +264,8 @@ public string RemoveFromCollection(string client, Guid collection, IRelease rele /// The releases to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, params IRelease[] releases) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, releases)); @@ -279,8 +279,8 @@ public string RemoveFromCollection(string client, Guid collection, params IRelea /// The releases to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IEnumerable releases) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, releases)); @@ -294,8 +294,8 @@ public string RemoveFromCollection(string client, Guid collection, IEnumerableThe release to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IRelease release) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, release)); @@ -309,8 +309,8 @@ public string RemoveFromCollection(string client, ICollection collection, IRelea /// The releases to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, params IRelease[] releases) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, releases)); @@ -324,8 +324,8 @@ public string RemoveFromCollection(string client, ICollection collection, params /// The releases to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEnumerable releases) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, releases)); @@ -340,8 +340,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The releases to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IRelease[] releases) => this.RemoveFromCollectionAsync(client, collection, EntityType.Release, releases, cancellationToken); @@ -357,8 +357,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IRelease release, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Release, release, cancellationToken); @@ -373,8 +373,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The releases to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, params IRelease[] releases) => this.RemoveFromCollectionAsync(client, collection, EntityType.Release, releases); @@ -389,8 +389,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IEnumerable releases, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Release, releases, cancellationToken); @@ -406,8 +406,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The releases to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IRelease[] releases) => this.RemoveFromCollectionAsync(client, collection, EntityType.Release, releases, cancellationToken); @@ -423,8 +423,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IRelease release, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Release, release, cancellationToken); @@ -439,8 +439,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The releases to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, params IRelease[] releases) => this.RemoveFromCollectionAsync(client, collection, EntityType.Release, releases); @@ -455,8 +455,8 @@ public Task RemoveFromCollectionAsync(string client, ICollection collect /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEnumerable releases, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Release, releases, cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Collections.Series.cs b/MetaBrainz.MusicBrainz/Query.Collections.Series.cs index 6e9e64b..8161e16 100644 --- a/MetaBrainz.MusicBrainz/Query.Collections.Series.cs +++ b/MetaBrainz.MusicBrainz/Query.Collections.Series.cs @@ -1,6 +1,6 @@ using System; using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -23,8 +23,8 @@ public sealed partial class Query { /// The series to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, ISeries series) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, series)); @@ -38,8 +38,8 @@ public string AddToCollection(string client, Guid collection, ISeries series) /// The series to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, params ISeries[] series) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, series)); @@ -53,8 +53,8 @@ public string AddToCollection(string client, Guid collection, params ISeries[] s /// The series to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IEnumerable series) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, series)); @@ -68,8 +68,8 @@ public string AddToCollection(string client, Guid collection, IEnumerableThe series to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, ISeries series) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, series)); @@ -83,8 +83,8 @@ public string AddToCollection(string client, ICollection collection, ISeries ser /// The series to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, params ISeries[] series) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, series)); @@ -98,8 +98,8 @@ public string AddToCollection(string client, ICollection collection, params ISer /// The series to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEnumerable series) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, series)); @@ -114,8 +114,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The series to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params ISeries[] series) => this.AddToCollectionAsync(client, collection, EntityType.Series, series, cancellationToken); @@ -131,8 +131,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, ISeries series, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Series, series, cancellationToken); @@ -147,8 +147,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The series to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, params ISeries[] series) => this.AddToCollectionAsync(client, collection, EntityType.Series, series); @@ -163,8 +163,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IEnumerable series, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Series, series, cancellationToken); @@ -180,8 +180,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The series to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params ISeries[] series) => this.AddToCollectionAsync(client, collection, EntityType.Series, series, cancellationToken); @@ -197,8 +197,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, ISeries series, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Series, series, cancellationToken); @@ -213,8 +213,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The series to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, params ISeries[] series) => this.AddToCollectionAsync(client, collection, EntityType.Series, series); @@ -229,8 +229,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEnumerable series, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Series, series, cancellationToken); @@ -249,8 +249,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The series to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, ISeries series) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, series)); @@ -264,8 +264,8 @@ public string RemoveFromCollection(string client, Guid collection, ISeries serie /// The series to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, params ISeries[] series) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, series)); @@ -279,8 +279,8 @@ public string RemoveFromCollection(string client, Guid collection, params ISerie /// The series to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IEnumerable series) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, series)); @@ -294,8 +294,8 @@ public string RemoveFromCollection(string client, Guid collection, IEnumerableThe series to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, ISeries series) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, series)); @@ -309,8 +309,8 @@ public string RemoveFromCollection(string client, ICollection collection, ISerie /// The series to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, params ISeries[] series) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, series)); @@ -324,8 +324,8 @@ public string RemoveFromCollection(string client, ICollection collection, params /// The series to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEnumerable series) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, series)); @@ -340,8 +340,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The series to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params ISeries[] series) => this.RemoveFromCollectionAsync(client, collection, EntityType.Series, series, cancellationToken); @@ -357,8 +357,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, ISeries series, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Series, series, cancellationToken); @@ -373,8 +373,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The series to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, params ISeries[] series) => this.RemoveFromCollectionAsync(client, collection, EntityType.Series, series); @@ -389,8 +389,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IEnumerable series, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Series, series, cancellationToken); @@ -406,8 +406,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The series to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params ISeries[] series) => this.RemoveFromCollectionAsync(client, collection, EntityType.Series, series, cancellationToken); @@ -423,8 +423,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, ISeries series, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Series, series, cancellationToken); @@ -439,8 +439,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The series to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, params ISeries[] series) => this.RemoveFromCollectionAsync(client, collection, EntityType.Series, series); @@ -455,8 +455,8 @@ public Task RemoveFromCollectionAsync(string client, ICollection collect /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEnumerable series, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Series, series, cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Collections.Works.cs b/MetaBrainz.MusicBrainz/Query.Collections.Works.cs index a73cdb7..c5cbd69 100644 --- a/MetaBrainz.MusicBrainz/Query.Collections.Works.cs +++ b/MetaBrainz.MusicBrainz/Query.Collections.Works.cs @@ -1,6 +1,6 @@ using System; using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -23,8 +23,8 @@ public sealed partial class Query { /// The work to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IWork work) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, work)); @@ -38,8 +38,8 @@ public string AddToCollection(string client, Guid collection, IWork work) /// The works to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, params IWork[] works) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, works)); @@ -53,8 +53,8 @@ public string AddToCollection(string client, Guid collection, params IWork[] wor /// The works to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, IEnumerable works) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, works)); @@ -68,8 +68,8 @@ public string AddToCollection(string client, Guid collection, IEnumerable /// The work to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IWork work) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, work)); @@ -83,8 +83,8 @@ public string AddToCollection(string client, ICollection collection, IWork work) /// The works to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, params IWork[] works) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, works)); @@ -98,8 +98,8 @@ public string AddToCollection(string client, ICollection collection, params IWor /// The works to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEnumerable works) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, works)); @@ -114,8 +114,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The works to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IWork[] works) => this.AddToCollectionAsync(client, collection, EntityType.Work, works, cancellationToken); @@ -131,8 +131,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IWork work, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Work, work, cancellationToken); @@ -147,8 +147,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The works to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, params IWork[] works) => this.AddToCollectionAsync(client, collection, EntityType.Work, works); @@ -163,8 +163,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, IEnumerable works, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Work, works, cancellationToken); @@ -180,8 +180,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The works to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IWork[] works) => this.AddToCollectionAsync(client, collection, EntityType.Work, works, cancellationToken); @@ -197,8 +197,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IWork work, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Work, work, cancellationToken); @@ -213,8 +213,8 @@ public Task AddToCollectionAsync(string client, Guid collection, params /// The works to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, params IWork[] works) => this.AddToCollectionAsync(client, collection, EntityType.Work, works); @@ -229,8 +229,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEnumerable works, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection, EntityType.Work, works, cancellationToken); @@ -249,8 +249,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The work to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IWork work) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, work)); @@ -264,8 +264,8 @@ public string RemoveFromCollection(string client, Guid collection, IWork work) /// The works to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, params IWork[] works) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, works)); @@ -279,8 +279,8 @@ public string RemoveFromCollection(string client, Guid collection, params IWork[ /// The works to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, IEnumerable works) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, works)); @@ -294,8 +294,8 @@ public string RemoveFromCollection(string client, Guid collection, IEnumerableThe work to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IWork work) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, work)); @@ -309,8 +309,8 @@ public string RemoveFromCollection(string client, ICollection collection, IWork /// The works to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, params IWork[] works) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, works)); @@ -324,8 +324,8 @@ public string RemoveFromCollection(string client, ICollection collection, params /// The works to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEnumerable works) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, works)); @@ -340,8 +340,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The works to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, CancellationToken cancellationToken, params IWork[] works) => this.RemoveFromCollectionAsync(client, collection, EntityType.Work, works, cancellationToken); @@ -357,8 +357,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IWork work, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Work, work, cancellationToken); @@ -373,8 +373,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The works to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, params IWork[] works) => this.RemoveFromCollectionAsync(client, collection, EntityType.Work, works); @@ -389,8 +389,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, IEnumerable works, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Work, works, cancellationToken); @@ -406,8 +406,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The works to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params IWork[] works) => this.RemoveFromCollectionAsync(client, collection, EntityType.Work, works, cancellationToken); @@ -423,8 +423,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IWork work, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Work, work, cancellationToken); @@ -439,8 +439,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, pa /// The works to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, params IWork[] works) => this.RemoveFromCollectionAsync(client, collection, EntityType.Work, works); @@ -455,8 +455,8 @@ public Task RemoveFromCollectionAsync(string client, ICollection collect /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEnumerable works, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection, EntityType.Work, works, cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Collections.cs b/MetaBrainz.MusicBrainz/Query.Collections.cs index b894e8e..9ff890a 100644 --- a/MetaBrainz.MusicBrainz/Query.Collections.cs +++ b/MetaBrainz.MusicBrainz/Query.Collections.cs @@ -1,6 +1,5 @@ using System; using System.Collections.Generic; -using System.Net; using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -26,8 +25,8 @@ public sealed partial class Query { /// The MBID of the item to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, EntityType entityType, Guid item) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, entityType, item)); @@ -42,8 +41,8 @@ public string AddToCollection(string client, Guid collection, EntityType entityT /// The MBIDs of the items to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, EntityType entityType, params Guid[] items) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, entityType, items)); @@ -58,8 +57,8 @@ public string AddToCollection(string client, Guid collection, EntityType entityT /// The MBIDs of the items to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, Guid collection, EntityType entityType, IEnumerable items) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, entityType, items)); @@ -73,8 +72,8 @@ public string AddToCollection(string client, Guid collection, EntityType entityT /// The MBID of the item to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, Guid item) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, item)); @@ -88,8 +87,8 @@ public string AddToCollection(string client, ICollection collection, Guid item) /// The MBIDs of the items to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, params Guid[] items) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, items)); @@ -103,8 +102,8 @@ public string AddToCollection(string client, ICollection collection, params Guid /// The MBIDs of the items to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string AddToCollection(string client, ICollection collection, IEnumerable items) => AsyncUtils.ResultOf(this.AddToCollectionAsync(client, collection, items)); @@ -120,8 +119,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The MBIDs of the items to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, EntityType entityType, CancellationToken cancellationToken, params Guid[] items) => this.AddToCollectionAsync(client, collection, entityType, items, cancellationToken); @@ -138,8 +137,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, EntityType entityType, Guid item, CancellationToken cancellationToken = default) { var submission = new ModifyCollection(HttpMethod.Put, client, collection, entityType).Add(item); @@ -157,8 +156,8 @@ public string AddToCollection(string client, ICollection collection, IEnumerable /// The MBIDs of the items to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, EntityType entityType, params Guid[] items) => this.AddToCollectionAsync(client, collection, entityType, (IEnumerable) items); @@ -180,8 +179,8 @@ public Task AddToCollectionAsync(string client, Guid collection, EntityT /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, Guid collection, EntityType entityType, IEnumerable items, CancellationToken cancellationToken = default) { var submission = new ModifyCollection(HttpMethod.Put, client, collection, entityType).Add(items); @@ -205,8 +204,8 @@ public Task AddToCollectionAsync(string client, Guid collection, EntityT /// The MBIDs of the items to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params Guid[] items) => this.AddToCollectionAsync(client, collection.Id, collection.ContentType, items, cancellationToken); @@ -242,8 +241,8 @@ public Task AddToCollectionAsync(string client, Guid collection, EntityT /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, Guid item, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection.Id, collection.ContentType, item, cancellationToken); @@ -258,8 +257,8 @@ public Task AddToCollectionAsync(string client, Guid collection, EntityT /// The MBIDs of the items to add to . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, params Guid[] items) => this.AddToCollectionAsync(client, collection.Id, collection.ContentType, items); @@ -274,8 +273,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task AddToCollectionAsync(string client, ICollection collection, IEnumerable items, CancellationToken cancellationToken = default) => this.AddToCollectionAsync(client, collection.Id, collection.ContentType, items, cancellationToken); @@ -295,8 +294,8 @@ public Task AddToCollectionAsync(string client, ICollection collection, /// The MBID of the item to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, EntityType entityType, Guid item) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, entityType, item)); @@ -311,8 +310,8 @@ public string RemoveFromCollection(string client, Guid collection, EntityType en /// The MBIDs of the items to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, EntityType entityType, params Guid[] items) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, entityType, items)); @@ -327,8 +326,8 @@ public string RemoveFromCollection(string client, Guid collection, EntityType en /// The MBIDs of the items to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, Guid collection, EntityType entityType, IEnumerable items) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, entityType, items)); @@ -342,8 +341,8 @@ public string RemoveFromCollection(string client, Guid collection, EntityType en /// The MBID of the item to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, Guid item) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, item)); @@ -357,8 +356,8 @@ public string RemoveFromCollection(string client, ICollection collection, Guid i /// The MBIDs of the items to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, params Guid[] items) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, items)); @@ -372,8 +371,8 @@ public string RemoveFromCollection(string client, ICollection collection, params /// The MBIDs of the items to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public string RemoveFromCollection(string client, ICollection collection, IEnumerable items) => AsyncUtils.ResultOf(this.RemoveFromCollectionAsync(client, collection, items)); @@ -389,8 +388,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The MBIDs of the items to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, EntityType entityType, CancellationToken cancellationToken, params Guid[] items) => this.RemoveFromCollectionAsync(client, collection, entityType, items, cancellationToken); @@ -407,8 +406,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, EntityType entityType, Guid item, CancellationToken cancellationToken = default) { var submission = new ModifyCollection(HttpMethod.Delete, client, collection, entityType).Add(item); @@ -426,8 +425,8 @@ public string RemoveFromCollection(string client, ICollection collection, IEnume /// The MBIDs of the items to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, EntityType entityType, params Guid[] items) => this.RemoveFromCollectionAsync(client, collection, entityType, (IEnumerable) items); @@ -449,8 +448,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, En /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, Guid collection, EntityType entityType, IEnumerable items, CancellationToken cancellationToken = default) { var submission = new ModifyCollection(HttpMethod.Delete, client, collection, entityType).Add(items); @@ -474,8 +473,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, En /// The MBIDs of the items to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, CancellationToken cancellationToken, params Guid[] items) => this.RemoveFromCollectionAsync(client, collection.Id, collection.ContentType, items, cancellationToken); @@ -511,8 +510,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, En /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, Guid item, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection.Id, collection.ContentType, item, cancellationToken); @@ -527,8 +526,8 @@ public Task RemoveFromCollectionAsync(string client, Guid collection, En /// The MBIDs of the items to remove from . /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, params Guid[] items) => this.RemoveFromCollectionAsync(client, collection.Id, collection.ContentType, items); @@ -543,8 +542,8 @@ public Task RemoveFromCollectionAsync(string client, ICollection collect /// The cancellation token to cancel the operation. /// A message describing the result (usually "OK"). /// When is blank. - /// When the MusicBrainz web service reports an error. - /// When the MusicBrainz web service could not be contacted. + /// When the web service reports an error. + /// When something goes wrong with the request. public Task RemoveFromCollectionAsync(string client, ICollection collection, IEnumerable items, CancellationToken cancellationToken = default) => this.RemoveFromCollectionAsync(client, collection.Id, collection.ContentType, items, cancellationToken); diff --git a/MetaBrainz.MusicBrainz/Query.Lookup.cs b/MetaBrainz.MusicBrainz/Query.Lookup.cs index 83d484b..49328d9 100644 --- a/MetaBrainz.MusicBrainz/Query.Lookup.cs +++ b/MetaBrainz.MusicBrainz/Query.Lookup.cs @@ -1,6 +1,6 @@ using System; using System.Collections.Generic; -using System.Net; +using System.Net.Http; using System.Threading; using System.Threading.Tasks; @@ -19,8 +19,8 @@ public sealed partial class Query { /// The MBID for the area to look up. /// Additional information to include in the result. /// The requested area. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IArea LookupArea(Guid mbid, Include inc = Include.None) => AsyncUtils.ResultOf(this.LookupAreaAsync(mbid, inc)); /// Looks up the specified area. @@ -28,8 +28,8 @@ public sealed partial class Query { /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The requested area. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public async Task LookupAreaAsync(Guid mbid, Include inc = Include.None, CancellationToken cancellationToken = default) => await this.PerformRequestAsync("area", mbid, Query.BuildExtraText(inc), cancellationToken).ConfigureAwait(false); @@ -44,8 +44,8 @@ public async Task LookupAreaAsync(Guid mbid, Include inc = Include.None, /// The release status to filter on; applies only when includes . /// /// The requested artist. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IArtist LookupArtist(Guid mbid, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => AsyncUtils.ResultOf(this.LookupArtistAsync(mbid, inc, type, status)); @@ -61,8 +61,8 @@ public IArtist LookupArtist(Guid mbid, Include inc = Include.None, ReleaseType? /// /// The cancellation token to cancel the operation. /// The requested artist. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public async Task LookupArtistAsync(Guid mbid, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, CancellationToken cancellationToken = default) => await this.PerformRequestAsync("artist", mbid, Query.BuildExtraText(inc, status, type), cancellationToken) @@ -72,8 +72,8 @@ public IArtist LookupArtist(Guid mbid, Include inc = Include.None, ReleaseType? /// The MBID for the collection to look up. /// Additional information to include in the result. /// The requested collection. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public ICollection LookupCollection(Guid mbid, Include inc = Include.None) => AsyncUtils.ResultOf(this.LookupCollectionAsync(mbid, inc)); @@ -82,8 +82,8 @@ public ICollection LookupCollection(Guid mbid, Include inc = Include.None) /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The requested collection. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public async Task LookupCollectionAsync(Guid mbid, Include inc = Include.None, CancellationToken cancellationToken = default) => await this.PerformRequestAsync("collection", mbid, Query.BuildExtraText(inc), cancellationToken) @@ -105,8 +105,8 @@ public ICollection LookupCollection(Guid mbid, Include inc = Include.None) /// /// If , CD stubs are not returned. /// The result of the disc ID lookup. This can be a single disc or CD stub, or a list of matching releases. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IDiscIdLookupResult LookupDiscId(string discid, int[]? toc = null, Include inc = Include.None, bool allMedia = false, bool noStubs = false) => AsyncUtils.ResultOf(this.LookupDiscIdAsync(discid, toc, inc, allMedia, noStubs)); @@ -130,8 +130,8 @@ public ICollection LookupCollection(Guid mbid, Include inc = Include.None) /// of matching releases. /// /// The cancellation token to cancel the operation. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public async Task LookupDiscIdAsync(string discid, int[]? toc = null, Include inc = Include.None, bool allMediaFormats = false, bool noStubs = false, CancellationToken cancellationToken = default) { @@ -143,8 +143,8 @@ public ICollection LookupCollection(Guid mbid, Include inc = Include.None) /// The MBID for the event to look up. /// Additional information to include in the result. /// The requested event. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IEvent LookupEvent(Guid mbid, Include inc = Include.None) => AsyncUtils.ResultOf(this.LookupEventAsync(mbid, inc)); /// Looks up the specified event. @@ -152,24 +152,24 @@ public ICollection LookupCollection(Guid mbid, Include inc = Include.None) /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The requested event. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public async Task LookupEventAsync(Guid mbid, Include inc = Include.None, CancellationToken cancellationToken = default) => await this.PerformRequestAsync("event", mbid, Query.BuildExtraText(inc), cancellationToken).ConfigureAwait(false); /// Looks up the specified genre. /// The MBID for the genre to look up. /// The requested genre. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IGenre LookupGenre(Guid mbid) => AsyncUtils.ResultOf(this.LookupGenreAsync(mbid)); /// Looks up the specified genre. /// The MBID for the genre to look up. /// The cancellation token to cancel the operation. /// The requested genre. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public async Task LookupGenreAsync(Guid mbid, CancellationToken cancellationToken = default) => await this.PerformRequestAsync("genre", mbid, string.Empty, cancellationToken).ConfigureAwait(false); @@ -177,8 +177,8 @@ public async Task LookupGenreAsync(Guid mbid, CancellationToken cancella /// The MBID for the instrument to look up. /// Additional information to include in the result. /// The requested instrument. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IInstrument LookupInstrument(Guid mbid, Include inc = Include.None) => AsyncUtils.ResultOf(this.LookupInstrumentAsync(mbid, inc)); @@ -187,8 +187,8 @@ public IInstrument LookupInstrument(Guid mbid, Include inc = Include.None) /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The requested instrument. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public async Task LookupInstrumentAsync(Guid mbid, Include inc = Include.None, CancellationToken cancellationToken = default) => await this.PerformRequestAsync("instrument", mbid, Query.BuildExtraText(inc), cancellationToken) @@ -198,8 +198,8 @@ public IInstrument LookupInstrument(Guid mbid, Include inc = Include.None) /// The ISRC to look up. /// Additional information to include in the result. /// The recordings associated with the requested ISRC. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IIsrc LookupIsrc(string isrc, Include inc = Include.None) => AsyncUtils.ResultOf(this.LookupIsrcAsync(isrc, inc)); /// Looks up the recordings associated with the specified ISRC value. @@ -207,8 +207,8 @@ public IInstrument LookupInstrument(Guid mbid, Include inc = Include.None) /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The recordings associated with the requested ISRC. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public async Task LookupIsrcAsync(string isrc, Include inc = Include.None, CancellationToken cancellationToken = default) => await this.PerformRequestAsync("isrc", isrc, Query.BuildExtraText(inc), cancellationToken).ConfigureAwait(false); @@ -216,8 +216,8 @@ public async Task LookupIsrcAsync(string isrc, Include inc = Include.None /// The ISWC to look up. /// Additional information to include in the result. /// The works associated with the requested ISWC. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public IReadOnlyList LookupIswc(string iswc, Include inc = Include.None) => AsyncUtils.ResultOf(this.LookupIswcAsync(iswc, inc)); @@ -226,8 +226,8 @@ public IReadOnlyList LookupIswc(string iswc, Include inc = Include.None) /// Additional information to include in the result. /// The cancellation token to cancel the operation. /// The works associated with the requested ISWC. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public async Task> LookupIswcAsync(string iswc, Include inc = Include.None, CancellationToken cancellationToken = default) { // This "lookup" behaves like a browse, except that it does not support offset/limit. @@ -246,8 +246,8 @@ public IReadOnlyList LookupIswc(string iswc, Include inc = Include.None) /// The release status to filter on; applies only when includes . /// /// The requested label. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public ILabel LookupLabel(Guid mbid, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null) => AsyncUtils.ResultOf(this.LookupLabelAsync(mbid, inc, type, status)); @@ -262,8 +262,8 @@ public ILabel LookupLabel(Guid mbid, Include inc = Include.None, ReleaseType? ty /// /// The cancellation token to cancel the operation. /// The requested label. - /// When the web service reports an error. - /// When something goes wrong with the web request. + /// When the web service reports an error. + /// When something goes wrong with the request. public async Task LookupLabelAsync(Guid mbid, Include inc = Include.None, ReleaseType? type = null, ReleaseStatus? status = null, CancellationToken cancellationToken = default) => await this.PerformRequestAsync