Page kind: Reference
swarmops ancestry#
Compare two revisions' ancestry along every parent: whether FROM is an ancestor of TO, their merge bases, and a page of the changesets TO reaches and FROM does not.
- Group
read- Since
0.9.0- Mutates
- no
- Identity required
- no
- MCP tool
ancestry- Envelope op
ancestry- Exit codes
- 0
- Errors
- none
Syntax#
swarmops ancestry [OPTIONS] <FROM> <TO>Required arguments#
Syntax: <FROM>.
The first revision: the ancestor asked about, and the side the list leaves out.
Syntax: <TO>.
The second revision: the side whose changesets the list holds.
Optional arguments#
The command also takes the global options.
Syntax: -n, --limit <N>.
Default: 50.
The most changesets to list, 0 to 1,000: 0 lists none.
Syntax: --cursor <CURSOR>.
Resume the list: the previous page's cursor, exactly as it was returned, with the same FROM and TO.
Examples#
No recorded example yet.
No recorded example yet.
Return information#
result is a AncestryResp (swarmops schema AncestryResp prints its JSON Schema).
| Field | Type | Required | Description |
|---|---|---|---|
cursor | string or null | no | When more entries follow: where the next page continues. Opaque: pass it back as given, as the next request's cursor, with the same from and to. |
entries | array of ChangesetSummary | yes | The changesets to reaches and from does not, after the request's cursor. |
from | string | yes | The full id from named. |
is_ancestor | boolean | yes | Whether from is an ancestor of to along any parents; a changeset is its own. |
merge_bases | array of string | yes | The merge bases: the common ancestors that no other common ancestor reaches, at most 64; from alone when it is an ancestor of to, none when the two share no history. |
merge_bases_truncated | boolean | yes | Whether there are more merge bases than the 64 listed. |
to | string | yes | The full id to named. |
Envelope op: ancestry.
Exit codes:
0: Success.
Errors#
No golden step shows this command failing yet.
Any command that opens a store may also fail with a store error, such as E_NOT_A_REPO, E_IO or E_STORE_CORRUPT; a command line the grammar refuses is E_INVALID_ARG (exit 2).