hub
list_refs
List live refs for a StrataHub dataset.
strata hub list-refsdb.hub.list_refs(dataset: 'str', *, hub_url: 'Optional[str]' = None) -> 'Any'wire hub_list_refs
Reads `GET /v1/datasets/<name>/refs` from the effective hub URL. Yanked refs are filtered by the hub.
Status commands return a scalar or compact status payload and do not mutate database state.
To see the complete help for this command, run:
strata hub list-refs --helphelp(db.hub.list_refs)
Example
No CLI example in this release.
[ref.branch for ref in db.hub.list_refs("titanic").refs] # doctest: +SKIPParameters
| Name | Type | Required | Description |
|---|---|---|---|
| dataset | string | yes | Dataset slug. |
| hub_url | string or null | no | Explicit hub URL; when absent the 5-layer resolver runs. |
Returns
StatusResponse<HubRefList>
- dataHubRefList
- typestring
Errors
Recover by code. Retry policy and commit outcome come from the shipped error registry.
| Code | Retry | Commit outcome |
|---|---|---|
| failed_precondition.engine.runtime_closed | never | not_started |
| not_found.engine.branch | never | not_applicable |
| unsupported.executor.hub_feature_disabled | after_state_change | not_started |
| invalid_argument.executor.hub_url | never | not_started |
| unavailable.executor.hub_transport | same_request | not_started |
| invalid_argument.executor.hub_dataset | never | not_started |
| not_found.executor.hub_dataset | never | not_started |