Artifacts
بدءًا من Julia 1.6، تم نقل دعم العناصر من Pkg.jl إلى Julia نفسها. حتى يمكن إضافة الوثائق المناسبة هنا، يمكنك معرفة المزيد عن العناصر في دليل Pkg.jl على https://julialang.github.io/Pkg.jl/v1/artifacts/.
تتطلب واجهة برمجة التطبيقات الخاصة بالتحف في جوليا على الأقل جوليا 1.6. في إصدارات جوليا 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)ارجع ما إذا كان العنصر المعطى (المحدد بواسطة تجزئة شجرة git sha1 الخاصة به) موجودًا على القرص. لاحظ أنه من الممكن أن يكون العنصر المعطى موجودًا في مواقع متعددة (مثل داخل عدة مستودعات).
تتطلب هذه الوظيفة على الأقل Julia 1.3.
Artifacts.artifact_path — Functionartifact_path(hash::SHA1; honor_overrides::Bool=true)بالنظر إلى عنصر (محدد بواسطة تجزئة شجرة git SHA1)، قم بإرجاع مسار تثبيته. إذا لم يكن العنصر موجودًا، فقم بإرجاع الموقع الذي سيتم تثبيته فيه.
تتطلب هذه الوظيفة على الأقل جوليا 1.3.
Artifacts.select_downloadable_artifacts — Functionselect_downloadable_artifacts(artifacts_toml::String;
platform = HostPlatform,
include_lazy = false,
pkg_uuid = nothing)إرجاع قاموس حيث كل إدخال هو عنصر من العناصر من Artifacts.toml المعطاة التي يجب تنزيلها للمنصة المطلوبة. يتم تضمين العناصر الكسولة إذا تم تعيين include_lazy.