Artifacts

بدءًا من Julia 1.6، تم نقل دعم العناصر من Pkg.jl إلى Julia نفسها. حتى يمكن إضافة الوثائق المناسبة هنا، يمكنك معرفة المزيد عن العناصر في دليل Pkg.jl على https://julialang.github.io/Pkg.jl/v1/artifacts/.

Julia 1.6

تتطلب واجهة برمجة التطبيقات الخاصة بالتحف في جوليا على الأقل جوليا 1.6. في إصدارات جوليا 1.3 إلى 1.5، يمكنك استخدام Pkg.Artifacts بدلاً من ذلك.

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

احصل على بيانات التعريف حول عنصر معين (محدد بالاسم) المخزن داخل ملف (Julia)Artifacts.toml المعطى. إذا كان العنصر خاصًا بالمنصة، استخدم platform لاختيار التعيين الأنسب. إذا لم يتم العثور على أي شيء، ارجع nothing.

Julia 1.3

تتطلب هذه الوظيفة على الأقل Julia 1.3.

source
Artifacts.artifact_hashFunction
artifact_hash(name::String, artifacts_toml::String;
              platform::AbstractPlatform = HostPlatform())

غلاف رقيق حول artifact_meta() لإرجاع تجزئة الأثر المحدد، المدمج حسب النظام الأساسي. يُرجع nothing إذا لم يمكن العثور على أي خريطة.

Julia 1.3

تتطلب هذه الوظيفة على الأقل Julia 1.3.

source
Artifacts.find_artifacts_tomlFunction
find_artifacts_toml(path::String)

بالنظر إلى المسار إلى ملف .jl، (مثل الذي يتم إرجاعه بواسطة __source__.file في سياق الماكرو)، ابحث عن (Julia)Artifacts.toml الذي يحتوي عليه المشروع المحتوي (إذا كان موجودًا)، وإلا أعد nothing.

Julia 1.3

تتطلب هذه الوظيفة على الأقل Julia 1.3.

source
Artifacts.@artifact_strMacro
macro 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.3.

Julia 1.6

يتطلب الفهرسة باستخدام الشريحة على الأقل Julia 1.6.

source
Artifacts.artifact_existsFunction
artifact_exists(hash::SHA1; honor_overrides::Bool=true)

ارجع ما إذا كان العنصر المعطى (المحدد بواسطة تجزئة شجرة git sha1 الخاصة به) موجودًا على القرص. لاحظ أنه من الممكن أن يكون العنصر المعطى موجودًا في مواقع متعددة (مثل داخل عدة مستودعات).

Julia 1.3

تتطلب هذه الوظيفة على الأقل Julia 1.3.

source
Artifacts.artifact_pathFunction
artifact_path(hash::SHA1; honor_overrides::Bool=true)

بالنظر إلى عنصر (محدد بواسطة تجزئة شجرة git SHA1)، قم بإرجاع مسار تثبيته. إذا لم يكن العنصر موجودًا، فقم بإرجاع الموقع الذي سيتم تثبيته فيه.

جوليا 1.3

تتطلب هذه الوظيفة على الأقل جوليا 1.3.

source
Artifacts.select_downloadable_artifactsFunction
select_downloadable_artifacts(artifacts_toml::String;
                              platform = HostPlatform,
                              include_lazy = false,
                              pkg_uuid = nothing)

إرجاع قاموس حيث كل إدخال هو عنصر من العناصر من Artifacts.toml المعطاة التي يجب تنزيلها للمنصة المطلوبة. يتم تضمين العناصر الكسولة إذا تم تعيين include_lazy.

source