/// <summary>
/// Create a component,
/// More information <a href="https://docs.atlassian.com/jira/REST/cloud/#api/2/component-createComponent">here</a>
/// </summary>
/// <param name="jiraClient">IProjectDomain to bind the extension method to</param>
/// <param name="component">Component to create</param>
/// <param name="cancellationToken">CancellationToken</param>
/// <returns>Component with the details, like id</returns>
public static async Task <Component> CreateComponentAsync(this IProjectDomain jiraClient, Component component, CancellationToken cancellationToken = default)
{
Log.Debug().WriteLine("Creating component {0}", component.Name);
var componentUri = jiraClient.JiraRestUri.AppendSegments("component");
jiraClient.Behaviour.MakeCurrent();
var response = await componentUri.PostAsync <HttpResponse <Component, Error> >(component, cancellationToken).ConfigureAwait(false);
return(response.HandleErrors());
}
/// <summary>
/// Get component information
/// More information <a href="https://docs.atlassian.com/jira/REST/cloud/#api/2/component-getComponent">here</a>
/// </summary>
/// <param name="jiraClient">IProjectDomain to bind the extension method to</param>
/// <param name="componentId">long with ID of the component to retrieve</param>
/// <param name="cancellationToken">CancellationToken</param>
/// <returns>Component</returns>
public static async Task <Component> GetComponentAsync(this IProjectDomain jiraClient, long componentId, CancellationToken cancellationToken = default)
{
Log.Debug().WriteLine("Retrieving component with id {0}", componentId);
var componentUri = jiraClient.JiraRestUri.AppendSegments("component", componentId);
jiraClient.Behaviour.MakeCurrent();
var response = await componentUri.GetAsAsync <HttpResponse <Component, Error> >(cancellationToken).ConfigureAwait(false);
return(response.HandleErrors());
}
/// <summary>
/// Delete a component
/// More information <a href="https://docs.atlassian.com/jira/REST/cloud/#api/2/component-delete">here</a>
/// </summary>
/// <param name="jiraClient">IProjectDomain to bind the extension method to</param>
/// <param name="componentId">long with id of the component to delete</param>
/// <param name="cancellationToken">CancellationToken</param>
public static async Task DeleteComponentAsync(this IProjectDomain jiraClient, long componentId, CancellationToken cancellationToken = default)
{
Log.Debug().WriteLine("Deleting component {0}", componentId);
var componentUri = jiraClient.JiraRestUri.AppendSegments("component", componentId);
jiraClient.Behaviour.MakeCurrent();
var response = await componentUri.DeleteAsync <HttpResponse>(cancellationToken).ConfigureAwait(false);
response.HandleStatusCode(HttpStatusCode.NoContent);
}
/// <summary>
/// Get security level information
/// More information <a href="https://docs.atlassian.com/software/jira/docs/api/REST/8.5.3/#api/2/project/{projectKeyOrId}/securitylevel">here</a>
/// </summary>
/// <param name="jiraClient">IProjectDomain to bind the extension method to</param>
/// <param name="projectKey">project key</param>
/// <param name="cancellationToken">CancellationToken</param>
/// <returns>IEnumerable with SecurityLinks</returns>
public static async Task <IEnumerable <SecurityLevel> > GetSecurityLevelsAsync(this IProjectDomain jiraClient, string projectKey,
CancellationToken cancellationToken = default)
{
Log.Debug().WriteLine("Retrieving SecurityLevels for {0}", projectKey);
var securityLevelUri = jiraClient.JiraRestUri.AppendSegments("project", projectKey, "securitylevel");
jiraClient.Behaviour.MakeCurrent();
var response = await securityLevelUri.GetAsAsync <HttpResponse <SecurityLevels, Error> >(cancellationToken).ConfigureAwait(false);
return(response.HandleErrors().Levels);
}
/// <summary>
/// Retrieve the Avatar for the specified project
/// </summary>
/// <typeparam name="TBitmap">Type of the bitmap, e.g. Bitmap or BitmapSource</typeparam>
/// <param name="bitbucketClient">IProjectDomain to pin this extension method to</param>
/// <param name="projectKey">string with key of the project</param>
/// <param name="size">wanted size of the avatar</param>
/// <param name="cancellationToken">CancellationToken</param>
/// <returns>TBitmap</returns>
public static async Task <TBitmap> GetAvatarAsync <TBitmap>(this IProjectDomain bitbucketClient, string projectKey, int?size = null, CancellationToken cancellationToken = new CancellationToken())
where TBitmap : class
{
var projectAvatarUri = bitbucketClient.BitbucketApiUri.AppendSegments("projects", projectKey, "avatar.png");
if (size.HasValue)
{
projectAvatarUri = projectAvatarUri.ExtendQuery("s", size.Value);
}
bitbucketClient.Behaviour.MakeCurrent();
return(await projectAvatarUri.GetAsAsync <TBitmap>(cancellationToken).ConfigureAwait(false));
}
/// <summary>
/// Get projects information
/// See: https://docs.atlassian.com/jira/REST/latest/#d2e2779
/// </summary>
/// <param name="jiraClient">IProjectDomain to bind the extension method to</param>
/// <param name="projectKey">key of the project</param>
/// <param name="cancellationToken">CancellationToken</param>
/// <returns>ProjectDetails</returns>
public static async Task <Project> GetAsync(this IProjectDomain jiraClient, string projectKey, CancellationToken cancellationToken = default)
{
if (projectKey == null)
{
throw new ArgumentNullException(nameof(projectKey));
}
Log.Debug().WriteLine("Retrieving project {0}", projectKey);
var projectUri = jiraClient.JiraRestUri.AppendSegments("project", projectKey);
// Add the configurable expand values, if the value is not null or empty
if (JiraConfig.ExpandGetProject?.Length > 0)
{
projectUri = projectUri.ExtendQuery("expand", string.Join(",", JiraConfig.ExpandGetProject));
}
jiraClient.Behaviour.MakeCurrent();
var response = await projectUri.GetAsAsync <HttpResponse <Project, Error> >(cancellationToken).ConfigureAwait(false);
return(response.HandleErrors());
}
/// <summary>
/// Retrieve all projects which the current user is allowed to see
/// </summary>
/// <param name="bitbucketClient"></param>
/// <param name="pagingInfo">PagingInfo to enable paging, the Results object is of type PagingInfo</param>
/// <param name="cancellationToken">CancellationToken</param>
/// <returns>Results with projects</returns>
public static async Task <Results <Project> > GetAllAsync(this IProjectDomain bitbucketClient, PagingInfo pagingInfo = null, CancellationToken cancellationToken = default(CancellationToken))
{
var projectsUri = bitbucketClient.BitbucketApiUri.AppendSegments("projects");
if (pagingInfo != null)
{
if (pagingInfo.IsLastPage)
{
return(new Results <Project>()
{
IsLastPage = true,
Values = new List <Project>()
});
}
projectsUri = projectsUri.ExtendQuery("start", pagingInfo.NextPageStart);
projectsUri = projectsUri.ExtendQuery("limit", pagingInfo.Limit);
}
bitbucketClient.Behaviour.MakeCurrent();
var response = await projectsUri.GetAsAsync <HttpResponse <Results <Project>, ErrorList> >(cancellationToken).ConfigureAwait(false);
return(response.HandleErrors());
}
/// <summary>
/// Get all visible projects
/// More information <a href="https://docs.atlassian.com/jira/REST/latest/#d2e2779">here</a>
/// </summary>
/// <param name="jiraClient">IProjectDomain to bind the extension method to</param>
/// <param name="recent">
/// if this parameter is set then only projects recently accessed by the current user (if not logged
/// in then based on HTTP session) will be returned (maximum count limited to the specified number but no more than
/// 20).
/// </param>
/// <param name="cancellationToken">CancellationToken</param>
/// <returns>list of ProjectDigest</returns>
public static async Task <IList <ProjectDigest> > GetAllAsync(this IProjectDomain jiraClient, int?recent = null,
CancellationToken cancellationToken = default)
{
Log.Debug().WriteLine("Retrieving projects");
var projectsUri = jiraClient.JiraRestUri.AppendSegments("project");
if (recent.HasValue)
{
projectsUri = projectsUri.ExtendQuery("recent", recent);
}
// Add the configurable expand values, if the value is not null or empty
if (JiraConfig.ExpandGetProjects?.Length > 0)
{
projectsUri = projectsUri.ExtendQuery("expand", string.Join(",", JiraConfig.ExpandGetProjects));
}
jiraClient.Behaviour.MakeCurrent();
var response = await projectsUri.GetAsAsync <HttpResponse <IList <ProjectDigest>, Error> >(cancellationToken).ConfigureAwait(false);
return(response.HandleErrors());
}
/// <summary>
/// Retrieve the users who can create issues for the specified project
/// </summary>
/// <param name="jiraClient">IProjectDomain</param>
/// <param name="projectKey">string with the key of the project</param>
/// <param name="userpattern">optional string with a pattern to match the user to</param>
/// <param name="startAt">optional int with the start, used for paging</param>
/// <param name="maxResults">optional int with the maximum number of results, default is 50</param>
/// <param name="cancellationToken">CancellationToken</param>
/// <returns>IEnumerable with User</returns>
public static Task <IEnumerable <User> > GetIssueCreatorsAsync(this IProjectDomain jiraClient, string projectKey, string userpattern = null, int?startAt = null, int?maxResults = null, CancellationToken cancellationToken = default)
{
return(jiraClient.User.GetAssignableUsersAsync(userpattern, projectKey, startAt: startAt, maxResults: maxResults, cancellationToken: cancellationToken));
}
public ProjectController(IProjectDomain projectDomain)
{
_ProjectDomain = projectDomain;
}
public ApiProjectController(IProjectDomain projectDomain)
{
_projectDomain = projectDomain;
}
public ProjectApplication(IProjectDomain ProjectDomain, IMapper mapper, IAppLogger <ProjectApplication> logger)
{
_ProjectsDomain = ProjectDomain;
_mapper = mapper;
_logger = logger;
}
public ProjectsController()
{
kernel.Load(Assembly.GetExecutingAssembly());
db = kernel.Get <IDatabaseContext>();
domain = kernel.Get <IProjectDomain>();
}
