public async Task <IteratorBasedPage <PullRequest> > GetPullRequestsPage(string repositoryName, string ownerName, int page, int limit = 50,
IPullRequestQueryBuilder builder = null)
{
var url = EnterpriseApiUrls.PullRequests(ownerName, repositoryName);
var request = new YouTrackRestRequest(url, Method.GET);
if (builder != null)
{
foreach (var param in builder.GetQueryParameters())
{
request.AddQueryParameter(param.Key, param.Value);
}
}
request.AddQueryParameter("limit", limit.ToString()).AddQueryParameter("start", ((page - 1) * limit).ToString());
var res = (await RestClient.ExecuteTaskAsync <EnterpriseIteratorBasedPage <EnterprisePullRequest> >(request)).Data;
return(new IteratorBasedPage <PullRequest>()
{
Values = res.Values.MapTo <List <PullRequest> >(),
Size = res.Size,
Next = res.NextPageStart.ToString(),
});
}
/// <summary>
/// Updates an issue on the server in a specific project.
/// </summary>
/// <remarks>Uses the REST API <a href="https://www.jetbrains.com/help/youtrack/standalone/Update-an-Issue.html">Update an Issue</a>.</remarks>
/// <param name="issueId">Id of the issue to update.</param>
/// <param name="summary">Updated summary of the issue.</param>
/// <param name="description">Updated description of the issue.</param>
/// <exception cref="T:System.ArgumentNullException">When the <paramref name="issueId"/> is null or empty.</exception>
/// <exception cref="T:YouTrackErrorException">When the call to the remote YouTrack server instance failed and YouTrack reported an error message.</exception>
/// <exception cref="T:System.Net.HttpRequestException">When the call to the remote YouTrack server instance failed.</exception>
public async Task UpdateIssue(string issueId, string summary = null, string description = null)
{
if (string.IsNullOrEmpty(issueId))
{
throw new ArgumentNullException(nameof(issueId));
}
if (summary == null && description == null)
{
return;
}
var url = IssuesUrls.UpdateIssue(issueId);
var request = new YouTrackRestRequest(url, Method.POST);
if (!string.IsNullOrEmpty(summary))
{
request.AddQueryParameter("summary", WebUtility.UrlEncode(summary));
}
if (!string.IsNullOrEmpty(description))
{
request.AddQueryParameter("description", WebUtility.UrlEncode(description));
}
request.AddHeader("Content-Type", "multipart/form-data");
var response = await RestClient.ExecuteTaskAsync(request);
}
/// <summary>
/// Applies a command to a specific issue on the server.
/// </summary>
/// <remarks>Uses the REST API <a href="https://www.jetbrains.com/help/youtrack/standalone/Apply-Command-to-an-Issue.html">Apply Command to an Issue</a>.</remarks>
/// <param name="issueId">Id of the issue to apply the command to.</param>
/// <param name="command">The command to apply. A command might contain a string of attributes and their values - you can change multiple fields with one complex command.</param>
/// <param name="comment">A comment to add to an issue.</param>
/// <param name="disableNotifications">When <value>true</value>, no notifications about changes made with the specified command will be sent. Defaults to <value>false</value>.</param>
/// <param name="runAs">Login name for a user on whose behalf the command should be applied.</param>
/// <exception cref="T:System.ArgumentNullException">When the <paramref name="issueId"/> or <paramref name="command"/> is null or empty.</exception>
/// <exception cref="T:YouTrackErrorException">When the call to the remote YouTrack server instance failed and YouTrack reported an error message.</exception>
/// <exception cref="T:System.Net.HttpRequestException">When the call to the remote YouTrack server instance failed.</exception>
public async Task ApplyCommand(string issueId, string command, string comment = null,
bool disableNotifications = false, string runAs = null)
{
if (string.IsNullOrEmpty(issueId))
{
throw new ArgumentNullException(nameof(issueId));
}
if (string.IsNullOrEmpty(command))
{
throw new ArgumentNullException(nameof(command));
}
var url = IssuesUrls.ApplyCommand(issueId);
var request = new YouTrackRestRequest(url, Method.POST);
request.AddQueryParameter("command", WebUtility.UrlEncode(command));
if (!string.IsNullOrEmpty(comment))
{
request.AddQueryParameter("comment", WebUtility.UrlEncode(comment));
}
if (disableNotifications)
{
request.AddQueryParameter("disableNotifications", WebUtility.UrlEncode("true"));
}
if (!string.IsNullOrEmpty(runAs))
{
request.AddQueryParameter("runAs", WebUtility.UrlEncode(runAs));
}
request.AddHeader("Content-Type", "multipart/form-data");
var response = await RestClient.ExecuteTaskAsync(request);
if (response.StatusCode == HttpStatusCode.BadRequest)
{
//TODO THE implement that.
// Try reading the error message
//var responseJson = response.
//if (responseJson["value"] != null)
//{
// throw new YouTrackErrorException(responseJson["value"].Value<string>());
//}
//else
//{
// throw new YouTrackErrorException(Strings.Exception_UnknownError);
//}
}
}
private async Task <string> GetAllLines(string url) //todo temporary for test
{
var result = new EnterpriseBrowsePage()
{
Lines = new List <EnterpriseBrowseText>()
};
IRestResponse <EnterpriseBrowsePage> response;
ulong pageNumber = 0;
do
{
var request = new YouTrackRestRequest(url, Method.GET);
request.AddQueryParameter("start", pageNumber.ToString());
response = await RestClient.ExecuteTaskAsync <EnterpriseBrowsePage>(request);
if (response.Data?.Lines == null)
{
break;
}
result.Lines.AddRange(response.Data.Lines);
pageNumber += response.Data.Size.Value;
} while (response.Data?.IsLastPage == false);
return(string.Join(Environment.NewLine, result.Lines.Select(x => x.Text)));
}
/// <summary>
/// Attaches a file to an issue on the server.
/// </summary>
/// <remarks>Uses the REST API <a href="https://www.jetbrains.com/help/youtrack/standalone/Attach-File-to-an-Issue.html">Attach File to an Issue</a>.</remarks>
/// <param name="issueId">Id of the issue to attach the file to.</param>
/// <param name="attachmentName">Filename for the attachment.</param>
/// <param name="attachmentStream">The <see cref="T:System.IO.Stream"/> to attach.</param>
/// <param name="group">Attachment visibility group.</param>
/// <param name="author">Creator of the attachment. Note to define author the 'Low-Level Administration' permission is required.</param>
/// <exception cref="T:System.ArgumentNullException">When the <paramref name="issueId"/>, <paramref name="attachmentName"/> or <paramref name="attachmentStream"/> is null or empty.</exception>
/// <exception cref="T:System.Net.HttpRequestException">When the call to the remote YouTrack server instance failed.</exception>
public async Task AttachFileToIssue(string issueId, IAttachFileQueryBuilder builder, Stream attachmentStream)
{
if (string.IsNullOrEmpty(issueId))
{
throw new ArgumentNullException(nameof(issueId));
}
if (attachmentStream == null)
{
throw new ArgumentNullException(nameof(attachmentStream));
}
var url = IssuesUrls.AttachFileToIssue(issueId);
var request = new YouTrackRestRequest(url, Method.POST);
if (builder != null)
{
foreach (var param in builder.GetQueryParameters())
{
request.AddQueryParameter(param.Key, param.Value);
}
}
request.AddHeader("Content-Type", "multipart/form-data");
var streamContent = new StreamContent(attachmentStream);
streamContent.Headers.ContentDisposition = new ContentDispositionHeaderValue("form-data")
{
FileName = builder.GetAttachmentName(),
Name = builder.GetAttachmentName()
};
var content = new MultipartFormDataContent
{
streamContent
};
request.AddParameter("application/json; charset=utf-8", request.JsonSerializer.Serialize(content),
ParameterType.RequestBody);
var response = await RestClient.ExecuteTaskAsync(request);
//var response = await client.PostAsync($"rest/issue/{issueId}/attachment?{query}", content);
if (response.StatusCode == HttpStatusCode.BadRequest)
{
//TODO THE
// Try reading the error message
//var responseJson = JObject.Parse(await response.Content.ReadAsStringAsync());
//if (responseJson["value"] != null)
//{
// throw new YouTrackErrorException(responseJson["value"].Value<string>());
//}
//else
//{
// throw new YouTrackErrorException(Strings.Exception_UnknownError);
//}
}
}
public async Task <IteratorBasedPage <PullRequest> > GetPullRequestsPage(string repositoryName, string ownerName, int page, int limit = 50,
IPullRequestQueryBuilder builder = null)
{
var url = ApiUrls.PullRequests(ownerName, repositoryName);
var request = new YouTrackRestRequest(url, Method.GET);
if (builder != null)
{
foreach (var param in builder.GetQueryParameters())
{
request.AddQueryParameter(param.Key, param.Value);
}
}
request.AddQueryParameter("pagelen", limit.ToString()).AddQueryParameter("page", page.ToString());
var response = await RestClient.ExecuteTaskAsync <IteratorBasedPage <PullRequest> >(request);
return(response.Data);
}
/// <summary>
/// Get a list of issues that match one or more search queries.
/// </summary>
/// <remarks>Uses the REST API <a href="https://www.jetbrains.com/help/youtrack/standalone/Get-the-List-of-Issues.html">Get Issues</a>.</remarks>
/// <returns>The <see cref="Issue" /> list that matches the requested</returns>
public async Task <IEnumerable <Issue> > GetListIssues(IIssueQueryBuilder builder = null)
{
var url = IssuesUrls.GetIssues();
var request = new YouTrackRestRequest(url, Method.GET);
if (builder != null)
{
foreach (var param in builder.GetQueryParameters())
{
request.AddQueryParameter(param.Key, param.Value);
}
}
var response = await RestClient.ExecuteTaskAsync <IssueCollectionWrapper>(request);
return(response.Data.Issues);
}
public async Task <IEnumerable <UserShort> > GetRepositoryUsers(string repositoryName, string ownerName, string filter)
{
var url = ApiUrls.Mentions(ownerName, repositoryName);
var query = new QueryString()
{
{ "term", filter }
};
var request = new YouTrackRestRequest(url, Method.GET);
foreach (var par in query)
{
request.AddQueryParameter(par.Key, par.Value);
}
var response = await _webClient.ExecuteTaskAsync <List <UserShort> >(request);
return(response.Data);
}
/// <summary>
/// Get all issues by project
/// </summary>
///<remarks>Uses the REST API <a href="https://www.jetbrains.com/help/youtrack/standalone/Get-Issues-in-a-Project.html">Get Issues in a Project</a>.</remarks>
/// <param name="projectId">ProjectID of a project to get issues from.</param>
/// <returns>The <see cref="Issue" /> list that matches the requested <paramref name="projectId"/>.</returns>
/// <exception cref="T:System.ArgumentNullException">When the <paramref name="projectId"/> is null or empty.</exception>
/// <exception cref="T:System.Net.HttpRequestException">When the call to the remote YouTrack server instance failed.</exception>
public async Task <IEnumerable <Issue> > GetIssuesByProject(string projectId, IIssueQueryBuilder builder = null)
{
if (string.IsNullOrEmpty(projectId))
{
throw new ArgumentNullException(nameof(projectId));
}
var url = IssuesUrls.GetIssuesByProject(projectId);
var request = new YouTrackRestRequest(url, Method.GET);
if (builder != null)
{
foreach (var param in builder.GetQueryParameters())
{
request.AddQueryParameter(param.Key, param.Value);
}
}
var response = await RestClient.ExecuteTaskAsync <List <Issue> >(request);
return(response.Data);
}
public async Task <IEnumerable <FileDiff> > GetCommitsDiff(string repoName, string owner, string fromCommit, string toCommit)
{
var url = EnterpriseApiUrls.CommitsDiff(owner, repoName);
var queryString = new QueryString()
{
{ "from", fromCommit },
{ "to", toCommit },
};
var request = new YouTrackRestRequest(url, Method.GET);
foreach (var param in queryString)
{
request.AddQueryParameter(param.Key, param.Value);
}
var response = await RestClient.ExecuteTaskAsync <EnterpriseDiffResponse>(request);
var fileDiffs = ParseFileDiffs(response);
return(fileDiffs);
}
/// <summary>
/// Creates an issue on the server in a specific project.
/// </summary>
/// <remarks>Uses the REST API <a href="https://www.jetbrains.com/help/youtrack/standalone/Create-New-Issue.html">Create New Issue</a>.</remarks>
/// <param name="projectId">Id of the project to create an issue in.</param>
/// <param name="issue">The <see cref="Issue" /> to create. At the minimum needs the Summary field populated.</param>
/// <returns>The newly created <see cref="Issue" />'s id on the server.</returns>
/// <exception cref="T:System.ArgumentNullException">When the <paramref name="projectId"/> is null or empty.</exception>
/// <exception cref="T:YouTrackErrorException">When the call to the remote YouTrack server instance failed and YouTrack reported an error message.</exception>
/// <exception cref="T:System.Net.HttpRequestException">When the call to the remote YouTrack server instance failed.</exception>
public async Task <string> CreateIssue(string projectId, Issue issue)
{
if (string.IsNullOrEmpty(projectId))
{
throw new ArgumentNullException(nameof(projectId));
}
//TODO THE queryBuilder ?
var url = IssuesUrls.CreateIssue();
var request = new YouTrackRestRequest(url, Method.PUT);
request.AddQueryParameter("project", projectId);
if (!string.IsNullOrEmpty(issue.Summary))
{
request.AddQueryParameter("summary", WebUtility.UrlEncode(issue.Summary));
}
if (!string.IsNullOrEmpty(issue.Description))
{
request.AddQueryParameter("description", WebUtility.UrlEncode(issue.Summary));
}
request.AddHeader("Content-Type", "multipart/form-data");
var response = await RestClient.ExecuteTaskAsync(request);
// Extract issue id from Location header response
var marker = "rest/issue/";
var locationHeader =
response.Headers.FirstOrDefault(h => h.Name.Equals("Location", StringComparison.OrdinalIgnoreCase));
var issueId =
locationHeader.Value.ToString().Substring(
locationHeader.Value.ToString().IndexOf(marker, StringComparison.OrdinalIgnoreCase) +
marker.Length);
// For every custom field, apply a command
var customFields = issue.Fields
.Where(field => !ReservedFields.Contains(field.Name.ToLower()))
.ToDictionary(field => field.Name, field => field.Value);
foreach (var customField in customFields)
{
if (!(customField.Value is string) && customField.Value is System.Collections.IEnumerable enumerable)
{
await ApplyCommand(issueId, $"{customField.Key} {string.Join(" ", enumerable.OfType<string>())}",
string.Empty);
}
else if (customField.Value is DateTime dateTime)
{
await ApplyCommand(issueId, $"{customField.Key} {dateTime:s}", string.Empty);
}
else if (customField.Value is DateTimeOffset dateTimeOffset)
{
await ApplyCommand(issueId, $"{customField.Key} {dateTimeOffset:s}", string.Empty);
}
else
{
await ApplyCommand(issueId, $"{customField.Key} {customField.Value}", string.Empty);
}
}
// Add comments?
foreach (var issueComment in issue.Comments)
{
await ApplyCommand(issueId, "comment", issueComment.Text, runAs : issueComment.Author);
}
// Add tags?
foreach (var issueTag in issue.Tags)
{
await ApplyCommand(issueId, $"tag {issueTag.Value}");
}
return(issueId);
}