نام (NAME)

iex — پوسته تعاملی Elixir

خلاصه دستور (SYNOPSIS)

iex [OPTIONS]

توضیحات (DESCRIPTION)

پوسته تعاملی برای ارزیابی، اشکال‌زدایی و درون‌نگری (introspection) سامانه زمان اجرای Elixir به کار می‌رود. همچنین می‌توان از این برنامه برای آزمایش عملکرد قطعه‌کدهای کوچک، بدون نیاز به ذخیره کردن کد در یک فایل، استفاده کرد.

گزینه‌ها (OPTIONS)

توجه داشته باشید که بسیاری از گزینه‌های ذکر شده در اینجا از پوسته Erlang به امانت گرفته شده‌اند، بنابراین erl(1) می‌تواند به عنوان یک منبع اطلاعاتی اضافی برای گزینه‌ها استفاده شود.

-h, --help

پیام راهنما را در خطای استاندارد (stderr) نمایش می‌دهد و خارج می‌شود.

-v, --version

نسخه Elixir را در خروجی استاندارد (stdout) نمایش می‌دهد و خارج می‌شود.

-e, --eval expression

عبارت مشخص‌شده را ارزیابی می‌کند (گزینه --rpc-eval را ببینید).

-r file

فایل مشخص‌شده را ملزم (require) می‌کند. به عبارت دیگر، وجود فایل در ابتدای شروع iex بررسی می‌شود.

-S script

اسکریپت مشخص‌شده را اجرا می‌کند.

-pa directory

دایرکتوری مشخص‌شده را به ابتدای مسیر کد (code path) اضافه می‌کند. اگر دایرکتوری از قبل وجود داشته باشد، از جایگاه قبلی خود حذف شده و در ابتدا قرار می‌گیرد.

همچنین تابع Code.prepend_path/1 را ببینید.

-pr file

همان عملیات -r (بالا را ببینید) را به صورت موازی انجام می‌دهد.

-pz directory

دایرکتوری مشخص‌شده را به انتهای مسیر کد اضافه می‌کند. اگر دایرکتوری از قبل وجود داشته باشد، نه از جایگاه قبلی خود حذف می‌شود و نه به انتها منتقل می‌گردد.

همچنین تابع Code.append_path/1 را ببینید.

--app application

برنامه (application) مشخص‌شده و تمام وابستگی‌های آن را راه‌اندازی می‌کند.

--boot file

نام فایل بوت، file.boot را که برای راه‌اندازی سامانه استفاده می‌شود، مشخص می‌کند. مگر اینکه file شامل یک مسیر مطلق باشد، سامانه به دنبال file.boot در دایرکتوری جاری و دایرکتوری‌های $ROOT/bin می‌گردد.

پیش‌فرض $ROOT/bin/start.boot است.

این گزینه معادل -boot در Erlang است.

--boot-var var dir

اگر اسکریپت بوت شامل یک متغیر مسیر var به جز $ROOT باشد، این متغیر به dir بسط می‌یابد. زمانی استفاده می‌شود که برنامه‌ها در دایرکتوری دیگری غیر از $ROOT/lib نصب شده باشند.

این گزینه معادل -boot_var در Erlang است.

همچنین تابع :systools.make_script/1,2 در SASL را ببینید.

--erl parameters

همان کاربرد ELIXIR_ERL_OPTIONS را ارائه می‌دهد (بخش محیط (ENVIRONMENT) را ببینید).

--erl-config file

نام یک فایل پیکربندی، file.config را مشخص می‌کند که برای پیکربندی برنامه‌ها به کار می‌رود. توجه داشته باشید که فایل پیکربندی باید به زبان Erlang نوشته شده باشد.

این گزینه معادل -config در Erlang است.

--cookie value

مقدار مجیک کوکی (magic cookie) را مشخص می‌کند. اگر هنگام شروع به کار گره این مقدار از طریق گزینه مشخص نشده باشد، از فایل ~/.erlang.cookie خوانده خواهد شد (بخش فایل‌ها (FILES) را ببینید). گره‌های توزیع‌شده تنها زمانی می‌توانند با یکدیگر تعامل داشته باشند که مجیک کوکی‌های یکسانی داشته باشند.

همچنین تابع Node.set_cookie/2 را ببینید.

--hidden

یک گره پنهان (hidden node) را راه‌اندازی می‌کند.

