Command-line Interface

Using arguments inside scripts

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

$ julia script.jl arg1 arg2...

これらの追加のコマンドライン引数は、グローバル定数 ARGS に渡されます。スクリプト自体の名前は、グローバル PROGRAM_FILE として渡されます。コマンドラインで -e オプションを使用して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(ARGS) という関数を実行しようとします。もしそのような関数が定義されており、@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を起動する際に利用可能なコマンドラインスイッチの完全なリストです（'*'はデフォルト値を示します。'($)'でマークされた設定は、パッケージの事前コンパイルをトリガーする可能性があります）：