changes.list() - Mesa Docs

List current reachable changes, optionally restricted to a bookmark. Required scope: write

changes = await mesa.changes.list(repo="app", bookmark="main")

for change in changes.changes:
    print(change.id, change.current_commit_oid, change.message)

Options

str

required

Repository name.

str | None

Opaque pagination cursor from a previous response.

int | None

Maximum number of changes to return. The server maximum is 100.

str | None

Restrict results to changes reachable from this bookmark.

Response

str | None

Cursor for the next page, or null when no more results remain.

bool

Whether another page of results is available.

list[Change]

Change objects.

Change

str

Change ID.

str

Current commit OID for the change.

bool

Whether the current commit still contains unresolved conflicts.

str

Current change description. Empty string means the change has no description.

list[CommitIdentity]

Complete ordered commit attribution. Every entry is an equal contributor.

datetime

Shared authored timestamp. The virtual root uses the Unix epoch.

CommitSignature

Committer identity. The virtual root has an empty name and email at the Unix epoch.

The deprecated REST author field is not returned by the SDK; read authors and authored_at.

list[str]

Parent change IDs for this change.

datetime

Creation time.

datetime

Last update time.

CommitIdentity

str

Author display name.

str | None

Author email address, or None when no email was supplied.

CommitSignature

str

Committer display name.

str

Email address, or "" when none was supplied. This string form is retained for compatibility.

datetime | None

Timestamp for this signature when provided.

​Options

​Response

​Change

​CommitIdentity

​CommitSignature

Options

Response

Change

CommitIdentity

CommitSignature