[Approved] Add repository topics

Octokit.Reactive/Clients/IObservableRepositoriesClient.cs

@@ -1,6 +1,8 @@
 using System;
+using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using System.Reactive;
+using System.Threading.Tasks;
 
 namespace Octokit.Reactive
 {
@@ -556,5 +558,79 @@ public interface IObservableRepositoriesClient
  /// Refer to the API documentation for more information: https://developer.github.com/v3/repos/projects/
  /// </remarks>
  IObservableProjectsClient Project { get; }
+
+ /// <summary>
+ /// Gets all topics for the specified owner and repository name.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#get-all-repository-topics">API documentation</a> for more details
+ /// </remarks>
+ /// <param name="owner">The owner of the repository</param>
+ /// <param name="name">The name of the repository</param>
+ /// <param name="options">Options for changing the API response</param>
+ /// <returns>All topics associated with the repository.</returns>
+ IObservable<string> GetAllTopics(string owner, string name, ApiOptions options);
+
+ /// <summary>
+ /// Gets all topics for the specified owner and repository name.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#get-all-repository-topics">API documentation</a> for more details
+ /// </remarks>
+ /// <param name="owner">The owner of the repository</param>
+ /// <param name="name">The name of the repository</param>
+ /// <returns>All topics associated with the repository.</returns>
+ IObservable<string> GetAllTopics(string owner, string name);
+
+
+
+ /// <summary>
+ /// Gets all topics for the specified repository ID.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#get-all-repository-topics">API documentation</a> for more details
+ /// </remarks>
+ /// <param name="repositoryId">The ID of the repository</param>
+ /// <param name="options">Options for changing the API response</param>
+ /// <returns>All topics associated with the repository.</returns>
+ IObservable<string> GetAllTopics(long repositoryId, ApiOptions options);
+
+ /// <summary>
+ /// Gets all topics for the specified repository ID.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#get-all-repository-topics">API documentation</a> for more details
+ /// </remarks>
+ /// <param name="repositoryId">The ID of the repository</param>
+ /// <returns>All topics associated with the repository.</returns>
+ IObservable<string> GetAllTopics(long repositoryId);
+
+ /// <summary>
+ /// Replaces all topics for the specified repository.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#replace-all-repository-topics">API documentation</a> for more details
+ ///
+ /// This is a replacement operation; it is not additive. To clear repository topics, for example, you could specify an empty list of topics here.
+ /// </remarks>
+ /// <param name="repositoryId">The ID of the repository</param>
+ /// <param name="topics">The list of topics to associate with the repository</param>
+ /// <returns>All topics now associated with the repository.</returns>
+ IObservable<string> ReplaceAllTopics(long repositoryId, IEnumerable<string> topics);
+
+ /// <summary>
+ /// Replaces all topics for the specified repository.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#replace-all-repository-topics">API documentation</a> for more details
+ ///
+ /// This is a replacement operation; it is not additive. To clear repository topics, for example, you could specify an empty list of topics here.
+ /// </remarks>
+ /// <param name="owner">The owner of the repository</param>
+ /// <param name="name">The name of the repository</param>
+ /// <param name="topics">The list of topics to associate with the repository</param>
+ /// <returns>All topics now associated with the repository.</returns>
+ IObservable<string> ReplaceAllTopics(string owner, string name, IEnumerable<string> topics);
+
  }
 }

Octokit.Reactive/Clients/ObservableRepositoriesClient.cs

@@ -1,9 +1,11 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
+using System.Linq;
 using System.Reactive;
 using System.Reactive.Linq;
 using System.Reactive.Threading.Tasks;
+using System.Threading.Tasks;
 using Octokit.Reactive.Clients;
 using Octokit.Reactive.Internal;
 
