CodeCommit / Client / get_comments_for_compared_commit

get_comments_for_compared_commit

CodeCommit.Client.get_comments_for_compared_commit(**kwargs)

Returns information about comments made on the comparison between two commits.

Note

Reaction counts might include numbers from user identities who were deleted after the reaction was made. For a count of reactions from active identities, use GetCommentReactions.

See also: AWS API Documentation

Request Syntax

response = client.get_comments_for_compared_commit(
    repositoryName='string',
    beforeCommitId='string',
    afterCommitId='string',
    nextToken='string',
    maxResults=123
)

Parameters:

• repositoryName (string) –

  [REQUIRED]

  The name of the repository where you want to compare commits.

• beforeCommitId (string) – To establish the directionality of the comparison, the full commit ID of the before commit.

• afterCommitId (string) –

  [REQUIRED]

  To establish the directionality of the comparison, the full commit ID of the after commit.

• nextToken (string) – An enumeration token that when provided in a request, returns the next batch of the results.

• maxResults (integer) – A non-zero, non-negative integer used to limit the number of returned results. The default is 100 comments, but you can configure up to 500.

Return type:

dict

Returns:

Response Syntax

{
    'commentsForComparedCommitData': [
        {
            'repositoryName': 'string',
            'beforeCommitId': 'string',
            'afterCommitId': 'string',
            'beforeBlobId': 'string',
            'afterBlobId': 'string',
            'location': {
                'filePath': 'string',
                'filePosition': 123,
                'relativeFileVersion': 'BEFORE'|'AFTER'
            },
            'comments': [
                {
                    'commentId': 'string',
                    'content': 'string',
                    'inReplyTo': 'string',
                    'creationDate': datetime(2015, 1, 1),
                    'lastModifiedDate': datetime(2015, 1, 1),
                    'authorArn': 'string',
                    'deleted': True|False,
                    'clientRequestToken': 'string',
                    'callerReactions': [
                        'string',
                    ],
                    'reactionCounts': {
                        'string': 123
                    }
                },
            ]
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) –

  • commentsForComparedCommitData (list) –

    A list of comment objects on the compared commit.

    • (dict) –

      Returns information about comments on the comparison between two commits.

      • repositoryName (string) –

        The name of the repository that contains the compared commits.

      • beforeCommitId (string) –

        The full commit ID of the commit used to establish the before of the comparison.

      • afterCommitId (string) –

        The full commit ID of the commit used to establish the after of the comparison.

      • beforeBlobId (string) –

        The full blob ID of the commit used to establish the before of the comparison.

      • afterBlobId (string) –

        The full blob ID of the commit used to establish the after of the comparison.

      • location (dict) –

        Location information about the comment on the comparison, including the file name, line number, and whether the version of the file where the comment was made is BEFORE or AFTER.

        • filePath (string) –

          The name of the file being compared, including its extension and subdirectory, if any.

        • filePosition (integer) –

          The position of a change in a compared file, in line number format.

        • relativeFileVersion (string) –

          In a comparison of commits or a pull request, whether the change is in the before or after of that comparison.

      • comments (list) –

        An array of comment objects. Each comment object contains information about a comment on the comparison between commits.

        • (dict) –

          Returns information about a specific comment.

          • commentId (string) –

            The system-generated comment ID.

          • content (string) –

            The content of the comment.

          • inReplyTo (string) –

            The ID of the comment for which this comment is a reply, if any.

          • creationDate (datetime) –

            The date and time the comment was created, in timestamp format.

          • lastModifiedDate (datetime) –

            The date and time the comment was most recently modified, in timestamp format.

          • authorArn (string) –

            The Amazon Resource Name (ARN) of the person who posted the comment.

          • deleted (boolean) –

            A Boolean value indicating whether the comment has been deleted.

          • clientRequestToken (string) –

            A unique, client-generated idempotency token that, when provided in a request, ensures the request cannot be repeated with a changed parameter. If a request is received with the same parameters and a token is included, the request returns information about the initial request that used that token.

          • callerReactions (list) –

            The emoji reactions to a comment, if any, submitted by the user whose credentials are associated with the call to the API.

            • (string) –

          • reactionCounts (dict) –

            A string to integer map that represents the number of individual users who have responded to a comment with the specified reactions.

            • (string) –

              • (integer) –

  • nextToken (string) –

    An enumeration token that can be used in a request to return the next batch of the results.

Exceptions

• CodeCommit.Client.exceptions.RepositoryNameRequiredException

• CodeCommit.Client.exceptions.RepositoryDoesNotExistException

• CodeCommit.Client.exceptions.InvalidRepositoryNameException

• CodeCommit.Client.exceptions.CommitIdRequiredException

• CodeCommit.Client.exceptions.InvalidCommitIdException

• CodeCommit.Client.exceptions.CommitDoesNotExistException

• CodeCommit.Client.exceptions.InvalidMaxResultsException

• CodeCommit.Client.exceptions.InvalidContinuationTokenException

• CodeCommit.Client.exceptions.EncryptionIntegrityChecksFailedException

• CodeCommit.Client.exceptions.EncryptionKeyAccessDeniedException

• CodeCommit.Client.exceptions.EncryptionKeyDisabledException

• CodeCommit.Client.exceptions.EncryptionKeyNotFoundException

• CodeCommit.Client.exceptions.EncryptionKeyUnavailableException