Artifacts
Julia 1.6以降、アーティファクトのサポートはPkg.jl
からJulia自体に移行されました。ここに適切なドキュメントが追加されるまで、アーティファクトについてはPkg.jl
マニュアルで詳しく学ぶことができます。https://julialang.github.io/Pkg.jl/v1/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
を返します。
Artifacts.artifact_hash
— Functionartifact_hash(name::String, artifacts_toml::String;
platform::AbstractPlatform = HostPlatform())
指定されたプラットフォームで圧縮されたアーティファクトのハッシュを返すための artifact_meta()
の薄いラッパー。マッピングが見つからない場合は nothing
を返します。
Artifacts.find_artifacts_toml
— Functionfind_artifacts_toml(path::String)
与えられた.jl
ファイルへのパス(マクロコンテキストで__source__.file
によって返されるものなど)に基づいて、含まれているプロジェクト内の(Julia)Artifacts.toml
を見つけます(存在する場合)。そうでない場合はnothing
を返します。
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"
Artifacts.artifact_exists
— Functionartifact_exists(hash::SHA1; honor_overrides::Bool=true)
指定されたアーティファクト(そのsha1 gitツリーハッシュによって識別される)がディスク上に存在するかどうかを返します。指定されたアーティファクトが複数の場所(例えば、複数のデポ内)に存在する可能性があることに注意してください。
Artifacts.artifact_path
— Functionartifact_path(hash::SHA1; honor_overrides::Bool=true)
SHA1 gitツリーハッシュで識別されるアーティファクトのインストールパスを返します。アーティファクトが存在しない場合は、インストールされる場所を返します。
Artifacts.select_downloadable_artifacts
— Functionselect_downloadable_artifacts(artifacts_toml::String;
platform = HostPlatform,
include_lazy = false,
pkg_uuid = nothing)
指定されたプラットフォームのためにダウンロードすべき Artifacts.toml
からのすべてのエントリを含む辞書を返します。 include_lazy
が設定されている場合は、遅延アーティファクトも含まれます。