tcms.rpc.api.testexecution module

tcms.rpc.api.testexecution.add_comment(execution_id, comment, **kwargs)[source]
RPC TestExecution.add_comment(execution_id, comment)

Add comment to selected test execution.

Parameters:
  • execution_id (int) – PK of a TestExecution object
  • comment (str) – The text to add as a comment
  • **kwargs – Dict providing access to the current request, protocol, entry point name and handler instance from the rpc method
Returns:

Serialized django_comments.models.Comment object
Return type:

dict
Raises:

PermissionDenied – if missing django_comments.add_comment permission
RPC TestExecution.add_link(values)

Add new URL link to a TestExecution

Parameters:
  • values (dict) – Field values for tcms.core.contrib.linkreference.models.LinkReference
  • update_tracker (bool, default=False) – Automatically update Issue Tracker by placing a comment linking back to the failed TestExecution.
  • **kwargs – Dict providing access to the current request, protocol, entry point name and handler instance from the rpc method
Returns:

Serialized tcms.core.contrib.linkreference.models.LinkReference object
Return type:

dict
Raises:

Note

Always ‘link’ with IT instance if URL is from Kiwi TCMS own bug tracker!

tcms.rpc.api.testexecution.filter(query)[source]
RPC TestExecution.filter(query)

Perform a search and return the resulting list of test case executions.

Parameters:query (dict) – Field lookups for tcms.testruns.models.TestExecution
Returns:List of serialized tcms.testruns.models.TestExecution objects
Return type:list(dict)
tcms.rpc.api.testexecution.get_comments(execution_id)[source]
RPC TestExecution.get_comments(execution_id)

Get all comments for selected test execution.

Parameters:execution_id (int) – PK of a TestExecution object
Returns:Serialized django_comments.models.Comment object
Return type:dict
Raises:PermissionDenied – if missing django_comments.view_comment permission
RPC TestExecution.get_links(query)

Get URL links for the specified TestExecution

Parameters:query (dict) – Field lookups for tcms.core.contrib.linkreference.models.LinkReference
Returns:Serialized list of tcms.core.contrib.linkreference.models.LinkReference objects
Return type:dict
tcms.rpc.api.testexecution.history(execution_id)[source]
RPC TestExecution.history(execution_id)

Return the history for the selected test execution.

Parameters:execution_id (int) – PK of a TestExecution object
Returns:List of serialized tcms.core.history.KiwiHistoricalRecords objects
Return type:list(dict)
Raises:PermissionDenied – if missing testruns.view_testexecution permission
tcms.rpc.api.testexecution.properties(query)[source]
RPC TestExecution.properties(query)

Return properties for a TestExecution

Parameters:query (dict) – Field lookups for tcms.testruns.models.TestExecutionProperty
Returns:Serialized list of tcms.testruns.models.TestExecutionProperty objects
Return type:dict
tcms.rpc.api.testexecution.remove_comment(execution_id, comment_id=None)[source]
RPC TestExecution.remove_comment(execution_id, comment_id)

Remove all or specified comment(s) from selected test execution.

Parameters:
  • execution_id (int) – PK of a TestExecution object
  • comment_id (int) – PK of a Comment object or None
Raises:

PermissionDenied – if missing django_comments.delete_comment permission
RPC TestExecution.remove_link(query)

Remove URL link from TestExecution

Parameters:query (dict) – Field lookups for tcms.core.contrib.linkreference.models.LinkReference
tcms.rpc.api.testexecution.update(execution_id, values, **kwargs)[source]
RPC TestExecution.update(execution_id, values)

Update the selected TestExecution

Parameters:
  • execution_id (int) – PK of TestExecution to modify
  • values (dict) – Field values for tcms.testruns.models.TestExecution
  • **kwargs – Dict providing access to the current request, protocol, entry point name and handler instance from the rpc method
Returns:

Serialized tcms.testruns.models.TestExecution object
Return type:

dict
Raises:
  • ValueError – if data validations fail
  • PermissionDenied – if missing testruns.change_testexecution permission