Files
octokit.net/Octokit.Reactive/Clients/IObservableProjectCardsClient.cs
Nick Floyd 6565a07974 [BREAKING CHANGES]: int to long Ids for PreReceiveHook, Deployment Environments, Repository, Org Team, Repo Invitations, Public Key, Project Cards, Organization Invitation, Migrations, GpgKey, Deployment, Authorizations, Accounts / Profiles, Codespace / Workspaces (#2941)
* Fixes ids for Releases, Collaborators, and Contributors

* updates the interface for releases

* update the obverable release client

* updates ids from int to long based on GH database schema

* converts a test condition to use the proper type

* updates generated paging and observable classes
2024-06-26 10:57:30 -05:00

104 lines
4.5 KiB
C#

using System;
using System.Diagnostics.CodeAnalysis;
namespace Octokit.Reactive
{
/// <summary>
/// A client for GitHub's Project Cards API.
/// </summary>
/// <remarks>
/// See the <a href="https://developer.github.com/v3/repos/projects/cards/">Repository Projects API documentation</a> for more information.
/// </remarks>
public interface IObservableProjectCardsClient
{
/// <summary>
/// Gets all cards.
/// </summary>
/// <remarks>
/// See the <a href="https://developer.github.com/v3/repos/projects/#list-projects-cards">API documentation</a> for more information.
/// </remarks>
/// <param name="columnId">The id of the column</param>
IObservable<ProjectCard> GetAll(int columnId);
/// <summary>
/// Gets all cards.
/// </summary>
/// <remarks>
/// See the <a href="https://developer.github.com/v3/repos/projects/#list-projects-cards">API documentation</a> for more information.
/// </remarks>
/// <param name="columnId">The id of the column</param>
/// <param name="options">Options for changing the API response</param>
IObservable<ProjectCard> GetAll(int columnId, ApiOptions options);
/// <summary>
/// Gets all cards.
/// </summary>
/// <remarks>
/// See the <a href="https://developer.github.com/v3/repos/projects/#list-projects-cards">API documentation</a> for more information.
/// </remarks>
/// <param name="columnId">The id of the column</param>
/// <param name="request">Used to filter the list of project cards returned</param>
IObservable<ProjectCard> GetAll(int columnId, ProjectCardRequest request);
/// <summary>
/// Gets all cards.
/// </summary>
/// <remarks>
/// See the <a href="https://developer.github.com/v3/repos/projects/#list-projects-cards">API documentation</a> for more information.
/// </remarks>
/// <param name="columnId">The id of the column</param>
/// <param name="request">Used to filter the list of project cards returned</param>
/// <param name="options">Options for changing the API response</param>
IObservable<ProjectCard> GetAll(int columnId, ProjectCardRequest request, ApiOptions options);
/// <summary>
/// Gets a single card.
/// </summary>
/// <remarks>
/// See the <a href="https://developer.github.com/v3/repos/projects/#get-a-project-card">API documentation</a> for more information.
/// </remarks>
/// <param name="id">The id of the card</param>
[SuppressMessage("Microsoft.Naming", "CA1716:IdentifiersShouldNotMatchKeywords", MessageId = "Get")]
IObservable<ProjectCard> Get(long id);
/// <summary>
/// Creates a card.
/// </summary>
/// <remarks>
/// See the <a href="https://developer.github.com/v3/repos/projects/#create-a-project-card">API documentation</a> for more information.
/// </remarks>
/// <param name="columnId">The id of the column</param>
/// <param name="newProjectCard">The card to create</param>
IObservable<ProjectCard> Create(int columnId, NewProjectCard newProjectCard);
/// <summary>
/// Updates a card.
/// </summary>
/// <remarks>
/// See the <a href="https://developer.github.com/v3/repos/projects/#update-a-project-card">API documentation</a> for more information.
/// </remarks>
/// <param name="id">The id of the card</param>
/// <param name="projectCardUpdate">New values to update the card with</param>
IObservable<ProjectCard> Update(long id, ProjectCardUpdate projectCardUpdate);
/// <summary>
/// Deletes a card.
/// </summary>
/// <remarks>
/// See the <a href="https://developer.github.com/v3/repos/projects/#delete-a-project-card">API documentation</a> for more information.
/// </remarks>
/// <param name="id">The id of the card</param>
IObservable<bool> Delete(long id);
/// <summary>
/// Moves a card.
/// </summary>
/// <remarks>
/// See the <a href="https://developer.github.com/v3/repos/projects/#move-a-project-card">API documentation</a> for more information.
/// </remarks>
/// <param name="id">The id of the card</param>
/// <param name="position">The position to move the card</param>
IObservable<bool> Move(long id, ProjectCardMove position);
}
}