2013-05-14 08:33:31 -04:00
|
|
|
module API
|
2012-07-24 08:19:51 -04:00
|
|
|
class Issues < Grape::API
|
2016-11-07 09:15:14 -05:00
|
|
|
include PaginationParams
|
|
|
|
|
2012-07-24 08:19:51 -04:00
|
|
|
before { authenticate! }
|
|
|
|
|
2017-08-21 18:42:03 -04:00
|
|
|
helpers ::Gitlab::IssuableMetadata
|
|
|
|
|
2014-08-14 06:41:16 -04:00
|
|
|
helpers do
|
2016-10-26 04:08:58 -04:00
|
|
|
def find_issues(args = {})
|
|
|
|
args = params.merge(args)
|
|
|
|
|
|
|
|
args.delete(:id)
|
|
|
|
args[:milestone_title] = args.delete(:milestone)
|
2017-01-27 12:34:15 -05:00
|
|
|
args[:label_name] = args.delete(:labels)
|
2016-10-26 04:08:58 -04:00
|
|
|
|
2017-01-27 12:34:15 -05:00
|
|
|
issues = IssuesFinder.new(current_user, args).execute
|
2017-08-28 20:02:26 -04:00
|
|
|
.preload(:assignees, :labels, :notes, :timelogs)
|
2016-10-26 04:08:58 -04:00
|
|
|
|
|
|
|
issues.reorder(args[:order_by] => args[:sort])
|
2014-09-04 18:01:12 -04:00
|
|
|
end
|
|
|
|
|
2016-11-07 09:15:14 -05:00
|
|
|
params :issues_params do
|
|
|
|
optional :labels, type: String, desc: 'Comma-separated list of label names'
|
2016-10-26 04:08:58 -04:00
|
|
|
optional :milestone, type: String, desc: 'Milestone title'
|
2016-11-07 09:15:14 -05:00
|
|
|
optional :order_by, type: String, values: %w[created_at updated_at], default: 'created_at',
|
|
|
|
desc: 'Return issues ordered by `created_at` or `updated_at` fields.'
|
|
|
|
optional :sort, type: String, values: %w[asc desc], default: 'desc',
|
|
|
|
desc: 'Return issues sorted in `asc` or `desc` order.'
|
2017-01-04 04:07:00 -05:00
|
|
|
optional :milestone, type: String, desc: 'Return issues for a specific milestone'
|
2017-02-23 08:29:35 -05:00
|
|
|
optional :iids, type: Array[Integer], desc: 'The IID array of issues'
|
2017-03-30 21:11:12 -04:00
|
|
|
optional :search, type: String, desc: 'Search issues for text present in the title or description'
|
2017-06-13 17:02:35 -04:00
|
|
|
optional :created_after, type: DateTime, desc: 'Return issues created after the specified time'
|
|
|
|
optional :created_before, type: DateTime, desc: 'Return issues created before the specified time'
|
2017-07-20 16:44:48 -04:00
|
|
|
optional :author_id, type: Integer, desc: 'Return issues which are authored by the user with the given ID'
|
|
|
|
optional :assignee_id, type: Integer, desc: 'Return issues which are assigned to the user with the given ID'
|
2017-07-24 16:41:33 -04:00
|
|
|
optional :scope, type: String, values: %w[created-by-me assigned-to-me all],
|
2017-07-27 18:08:44 -04:00
|
|
|
desc: 'Return issues for the given scope: `created-by-me`, `assigned-to-me` or `all`'
|
2017-09-03 03:34:50 -04:00
|
|
|
optional :my_reaction_emoji, type: String, desc: 'Return issues reacted by the authenticated user by the given emoji'
|
2016-11-07 09:15:14 -05:00
|
|
|
use :pagination
|
|
|
|
end
|
2016-11-10 05:23:44 -05:00
|
|
|
|
2017-04-05 12:31:15 -04:00
|
|
|
params :issue_params_ce do
|
2016-11-07 09:15:14 -05:00
|
|
|
optional :description, type: String, desc: 'The description of an issue'
|
2017-05-04 08:11:15 -04:00
|
|
|
optional :assignee_ids, type: Array[Integer], desc: 'The array of user IDs to assign issue'
|
|
|
|
optional :assignee_id, type: Integer, desc: '[Deprecated] The ID of a user to assign issue'
|
2016-11-07 09:15:14 -05:00
|
|
|
optional :milestone_id, type: Integer, desc: 'The ID of a milestone to assign issue'
|
|
|
|
optional :labels, type: String, desc: 'Comma-separated list of label names'
|
2017-04-12 07:19:45 -04:00
|
|
|
optional :due_date, type: String, desc: 'Date string in the format YEAR-MONTH-DAY'
|
2016-11-07 09:15:14 -05:00
|
|
|
optional :confidential, type: Boolean, desc: 'Boolean parameter if the issue should be confidential'
|
2017-09-01 08:03:57 -04:00
|
|
|
optional :discussion_locked, type: Boolean, desc: " Boolean parameter indicating if the issue's discussion is locked"
|
2016-11-10 05:23:44 -05:00
|
|
|
end
|
2017-04-05 12:31:15 -04:00
|
|
|
|
|
|
|
params :issue_params do
|
|
|
|
use :issue_params_ce
|
|
|
|
end
|
2014-08-14 06:41:16 -04:00
|
|
|
end
|
|
|
|
|
2012-07-24 08:19:51 -04:00
|
|
|
resource :issues do
|
2016-11-07 09:15:14 -05:00
|
|
|
desc "Get currently authenticated user's issues" do
|
2017-03-06 06:48:10 -05:00
|
|
|
success Entities::IssueBasic
|
2016-11-07 09:15:14 -05:00
|
|
|
end
|
|
|
|
params do
|
|
|
|
optional :state, type: String, values: %w[opened closed all], default: 'all',
|
|
|
|
desc: 'Return opened, closed, or all issues'
|
|
|
|
use :issues_params
|
2017-07-24 16:41:33 -04:00
|
|
|
optional :scope, type: String, values: %w[created-by-me assigned-to-me all], default: 'created-by-me',
|
2017-07-27 18:08:44 -04:00
|
|
|
desc: 'Return issues for the given scope: `created-by-me`, `assigned-to-me` or `all`'
|
2016-11-07 09:15:14 -05:00
|
|
|
end
|
2012-07-24 08:19:51 -04:00
|
|
|
get do
|
2017-07-24 16:41:33 -04:00
|
|
|
issues = find_issues
|
2016-09-09 10:16:14 -04:00
|
|
|
|
2017-08-28 20:02:26 -04:00
|
|
|
options = {
|
|
|
|
with: Entities::IssueBasic,
|
|
|
|
current_user: current_user,
|
|
|
|
issuable_metadata: issuable_meta_data(issues, 'Issue')
|
|
|
|
}
|
2017-08-21 18:42:03 -04:00
|
|
|
|
|
|
|
present paginate(issues), options
|
2012-07-24 08:19:51 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2016-11-07 09:15:14 -05:00
|
|
|
params do
|
|
|
|
requires :id, type: String, desc: 'The ID of a group'
|
|
|
|
end
|
2017-08-31 07:44:49 -04:00
|
|
|
resource :groups, requirements: API::PROJECT_ENDPOINT_REQUIREMENTS do
|
2016-11-07 09:15:14 -05:00
|
|
|
desc 'Get a list of group issues' do
|
2017-03-06 06:48:10 -05:00
|
|
|
success Entities::IssueBasic
|
2016-11-07 09:15:14 -05:00
|
|
|
end
|
|
|
|
params do
|
2017-03-27 09:43:21 -04:00
|
|
|
optional :state, type: String, values: %w[opened closed all], default: 'all',
|
2016-11-07 09:15:14 -05:00
|
|
|
desc: 'Return opened, closed, or all issues'
|
|
|
|
use :issues_params
|
|
|
|
end
|
2016-06-07 18:01:54 -04:00
|
|
|
get ":id/issues" do
|
2016-10-26 04:08:58 -04:00
|
|
|
group = find_group!(params[:id])
|
2016-06-07 18:01:54 -04:00
|
|
|
|
2017-03-27 09:43:21 -04:00
|
|
|
issues = find_issues(group_id: group.id)
|
2016-09-09 10:16:14 -04:00
|
|
|
|
2017-08-28 20:02:26 -04:00
|
|
|
options = {
|
|
|
|
with: Entities::IssueBasic,
|
|
|
|
current_user: current_user,
|
|
|
|
issuable_metadata: issuable_meta_data(issues, 'Issue')
|
|
|
|
}
|
2017-08-21 18:42:03 -04:00
|
|
|
|
|
|
|
present paginate(issues), options
|
2016-06-07 18:01:54 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2016-11-10 05:23:44 -05:00
|
|
|
params do
|
|
|
|
requires :id, type: String, desc: 'The ID of a project'
|
|
|
|
end
|
2017-08-31 07:44:49 -04:00
|
|
|
resource :projects, requirements: API::PROJECT_ENDPOINT_REQUIREMENTS do
|
2017-01-18 11:48:16 -05:00
|
|
|
include TimeTrackingEndpoints
|
|
|
|
|
2016-11-07 09:15:14 -05:00
|
|
|
desc 'Get a list of project issues' do
|
2017-03-06 06:48:10 -05:00
|
|
|
success Entities::IssueBasic
|
2016-11-07 09:15:14 -05:00
|
|
|
end
|
|
|
|
params do
|
|
|
|
optional :state, type: String, values: %w[opened closed all], default: 'all',
|
|
|
|
desc: 'Return opened, closed, or all issues'
|
|
|
|
use :issues_params
|
|
|
|
end
|
2012-07-24 08:19:51 -04:00
|
|
|
get ":id/issues" do
|
2017-03-20 13:03:29 -04:00
|
|
|
project = find_project!(params[:id])
|
2016-10-12 08:08:57 -04:00
|
|
|
|
2016-10-26 04:08:58 -04:00
|
|
|
issues = find_issues(project_id: project.id)
|
2017-01-04 03:23:46 -05:00
|
|
|
|
2017-08-28 20:02:26 -04:00
|
|
|
options = {
|
|
|
|
with: Entities::IssueBasic,
|
|
|
|
current_user: current_user,
|
|
|
|
project: user_project,
|
|
|
|
issuable_metadata: issuable_meta_data(issues, 'Issue')
|
|
|
|
}
|
2017-08-21 18:42:03 -04:00
|
|
|
|
|
|
|
present paginate(issues), options
|
2012-07-24 08:19:51 -04:00
|
|
|
end
|
|
|
|
|
2016-11-07 09:15:14 -05:00
|
|
|
desc 'Get a single project issue' do
|
|
|
|
success Entities::Issue
|
|
|
|
end
|
|
|
|
params do
|
2017-02-25 03:44:09 -05:00
|
|
|
requires :issue_iid, type: Integer, desc: 'The internal ID of a project issue'
|
2016-11-07 09:15:14 -05:00
|
|
|
end
|
2017-07-25 05:35:45 -04:00
|
|
|
get ":id/issues/:issue_iid", as: :api_v4_project_issue do
|
2017-02-25 03:44:09 -05:00
|
|
|
issue = find_project_issue(params[:issue_iid])
|
2016-11-07 09:15:14 -05:00
|
|
|
present issue, with: Entities::Issue, current_user: current_user, project: user_project
|
2012-07-24 08:19:51 -04:00
|
|
|
end
|
|
|
|
|
2016-11-07 09:15:14 -05:00
|
|
|
desc 'Create a new project issue' do
|
|
|
|
success Entities::Issue
|
|
|
|
end
|
|
|
|
params do
|
|
|
|
requires :title, type: String, desc: 'The title of an issue'
|
|
|
|
optional :created_at, type: DateTime,
|
|
|
|
desc: 'Date time when the issue was created. Available only for admins and project owners.'
|
2017-03-10 03:19:12 -05:00
|
|
|
optional :merge_request_to_resolve_discussions_of, type: Integer,
|
2016-11-07 09:15:14 -05:00
|
|
|
desc: 'The IID of a merge request for which to resolve discussions'
|
2016-12-22 07:31:12 -05:00
|
|
|
optional :discussion_to_resolve, type: String,
|
2017-03-10 03:19:12 -05:00
|
|
|
desc: 'The ID of a discussion to resolve, also pass `merge_request_to_resolve_discussions_of`'
|
2016-11-07 09:15:14 -05:00
|
|
|
use :issue_params
|
|
|
|
end
|
2016-07-12 11:59:21 -04:00
|
|
|
post ':id/issues' do
|
2016-11-07 09:15:14 -05:00
|
|
|
# Setting created_at time only allowed for admins and project owners
|
|
|
|
unless current_user.admin? || user_project.owner == current_user
|
|
|
|
params.delete(:created_at)
|
|
|
|
end
|
2014-07-30 10:17:29 -04:00
|
|
|
|
2016-11-07 09:15:14 -05:00
|
|
|
issue_params = declared_params(include_missing: false)
|
2016-12-06 11:13:14 -05:00
|
|
|
|
2017-05-04 08:11:15 -04:00
|
|
|
issue_params = convert_parameters_from_legacy_format(issue_params)
|
|
|
|
|
2016-11-07 09:15:14 -05:00
|
|
|
issue = ::Issues::CreateService.new(user_project,
|
|
|
|
current_user,
|
|
|
|
issue_params.merge(request: request, api: true)).execute
|
2016-07-30 00:18:32 -04:00
|
|
|
if issue.spam?
|
2016-07-21 19:11:53 -04:00
|
|
|
render_api_error!({ error: 'Spam detected' }, 400)
|
|
|
|
end
|
2016-07-18 19:17:43 -04:00
|
|
|
|
2014-04-02 06:38:35 -04:00
|
|
|
if issue.valid?
|
2016-11-04 14:19:08 -04:00
|
|
|
present issue, with: Entities::Issue, current_user: current_user, project: user_project
|
2014-04-02 06:38:35 -04:00
|
|
|
else
|
2014-08-18 14:09:09 -04:00
|
|
|
render_validation_error!(issue)
|
2012-07-24 08:19:51 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2016-11-10 05:23:44 -05:00
|
|
|
desc 'Update an existing issue' do
|
|
|
|
success Entities::Issue
|
|
|
|
end
|
|
|
|
params do
|
2017-02-25 03:44:09 -05:00
|
|
|
requires :issue_iid, type: Integer, desc: 'The internal ID of a project issue'
|
2016-11-07 09:15:14 -05:00
|
|
|
optional :title, type: String, desc: 'The title of an issue'
|
|
|
|
optional :updated_at, type: DateTime,
|
|
|
|
desc: 'Date time when the issue was updated. Available only for admins and project owners.'
|
2016-12-22 03:41:53 -05:00
|
|
|
optional :state_event, type: String, values: %w[reopen close], desc: 'State of the issue'
|
2016-11-07 09:15:14 -05:00
|
|
|
use :issue_params
|
2017-08-31 06:38:32 -04:00
|
|
|
at_least_one_of :title, :description, :assignee_ids, :assignee_id, :milestone_id, :discussion_locked,
|
2016-11-07 09:15:14 -05:00
|
|
|
:labels, :created_at, :due_date, :confidential, :state_event
|
2016-11-10 05:23:44 -05:00
|
|
|
end
|
2017-02-25 03:44:09 -05:00
|
|
|
put ':id/issues/:issue_iid' do
|
|
|
|
issue = user_project.issues.find_by!(iid: params.delete(:issue_iid))
|
2015-06-26 09:55:56 -04:00
|
|
|
authorize! :update_issue, issue
|
2016-08-15 12:50:41 -04:00
|
|
|
|
2016-11-07 09:15:14 -05:00
|
|
|
# Setting created_at time only allowed for admins and project owners
|
|
|
|
unless current_user.admin? || user_project.owner == current_user
|
|
|
|
params.delete(:updated_at)
|
|
|
|
end
|
2016-07-15 10:21:53 -04:00
|
|
|
|
2017-02-14 14:07:11 -05:00
|
|
|
update_params = declared_params(include_missing: false).merge(request: request, api: true)
|
|
|
|
|
2017-05-04 08:11:15 -04:00
|
|
|
update_params = convert_parameters_from_legacy_format(update_params)
|
|
|
|
|
2016-11-07 09:15:14 -05:00
|
|
|
issue = ::Issues::UpdateService.new(user_project,
|
|
|
|
current_user,
|
2017-02-14 14:07:11 -05:00
|
|
|
update_params).execute(issue)
|
|
|
|
|
|
|
|
render_spam_error! if issue.spam?
|
2013-06-11 11:15:18 -04:00
|
|
|
|
2014-04-02 06:54:41 -04:00
|
|
|
if issue.valid?
|
2016-11-04 14:19:08 -04:00
|
|
|
present issue, with: Entities::Issue, current_user: current_user, project: user_project
|
2014-04-02 06:54:41 -04:00
|
|
|
else
|
2014-08-18 14:09:09 -04:00
|
|
|
render_validation_error!(issue)
|
2012-07-24 08:19:51 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2016-11-07 09:15:14 -05:00
|
|
|
desc 'Move an existing issue' do
|
|
|
|
success Entities::Issue
|
|
|
|
end
|
|
|
|
params do
|
2017-02-25 03:44:09 -05:00
|
|
|
requires :issue_iid, type: Integer, desc: 'The internal ID of a project issue'
|
2016-11-07 09:15:14 -05:00
|
|
|
requires :to_project_id, type: Integer, desc: 'The ID of the new project'
|
|
|
|
end
|
2017-02-25 03:44:09 -05:00
|
|
|
post ':id/issues/:issue_iid/move' do
|
|
|
|
issue = user_project.issues.find_by(iid: params[:issue_iid])
|
2016-11-07 09:15:14 -05:00
|
|
|
not_found!('Issue') unless issue
|
2016-04-07 08:07:17 -04:00
|
|
|
|
2016-11-07 09:15:14 -05:00
|
|
|
new_project = Project.find_by(id: params[:to_project_id])
|
|
|
|
not_found!('Project') unless new_project
|
2016-04-07 08:07:17 -04:00
|
|
|
|
|
|
|
begin
|
|
|
|
issue = ::Issues::MoveService.new(user_project, current_user).execute(issue, new_project)
|
2016-11-04 14:19:08 -04:00
|
|
|
present issue, with: Entities::Issue, current_user: current_user, project: user_project
|
2016-04-07 08:07:17 -04:00
|
|
|
rescue ::Issues::MoveService::MoveError => error
|
|
|
|
render_api_error!(error.message, 400)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2016-11-07 09:15:14 -05:00
|
|
|
desc 'Delete a project issue'
|
|
|
|
params do
|
2017-02-25 03:44:09 -05:00
|
|
|
requires :issue_iid, type: Integer, desc: 'The internal ID of a project issue'
|
2016-11-07 09:15:14 -05:00
|
|
|
end
|
2017-02-25 03:44:09 -05:00
|
|
|
delete ":id/issues/:issue_iid" do
|
|
|
|
issue = user_project.issues.find_by(iid: params[:issue_iid])
|
2016-11-07 09:15:14 -05:00
|
|
|
not_found!('Issue') unless issue
|
2016-02-26 03:55:43 -05:00
|
|
|
|
2016-03-21 09:12:52 -04:00
|
|
|
authorize!(:destroy_issue, issue)
|
2017-03-01 08:35:48 -05:00
|
|
|
|
2017-03-02 07:14:13 -05:00
|
|
|
destroy_conditionally!(issue)
|
2012-07-24 08:19:51 -04:00
|
|
|
end
|
2017-04-12 07:38:00 -04:00
|
|
|
|
|
|
|
desc 'List merge requests closing issue' do
|
|
|
|
success Entities::MergeRequestBasic
|
|
|
|
end
|
|
|
|
params do
|
|
|
|
requires :issue_iid, type: Integer, desc: 'The internal ID of a project issue'
|
|
|
|
end
|
|
|
|
get ':id/issues/:issue_iid/closed_by' do
|
|
|
|
issue = find_project_issue(params[:issue_iid])
|
|
|
|
|
|
|
|
merge_request_ids = MergeRequestsClosingIssues.where(issue_id: issue).select(:merge_request_id)
|
|
|
|
merge_requests = MergeRequestsFinder.new(current_user, project_id: user_project.id).execute.where(id: merge_request_ids)
|
|
|
|
|
|
|
|
present paginate(merge_requests), with: Entities::MergeRequestBasic, current_user: current_user, project: user_project
|
|
|
|
end
|
2017-07-05 10:27:32 -04:00
|
|
|
|
|
|
|
desc 'Get the user agent details for an issue' do
|
|
|
|
success Entities::UserAgentDetail
|
|
|
|
end
|
|
|
|
params do
|
|
|
|
requires :issue_iid, type: Integer, desc: 'The internal ID of a project issue'
|
|
|
|
end
|
|
|
|
get ":id/issues/:issue_iid/user_agent_detail" do
|
|
|
|
authenticated_as_admin!
|
|
|
|
|
|
|
|
issue = find_project_issue(params[:issue_iid])
|
|
|
|
|
|
|
|
return not_found!('UserAgentDetail') unless issue.user_agent_detail
|
|
|
|
|
2017-07-06 09:19:14 -04:00
|
|
|
present issue.user_agent_detail, with: Entities::UserAgentDetail
|
2017-07-05 10:27:32 -04:00
|
|
|
end
|
2012-07-24 08:19:51 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|