artifact_meta(name::String, artifacts_toml::String;              platform::AbstractPlatform = HostPlatform(),              pkg_uuid::Union{Base.UUID,Nothing}=nothing)

Get metadata about a given artifact (identified by name) stored within the given(Julia)Artifacts.toml file. If the artifact is platform-specific, useplatform to choose the most appropriate mapping. If none is found, returnnothing.

artifact_hash(name::String, artifacts_toml::String;              platform::AbstractPlatform = HostPlatform())

Thin wrapper aroundartifact_meta() to return the hash of the specified, platform- collapsed artifact. Returnsnothing if no mapping can be found.

find_artifacts_toml(path::String)

Given the path to a.jl file, (such as the one returned by__source__.file in a macro context), find the(Julia)Artifacts.toml that is contained within the containing project (if it exists), otherwise returnnothing.

macro artifact_str(name)

Return the on-disk path to an artifact. Automatically looks the artifact up by name in the project's(Julia)Artifacts.toml file. Throws an error on if the requested artifact is not present. If run in the REPL, searches for the toml file starting in the current directory, seefind_artifacts_toml() for more.

If the artifact is marked "lazy" and the package hasusing LazyArtifacts defined, the artifact will be downloaded on-demand withPkg the first time this macro tries to compute the path. The files will then be left installed locally for later.

Ifname contains a forward or backward slash, all elements after the first slash will be taken to be path names indexing into the artifact, allowing for an easy one-liner to access a single file/directory within an artifact. Example:

ffmpeg_path = @artifact"FFMPEG/bin/ffmpeg"

artifact_exists(hash::SHA1; honor_overrides::Bool=true)

Return whether or not the given artifact (identified by its sha1 git tree hash) exists on-disk. Note that it is possible that the given artifact exists in multiple locations (e.g. within multiple depots).

artifact_path(hash::SHA1; honor_overrides::Bool=true)

Given an artifact (identified by SHA1 git tree hash), return its installation path. If the artifact does not exist, returns the location it would be installed to.

select_downloadable_artifacts(artifacts_toml::String;                              platform = HostPlatform,                              include_lazy = false,                              pkg_uuid = nothing)

Return a dictionary where every entry is an artifact from the givenArtifacts.toml that should be downloaded for the requested platform. Lazy artifacts are included ifinclude_lazy is set.