اتصالات میان گره‌ها متعدی (transitive) هستند. برای مثال، اگر گره A به گره B متصل باشد و گره B به گره C متصل باشد، آنگاه گره A نیز به گره C متصل است. گزینه --hidden امکان ایجاد گره‌ای را فراهم می‌کند که می‌تواند بدون ایجاد اتصالات ناخواسته و اضافی، به گره دیگری متصل شود.

تابع Node.list/0 امکان دریافت فهرست گره‌های متصل به گره هدف را فراهم می‌کند؛ با این حال، این فهرست شامل گره‌های پنهان نخواهد بود. بسته به پارامتر ورودی، تابع Node.list/1 امکان دریافت فهرستی را فراهم می‌کند که تنها شامل گره‌های پنهان است (پارامتر :hidden) یا هر دو گره‌های پنهان و غیرپنهان (پارامتر :connected).

--logger-otp-reports val

گزارش‌دهی OTP را فعال یا غیرفعال می‌کند (val می‌تواند true یا false باشد).

--logger-sasl-reports val

گزارش‌دهی SASL را فعال یا غیرفعال می‌کند (val می‌تواند true یا false باشد).

--sname name

یک نام کوتاه به گره اختصاص می‌دهد و آن را راه‌اندازی می‌کند. نام‌های کوتاه به شکل name@host هستند، که در آن host نام میزبان مقصد (hostname(1)) است که گره را اجرا می‌کند. گره‌های دارای نام کوتاه تنها می‌توانند در یک شبکه محلی یکسان با یکدیگر تعامل داشته باشند.

--name name

یک نام بلند به گره اختصاص می‌دهد و آن را راه‌اندازی می‌کند. نام‌های بلند به شکل name@host هستند، که در آن host آدرس IP میزبانی است که گره را اجرا می‌کند. بر خلاف گره‌های دارای نام کوتاه، گره‌های دارای نام بلند به مرزهای یک شبکه محلی محدود نمی‌شوند (بالا را ببینید).

--pipe-to pipedir logdir

ماشین مجازی Erlang را با یک pipedir و logdir نام‌گذاری‌شده اجرا می‌کند (فقط برای سیستم‌عامل‌های شبیه به یونیکس).

--rpc-eval node expression

عبارت مشخص‌شده را روی گره تعیین‌شده ارزیابی می‌کند (گزینه --eval را ببینید).

--vm-args file

آرگومان‌های خط فرمان را از file می‌خواند و آن‌ها را به ماشین مجازی Erlang ارسال می‌کند.

این گزینه معادل -args_file در Erlang است.

--dot-iex file

فایل مشخص‌شده را به جای .iex.exs بارگذاری می‌کند (بخش فایل‌ها (FILES) را ببینید).

--remsh node

به گره مشخص‌شده‌ای که با گزینه‌های --sname یا --name راه‌اندازی شده است متصل می‌شود (بالا را ببینید).

--

گزینه‌های ارسال‌شده به کامپایلر را از گزینه‌های ارسال‌شده به کد اجرایی جدا می‌کند.

نکات (NOTES)

گزینه‌های زیر می‌توانند بیش از یک بار مشخص شوند: --boot-var, --erl-config, --eval, --rpc-eval.

محیط (ENVIRONMENT)

ELIXIR_ERL_OPTIONS

امکان ارسال پارامترها به زمان اجرای Erlang را فراهم می‌کند.

فایل‌ها (FILES)

~/.erlang.cookie

مقدار مجیک کوکی را ذخیره می‌کند که تنها در صورتی استفاده می‌شود که از طریق گزینه --cookie مشخص نشده باشد (بالا را ببینید). اگر هنگام راه‌اندازی گره این فایل وجود نداشته باشد، ایجاد خواهد شد.

.iex.exs

پس از شروع به کار iex، به دنبال فایل .iex.exs می‌گردد و در صورت یافتن، کد موجود در فایل را در زمینه (context) پوسته اجرا می‌کند. در ابتدا جستجو در دایرکتوری کاری جاری آغاز می‌شود؛ سپس در صورت نیاز، در دایرکتوری خانگی (home) ادامه می‌یابد.

همچنین ببینید (SEE ALSO)

elixir(1), elixirc(1), mix(1)

نویسندگان (AUTHORS)

Elixir توسط The Elixir Team نگهداری می‌شود.

 

این صفحه راهنما توسط Evgeny Golyshev تهیه شده است.

 

Copyright (c) 2012 Plataformatec.

 

Copyright (c) 2021 The Elixir Team.

 

منابع اینترنتی (INTERNET RESOURCES)

وبگاه اصلی: https://elixir-lang.org

 

مستندات: https://elixir-lang.org/docs.html