ResourceVersion

ResourceVersion

is an option for ResourceObject, ResourceFunction and related functions for specifying the version of a resource.

Details

  • ResourceVersion typically has a default value of Automatic, which provides the most-recent, locally cached version.
  • If no versions are cached, then the latest compatible version is acquired from the resource system.
  • ResourceVersion is supported for published resources from any repository including the Function Repository, Data Repository and Neural Net Repository. Versioning is not supported by custom resources not published in a repository, such as those deployed to a specific user's cloud account.
  • Version values are strings of the form "x.y.z" where changes in z represent bug fixes, changes in y represent incremental updates and changes in x represent major, potentially breaking changes.
  • In addition to strings specifying exact versions, ResourceVersion accepts GreaterThan, LessThan, GreaterEqualThan, LessEqualThan and EqualTo operators. Operators can be combined using And to define more complicated version ranges. When multiple versions match the specification, the latest version compatible with the requesting environment is returned.
  • The resource system will only return versions compatible with the requesting environment. Compatibility is based in part on $VersionNumber, $SystemWordLength and $OperatingSystem.

Examples

open allclose all

Basic Examples  (2)

Retrieve a specific version of a ResourceObject:

Get two versions of a ResourceFunction:

Use both versions; note how the later version has added buttons to the game interface:

Scope  (3)

Specify a maximum version:

Verify the version:

This version does not support the two-argument form:

A newer version, retrieved using GreaterThan, does support a direction:

Use And to combine operators:

ResourceData supports ResourceVersion. Retrieve an old version of data:

Retrieve the latest data:

Wolfram Research (2020), ResourceVersion, Wolfram Language function, https://reference.wolfram.com/language/ref/ResourceVersion.html (updated 2021).

Text

Wolfram Research (2020), ResourceVersion, Wolfram Language function, https://reference.wolfram.com/language/ref/ResourceVersion.html (updated 2021).

CMS

Wolfram Language. 2020. "ResourceVersion." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2021. https://reference.wolfram.com/language/ref/ResourceVersion.html.

APA

Wolfram Language. (2020). ResourceVersion. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ResourceVersion.html

BibTeX

@misc{reference.wolfram_2024_resourceversion, author="Wolfram Research", title="{ResourceVersion}", year="2021", howpublished="\url{https://reference.wolfram.com/language/ref/ResourceVersion.html}", note=[Accessed: 17-November-2024 ]}

BibLaTeX

@online{reference.wolfram_2024_resourceversion, organization={Wolfram Research}, title={ResourceVersion}, year={2021}, url={https://reference.wolfram.com/language/ref/ResourceVersion.html}, note=[Accessed: 17-November-2024 ]}