Command-line Interface

Using arguments inside scripts

スクリプトを julia を使って実行する際に、スクリプトに追加の引数を渡すことができます：

$ julia script.jl arg1 arg2...

これらの追加のコマンドライン引数は、グローバル定数 ARGS に渡されます。スクリプト自体の名前は、グローバル PROGRAM_FILE として渡されます。コマンドラインで -e オプションを使用してJulia式が与えられた場合（以下の julia ヘルプ出力を参照）、ARGS も設定されますが、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用の引数を区別するために使用できます:

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

詳細な情報については Scripting を参照してください。

The Main.main entry point

Julia 1.11 以降、Base はマクロ @main をエクスポートします。このマクロはシンボル main に展開されますが、スクリプトや式の実行が終了すると、julia は Main.main(Base.ARGS) を実行しようとします。これは、Main.main という関数が定義されており、この動作が @main マクロを使用することで選択された場合に限ります。

この機能は、コンパイルされたワークフローとインタラクティブなワークフローの統合を支援することを目的としています。コンパイルされたワークフローでは、main 関数を定義するコードの読み込みが、呼び出しから空間的および時間的に分離される場合があります。しかし、インタラクティブなワークフローでは、評価されたスクリプトまたは式の最後で exit(main(ARGS)) を明示的に呼び出すのと同等の動作になります。

この機能を実際に見るために、次の定義を考えてみてください。これは、mainへの明示的な呼び出しがなくても、print関数を実行します。

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

Mainモジュールのmainバインディングのみがこの動作を持ち、定義モジュール内でマクロ@mainが使用された場合に限ります。

例えば、mainの代わりにhelloを使用しても、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
$

ただし、現在のベストプラクティスの推奨事項は、アプリケーションコードと再利用可能なライブラリコードを同じパッケージに混在させないことです。ヘルパーアプリケーションは、別のパッケージとして配布するか、パッケージの bin フォルダー内にある別の main エントリポイントを持つスクリプトとして配布することができます。

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を実行するたびに実行したいコードがある場合は、それを~/.julia/config/startup.jlに置くことができます：

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

...

最初にJuliaを実行した後、~/.juliaディレクトリが作成されるはずですが、使用する場合は~/.julia/configフォルダと~/.julia/config/startup.jlファイルを作成する必要があるかもしれません。

The Julia REPL でのみスタートアップコードを実行し（例えば、julia がスクリプトで実行されるときには実行しない）、startup.jl に atreplinit を使用します：

atreplinit() do repl
    # ...
end

Command-line switches for Julia

Juliaコードを実行する方法はいくつかあり、perlやrubyプログラムで利用可能なオプションに似たものがあります：

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

次のは、juliaを起動する際に利用可能なコマンドラインスイッチの完全なリストです（'*'はデフォルト値を示します。'($)'でマークされた設定は、パッケージの事前コンパイルをトリガーする可能性があります）：

--option={...} の形式を持つオプションは、--option=value または --option value として指定できます。例えば、julia --banner=no は julia --banner no と同等です。これは、出力用のファイル名を取るオプションに特に関連しており、（例えば）--trace-compile の引数を指定し忘れると、その後のオプションがファイル名として解釈され、意図せず上書きされる可能性があります。

--option[=...] の形式のオプションは、--option value として指定することはできません。代わりに --option=value として指定する必要があります（引数が提供されない場合は単に --option として指定できます）。