def delete(self, project_pk, tkt_id, comment_id):
"""
Delete a Comment
:param project_pk: Project ID
:param tkt_id: Ticket ID
:param comment_id: Comment ID
:return: Nothing
"""
get_project_request(project_pk)
get_ticket_request(tkt_id)
comment = Comment.get_by_id(comment_id)
if not comment:
raise api_errors.MissingResource(api_errors.INVALID_COMMENT_MSG)
if comment.who.id != current_user.id:
raise api_errors.ForbiddenRequest()
# save activity
save_notification(project_pk=project_pk,
verb='delete_comment',
data={
"comment": comment.to_dict(),
"ticket": comment.ticket.to_dict()
})
comment.delete()
return {}, 204
def put(self, project_pk, tkt_id, pm_id):
"""
Assign a member to a ticket, this will update the ticket
:param project_pk: Project ID
:param tkt_id: Ticket ID
:param member_id: Member ID
:return: Ticket Object
"""
get_project_request(project_pk)
tkt = get_ticket_request(tkt_id)
pm = ProjectMember.get_by_id(pm_id)
if not pm:
raise api_errors.MissingResource(
api_errors.INVALID_PROJECT_MEMBER_MSG)
if pm in tkt.assigned_to:
raise api_errors.InvalidAPIUsage(
api_errors.INVALID_ALREADY_ADDED_MSG)
tkt.assigned_to.append(pm)
tkt.save()
# save activity
save_notification(project_pk=project_pk,
verb='new_assigment',
data=tkt.to_dict())
return tkt, 200
def put(self, project_pk, tkt_id, comment_id):
"""
Update a comment
:param project_pk: Project ID
:param tkt_id: Ticket ID
:param comment_id: Comment ID
:return: Updated Comment
"""
get_project_request(project_pk)
get_ticket_request(tkt_id)
comment = Comment.get_by_id(comment_id)
if not comment:
raise api_errors.MissingResource(api_errors.INVALID_COMMENT_MSG)
data = request.get_json(silent=True)
if not data:
raise api_errors.InvalidAPIUsage(api_errors.INVALID_JSON_BODY_MSG)
if comment.who.id != current_user.id:
raise api_errors.ForbiddenRequest()
comment.comment = data.get('comment')
comment.save()
save_notification(project_pk=project_pk,
verb='update_comment',
data={
"comment": comment.to_dict(),
"ticket": comment.ticket.to_dict()
})
return comment, 200
def post(self, project_pk, tkt_id):
"""
Add Attachment to Ticket
:param project_pk: Project ID
:param tkt_id: Ticket ID
:return: Created Attachment
"""
get_project_request(project_pk)
file_item = request.files.get('file')
if not file_item:
raise api_errors.InvalidAPIUsage(payload=dict(
file=api_errors.REQUIRED_MSG))
data = json.loads(request.form.get('data'))
if not data:
raise api_errors.InvalidAPIUsage(payload=dict(
data=api_errors.REQUIRED_MSG))
ticket = get_ticket_request(tkt_id)
att = Attachment()
att.name = data.get('name')
att.size = data.get('size')
att.type = data.get('type')
att.data = base64.b64encode(file_item.stream.read())
att.save()
ticket.files.append(att)
ticket.save()
# save activity
save_notification(project_pk=project_pk,
verb='new_attachment',
data=att.to_dict())
return att, 200
def post(self, project_pk):
"""
Move Ticket
:param project_pk: Project ID
:return:
"""
get_project_request(project_pk)
data = request.get_json(silent=True)
if not data:
raise api_errors.InvalidAPIUsage(api_errors.INVALID_JSON_BODY_MSG)
source = data.get('source')
destiny = data.get('dest')
if not source or not destiny:
raise api_errors.InvalidAPIUsage(payload={
'source': api_errors.REQUIRED_MSG,
'dest': api_errors.REQUIRED_MSG
})
remove_from_sprint = False
sprint_id = None
ticket_id = None
if source.get('project_id'):
sprint_id = destiny.get('sprint_id')
ticket_id = source.get('ticket_id')
elif source.get('sprint_id') and destiny.get('sprint_id'):
sprint_id = destiny.get('sprint_id')
ticket_id = source.get('ticket_id')
elif source.get('sprint_id') and destiny.get('project_id'):
sprint_id = source.get('sprint_id')
ticket_id = source.get('ticket_id')
remove_from_sprint = True
sprint = get_sprint_request(sprint_id)
ticket = get_ticket_request(ticket_id)
if remove_from_sprint:
SprintTicketOrder.inactivate_spo(sprint, ticket)
Ticket.order_items(destiny.get('order'))
else:
SprintTicketOrder.inactivate_spo(sprint, ticket)
tkt_ord_sprint = SprintTicketOrder()
tkt_ord_sprint.sprint = sprint
tkt_ord_sprint.ticket = ticket
tkt_ord_sprint.ticket_repr = ticket.to_dict()
tkt_ord_sprint.save()
SprintTicketOrder.order_items(destiny.get('order'), sprint)
# save activity
save_notification(project_pk=project_pk,
verb='ticket_movement',
data=data)
return data, 200
def put(self, project_pk, tkt_id):
"""
Update Ticket
:param project_pk: Project ID
:param tkt_id: Ticket ID
:return: updated Ticket Resource
"""
get_project_request(project_pk)
tkt = get_ticket_request(tkt_id)
data = request.get_json(silent=True)
if not data:
raise api_errors.InvalidAPIUsage(api_errors.INVALID_JSON_BODY_MSG)
tkt.description = data.get('description', tkt.description)
tkt.points = data.get('points', tkt.points)
tkt.title = data.get('title', tkt.title)
tkt.labels = data.get('labels', tkt.labels)
tkt.type = data.get('type', tkt.type)
tkt.closed = data.get('closed', tkt.closed)
if 'related_tickets_data' in data:
for tkt_rel_data in data.get('related_tickets_data'):
tkt_rel = Ticket.get_by_id(tkt_rel_data.get('value'))
if tkt_rel:
rt = TicketDependency()
rt.ticket = tkt_rel
rt.type = tkt_rel_data.get('type', 'R')
rt.save()
tkt.related_tickets.append(rt)
tkt.save()
if data.get('sprint'):
sprint = Sprint.get_by_id(data.get('sprint')['pk'])
if sprint:
spo = SprintTicketOrder.get_active_sprint_ticket(sprint, tkt)
if not spo:
# remove old data if this already exists
spo = SprintTicketOrder(sprint=sprint, ticket=tkt)
spo.ticket_repr = tkt.to_dict()
spo.order = SprintTicketOrder.get_next_order_index(
sprint.id)
spo.save()
else:
spo = SprintTicketOrder.get_active_ticket(tkt)
if spo:
spo.ticket_repr = tkt.to_dict()
spo.save()
# save activity
save_notification(project_pk=project_pk,
verb='update_ticket',
data=tkt.to_dict())
return tkt, 200
def get(self, project_pk, tkt_id):
"""
Get the list of comments
:param project_pk:
:param tkt_id:
:return:
"""
get_project_request(project_pk)
get_ticket_request(tkt_id)
return Comment.get_by_ticket(tkt_id), 200
def get(self, project_pk, tkt_id):
"""
Get a Ticket Instance
:param project_pk: Project ID
:param tkt_id: Ticket ID
:return: Ticket Resource
"""
get_project_request(project_pk)
tkt = get_ticket_request(tkt_id)
return tkt, 200
def get(self, project_pk, sp_id):
"""
Get a Sprint Instance
:param project_pk: Project ID
:param sp_id: Sprint ID
:return: Sprint Object
"""
get_project_request(project_pk)
sp = get_sprint_request(sp_id)
return sp, 200
def get(self, project_pk, tkt_id, att_id):
"""
Get an Attachment
:param project_pk: Project ID
:param tkt_id: Ticket ID
:param att_id: Attachment ID
:return: Attachment
"""
get_project_request(project_pk)
get_ticket_request(tkt_id)
att = Attachment.get_by_id(att_id)
if not att:
raise api_errors.MissingResource(api_errors.INVALID_ATTACHMENT_MSG)
return att, 200
def delete(self, project_pk, tkt_id):
"""
Delete Ticket Resource
:param project_pk: Project ID
:param tkt_id: Ticket ID
:return: Nothing
"""
get_project_request(project_pk)
tkt = get_ticket_request(tkt_id)
# save activity
save_notification(project_pk=project_pk,
verb='delete_ticket',
data=tkt.to_dict())
tkt.delete()
return {}, 204
def post(self, project_pk, column):
"""
Order Tickets in Columns
:param project_pk: Project ID
:param column: Column ID
:return: Order
"""
data = request.get_json(silent=True)
if not data:
raise api_errors.InvalidAPIUsage(api_errors.INVALID_JSON_BODY_MSG)
project = get_project_request(project_pk)
col = Column.get_by_id(column)
if not col:
raise api_errors.MissingResource(api_errors.INVALID_COLUMN_MSG)
if project.project_type == 'S':
sprint = get_sprint_request(data.get('sprint'))
TicketCT.order_items(data.get('order'), sprint=sprint)
else:
TicketCT.order_items(data.get('order'))
# save activity
save_notification(project_pk=project_pk,
verb='ticket_column_order',
data=data)
return data, 200
def delete(self, project_pk, sp_id):
"""
Delete Sprint
:param project_pk: Project ID
:param sp_id: Sprint ID
:return: Nothing
"""
get_project_request(project_pk)
sp = get_sprint_request(sp_id)
# save activity
save_notification(project_pk=project_pk,
verb='delete_sprint',
data=sp.to_dict())
sp.delete()
return {}, 204
def get(self, project_pk):
"""
Get List of archived sprints
:param project_pk: Project ID
:return: List of sprints
"""
prj = get_project_request(project_pk)
return Sprint.get_archived_sprints(prj).to_json(), 200
def post(self, project_pk):
"""
Update Order
"""
get_project_request(project_pk)
data = request.get_json(silent=True)
if not data:
raise api_errors.InvalidAPIUsage(api_errors.INVALID_JSON_BODY_MSG)
Ticket.order_items(data)
# save activity
save_notification(project_pk=project_pk,
verb='backlog_order',
data=data)
return data, 200
def get(self, project_pk):
"""
Get List of sprints
:param project_pk: Project ID
:return: List of sprints
"""
prj = get_project_request(project_pk)
return Sprint.objects(project=prj).order_by('order').to_json()
def get(self, project_pk):
"""
Get List of Sprints by Project
:param project_pk: Project ID
:return:
"""
prj = get_project_request(project_pk)
return Sprint.get_by_project_not_finalized(prj), 200
def delete(self, project_pk, tkt_id, rtkt_id):
"""
Delete Related Ticket
:param project_pk: Project ID
:param tkt_id: Ticket ID
:param rtkt_id: Related Ticket ID
:return:
"""
get_project_request(project_pk)
get_ticket_request(tkt_id)
rtkt = TicketDependency.get_by_id(rtkt_id)
if not rtkt:
raise api_errors.MissingResource(api_errors.INVALID_TICKET_MSG)
Ticket.remove_related_ticket(tkt_id, rtkt)
return {}, 204
def get(self, project_pk):
"""
Get Closed tickets
:param project_pk: Project ID
:return: List of tickets closed
"""
prj = get_project_request(project_pk)
return Ticket.get_closed_tickets(prj), 200
def get(self, project_pk, tkt_id, comment_id):
"""
Get a Comment Resource
:param project_pk: Project ID
:param tkt_id: Ticket ID
:param comment_id: Comment ID
:return:
"""
get_project_request(project_pk)
get_ticket_request(tkt_id)
comment = Comment.get_by_id(comment_id)
if not comment:
api_errors.MissingResource(api_errors.INVALID_COMMENT_MSG)
return comment, 200
def get(self, project_pk):
"""
Get Active Sprint by Project
:param project_pk: ProjectID
:return: Sprint Object
"""
prj = get_project_request(project_pk)
sprint = Sprint.get_active_sprint(prj)
return sprint, 200
def post(self, project_pk, tkt_id):
"""
Create a Comment for a ticket
:param project_pk: Project ID
:param tkt_id: Ticket ID
:return: Created Comment
"""
get_project_request(project_pk)
get_ticket_request(tkt_id)
data = request.get_json(silent=True)
if not data:
raise api_errors.InvalidAPIUsage(api_errors.INVALID_JSON_BODY_MSG)
c = Comment(ticket=tkt_id)
c.who = current_user.to_dbref()
c.comment = data.get('comment')
c.save()
if data.get('mentions'):
for m in data.get('mentions'):
if m is not None:
user = User.get_by_id(m)
if user:
create_notification_email(user, c)
# save activity
save_notification(project_pk=project_pk,
verb='mention',
user_to=user,
data={
"comment": c.to_dict(),
"ticket": c.ticket.to_dict()
})
else:
# save activity
save_notification(project_pk=project_pk,
verb='new_comment',
data={
"comment": c.to_dict(),
"ticket": c.ticket.to_dict()
})
return c, 201
def delete(self, project_pk, tkt_id, att_id):
"""
Delete an attachment
:param project_pk: Project ID
:param tkt_id: Ticket ID
:param att_id: Attachment ID
:return: Nothing
"""
get_project_request(project_pk)
att = Attachment.get_by_id(att_id)
tkt = get_ticket_request(tkt_id)
Ticket.remove_attachment(tkt.id, att)
# save activity
save_notification(project_pk=project_pk,
verb='delete_attachment',
data=att.to_dict())
att.delete()
return {}, 204
def post(self, project_pk, sprint_pk):
"""
Update Order of tickets in sprint
:param project_pk: Project ID
:param sprint_pk: Sprint ID
:return: Order
"""
get_project_request(project_pk)
data = request.get_json(silent=True)
if not data:
raise api_errors.InvalidAPIUsage(api_errors.INVALID_JSON_BODY_MSG)
sprint = get_sprint_request(sprint_pk)
SprintTicketOrder.order_items(data, sprint)
# save activity
save_notification(project_pk=project_pk,
verb='sprint_ticket_order',
data=data)
return data, 200
def delete(self, project_pk, tkt_id, pm_id):
"""
Remove member from ticket
:param project_pk: Project ID
:param tkt_id: Ticket ID
:param member_id: ProjectMember ID
:return: Nothing
"""
get_project_request(project_pk)
tkt = get_ticket_request(tkt_id)
pm = ProjectMember.get_by_id(pm_id)
if not pm:
raise api_errors.MissingResource(
api_errors.INVALID_PROJECT_MEMBER_MSG)
Ticket.remove_member(tkt, pm)
# save activity
save_notification(project_pk=project_pk,
verb='delete_assignment',
data=tkt.to_dict())
return {}, 204
def post(self, project_pk):
"""
Create a Sprint for a Project
"""
project = get_project_request(project_pk)
total = Sprint.objects(project=project).count()
sp = Sprint(project=project)
sp.name = 'Sprint %d' % (total + 1)
sp.save()
# save activity
save_notification(project_pk=project_pk,
verb='new_sprint',
data=sp.to_dict())
return sp, 201
def post(self, project_pk, tkt_id):
"""
Clone Ticket - Make a copy of a ticket
:param project_pk:
:param tkt_id:
:return:
"""
prj = get_project_request(project_pk)
tkt = get_ticket_request(tkt_id)
new_tkt = tkt.clone()
last_tkt = Ticket.get_last_ticket(prj)
new_tkt.number = last_tkt.number + 1 if last_tkt else 1
new_tkt.order = Ticket.get_next_order_index(prj)
new_tkt.save()
return new_tkt, 200
def get(self, project_pk, query):
"""
Search Tickets by project
:param project_pk: Project ID
:param query: text to search
:return: List of matched tickets
"""
prj = get_project_request(project_pk)
tickets = set(Ticket.search(query, [str(prj.pk)]))
results = []
for tkt in tickets:
val = dict(text='%s-%s: %s' %
(tkt.project.prefix, tkt.number, tkt.title),
value=str(tkt.id))
results.append(val)
return results, 200
def get(self, project_pk):
"""
Get Tickets for a Project
:param project_pk: Project ID
:return: List of tickets
"""
prj = get_project_request(project_pk)
tickets = []
sprints = Sprint.get_by_project(prj)
if prj.project_type == u'S':
for s in sprints:
spos = SprintTicketOrder.get_active_sprint(s)
for spo in spos:
tickets.append(spo.ticket.id)
return Ticket.get_tickets_backlog(project_pk, tickets), 200
def get(self, project_pk, sprint_id):
"""
Get tickets fro a Sprint
:param project_pk: Project ID
:param sprint_id: Sprint ID
:return: List of Tickets
"""
prj = get_project_request(project_pk)
sprint = get_sprint_request(sprint_id)
# first get all the columns
ticket_list = []
columns = Column.get_by_project(prj)
if columns:
ticket_transitions = TicketCT.get_transitions_in_cols(columns)
tickets_in_cols = []
for tt in ticket_transitions:
tickets_in_cols.append(tt.ticket)
# exclude from sprint
tickets = SprintTicketOrder.list_spo(sprint, tickets_in_cols)
for t in tickets:
if t.ticket.__class__.__name__ != 'DBRef':
tkt = t.ticket_repr
tkt['order'] = t.order
tkt['badges'] = {
'comments': Comment.get_by_ticket(t.ticket).count(),
'files': len(t.ticket.files)
}
assignments = []
for ass in t.ticket.assigned_to:
if ass.__class__.__name__ != 'DBRef':
val = ass.to_dict()
val['member'] = ass.member.to_dict()
assignments.append(val)
tkt['assigned_to'] = assignments
ticket_list.append(tkt)
return ticket_list, 200
