spl:fetch

Introduction

spl:fetch downloads a product line’s model from UVLHub by DOI into your cache. Reading needs no account and no key. You rarely need it by hand, since every spl:* command that reads a model downloads it when it is missing.

splent spl:fetch sample_splent_spl

  Downloading UVL from https://www.uvlhub.io/doi/10.5281/zenodo.23076870/files/raw/sample_splent_spl.uvl/
  UVL cached at /workspace/.splent_cache/spls/sample_splent_spl@v4/sample_splent_spl.uvl
  Cached sample_splent_spl at /workspace/.splent_cache/spls/sample_splent_spl@v4/sample_splent_spl.uvl

A model already cached is not downloaded again, and only the last line is printed.

Where the DOI comes from

The first of these that records a DOI wins.

The working copy, splent_spl_<name>/metadata.toml.
A product of the workspace that pins the line in [tool.splent.spl_model].
The metadata.toml of a previous download in the cache.
The pin the CLI ships for sample_splent_spl.

The file goes to .splent_cache/spls/<name>@<version>/, or @<DOI> when the pin has no version, next to a metadata.toml that records the pin. A working copy is never written. When you have one, the command reminds you that it wins when the model is read.

Downloading again

splent spl:fetch sample_splent_spl --force

--force downloads the model even when it is cached.

Reference

Options

Option	Description
`--force`	Download again even if the model is cached

UVLHUB_URL points reads at another UVLHub instance. It defaults to https://www.uvlhub.io.

Errors

Message	What to do
`No UVL model found for '<name>'.`	No DOI is recorded anywhere. It lists the paths it looked in. Record a DOI with `spl:pin` or start the model with `spl:create`
`UVLHub returned <status> for <url>`	Check the DOI and the file name in the pin
`Failed to download UVL: ...`	UVLHub could not be reached. Check your network
`Refusing to write the SPL model to <path>: it is not inside <cache>.`	Something in the cache, such as a symlink, leads elsewhere. Remove it

Requirements

Detached mode, with no product selected. A leading SPLENT_APP= runs one command detached and keeps your selection.