Artifacts
Julia 1.6以降、アーティファクトのサポートはPkg.jl
からJulia自体に移行されました。ここに適切なドキュメントが追加されるまで、アーティファクトについてはPkg.jl
マニュアルで詳しく学ぶことができます。リンクはhttps://julialang.github.io/Pkg.jl/v1/artifacts/です。
JuliaのアーティファクトAPIは、少なくともJulia 1.6が必要です。Juliaのバージョン1.3から1.5では、代わりにPkg.Artifacts
を使用できます。
Artifacts.artifact_meta
— Functionartifact_meta(name::String, artifacts_toml::String;
platform::AbstractPlatform = HostPlatform(),
pkg_uuid::Union{Base.UUID,Nothing}=nothing)
指定された (Julia)Artifacts.toml
ファイル内に保存されているアーティファクト(名前で識別される)に関するメタデータを取得します。アーティファクトがプラットフォーム固有の場合は、platform
を使用して最も適切なマッピングを選択します。見つからない場合は nothing
を返します。
この関数は少なくとも Julia 1.3 を必要とします。
Artifacts.artifact_hash
— Functionartifact_hash(name::String, artifacts_toml::String;
platform::AbstractPlatform = HostPlatform())
指定されたプラットフォームに対応したアーティファクトのハッシュを返すための artifact_meta()
の薄いラッパーです。マッピングが見つからない場合は nothing
を返します。
この関数は少なくとも Julia 1.3 が必要です。
Artifacts.find_artifacts_toml
— Functionfind_artifacts_toml(path::String)
指定された.jl
ファイルへのパス(マクロコンテキストで__source__.file
によって返されるものなど)をもとに、含まれているプロジェクト内の(Julia)Artifacts.toml
を見つけます(存在する場合)。そうでなければ、nothing
を返します。
この関数は少なくともJulia 1.3が必要です。
Artifacts.@artifact_str
— Macromacro artifact_str(name)
アーティファクトへのディスク上のパスを返します。プロジェクトの (Julia)Artifacts.toml
ファイルで名前によってアーティファクトを自動的に検索します。要求されたアーティファクトが存在しない場合はエラーをスローします。REPLで実行されると、現在のディレクトリから始めてtomlファイルを検索します。詳細は find_artifacts_toml()
を参照してください。
アーティファクトが「遅延」とマークされており、パッケージに using LazyArtifacts
が定義されている場合、このマクロがパスを計算しようとする最初の時に Pkg
を使用してアーティファクトがオンデマンドでダウンロードされます。その後、ファイルはローカルにインストールされたままにされ、後で使用できます。
name
にスラッシュが含まれている場合、最初のスラッシュ以降のすべての要素はアーティファクト内のパス名として扱われ、アーティファクト内の単一のファイル/ディレクトリにアクセスするための簡単なワンライナーが可能になります。例:
ffmpeg_path = @artifact"FFMPEG/bin/ffmpeg"
このマクロは少なくともJulia 1.3を必要とします。
スラッシュインデックスは少なくともJulia 1.6を必要とします。
Artifacts.artifact_exists
— Functionartifact_exists(hash::SHA1; honor_overrides::Bool=true)
与えられたアーティファクト(そのsha1 gitツリーハッシュによって識別される)がディスク上に存在するかどうかを返します。与えられたアーティファクトが複数の場所(例えば、複数のデポ内)に存在する可能性があることに注意してください。
この関数は少なくともJulia 1.3が必要です。
Artifacts.artifact_path
— Functionartifact_path(hash::SHA1; honor_overrides::Bool=true)
SHA1 gitツリーハッシュで識別されるアーティファクトのインストールパスを返します。アーティファクトが存在しない場合は、インストールされる場所を返します。
この関数は少なくともJulia 1.3が必要です。
Artifacts.select_downloadable_artifacts
— Functionselect_downloadable_artifacts(artifacts_toml::String;
platform = HostPlatform,
include_lazy = false,
pkg_uuid = nothing)
指定されたプラットフォームのためにダウンロードすべき Artifacts.toml
からのすべてのエントリを含む辞書を返します。 include_lazy
が設定されている場合は、遅延アーティファクトも含まれます。