Command-line Interface

Using arguments inside scripts

عند تشغيل نص باستخدام julia، يمكنك تمرير معلمات إضافية إلى نصك:

$ julia script.jl arg1 arg2...

تُمرر هذه المعاملات الإضافية لواجهة الأوامر في الثابت العالمي ARGS. يتم تمرير اسم البرنامج النصي نفسه كـ PROGRAM_FILE العالمي. لاحظ أن ARGS يتم تعيينه أيضًا عندما يتم إعطاء تعبير جوليا باستخدام خيار -e في سطر الأوامر (انظر مخرجات مساعدة julia أدناه) ولكن سيكون PROGRAM_FILE فارغًا. على سبيل المثال، لطباعة المعاملات المعطاة لبرنامج نصي، يمكنك القيام بذلك:

$ julia -e 'println(PROGRAM_FILE); for x in ARGS; println(x); end' foo bar

foo
bar

أو يمكنك وضع هذا الرمز في نص وتشغيله:

$ echo 'println(PROGRAM_FILE); for x in ARGS; println(x); end' > script.jl
$ julia script.jl foo bar
script.jl
foo
bar

يمكن استخدام الفاصل -- لفصل وسائط سطر الأوامر المخصصة لملف البرنامج النصي عن الوسائط المخصصة لجوليا:

$ julia --color=yes -O -- script.jl arg1 arg2..

انظر أيضًا Scripting لمزيد من المعلومات حول كتابة نصوص جوليا.

The Main.main entry point

اعتبارًا من جوليا 1.11، يقوم Base بتصدير الماكرو @main. هذا الماكرو يتوسع إلى الرمز main، ولكن عند الانتهاء من تنفيذ نص أو تعبير، سيحاول julia تنفيذ الدالة Main.main(ARGS) إذا تم تعريف مثل هذه الدالة وتم اختيار هذا السلوك باستخدام الماكرو @main.

تُعَد هذه الميزة مخصصة للمساعدة في توحيد سير العمل المجمعة والتفاعلية. في سير العمل المجمعة، قد يكون تحميل الكود الذي يُعرّف دالة main مفصولًا مكانيًا وزمنيًا عن الاستدعاء. ومع ذلك، بالنسبة لسير العمل التفاعلية، فإن السلوك يعادل استدعاء exit(main(ARGS)) بشكل صريح في نهاية البرنامج النصي أو التعبير المُقيَّم.

لرؤية هذه الميزة قيد التنفيذ، اعتبر التعريف التالي، الذي سينفذ دالة الطباعة على الرغم من عدم وجود استدعاء صريح لـ main:

$ julia -e '(@main)(args) = println("Hello World!")'
Hello World!
$

فقط الربط main في وحدة Main لديه هذا السلوك وفقط إذا تم استخدام الماكرو @main داخل الوحدة المعرفة.

على سبيل المثال، استخدام hello بدلاً من main لن يؤدي إلى تنفيذ دالة hello:

$ julia -e 'hello(ARGS) = println("Hello World!")'
$

ولن يكون تعريف بسيط لـ main:

$ julia -e 'main(ARGS) = println("Hello World!")'
$

ومع ذلك، لا يلزم أن يحدث الاشتراك في وقت التعريف:

$ julia -e 'main(ARGS) = println("Hello World!"); @main'
Hello World!
$

يمكن استيراد الربط main من حزمة. حزمة hello world المعرفة كالتالي

module Hello

export main
(@main)(args) = println("Hello from the package!")

end

قد يُستخدم كـ:

$ julia -e 'using Hello'
Hello from the package!
$ julia -e 'import Hello' # N.B.: Execution depends on the binding not whether the package is loaded
$

ومع ذلك، لاحظ أن التوصية الحالية لأفضل الممارسات هي عدم خلط كود التطبيق وكود المكتبة القابلة لإعادة الاستخدام في نفس الحزمة. يمكن توزيع التطبيقات المساعدة كحزم منفصلة أو كبرامج نصية مع نقاط دخول main منفصلة في مجلد bin الخاص بالحزمة.

Parallel mode

يمكن بدء Julia في وضع التوازي باستخدام إما خيارات -p أو --machine-file. ستقوم -p n بإطلاق n عمليات عامل إضافية، بينما ستقوم --machine-file file بإطلاق عامل لكل سطر في الملف file. يجب أن تكون الآلات المعرفة في file قابلة للوصول عبر تسجيل دخول ssh بدون كلمة مرور، مع تثبيت Julia في نفس الموقع مثل المضيف الحالي. تأخذ كل تعريف آلة الشكل [count*][user@]host[:port] [bind_addr[:port]]. الافتراضي لـ user هو المستخدم الحالي، و port هو منفذ ssh القياسي. count هو عدد العمال الذين سيتم إنشاؤهم على العقدة، والافتراضي هو 1. يحدد الخيار الاختياري bind-to bind_addr[:port] عنوان IP والمنفذ الذي يجب أن تستخدمه العمال الآخرون للاتصال بهذا العامل.

Startup file

إذا كان لديك كود تريد تنفيذه كلما تم تشغيل جوليا، يمكنك وضعه في ~/.julia/config/startup.jl:

$ echo 'println("Greetings! 你好! 안녕하세요?")' > ~/.julia/config/startup.jl
$ julia
Greetings! 你好! 안녕하세요?

...

لاحظ أنه على الرغم من أنه يجب أن يكون لديك دليل ~/.julia بمجرد تشغيلك لجوليا لأول مرة، قد تحتاج إلى إنشاء مجلد ~/.julia/config وملف ~/.julia/config/startup.jl إذا كنت تستخدمه.

لتشغيل كود بدء التشغيل فقط في The Julia REPL (وليس عند تشغيل julia على سبيل المثال في نص برمجي)، استخدم atreplinit في startup.jl:

atreplinit() do repl
    # ...
end

Command-line switches for Julia

هناك طرق مختلفة لتشغيل كود جوليا وتوفير خيارات، مشابهة لتلك المتاحة لبرامج perl و ruby:

julia [switches] -- [programfile] [args...]

القائمة التالية هي قائمة كاملة من مفاتيح سطر الأوامر المتاحة عند تشغيل جوليا (علامة '*' تشير إلى القيمة الافتراضية، إذا كانت قابلة للتطبيق؛ الإعدادات المميزة '($)' قد تؤدي إلى تجميع الحزم مسبقًا):