@@ -821,5 +823,96 @@ public IObservable<CompareResult> Compare(string owner, string name, string @bas
  /// Refer to the API documentation for more information: https://developer.github.com/v3/repos/projects/
  /// </remarks>
  public IObservableProjectsClient Project { get; private set; }
+
+ /// <summary>
+ /// Gets all topics for the specified owner and repository name.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#get-all-repository-topics">API documentation</a> for more details
+ /// </remarks>
+ /// <param name="owner">The owner of the repository</param>
+ /// <param name="name">The name of the repository</param>
+ /// <param name="options">Options for changing the API response</param>
+ /// <returns>All topics associated with the repository.</returns>
+ public IObservable<string> GetAllTopics(string owner, string name, ApiOptions options)
+ {
+ var url = ApiUrls.RepositoryTopics(owner, name);
+ return _connection.GetAndFlattenAllPages<string>(url, null, AcceptHeaders.RepositoryTopicsPreview, options);
+ }
+
+ /// <summary>
+ /// Gets all topics for the specified owner and repository name.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#get-all-repository-topics">API documentation</a> for more details
+ /// </remarks>
+ /// <param name="owner">The owner of the repository</param>
+ /// <param name="name">The name of the repository</param>
+ /// <returns>All topics associated with the repository.</returns>
+ public IObservable<string> GetAllTopics(string owner, string name)
+ {
+ return GetAllTopics(owner, name, ApiOptions.None);
+ }
+
+ /// <summary>
+ /// Gets all topics for the specified repository ID.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#get-all-repository-topics">API documentation</a> for more details
+ /// </remarks>
+ /// <param name="repositoryId">The ID of the repository</param>
+ /// <param name="options">Options for changing the API response</param>
+ /// <returns>All topics associated with the repository.</returns>
+ public IObservable<string> GetAllTopics(long repositoryId, ApiOptions options)
+ {
+ var url = ApiUrls.RepositoryTopics(repositoryId);
+ return _connection.GetAndFlattenAllPages<string>(url, null, AcceptHeaders.RepositoryTopicsPreview, options);
+ }
+
+ /// <summary>
+ /// Gets all topics for the specified repository ID.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#get-all-repository-topics">API documentation</a> for more details
+ /// </remarks>
+ /// <param name="repositoryId">The ID of the repository</param>
+ /// <returns>All topics associated with the repository.</returns>
+ public IObservable<string> GetAllTopics(long repositoryId)
+ {
+ return GetAllTopics(repositoryId, ApiOptions.None);
+ }
+
+ /// <summary>
+ /// Replaces all topics for the specified repository.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#replace-all-repository-topics">API documentation</a> for more details
+ ///
+ /// This is a replacement operation; it is not additive. To clear repository topics, for example, you could specify an empty list of topics here.
+ /// </remarks>
+ /// <param name="repositoryId">The ID of the repository</param>
+ /// <param name="topics">The list of topics to associate with the repository</param>
+ /// <returns>All topics now associated with the repository.</returns>
+ public IObservable<string> ReplaceAllTopics(long repositoryId, IEnumerable<string> topics)
+ {
+ return _client.ReplaceAllTopics(repositoryId, topics).Result.ToObservable();
+ }
+
+ /// <summary>
+ /// Replaces all topics for the specified repository.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#replace-all-repository-topics">API documentation</a> for more details
+ ///
+ /// This is a replacement operation; it is not additive. To clear repository topics, for example, you could specify an empty list of topics here.
+ /// </remarks>
+ /// <param name="owner">The owner of the repository</param>
+ /// <param name="name">The name of the repository</param>
+ /// <param name="topics">The list of topics to associate with the repository</param>
+ /// <returns>All topics now associated with the repository.</returns>
+ public IObservable<string> ReplaceAllTopics(string owner, string name, IEnumerable<string> topics)
+ {
+ return _client.ReplaceAllTopics(owner, name, topics).Result.ToObservable();
+ }
  }
 }

Octokit.sln.DotSettings

@@ -269,6 +269,7 @@ II.2.12 <HandlesEvent />
  <s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpKeepExistingMigration/@EntryIndexedValue">True</s:Boolean>
  <s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpPlaceEmbeddedOnSameLineMigration/@EntryIndexedValue">True</s:Boolean>
  <s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpRenamePlacementToArrangementMigration/@EntryIndexedValue">True</s:Boolean>
