Skip to main content
fs.changes operates on the mounted filesystem checkout. For REST-level change creation and patching, use mesa.changes. 
async with mesa.fs.mount(repos=["app"]) as fs:
    change_id = await fs.changes.new("app", bookmark="main", message="Cool new feature")
    await fs.write("/acme/app/feature.py", b"print('hi')\n")
    current = await fs.changes.current("app")

​
Methods

​
new(repo, bookmark=None, change_id=None, message=None)
async -> str
Create a new change forked from a bookmark or existing change. Exactly one of bookmark or change_id must be supplied. Pass message to set the new change description; None omits it and creates the change with no description.
​
edit(repo, bookmark=None, change_id=None)
async -> str
Check out an existing change. This never creates a new change. Exactly one of bookmark or change_id must be supplied.
​
list(repo, limit=50)
async -> list[ChangeInfo]
List changes reachable from the current checkout, most recent first.
​
current(repo)
async -> ChangeInfo
Return the currently active change for a mounted repo.

​
ChangeInfo

​
change_id
str
Mesa change ID.
​
commit_oid
str
Git commit OID for the change snapshot.

​
Errors

Raises FileNotFoundError if the source bookmark or change does not exist.