repo

The repo module is an interface for performing actions onto git providers. Reply to a comment, create an issue, review a pull request, open a pull request, etc.

Example Usage

from blocks import repo

# Create a new issue
repo.create_issue(
    title="Update README.md",
    body="Update the README.md file",
    state="open",
    target_branch="main"
)

# Update an issue
repo.update_issue(
    issue_number=1,
    title="Update README.md",
    body="Update the README.md file",
    state="open",
    target_branch="main"
)

# Comment on a pull request
repo.comment_on_pull_request(
    pull_request_number=1,
    body="Update the README.md file",
    owner="BlocksOrg",
    repo="blocks"
)

Methods

update_pull_request

Updates a pull request. Typically, you’d use this to update the title, body/description, or state of a pull request.

repo.update_pull_request(
    pull_request_number=1,
    title="Update README.md",
    body="Some description",
)

int

required

The number of the pull request to update.

string

The title of the pull request.

string

The body of the pull request.

bool

Whether the maintainer can modify the pull request.

string

The state of the pull request.

Show child attributes

string

The pull request is open.

string

The pull request is closed.

string

The target branch of the pull request.

string

The owner of the repository.

string

The name of the repository.

update_issue

Updates an issue. Typically, you’d use this to update the title, description, or state of an issue.

repo.update_issue(
    issue_number=1,
    title="Update README.md",
    description="Update the README.md file",
)

int

required

The number of the issue to update.

string

The title of the issue.

string

The body of the issue.

string

The state of the issue.

Show child attributes

string

The issue is open.

string

The issue is closed.

string

The reason the issue is in the state it is in.

Show child attributes

string

The issue is completed.

string

The issue is not planned.

string

The issue is reopened.

int

The number of the milestone to assign to the issue.

string

The target branch of the issue.

string

The owner of the repository.

string

The name of the repository.

create_issue

Creates an issue.

repo.create_issue(
    title="Update README.md",
    body="Some description",
)

string

required

The title of the issue.

string

The body of the issue.

string[]

A list of assignees to assign to the issue. Corresponds to arrays of user.login.

list

A list of labels to add to the issue.

int

The number of the milestone to assign to the issue.

string

The owner of the repository.

string

The name of the repository.

create_pull_request

Creates a pull request.

repo.create_pull_request(
    source_branch="main",
    target_branch="develop",
    title="Update README.md",
    body="Some description"
)

string

required

The source branch to create the pull request from.

string

required

The target branch to create the pull request to.

string

required

The title of the pull request.

string

The body of the pull request.

bool

Whether the pull request is a draft.

int

The number of the issue to create the pull request from.

string

The owner of the repository.

string

The name of the repository.

comment_on_pull_request

Comments on a pull request.

repo.comment_on_pull_request(
    pull_request_number=1,
    body="Update the README.md file",
)

int

required

The number of the pull request to comment on.

string

required

The body of the comment.

string

The owner of the repository.

string

The name of the repository.

delete_pull_request_comment

Deletes a pull request comment.

repo.delete_pull_request_comment(
    comment_id=1
)

int

required

The ID of the comment to delete.

string

The owner of the repository.

string

The name of the repository.

update_pull_request_comment

repo.update_pull_request_comment(
    comment_id=1,
    body="Some description"
)

Updates a pull request comment.

int

required

The ID of the comment to update.

string

required

The body of the comment.

string

The owner of the repository.

string

The name of the repository.

comment_on_pull_request_file

Comments on a file in a pull request.

repo.comment_on_pull_request_file(
    commit_id="1234567890",
    file_path="README.md",
    pull_request_number=1,
    body="Update the README.md file",
    position=1,
)

string

The SHA of the commit to comment on.

string

The path of the file to comment on.

int

The position of the comment in the file.

int

required

The number of the pull request to comment on.

string

The body of the comment.

int

The line number to comment on.

int

The ID of the comment to reply to.

string

The side of the comment in the file.

Show child attributes

string

The comment is on the left side of the file.

string

The comment is on the right side of the file.

int

The start line of the comment in the file.

string

The side of the comment in the file.

Show child attributes

string

The comment is on the left side of the file.

string

The comment is on the right side of the file.

string

The comment is on the side of the file.

string

The type of the subject.

Show child attributes

string

The comment is on a line.

string

The comment is on a file.

string

The owner of the repository.

string

The name of the repository.

update_issue_comment

Updates an issue comment.

repo.update_issue_comment(
    comment_id=1,
    body="Update the README.md file"
)

int

required

The ID of the comment to update.

string

required

The body of the comment.

string

The owner of the repository.

string

The name of the repository.

delete_issue_comment

Deletes an issue comment.

repo.delete_issue_comment(
    comment_id=1
)

int

required

The ID of the comment to delete.

string

The owner of the repository.

string

The name of the repository.

comment_on_issue

Comments on an issue.

repo.comment_on_issue(
    issue_number=1,
    body="Update the README.md file"
)

int

required

The number of the issue to comment on.

string

required

The body of the comment.

string

The owner of the repository.

string

The name of the repository.

reply_to_pull_request_comment

Replies to a pull request comment.

repo.reply_to_pull_request_comment(
    reply_to_id=1,
    pull_request_number=1,
    body="Some description"
)

int

required

The ID of the comment to reply to.

int

required

The number of the pull request to reply to.

string

required

The body of the reply.

string

The owner of the repository.

string

The name of the repository.

review_pull_request

Reviews a pull request.

repo.review_pull_request(
    pull_request_number=1,
    body="Update the README.md file",
    commit_id="1234567890",
    comments=[],
    event="COMMENT",
)

int

required

The number of the pull request to review.

string

required

The body of the review.

string

The SHA of the commit to review.

list

A list of comments to add to the review.

Show child attributes

string

required

The relative path to the file that necessitates a review comment.

string

required

The body of the comment.

int

The line number to review.

string

The side of the comment in the file.

int

The start line of the comment in the file.

int

The position in the diff where you want to add a review comment. Note this value is not the same as the line number in the file. The position value equals the number of lines down from the first ”@@” hunk header in the file you want to add a comment. The line just below the ”@@” line is position 1, the next line is position 2, and so on. The position in the diff continues to increase through lines of whitespace and additional hunks until the beginning of a new file.

string

The event to trigger on the review.

Show child attributes

string

The review is approved.

string

The review is requested changes.

string

The review is a comment.

string

The owner of the repository.

string

The name of the repository.

Getting Started

Agents

CLI

Events

Decorators

SDK

Example Usage

Methods

update_pull_request

update_issue

create_issue

create_pull_request

comment_on_pull_request

delete_pull_request_comment

update_pull_request_comment

comment_on_pull_request_file

update_issue_comment

delete_issue_comment

comment_on_issue

reply_to_pull_request_comment

review_pull_request

​Example Usage

​Methods

​update_pull_request

​update_issue

​create_issue

​create_pull_request

​comment_on_pull_request

​delete_pull_request_comment

​update_pull_request_comment

​comment_on_pull_request_file

​update_issue_comment

​delete_issue_comment

​comment_on_issue

​reply_to_pull_request_comment

​review_pull_request

Example Usage

Methods

update_pull_request

update_issue

create_issue

create_pull_request

comment_on_pull_request

delete_pull_request_comment

update_pull_request_comment

comment_on_pull_request_file

update_issue_comment

delete_issue_comment

comment_on_issue

reply_to_pull_request_comment

review_pull_request