+ <s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpUseContinuousIndentInsideBracesMigration/@EntryIndexedValue">True</s:Boolean>
  <s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002EAddAccessorOwnerDeclarationBracesMigration/@EntryIndexedValue">True</s:Boolean>
  <s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002ECSharpPlaceAttributeOnSameLineMigration/@EntryIndexedValue">True</s:Boolean>
  <s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002EMigrateBlankLinesAroundFieldToBlankLinesAroundProperty/@EntryIndexedValue">True</s:Boolean>

Octokit/Clients/IRepositoriesClient.cs

@@ -621,5 +621,80 @@ public interface IRepositoriesClient
  /// Refer to the API documentation for more information: https://developer.github.com/v3/repos/projects/
  /// </remarks>
  IProjectsClient Project { get; }
+
+ /// <summary>
+ /// Gets all topics for the specified owner and repository name.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#get-all-repository-topics">API documentation</a> for more details
+ /// </remarks>
+ /// <param name="owner">The owner of the repository</param>
+ /// <param name="name">The name of the repository</param>
+ /// <param name="options">Options for changing the API response</param>
+ /// <returns>All topics associated with the repository.</returns>
+ Task<IReadOnlyList<string>> GetAllTopics(string owner, string name, ApiOptions options);
+
+ /// <summary>
+ /// Gets all topics for the specified owner and repository name.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#get-all-repository-topics">API documentation</a> for more details
+ /// </remarks>
+ /// <param name="owner">The owner of the repository</param>
+ /// <param name="name">The name of the repository</param>
+ /// <returns>All topics associated with the repository.</returns>
+ Task<IReadOnlyList<string>> GetAllTopics(string owner, string name);
+
+
+
+ /// <summary>
+ /// Gets all topics for the specified repository ID.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#get-all-repository-topics">API documentation</a> for more details
+ /// </remarks>
+ /// <param name="repositoryId">The ID of the repository</param>
+ /// <param name="options">Options for changing the API response</param>
+ /// <returns>All topics associated with the repository.</returns>
+ Task<IReadOnlyList<string>> GetAllTopics(long repositoryId, ApiOptions options);
+
+ /// <summary>
+ /// Gets all topics for the specified repository ID.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#get-all-repository-topics">API documentation</a> for more details
+ /// </remarks>
+ /// <param name="repositoryId">The ID of the repository</param>
+ /// <returns>All topics associated with the repository.</returns>
+ Task<IReadOnlyList<string>> GetAllTopics(long repositoryId);
+
+
+ /// <summary>
+ /// Replaces all topics for the specified repository.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#replace-all-repository-topics">API documentation</a> for more details
+ ///
+ /// This is a replacement operation; it is not additive. To clear repository topics, for example, you could specify an empty list of topics here.
+ /// </remarks>
+ /// <param name="repositoryId">The ID of the repository</param>
+ /// <param name="topics">The list of topics to associate with the repository</param>
+ /// <returns>All topics now associated with the repository.</returns>
+ Task<IReadOnlyList<string>> ReplaceAllTopics(long repositoryId, IEnumerable<string> topics);
+
+ /// <summary>
+ /// Replaces all topics for the specified repository.
+ /// </summary>
+ /// <remarks>
+ /// See the <a href="https://docs.github.com/en/rest/reference/repos#replace-all-repository-topics">API documentation</a> for more details
+ ///
+ /// This is a replacement operation; it is not additive. To clear repository topics, for example, you could specify an empty list of topics here.
+ /// </remarks>
+ /// <param name="owner">The owner of the repository</param>
+ /// <param name="name">The name of the repository</param>
+ /// <param name="topics">The list of topics to associate with the repository</param>
+ /// <returns>All topics now associated with the repository.</returns>
+ Task<IReadOnlyList<string>> ReplaceAllTopics(string owner, string name, IEnumerable<string> topics);
+
  }
 }