The Workspace class allows you to interact with an Oxen workspace without downloading the data locally.
Workspaces can be created off a branch and is tied to the commit id of the branch at the time of creation.
You can commit a Workspace back to the same branch if the branch has not advanced, otherwise you will have to commit to a new branch and merge.
Create a workspace from a branch.
Create a new Workspace.
Arguments:
repo
- PyRemoteRepo
The remote repo to create the workspace from.branch
- str
The branch name to create the workspace from. The workspace
will be tied to the commit id of the branch at the time of creation.workspace_id
- Optional[str]
The workspace id to create the workspace from.
If left empty, will create a unique workspace id.workspace_name
- Optional[str]
The name of the workspace. If left empty, the workspace will have no name.path
- Optional[str]
The path to the workspace. If left empty, the workspace will be created in the root of the remote repo.Get the id of the workspace.
Get the name of the workspace.
Get the branch that the workspace is tied to.
Get the commit id of the workspace.
Get the remote repo that the workspace is tied to.
Get the status of the workspace.
Arguments:
path
- str
The path to check the status of.Add a file to the workspace
Arguments:
src
- str
The path to the local file to be stageddst
- str
The path in the remote repo where the file will be addedRemove a file from the workspace
Arguments:
path
- str
The path to the file on workspace to be removedCommit the workspace to a branch
Arguments:
message
- str
The message to commit withbranch_name
- Optional[str]
The name of the branch to commit to. If left empty, will commit to the branch
the workspace was created from.Delete the workspace