diff --git a/Directory.Packages.props b/Directory.Packages.props index 1868a11..827553b 100644 --- a/Directory.Packages.props +++ b/Directory.Packages.props @@ -4,8 +4,8 @@ - - + + 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/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/HelperMethods.cs b/MetaBrainz.MusicBrainz/Json/HelperMethods.cs index b5d1902..f767e0b 100644 --- a/MetaBrainz.MusicBrainz/Json/HelperMethods.cs +++ b/MetaBrainz.MusicBrainz/Json/HelperMethods.cs @@ -15,25 +15,23 @@ internal static class HelperMethods { return TimeSpan.FromMilliseconds(ms.Value); } - public static EntityType ParseEntityType(string? text) { - return text switch { - "area" => EntityType.Area, - "artist" => EntityType.Artist, - "collection" => EntityType.Collection, - "event" => EntityType.Event, - "genre" => EntityType.Genre, - "instrument" => EntityType.Instrument, - "label" => EntityType.Label, - "place" => EntityType.Place, - "recording" => EntityType.Recording, - "release" => EntityType.Release, - "release-group" => EntityType.ReleaseGroup, // for Annotation - "release_group" => EntityType.ReleaseGroup, // for Collection and Relationship - "series" => EntityType.Series, - "url" => EntityType.Url, - "work" => EntityType.Work, - _ => EntityType.Unknown - }; - } + public static EntityType ParseEntityType(string? text) => text switch { + "area" => EntityType.Area, + "artist" => EntityType.Artist, + "collection" => EntityType.Collection, + "event" => EntityType.Event, + "genre" => EntityType.Genre, + "instrument" => EntityType.Instrument, + "label" => EntityType.Label, + "place" => EntityType.Place, + "recording" => EntityType.Recording, + "release" => EntityType.Release, + "release-group" => EntityType.ReleaseGroup, // for Annotation + "release_group" => EntityType.ReleaseGroup, // for Collection and Relationship + "series" => EntityType.Series, + "url" => EntityType.Url, + "work" => EntityType.Work, + _ => EntityType.Unknown + }; } 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/DiscIdLookupResultReader.cs b/MetaBrainz.MusicBrainz/Json/Readers/DiscIdLookupResultReader.cs index d12b8f1..a487f77 100644 --- a/MetaBrainz.MusicBrainz/Json/Readers/DiscIdLookupResultReader.cs +++ b/MetaBrainz.MusicBrainz/Json/Readers/DiscIdLookupResultReader.cs @@ -88,8 +88,9 @@ internal sealed class DiscIdLookupResultReader : 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/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 diff --git a/MetaBrainz.MusicBrainz/OAuth2.cs b/MetaBrainz.MusicBrainz/OAuth2.cs index 56be494..b68a235 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 is not 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 is not 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/DiscIdLookupResult.cs b/MetaBrainz.MusicBrainz/Objects/DiscIdLookupResult.cs index 77f3887..fda8ca6 100644 --- a/MetaBrainz.MusicBrainz/Objects/DiscIdLookupResult.cs +++ b/MetaBrainz.MusicBrainz/Objects/DiscIdLookupResult.cs @@ -8,25 +8,40 @@ namespace MetaBrainz.MusicBrainz.Objects; internal sealed class DiscIdLookupResult : JsonBasedObject, IDiscIdLookupResult { - public IDisc? Disc { get; set; } + public DiscIdLookupResult() { + } + + public DiscIdLookupResult(IDisc? disc) { + this.Disc = disc; + } + + public DiscIdLookupResult(IReadOnlyList? releases) { + this.Releases = releases; + } + + public DiscIdLookupResult(ICdStub? stub) { + this.Stub = stub; + } + + public IDisc? Disc { get; } - public IReadOnlyList? Releases { get; set; } + public IReadOnlyList? Releases { get; } - public ICdStub? Stub { get; set; } + public ICdStub? Stub { get; } /// Gets the textual representation of the disc ID lookup result. /// A string describing the lookup results. public override string ToString() { if (this.Disc is not null) { - return "Disc: " + this.Disc; + return $"Disc: {this.Disc}"; } if (this.Stub is not null) { - return "CD Stub: " + this.Stub; + return $"CD Stub: {this.Stub}"; } if (this.Releases is not null) { return $"{this.Releases.Count} Release(s)"; } - return string.Empty; // should be impossible + return "Result Data Not Recognized"; } } diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Alias.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Alias.cs index b7f620f..8e1b569 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Alias.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Alias.cs @@ -12,23 +12,23 @@ internal sealed class Alias : JsonBasedObject, IAlias { this.Primary = primary; } - public PartialDate? Begin { get; set; } + public PartialDate? Begin { get; init; } - public PartialDate? End { get; set; } + public PartialDate? End { get; init; } - public bool Ended { get; set; } + public bool Ended { get; init; } - public string? Locale { get; set; } + public string? Locale { get; init; } public string Name { get; } public bool Primary { get; } - public string? SortName { get; set; } + public string? SortName { get; init; } - public string? Type { get; set; } + public string? Type { get; init; } - public Guid? TypeId { get; set; } + public Guid? TypeId { get; init; } public override string ToString() { var text = this.Name; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Annotation.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Annotation.cs index 5843ab3..35898df 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Annotation.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Annotation.cs @@ -7,13 +7,13 @@ namespace MetaBrainz.MusicBrainz.Objects.Entities; internal sealed class Annotation : JsonBasedObject, IAnnotation { - public Guid? Entity { get; set; } + public Guid? Entity { get; init; } - public string? Name { get; set; } + public string? Name { get; init; } - public string? Text { get; set; } + public string? Text { get; init; } - public EntityType? Type { get; set; } + public EntityType? Type { get; init; } public override string? ToString() => this.Text; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Area.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Area.cs index 6eebfd6..5fc12f7 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Area.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Area.cs @@ -10,37 +10,37 @@ internal sealed class Area : Entity, IArea { public Area(Guid id) : base(EntityType.Area, id) { } - public IReadOnlyList? Aliases { get; set; } + public IReadOnlyList? Aliases { get; init; } - public string? Annotation { get; set; } + public string? Annotation { get; init; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } - public IReadOnlyList? Genres { get; set; } + public IReadOnlyList? Genres { get; init; } - public IReadOnlyList? Iso31661Codes { get; set; } + public IReadOnlyList? Iso31661Codes { get; init; } - public IReadOnlyList? Iso31662Codes { get; set; } + public IReadOnlyList? Iso31662Codes { get; init; } - public IReadOnlyList? Iso31663Codes { get; set; } + public IReadOnlyList? Iso31663Codes { get; init; } - public ILifeSpan? LifeSpan { get; set; } + public ILifeSpan? LifeSpan { get; init; } - public string? Name { get; set; } + public string? Name { get; init; } - public IReadOnlyList? Relationships { get; set; } + public IReadOnlyList? Relationships { get; init; } - public string? SortName { get; set; } + public string? SortName { get; init; } - public IReadOnlyList? Tags { get; set; } + public IReadOnlyList? Tags { get; init; } - public string? Type { get; set; } + public string? Type { get; init; } - public Guid? TypeId { get; set; } + public Guid? TypeId { get; init; } - public IReadOnlyList? UserGenres { get; set; } + public IReadOnlyList? UserGenres { get; init; } - public IReadOnlyList? UserTags { get; set; } + public IReadOnlyList? UserTags { get; init; } public override string ToString() { var text = this.Name ?? string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Artist.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Artist.cs index 22f9b92..89d758f 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Artist.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Artist.cs @@ -10,59 +10,59 @@ internal sealed class Artist : Entity, IArtist { public Artist(Guid id) : base(EntityType.Artist, id) { } - public IReadOnlyList? Aliases { get; set; } + public IReadOnlyList? Aliases { get; init; } - public string? Annotation { get; set; } + public string? Annotation { get; init; } - public IArea? Area { get; set; } + public IArea? Area { get; init; } - public IArea? BeginArea { get; set; } + public IArea? BeginArea { get; init; } - public string? Country { get; set; } + public string? Country { get; init; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } - public IArea? EndArea { get; set; } + public IArea? EndArea { get; init; } - public string? Gender { get; set; } + public string? Gender { get; init; } - public Guid? GenderId { get; set; } + public Guid? GenderId { get; init; } - public IReadOnlyList? Genres { get; set; } + public IReadOnlyList? Genres { get; init; } - public IReadOnlyList? Ipis { get; set; } + public IReadOnlyList? Ipis { get; init; } - public IReadOnlyList? Isnis { get; set; } + public IReadOnlyList? Isnis { get; init; } - public ILifeSpan? LifeSpan { get; set; } + public ILifeSpan? LifeSpan { get; init; } - public string? Name { get; set; } + public string? Name { get; init; } - public IRating? Rating { get; set; } + public IRating? Rating { get; init; } - public IReadOnlyList? Recordings { get; set; } + public IReadOnlyList? Recordings { get; init; } - public IReadOnlyList? Relationships { get; set; } + public IReadOnlyList? Relationships { get; init; } - public IReadOnlyList? ReleaseGroups { get; set; } + public IReadOnlyList? ReleaseGroups { get; init; } - public IReadOnlyList? Releases { get; set; } + public IReadOnlyList? Releases { get; init; } - public string? SortName { get; set; } + public string? SortName { get; init; } - public IReadOnlyList? Tags { get; set; } + public IReadOnlyList? Tags { get; init; } - public string? Type { get; set; } + public string? Type { get; init; } - public Guid? TypeId { get; set; } + public Guid? TypeId { get; init; } - public IReadOnlyList? UserGenres { get; set; } + public IReadOnlyList? UserGenres { get; init; } - public IRating? UserRating { get; set; } + public IRating? UserRating { get; init; } - public IReadOnlyList? UserTags { get; set; } + public IReadOnlyList? UserTags { get; init; } - public IReadOnlyList? Works { get; set; } + public IReadOnlyList? Works { get; init; } public override string ToString() { var text = this.Name ?? string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/CdStub.cs b/MetaBrainz.MusicBrainz/Objects/Entities/CdStub.cs index 705d32a..d0b78ce 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/CdStub.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/CdStub.cs @@ -14,17 +14,17 @@ internal sealed class CdStub : JsonBasedObject, ICdStub { public string Id { get; } - public string? Artist { get; set; } + public string? Artist { get; init; } - public string? Barcode { get; set; } + public string? Barcode { get; init; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } public string Title { get; } - public int TrackCount { get; set; } + public int TrackCount { get; init; } - public IReadOnlyList? Tracks { get; set; } + public IReadOnlyList? Tracks { get; init; } public override string ToString() { var text = string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Collection.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Collection.cs index a7c1276..62e9113 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Collection.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Collection.cs @@ -11,15 +11,15 @@ internal sealed class Collection : Entity, ICollection { this.ItemCount = itemCount; } - public string? Editor { get; set; } + public string? Editor { get; init; } public EntityType ContentType { get; } - public string? Name { get; set; } + public string? Name { get; init; } - public string? Type { get; set; } + public string? Type { get; init; } - public Guid? TypeId { get; set; } + public Guid? TypeId { get; init; } public int ItemCount { get; } diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/CoverArtArchive.cs b/MetaBrainz.MusicBrainz/Objects/Entities/CoverArtArchive.cs index 84380c9..5b9d26c 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/CoverArtArchive.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/CoverArtArchive.cs @@ -5,15 +5,15 @@ namespace MetaBrainz.MusicBrainz.Objects.Entities; internal sealed class CoverArtArchive : JsonBasedObject, ICoverArtArchive { - public bool Artwork { get; set; } + public bool Artwork { get; init; } - public bool Back { get; set; } + public bool Back { get; init; } - public int Count { get; set; } + public int Count { get; init; } - public bool Darkened { get; set; } + public bool Darkened { get; init; } - public bool Front { get; set; } + public bool Front { get; init; } public override string ToString() { if (this.Darkened) { diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Disc.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Disc.cs index c71a312..7e42e1e 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Disc.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Disc.cs @@ -18,7 +18,7 @@ internal sealed class Disc : JsonBasedObject, IDisc { public IReadOnlyList Offsets { get; } - public IReadOnlyList? Releases { get; set; } + public IReadOnlyList? Releases { get; init; } public int Sectors { get; } diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Event.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Event.cs index 18f6569..8fd59a1 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Event.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Event.cs @@ -10,39 +10,39 @@ internal sealed class Event : Entity, IEvent { public Event(Guid id) : base(EntityType.Event, id) { } - public IReadOnlyList? Aliases { get; set; } + public IReadOnlyList? Aliases { get; init; } - public string? Annotation { get; set; } + public string? Annotation { get; init; } - public bool Cancelled { get; set; } + public bool Cancelled { get; init; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } - public IReadOnlyList? Genres { get; set; } + public IReadOnlyList? Genres { get; init; } - public ILifeSpan? LifeSpan { get; set; } + public ILifeSpan? LifeSpan { get; init; } - public string? Name { get; set; } + public string? Name { get; init; } - public IRating? Rating { get; set; } + public IRating? Rating { get; init; } - public IReadOnlyList? Relationships { get; set; } + public IReadOnlyList? Relationships { get; init; } - public string? Setlist { get; set; } + public string? Setlist { get; init; } - public IReadOnlyList? Tags { get; set; } + public IReadOnlyList? Tags { get; init; } - public string? Time { get; set; } + public string? Time { get; init; } - public string? Type { get; set; } + public string? Type { get; init; } - public Guid? TypeId { get; set; } + public Guid? TypeId { get; init; } - public IReadOnlyList? UserGenres { get; set; } + public IReadOnlyList? UserGenres { get; init; } - public IRating? UserRating { get; set; } + public IRating? UserRating { get; init; } - public IReadOnlyList? UserTags { get; set; } + public IReadOnlyList? UserTags { get; init; } public override string ToString() { var text = this.Name ?? string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Genre.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Genre.cs index cdfa459..3b8560e 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Genre.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Genre.cs @@ -10,11 +10,11 @@ internal sealed class Genre : Entity, IGenre { this.Name = name; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } public string Name { get; } - public int? VoteCount { get; set; } + public int? VoteCount { get; init; } public override string ToString() { var text = this.Name; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Instrument.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Instrument.cs index 016bfd2..cb7ec75 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Instrument.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Instrument.cs @@ -10,29 +10,29 @@ internal sealed class Instrument : Entity, IInstrument { public Instrument(Guid id) : base(EntityType.Instrument, id) { } - public IReadOnlyList? Aliases { get; set; } + public IReadOnlyList? Aliases { get; init; } - public string? Annotation { get; set; } + public string? Annotation { get; init; } - public string? Description { get; set; } + public string? Description { get; init; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } - public IReadOnlyList? Genres { get; set; } + public IReadOnlyList? Genres { get; init; } - public string? Name { get; set; } + public string? Name { get; init; } - public IReadOnlyList? Relationships { get; set; } + public IReadOnlyList? Relationships { get; init; } - public IReadOnlyList? Tags { get; set; } + public IReadOnlyList? Tags { get; init; } - public string? Type { get; set; } + public string? Type { get; init; } - public Guid? TypeId { get; set; } + public Guid? TypeId { get; init; } - public IReadOnlyList? UserGenres { get; set; } + public IReadOnlyList? UserGenres { get; init; } - public IReadOnlyList? UserTags { get; set; } + public IReadOnlyList? UserTags { get; init; } public override string ToString() { var text = this.Name ?? string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Label.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Label.cs index d661539..2747adc 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Label.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Label.cs @@ -10,47 +10,47 @@ internal sealed class Label : Entity, ILabel { public Label(Guid id) : base(EntityType.Label, id) { } - public IReadOnlyList? Aliases { get; set; } + public IReadOnlyList? Aliases { get; init; } - public string? Annotation { get; set; } + public string? Annotation { get; init; } - public IArea? Area { get; set; } + public IArea? Area { get; init; } - public string? Country { get; set; } + public string? Country { get; init; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } - public IReadOnlyList? Genres { get; set; } + public IReadOnlyList? Genres { get; init; } - public IReadOnlyList? Ipis { get; set; } + public IReadOnlyList? Ipis { get; init; } - public IReadOnlyList? Isnis { get; set; } + public IReadOnlyList? Isnis { get; init; } - public int? LabelCode { get; set; } + public int? LabelCode { get; init; } - public ILifeSpan? LifeSpan { get; set; } + public ILifeSpan? LifeSpan { get; init; } - public string? Name { get; set; } + public string? Name { get; init; } - public IRating? Rating { get; set; } + public IRating? Rating { get; init; } - public IReadOnlyList? Relationships { get; set; } + public IReadOnlyList? Relationships { get; init; } - public IReadOnlyList? Releases { get; set; } + public IReadOnlyList? Releases { get; init; } - public string? SortName { get; set; } + public string? SortName { get; init; } - public IReadOnlyList? Tags { get; set; } + public IReadOnlyList? Tags { get; init; } - public string? Type { get; set; } + public string? Type { get; init; } - public Guid? TypeId { get; set; } + public Guid? TypeId { get; init; } - public IReadOnlyList? UserGenres { get; set; } + public IReadOnlyList? UserGenres { get; init; } - public IRating? UserRating { get; set; } + public IRating? UserRating { get; init; } - public IReadOnlyList? UserTags { get; set; } + public IReadOnlyList? UserTags { get; init; } public override string ToString() { var text = this.Name ?? string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/LabelInfo.cs b/MetaBrainz.MusicBrainz/Objects/Entities/LabelInfo.cs index 7c26e37..28390a2 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/LabelInfo.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/LabelInfo.cs @@ -5,9 +5,9 @@ namespace MetaBrainz.MusicBrainz.Objects.Entities; internal sealed class LabelInfo : JsonBasedObject, ILabelInfo { - public string? CatalogNumber { get; set; } + public string? CatalogNumber { get; init; } - public ILabel? Label { get; set; } + public ILabel? Label { get; init; } public override string ToString() { var text = string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/LifeSpan.cs b/MetaBrainz.MusicBrainz/Objects/Entities/LifeSpan.cs index 20ecf44..7444a1a 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/LifeSpan.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/LifeSpan.cs @@ -5,11 +5,11 @@ namespace MetaBrainz.MusicBrainz.Objects.Entities; internal sealed class LifeSpan : JsonBasedObject, ILifeSpan { - public PartialDate? Begin { get; set; } + public PartialDate? Begin { get; init; } - public PartialDate? End { get; set; } + public PartialDate? End { get; init; } - public bool Ended { get; set; } + public bool Ended { get; init; } public override string ToString() { var text = this.Begin?.ToString() ?? "????"; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Medium.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Medium.cs index 87c6d43..d6a9bca 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Medium.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Medium.cs @@ -8,25 +8,25 @@ namespace MetaBrainz.MusicBrainz.Objects.Entities; internal sealed class Medium : JsonBasedObject, IMedium { - public IReadOnlyList? DataTracks { get; set; } + public IReadOnlyList? DataTracks { get; init; } - public IReadOnlyList? Discs { get; set; } + public IReadOnlyList? Discs { get; init; } - public string? Format { get; set; } + public string? Format { get; init; } - public Guid? FormatId { get; set; } + public Guid? FormatId { get; init; } - public int Position { get; set; } + public int Position { get; init; } - public ITrack? Pregap { get; set; } + public ITrack? Pregap { get; init; } - public string? Title { get; set; } + public string? Title { get; init; } - public int TrackCount { get; set; } + public int TrackCount { get; init; } - public int? TrackOffset { get; set; } + public int? TrackOffset { get; init; } - public IReadOnlyList? Tracks { get; set; } + public IReadOnlyList? Tracks { get; init; } public override string ToString() { var text = this.Format ?? "Medium"; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/NameCredit.cs b/MetaBrainz.MusicBrainz/Objects/Entities/NameCredit.cs index 2045739..8771be7 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/NameCredit.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/NameCredit.cs @@ -5,11 +5,11 @@ namespace MetaBrainz.MusicBrainz.Objects.Entities; internal sealed class NameCredit : JsonBasedObject, INameCredit { - public IArtist? Artist { get; set; } + public IArtist? Artist { get; init; } - public string? JoinPhrase { get; set; } + public string? JoinPhrase { get; init; } - public string? Name { get; set; } + public string? Name { get; init; } public override string ToString() { var text = string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Place.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Place.cs index 79856d0..9659b81 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Place.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Place.cs @@ -10,35 +10,35 @@ internal sealed class Place : Entity, IPlace { public Place(Guid id) : base(EntityType.Place, id) { } - public string? Address { get; set; } + public string? Address { get; init; } - public IReadOnlyList? Aliases { get; set; } + public IReadOnlyList? Aliases { get; init; } - public string? Annotation { get; set; } + public string? Annotation { get; init; } - public IArea? Area { get; set; } + public IArea? Area { get; init; } - public ICoordinates? Coordinates { get; set; } + public ICoordinates? Coordinates { get; init; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } - public IReadOnlyList? Genres { get; set; } + public IReadOnlyList? Genres { get; init; } - public ILifeSpan? LifeSpan { get; set; } + public ILifeSpan? LifeSpan { get; init; } - public string? Name { get; set; } + public string? Name { get; init; } - public IReadOnlyList? Relationships { get; set; } + public IReadOnlyList? Relationships { get; init; } - public IReadOnlyList? Tags { get; set; } + public IReadOnlyList? Tags { get; init; } - public string? Type { get; set; } + public string? Type { get; init; } - public Guid? TypeId { get; set; } + public Guid? TypeId { get; init; } - public IReadOnlyList? UserGenres { get; set; } + public IReadOnlyList? UserGenres { get; init; } - public IReadOnlyList? UserTags { get; set; } + public IReadOnlyList? UserTags { get; init; } public override string ToString() { var text = this.Name ?? string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Rating.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Rating.cs index 9cf786e..1cf1367 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Rating.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Rating.cs @@ -7,9 +7,9 @@ namespace MetaBrainz.MusicBrainz.Objects.Entities; internal sealed class Rating : JsonBasedObject, IRating { - public decimal? Value { get; set; } + public decimal? Value { get; init; } - public int? VoteCount { get; set; } + public int? VoteCount { get; init; } public override string ToString() { var text = string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Recording.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Recording.cs index 798029a..207ff8f 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Recording.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Recording.cs @@ -10,39 +10,39 @@ internal sealed class Recording : Entity, IRecording { public Recording(Guid id) : base(EntityType.Recording, id) { } - public IReadOnlyList? Aliases { get; set; } + public IReadOnlyList? Aliases { get; init; } - public string? Annotation { get; set; } + public string? Annotation { get; init; } - public IReadOnlyList? ArtistCredit { get; set; } + public IReadOnlyList? ArtistCredit { get; init; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } - public PartialDate? FirstReleaseDate { get; set; } + public PartialDate? FirstReleaseDate { get; init; } - public IReadOnlyList? Genres { get; set; } + public IReadOnlyList? Genres { get; init; } - public IReadOnlyList? Isrcs { get; set; } + public IReadOnlyList? Isrcs { get; init; } - public TimeSpan? Length { get; set; } + public TimeSpan? Length { get; init; } - public IRating? Rating { get; set; } + public IRating? Rating { get; init; } - public IReadOnlyList? Relationships { get; set; } + public IReadOnlyList? Relationships { get; init; } - public IReadOnlyList? Releases { get; set; } + public IReadOnlyList? Releases { get; init; } - public IReadOnlyList? Tags { get; set; } + public IReadOnlyList? Tags { get; init; } - public string? Title { get; set; } + public string? Title { get; init; } - public IReadOnlyList? UserGenres { get; set; } + public IReadOnlyList? UserGenres { get; init; } - public IRating? UserRating { get; set; } + public IRating? UserRating { get; init; } - public IReadOnlyList? UserTags { get; set; } + public IReadOnlyList? UserTags { get; init; } - public bool Video { get; set; } + public bool Video { get; init; } public override string ToString() { var text = string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Relationship.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Relationship.cs index 4eda5b5..ed20bbc 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Relationship.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Relationship.cs @@ -8,45 +8,45 @@ namespace MetaBrainz.MusicBrainz.Objects.Entities; internal sealed class Relationship : JsonBasedObject, IRelationship { - public IArea? Area { get; set; } + public IArea? Area { get; init; } - public IArtist? Artist { get; set; } + public IArtist? Artist { get; init; } - public IReadOnlyList? Attributes { get; set; } + public IReadOnlyList? Attributes { get; init; } - public IReadOnlyDictionary? AttributeCredits { get; set; } + public IReadOnlyDictionary? AttributeCredits { get; init; } - public IReadOnlyDictionary? AttributeIds { get; set; } + public IReadOnlyDictionary? AttributeIds { get; init; } - public IReadOnlyDictionary? AttributeValues { get; set; } + public IReadOnlyDictionary? AttributeValues { get; init; } - public PartialDate? Begin { get; set; } + public PartialDate? Begin { get; init; } - public string? Direction { get; set; } + public string? Direction { get; init; } - public PartialDate? End { get; set; } + public PartialDate? End { get; init; } - public bool Ended { get; set; } + public bool Ended { get; init; } - public IEvent? Event { get; set; } + public IEvent? Event { get; init; } - public IInstrument? Instrument { get; set; } + public IInstrument? Instrument { get; init; } - public ILabel? Label { get; set; } + public ILabel? Label { get; init; } - public int? OrderingKey { get; set; } + public int? OrderingKey { get; init; } - public IPlace? Place { get; set; } + public IPlace? Place { get; init; } - public IRecording? Recording { get; set; } + public IRecording? Recording { get; init; } - public IRelease? Release { get; set; } + public IRelease? Release { get; init; } - public IReleaseGroup? ReleaseGroup { get; set; } + public IReleaseGroup? ReleaseGroup { get; init; } - public ISeries? Series { get; set; } + public ISeries? Series { get; init; } - public string? SourceCredit { get; set; } + public string? SourceCredit { get; init; } public IRelatableEntity? Target => this.TargetType switch { EntityType.Area => this.Area, @@ -64,19 +64,19 @@ internal sealed class Relationship : JsonBasedObject, IRelationship { _ => null }; - public string? TargetCredit { get; set; } + public string? TargetCredit { get; init; } - public Guid? TargetId { get; set; } + public Guid? TargetId { get; init; } - public EntityType? TargetType { get; set; } + public EntityType? TargetType { get; init; } - public string? Type { get; set; } + public string? Type { get; init; } - public Guid? TypeId { get; set; } + public Guid? TypeId { get; init; } - public IUrl? Url { get; set; } + public IUrl? Url { get; init; } - public IWork? Work { get; set; } + public IWork? Work { get; init; } public override string ToString() => $"{this.Type} → {this.TargetType}: {this.Target}"; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Release.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Release.cs index a2a4bc5..51a2a5f 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Release.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Release.cs @@ -10,57 +10,57 @@ internal sealed class Release : Entity, IRelease { public Release(Guid id) : base(EntityType.Release, id) { } - public IReadOnlyList? Aliases { get; set; } + public IReadOnlyList? Aliases { get; init; } - public string? Annotation { get; set; } + public string? Annotation { get; init; } - public IReadOnlyList? ArtistCredit { get; set; } + public IReadOnlyList? ArtistCredit { get; init; } - public string? Asin { get; set; } + public string? Asin { get; init; } - public string? Barcode { get; set; } + public string? Barcode { get; init; } - public IReadOnlyList? Collections { get; set; } + public IReadOnlyList? Collections { get; init; } - public string? Country { get; set; } + public string? Country { get; init; } - public ICoverArtArchive? CoverArtArchive { get; set; } + public ICoverArtArchive? CoverArtArchive { get; init; } - public PartialDate? Date { get; set; } + public PartialDate? Date { get; init; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } - public IReadOnlyList? Genres { get; set; } + public IReadOnlyList? Genres { get; init; } - public IReadOnlyList? LabelInfo { get; set; } + public IReadOnlyList? LabelInfo { get; init; } - public IReadOnlyList? Media { get; set; } + public IReadOnlyList? Media { get; init; } - public string? Packaging { get; set; } + public string? Packaging { get; init; } - public Guid? PackagingId { get; set; } + public Guid? PackagingId { get; init; } - public string? Quality { get; set; } + public string? Quality { get; init; } - public IReadOnlyList? Relationships { get; set; } + public IReadOnlyList? Relationships { get; init; } - public IReadOnlyList? ReleaseEvents { get; set; } + public IReadOnlyList? ReleaseEvents { get; init; } - public IReleaseGroup? ReleaseGroup { get; set; } + public IReleaseGroup? ReleaseGroup { get; init; } - public string? Status { get; set; } + public string? Status { get; init; } - public Guid? StatusId { get; set; } + public Guid? StatusId { get; init; } - public IReadOnlyList? Tags { get; set; } + public IReadOnlyList? Tags { get; init; } - public ITextRepresentation? TextRepresentation { get; set; } + public ITextRepresentation? TextRepresentation { get; init; } - public string? Title { get; set; } + public string? Title { get; init; } - public IReadOnlyList? UserGenres { get; set; } + public IReadOnlyList? UserGenres { get; init; } - public IReadOnlyList? UserTags { get; set; } + public IReadOnlyList? UserTags { get; init; } public override string ToString() { var text = string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/ReleaseEvent.cs b/MetaBrainz.MusicBrainz/Objects/Entities/ReleaseEvent.cs index e04aa21..5116d9a 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/ReleaseEvent.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/ReleaseEvent.cs @@ -5,9 +5,9 @@ namespace MetaBrainz.MusicBrainz.Objects.Entities; internal sealed class ReleaseEvent : JsonBasedObject, IReleaseEvent { - public IArea? Area { get; set; } + public IArea? Area { get; init; } - public PartialDate? Date { get; set; } + public PartialDate? Date { get; init; } public override string ToString() { if (this.Date is null) { diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/ReleaseGroup.cs b/MetaBrainz.MusicBrainz/Objects/Entities/ReleaseGroup.cs index 291f875..943932b 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/ReleaseGroup.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/ReleaseGroup.cs @@ -13,41 +13,41 @@ internal sealed class ReleaseGroup : Entity, IReleaseGroup { public ReleaseGroup(Guid id) : base(EntityType.ReleaseGroup, id) { } - public IReadOnlyList? Aliases { get; set; } + public IReadOnlyList? Aliases { get; init; } - public string? Annotation { get; set; } + public string? Annotation { get; init; } - public IReadOnlyList? ArtistCredit { get; set; } + public IReadOnlyList? ArtistCredit { get; init; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } - public PartialDate? FirstReleaseDate { get; set; } + public PartialDate? FirstReleaseDate { get; init; } - public IReadOnlyList? Genres { get; set; } + public IReadOnlyList? Genres { get; init; } - public string? PrimaryType { get; set; } + public string? PrimaryType { get; init; } - public Guid? PrimaryTypeId { get; set; } + public Guid? PrimaryTypeId { get; init; } - public IRating? Rating { get; set; } + public IRating? Rating { get; init; } - public IReadOnlyList? Relationships { get; set; } + public IReadOnlyList? Relationships { get; init; } - public IReadOnlyList? Releases { get; set; } + public IReadOnlyList? Releases { get; init; } - public IReadOnlyList? SecondaryTypes { get; set; } + public IReadOnlyList? SecondaryTypes { get; init; } - public IReadOnlyList? SecondaryTypeIds { get; set; } + public IReadOnlyList? SecondaryTypeIds { get; init; } - public IReadOnlyList? Tags { get; set; } + public IReadOnlyList? Tags { get; init; } - public string? Title { get; set; } + public string? Title { get; init; } - public IReadOnlyList? UserGenres { get; set; } + public IReadOnlyList? UserGenres { get; init; } - public IRating? UserRating { get; set; } + public IRating? UserRating { get; init; } - public IReadOnlyList? UserTags { get; set; } + public IReadOnlyList? UserTags { get; init; } public override string ToString() { var text = string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Series.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Series.cs index 8f25e25..627a238 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Series.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Series.cs @@ -10,27 +10,27 @@ internal sealed class Series : Entity, ISeries { public Series(Guid id) : base(EntityType.Series, id) { } - public IReadOnlyList? Aliases { get; set; } + public IReadOnlyList? Aliases { get; init; } - public string? Annotation { get; set; } + public string? Annotation { get; init; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } - public IReadOnlyList? Genres { get; set; } + public IReadOnlyList? Genres { get; init; } - public string? Name { get; set; } + public string? Name { get; init; } - public IReadOnlyList? Relationships { get; set; } + public IReadOnlyList? Relationships { get; init; } - public IReadOnlyList? Tags { get; set; } + public IReadOnlyList? Tags { get; init; } - public string? Type { get; set; } + public string? Type { get; init; } - public Guid? TypeId { get; set; } + public Guid? TypeId { get; init; } - public IReadOnlyList? UserGenres { get; set; } + public IReadOnlyList? UserGenres { get; init; } - public IReadOnlyList? UserTags { get; set; } + public IReadOnlyList? UserTags { get; init; } public override string ToString() { var text = this.Name ?? string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/SimpleTrack.cs b/MetaBrainz.MusicBrainz/Objects/Entities/SimpleTrack.cs index 74a3905..8128517 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/SimpleTrack.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/SimpleTrack.cs @@ -12,7 +12,7 @@ internal sealed class SimpleTrack : JsonBasedObject, ISimpleTrack { this.Length = length; } - public string? Artist { get; set; } + public string? Artist { get; init; } public TimeSpan Length { get; } diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Tag.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Tag.cs index dc9efec..fd1f7b4 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Tag.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Tag.cs @@ -11,7 +11,7 @@ internal sealed class Tag : JsonBasedObject, ITag { public string Name { get; } - public int? VoteCount { get; set; } + public int? VoteCount { get; init; } public override string ToString() { var text = this.Name; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/TextRepresentation.cs b/MetaBrainz.MusicBrainz/Objects/Entities/TextRepresentation.cs index 5ea8339..d965dbd 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/TextRepresentation.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/TextRepresentation.cs @@ -5,9 +5,9 @@ namespace MetaBrainz.MusicBrainz.Objects.Entities; internal sealed class TextRepresentation : JsonBasedObject, ITextRepresentation { - public string? Language { get; set; } + public string? Language { get; init; } - public string? Script { get; set; } + public string? Script { get; init; } public override string ToString() => $"{this.Language ?? "???"} / {this.Script ?? "???"}"; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Track.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Track.cs index 6e64adb..127406b 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Track.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Track.cs @@ -13,17 +13,17 @@ internal sealed class Track : JsonBasedObject, ITrack { this.Title = title; } - public IReadOnlyList? ArtistCredit { get; set; } + public IReadOnlyList? ArtistCredit { get; init; } public Guid Id { get; } - public TimeSpan? Length { get; set; } + public TimeSpan? Length { get; init; } - public string? Number { get; set; } + public string? Number { get; init; } - public int? Position { get; set; } + public int? Position { get; init; } - public IRecording? Recording { get; set; } + public IRecording? Recording { get; init; } public string Title { get; } diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Url.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Url.cs index 8f49ba9..0fa32f9 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Url.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Url.cs @@ -11,7 +11,7 @@ internal sealed class Url : Entity, IUrl { this.Resource = resource; } - public IReadOnlyList? Relationships { get; set; } + public IReadOnlyList? Relationships { get; init; } public Uri Resource { get; } diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/Work.cs b/MetaBrainz.MusicBrainz/Objects/Entities/Work.cs index 8eb60ab..60b659b 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/Work.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/Work.cs @@ -10,39 +10,39 @@ internal sealed class Work : Entity, IWork { public Work(Guid id) : base(EntityType.Work, id) { } - public IReadOnlyList? Aliases { get; set; } + public IReadOnlyList? Aliases { get; init; } - public string? Annotation { get; set; } + public string? Annotation { get; init; } - public IReadOnlyList? Attributes { get; set; } + public IReadOnlyList? Attributes { get; init; } - public string? Disambiguation { get; set; } + public string? Disambiguation { get; init; } - public IReadOnlyList? Genres { get; set; } + public IReadOnlyList? Genres { get; init; } - public IReadOnlyList? Iswcs { get; set; } + public IReadOnlyList? Iswcs { get; init; } - public string? Language { get; set; } + public string? Language { get; init; } - public IReadOnlyList? Languages { get; set; } + public IReadOnlyList? Languages { get; init; } - public IRating? Rating { get; set; } + public IRating? Rating { get; init; } - public IReadOnlyList? Relationships { get; set; } + public IReadOnlyList? Relationships { get; init; } - public IReadOnlyList? Tags { get; set; } + public IReadOnlyList? Tags { get; init; } - public string? Title { get; set; } + public string? Title { get; init; } - public string? Type { get; set; } + public string? Type { get; init; } - public Guid? TypeId { get; set; } + public Guid? TypeId { get; init; } - public IReadOnlyList? UserGenres { get; set; } + public IReadOnlyList? UserGenres { get; init; } - public IRating? UserRating { get; set; } + public IRating? UserRating { get; init; } - public IReadOnlyList? UserTags { get; set; } + public IReadOnlyList? UserTags { get; init; } public override string ToString() { var text = this.Title ?? string.Empty; diff --git a/MetaBrainz.MusicBrainz/Objects/Entities/WorkAttribute.cs b/MetaBrainz.MusicBrainz/Objects/Entities/WorkAttribute.cs index 0dd935d..394b974 100644 --- a/MetaBrainz.MusicBrainz/Objects/Entities/WorkAttribute.cs +++ b/MetaBrainz.MusicBrainz/Objects/Entities/WorkAttribute.cs @@ -7,13 +7,13 @@ namespace MetaBrainz.MusicBrainz.Objects.Entities; internal sealed class WorkAttribute : JsonBasedObject, IWorkAttribute { - public string? Type { get; set; } + public string? Type { get; init; } - public Guid? TypeId { get; set; } + public Guid? TypeId { get; init; } - public string? Value { get; set; } + public string? Value { get; init; } - public Guid? ValueId { get; set; } + public Guid? ValueId { get; init; } public override string ToString() => $"{this.Type}: {this.Value}"; 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/Objects/PagedQueryResults.cs b/MetaBrainz.MusicBrainz/Objects/PagedQueryResults.cs index 785be5a..b2c40ff 100644 --- a/MetaBrainz.MusicBrainz/Objects/PagedQueryResults.cs +++ b/MetaBrainz.MusicBrainz/Objects/PagedQueryResults.cs @@ -26,7 +26,7 @@ internal abstract class PagedQueryResults : IPag public IStreamingQueryResults AsStream() => new StreamingQueryResults(this); - bool IPagedQueryResults.IsActive => this.CurrentResult != null; + bool IPagedQueryResults.IsActive => this.CurrentResult is not null; public int? Limit { get; set; } diff --git a/MetaBrainz.MusicBrainz/Objects/Submissions/ModifyCollection.cs b/MetaBrainz.MusicBrainz/Objects/Submissions/ModifyCollection.cs index ccc3e84..3801ba0 100644 --- a/MetaBrainz.MusicBrainz/Objects/Submissions/ModifyCollection.cs +++ b/MetaBrainz.MusicBrainz/Objects/Submissions/ModifyCollection.cs @@ -61,22 +61,19 @@ internal sealed class ModifyCollection : ISubmission { string? ISubmission.RequestBody => null; - private static string MapType(EntityType entityType) { - return entityType switch { - EntityType.Area => "areas", - EntityType.Artist => "artists", - EntityType.Event => "events", - EntityType.Instrument => "instruments", - EntityType.Label => "labels", - EntityType.Place => "places", - EntityType.Recording => "recordings", - EntityType.Release => "releases", - EntityType.ReleaseGroup => "release-groups", - EntityType.Series => "series", - EntityType.Work => "works", - _ => throw new ArgumentOutOfRangeException(nameof(entityType), entityType, - "The specified entity type cannot be stored in a collection.") - }; - } + private static string MapType(EntityType type) => type switch { + EntityType.Area => "areas", + EntityType.Artist => "artists", + EntityType.Event => "events", + EntityType.Instrument => "instruments", + EntityType.Label => "labels", + EntityType.Place => "places", + EntityType.Recording => "recordings", + EntityType.Release => "releases", + EntityType.ReleaseGroup => "release-groups", + EntityType.Series => "series", + EntityType.Work => "works", + _ => throw new ArgumentOutOfRangeException(nameof(type), type, "The specified entity type cannot be stored in a collection.") + }; } diff --git a/MetaBrainz.MusicBrainz/Objects/Submissions/RatingSubmission.cs b/MetaBrainz.MusicBrainz/Objects/Submissions/RatingSubmission.cs index d246492..e62c9d7 100644 --- a/MetaBrainz.MusicBrainz/Objects/Submissions/RatingSubmission.cs +++ b/MetaBrainz.MusicBrainz/Objects/Submissions/RatingSubmission.cs @@ -49,9 +49,7 @@ public sealed class RatingSubmission : Submission { /// The rating to add (1-100), or 0 to remove the rating. /// The entity to rate. /// This submission request. - public RatingSubmission Add(byte rating, IRatableEntity entity) { - return this.Add(rating, entity.EntityType, entity.Id); - } + public RatingSubmission Add(byte rating, IRatableEntity entity) => this.Add(rating, entity.EntityType, entity.Id); /// Adds the specified rating to the specified entity. /// The rating to add (1-100), or 0 to remove the rating. @@ -86,17 +84,15 @@ private class RatingMap : Dictionary { private readonly RatingMap _works = new(); - private RatingMap GetMap(EntityType entityType) { - return entityType switch { - EntityType.Artist => this._artists, - EntityType.Event => this._events, - EntityType.Label => this._labels, - EntityType.Recording => this._recordings, - EntityType.ReleaseGroup => this._releaseGroups, - EntityType.Work => this._works, - _ => throw new ArgumentOutOfRangeException(nameof(entityType), entityType, "Entities of this type cannot be rated.") - }; - } + private RatingMap GetMap(EntityType entityType) => entityType switch { + EntityType.Artist => this._artists, + EntityType.Event => this._events, + EntityType.Label => this._labels, + EntityType.Recording => this._recordings, + EntityType.ReleaseGroup => this._releaseGroups, + EntityType.Work => this._works, + _ => throw new ArgumentOutOfRangeException(nameof(entityType), entityType, "Entities of this type cannot be rated.") + }; internal override string RequestBody { get { 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/Objects/Submissions/TagSubmission.cs b/MetaBrainz.MusicBrainz/Objects/Submissions/TagSubmission.cs index a1692c3..47e8f69 100644 --- a/MetaBrainz.MusicBrainz/Objects/Submissions/TagSubmission.cs +++ b/MetaBrainz.MusicBrainz/Objects/Submissions/TagSubmission.cs @@ -79,9 +79,7 @@ public sealed class TagSubmission : Submission { /// The vote to apply to the tag. /// The entity to tag. /// This submission request. - public TagSubmission Add(string tag, TagVote vote, ITaggableEntity entity) { - return this.Add(tag, vote, entity.EntityType, entity.Id); - } + public TagSubmission Add(string tag, TagVote vote, ITaggableEntity entity) => this.Add(tag, vote, entity.EntityType, entity.Id); /// Votes for the specified tag on the specified entities. /// The tag to vote for. @@ -131,22 +129,20 @@ private class TagMap : Dictionary { private readonly TagMap _works = new(); - private TagMap GetMap(EntityType entityType) { - return entityType switch { - EntityType.Area => this._areas, - EntityType.Artist => this._artists, - EntityType.Event => this._events, - EntityType.Instrument => this._instruments, - EntityType.Label => this._labels, - EntityType.Place => this._places, - EntityType.Recording => this._recordings, - EntityType.Release => this._releases, - EntityType.ReleaseGroup => this._releaseGroups, - EntityType.Series => this._series, - EntityType.Work => this._works, - _ => throw new ArgumentOutOfRangeException(nameof(entityType), entityType, "Entities of this type cannot be tagged.") - }; - } + private TagMap GetMap(EntityType entityType) => entityType switch { + EntityType.Area => this._areas, + EntityType.Artist => this._artists, + EntityType.Event => this._events, + EntityType.Instrument => this._instruments, + EntityType.Label => this._labels, + EntityType.Place => this._places, + EntityType.Recording => this._recordings, + EntityType.Release => this._releases, + EntityType.ReleaseGroup => this._releaseGroups, + EntityType.Series => this._series, + EntityType.Work => this._works, + _ => throw new ArgumentOutOfRangeException(nameof(entityType), entityType, "Entities of this type cannot be tagged.") + }; internal override string RequestBody { get { 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.Internals.cs b/MetaBrainz.MusicBrainz/Query.Internals.cs index 315934b..4d56741 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 is not 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 is not 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 is not null) { + throw new HttpError(error.Status, er.Error, response.Version, $"{er.Error}\n{er.Help}", error); + } + } + throw; } - return response; } internal Task PerformRequestAsync(string entity, Guid id, string extra, CancellationToken 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