Skip to content

parse_graph_locator

Function: warmhub.parse_graph_locator

parse_graph_locator(locator: str)

Parse "org/graph" or "wh:org/graph/..." into its two names.

Both forms are accepted because both are what users have in hand: the slug is what the UI shows, and a wref is what a previous read returned. A wref carries further segments (shape, name, version); they are ignored, because the handle binds a graph and nothing narrower.

Anything else raises ValueError naming the input and both accepted forms. It does not raise WarmHubError: no request was made and no server was involved, so a caller’s except WarmHubError around a network call must not swallow what is a typo in a literal.