The Julia REPL

Juliaには、julia実行ファイルに組み込まれた、機能豊富な対話型コマンドラインREPL(read-eval-print loop)が付属しています。Juliaの文をすばやく簡単に評価できるだけでなく、検索可能な履歴、タブ補完、便利なキーバインド、専用のヘルプモードとシェルモードも備えています。引数を指定せずにjuliaを呼び出すか、実行ファイルをダブルクリックするだけでREPLを起動できます。

$ julia

               _
   _       _ _(_)_     |  Documentation: https://docs.julialang.org
  (_)     | (_) (_)    |
   _ _   _| |_  __ _   |  Type "?" for help, "]?" for Pkg help.
  | | | | | | |/ _` |  |
  | | |_| | | | (_| |  |  Version 1.13.3 (2026-10-25)
 _/ |\__'_|_|_|\__'_|  |  HEAD/67ac47b* (fork: 1 commits, 12 days)
|__/                   |


julia>

対話セッションを終了するには、^D(空行でControlキーとdキーを同時に押す)と入力するか、exit()と入力してReturnキーまたはEnterキーを押します。REPLがバナーとjulia>プロンプトを表示します。

The different prompt modes

The Julian mode

REPLには、主に5つの動作モードがあります。最も一般的なのはJuliaプロンプトで、デフォルトのモードです。新しい行は通常、julia>で始まります。ここにJuliaの式を入力します。式を入力し終えてReturnキーまたはEnterキーを押すと、その式が評価され、最後の式の結果が表示されます。

julia> string(1 + 2)
"3"

対話的な作業に便利な機能もいくつかあります。REPLは結果を表示するだけでなく、その結果を変数ansにも束縛します。行末にセミコロンを付けると、結果の表示を抑制できます。

julia> string(3 * 4);

julia> ans
"12"

Juliaモードでは、「プロンプト貼り付け」と呼ばれる機能が使えます。julia>で始まるテキストをREPLに貼り付けると、この機能が有効になります。この場合、julia>で始まる式(および他のREPLモードのプロンプトであるshell>、help?>、pkg>)だけが解析され、それ以外は削除されます。そのため、プロンプトや出力を取り除かなくても、REPLセッションからコピーしたテキストをまとめて貼り付けられます。この機能はデフォルトで有効ですが、REPL.enable_promptpaste(::Bool)でいつでも無効化または有効化できます。有効な場合は、この段落の上にあるコードブロックをそのままREPLに貼り付けて試せます。標準のWindowsコマンドプロンプトでは、貼り付けが行われたことを検出する機能に制限があるため、この機能は動作しません。

式の実行結果がnothingでない場合、REPLは特定のIOContextを指定してshow関数を使い、結果を表示します(display経由で指定されます。デフォルトではshow(io, MIME("text/plain"), ans)を呼び出し、さらにそのデフォルトはshow(io, ans)です)。特に、:limit属性はtrueに設定されます。showメソッドによっては、:compactのように、まだ設定されていない属性にデフォルト値が設定されることもあります。実験的な機能として、Base.active_repl.options.iocontext辞書を使い、REPLで使用する属性とその値を指定できます。たとえば、次のようにします。

julia> rand(2, 2)
2×2 Matrix{Float64}:
 0.8833    0.329197
 0.719708  0.59114

julia> show(IOContext(stdout, :compact => false), "text/plain", rand(2, 2))
 0.43540323669187075  0.15759787870609387
 0.2540832269192739   0.4597637838786053
julia> Base.active_repl.options.iocontext[:compact] = false;

julia> rand(2, 2)
2×2 Matrix{Float64}:
 0.2083967319174056  0.13330606013126012
 0.6244375177790158  0.9777957560761545

起動時にこの辞書の値を自動的に定義するには、たとえば~/.julia/config/startup.jlファイルでatreplinit関数を使います。

atreplinit() do repl
    repl.options.iocontext[:compact] = false
end

Help mode

カーソルが行頭にあるときに?と入力すると、プロンプトをヘルプモードに切り替えられます。ヘルプモードで入力した内容について、Juliaはヘルプやドキュメントの表示を試みます。

julia> ? # upon typing ?, the prompt changes (in place) to: help?>

help?> string
search: string String Cstring Cwstring RevString randstring bytestring SubString

  string(xs...)

  Create a string from any values using the print function.

マクロ、型、変数についても問い合わせることができます。

help?> @time
  @time

  A macro to execute an expression, printing the time it took to execute, the number of allocations,
  and the total number of bytes its execution caused to be allocated, before returning the value of the
  expression.

  See also @timev, @timed, @elapsed, and @allocated.

help?> Int32
search: Int32 UInt32

  Int32 <: Signed

  32-bit signed integer type.

文字列リテラルまたは正規表現リテラルを入力すると、aproposを使ってすべてのdocstringを検索できます。

help?> "aprop"
REPL.stripmd
Base.Docs.apropos

help?> r"ap..p"
Base.:∘
Base.shell_escape_posixly
Distributed.CachingPool
REPL.stripmd
Base.Docs.apropos

ヘルプモードでは、拡張docstringにもアクセスできます。たとえば、?Printではなく??Printと入力すると、ソースコードのドキュメントにある# Extended helpセクションが表示されます。

ヘルプモードを終了するには、行頭でBackspaceキーを押します。

Shell mode

ヘルプモードでドキュメントをすばやく参照できるのと同様に、システムシェルを使ってシステムコマンドを実行することもよくあります。行頭で?を入力するとヘルプモードに切り替わりますが、セミコロン(;)を入力するとシェルモードに切り替わります。シェルモードは、行頭でBackspaceキーを押すと終了できます。

julia> ; # upon typing ;, the prompt changes (in place) to: shell>

shell> echo hello
hello
Note

Windowsユーザーの場合、JuliaのシェルモードからWindowsのシェルコマンドを実行することはできません。そのため、次のコマンドは失敗します。

julia> ; # upon typing ;, the prompt changes (in place) to: shell>

shell> dir
ERROR: IOError: could not spawn `dir`: no such file or directory (ENOENT)
Stacktrace!
.......

ただし、次のようにすればPowerShellを利用できます。

julia> ; # upon typing ;, the prompt changes (in place) to: shell>

shell> powershell
Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.
PS C:\Users\elm>

また、dirコマンドを使えば、次のようにcmd.exeも利用できます。

julia> ; # upon typing ;, the prompt changes (in place) to: shell>

shell> cmd
Microsoft Windows [version 10.0.17763.973]
(c) 2018 Microsoft Corporation. All rights reserved.
C:\Users\elm>dir
 Volume in drive C has no label
 Volume Serial Number is 1643-0CD7
  Directory of C:\Users\elm

29/01/2020  22:15    <DIR>          .
29/01/2020  22:15    <DIR>          ..
02/02/2020  08:06    <DIR>          .atom

Pkg mode

パッケージマネージャーモードでは、パッケージの読み込みや更新に特化したコマンドを使えます。Julia REPLのプロンプトで]キーを押すとこのモードに入り、CTRL-Cまたは行頭でBackspaceキーを押すと終了します。このモードのプロンプトはpkg>です。専用のヘルプモードもあり、pkg>プロンプトの行頭で?を押すと入れます。パッケージマネージャーモードの詳細は、https://julialang.github.io/Pkg.jl/v1/で参照できるPkgマニュアルに記載されています。

History searching

上記のすべてのモードで、実行した行は検索可能な履歴ファイルに保存されます。過去の履歴を対話的に検索するには、^R(Controlキーとrキー)を押します。

対話型の履歴ビューアーが表示されます。検索文字列を入力すると履歴が絞り込まれ、Enterキーを押すと選択した履歴項目がREPLに挿入されます。履歴検索機能の詳しいヘルプは、REPLで特殊なクエリ?および??を使って参照できます。

Julia REPLで実行したコマンドはすべて~/.julia/logs/repl_history.jlに記録されます。記録には実行時のタイムスタンプと、そのときのREPLモードも含まれます。履歴検索機能はこのログファイルを読み込み、以前に実行したコマンドを検索します。複数のREPLから同時にこのファイルへ書き込むことができ、検索を開始するたびに最新の履歴が取得されます。Juliaの起動時に--history-file=noフラグを渡すと、このファイルの使用を無効にできます。

Key bindings

Julia REPLではキーバインドを幅広く活用できます。終了用の^Dや検索用の^Rなど、いくつかのControlキーのキーバインドをすでに紹介しましたが、ほかにも多数あります。Controlキーに加えて、Metaキーのキーバインドもあります。これらはプラットフォームによる違いが大きいものの、多くの端末ではAltキーまたはOptionキーを押しながら別のキーを押すとMetaキーとして送信されます(そのように設定することもできます)。または、Escキーを押してから別のキーを押します。

キーバインド説明
プログラム制御
^D終了(バッファーが空の場合)
^C割り込みまたはキャンセル
^Lコンソール画面を消去
Return/Enter、^J改行。入力が完了していれば実行
meta-Return/Enter実行せずに改行を挿入
?または;ヘルプモードまたはシェルモードに切り替え(行頭の場合)
^R、^S上記の対話型履歴検索
カーソル移動
右矢印、^F右へ1文字移動
左矢印、^B左へ1文字移動
ctrl-右、meta-F右へ1単語移動
ctrl-左、meta-B左へ1単語移動
Home、^A行頭へ移動
End、^E行末へ移動
上矢印、^P1行上へ移動(またはカーソルより前のテキストに一致する直前の履歴項目へ移動)
下矢印、^N1行下へ移動(またはカーソルより前のテキストに一致する次の履歴項目へ移動)
Shift-矢印キー矢印キーの方向にカーソルを移動し、領域を有効化(「Shift選択」)
Page-up、meta-P直前の履歴項目へ移動
Page-down、meta-N次の履歴項目へ移動
meta-<最初の履歴項目へ移動(現在の履歴位置より前にある場合は、現在のセッションの最初の項目)
meta->最後の履歴項目へ移動
^-Space編集領域に「マーク」を設定(領域が有効な場合は無効化)
^-Space ^-Space編集領域に「マーク」を設定し、領域を有効化(ハイライト表示)
^G領域を無効化(ハイライト表示を解除)
^X^X現在位置とマークを入れ替え
編集
Backspace、^H直前の文字を削除。領域が有効な場合は領域全体を削除
Delete、^D1文字を前方削除(バッファーにテキストがある場合)
meta-Backspace直前の単語を削除
meta-d次の単語を前方削除
^W最も近い空白文字までの直前のテキストを削除
meta-w現在の領域をキルリングにコピー
meta-W現在の領域を「キル」し、テキストをキルリングに格納
^U行頭までを「キル」し、テキストをキルリングに格納
^K行末までを「キル」し、テキストをキルリングに格納
^Yキルリングのテキストを「ヤンク」して挿入
meta-y直前にヤンクしたテキストを、キルリング内の古い項目で置換
^Tカーソル付近の文字を入れ替え
meta-Up arrow現在の行と1行上の行を入れ替え
meta-Down arrow現在の行と1行下の行を入れ替え
meta-u次の単語を大文字に変換
meta-c次の単語をタイトルケースに変換
meta-l次の単語を小文字に変換
^/、^_直前の編集操作を元に戻す
^QREPLに数値を入力して^Qを押すと、対応するスタックフレームまたはメソッドをエディターで開く
meta-Left Arrow現在の行を左にインデント
meta-Right Arrow現在の行を右にインデント
meta-.直前の履歴項目の最後の単語を挿入
meta-e現在の入力をエディターで編集
履歴検索
上矢印、^P、^Kフォーカスを1項目上へ移動
下矢印、^P、^Nフォーカスを1項目下へ移動
Page up、^Bフォーカスを1ページ上へ移動
Page down、^Fフォーカスを1ページ下へ移動
meta-<最初(最も古い)の履歴項目にフォーカス
meta->最後(最も新しい)の履歴項目にフォーカス
Tab現在フォーカスされている項目の選択を切り替え
Enter現在フォーカスされている項目または選択済みの項目を確定
^Sフォーカスされている項目または選択済みの項目をクリップボードまたはファイルに保存
^C、^D、^G履歴検索を中止

Customizing keybindings

REPL.setup_interfaceに辞書を渡すと、Julia REPLのキーバインドをユーザーの好みに合わせて自由にカスタマイズできます。この辞書のキーには文字または文字列を指定できます。キー'*'はデフォルトのアクションを表します。Controlキーと文字xの組み合わせは、"^x"で表します。Metaキーとxの組み合わせは"\\M-x"または"\ex"、Controlキーとxの組み合わせは"\\C-x"または"^x"と記述できます。カスタムキーマップの値には、入力を無視することを示すnothing、またはシグネチャ(PromptState, AbstractREPL, Char)を受け取る関数を指定します。REPL.setup_interface関数はREPLの初期化前に呼び出す必要があるため、atreplinitに処理を登録します。たとえば、上矢印キーと下矢印キーで、前方一致検索を使わずに履歴を移動できるようにするには、次のコードを~/.julia/config/startup.jlに記述します。

import REPL
import REPL.LineEdit

const mykeys = Dict{Any,Any}(
    # Up Arrow
    "\e[A" => (s,o...)->(LineEdit.edit_move_up(s) || LineEdit.history_prev(s, LineEdit.mode(s).hist)),
    # Down Arrow
    "\e[B" => (s,o...)->(LineEdit.edit_move_down(s) || LineEdit.history_next(s, LineEdit.mode(s).hist))
)

function customize_keys(repl)
    repl.interface = REPL.setup_interface(repl; extra_repl_keymap = mykeys)
end

atreplinit(customize_keys)

キー入力に対して利用できるアクションを確認するには、LineEdit.jlを参照してください。

Automatic bracket insertion

Julia REPLでは、開き括弧、丸括弧、中括弧、引用符を入力すると、対応する閉じ記号を自動挿入できます。

この機能が有効な場合、開き括弧(、{、または[を入力すると、対応する閉じ括弧)、}、または]が自動挿入され、カーソルはその間に置かれます。引用符("、'、$`$)も同様です。その後、閉じ記号を入力すると、REPLは重複して挿入する代わりに、自動挿入された記号を飛び越えます。また、自動挿入の直後にBackspaceキーを押すと、開き記号と閉じ記号の両方が削除されます。

この機能を無効にするには、~/.julia/config/startup.jlファイルに次の設定を追加します。

atreplinit() do repl
    # Robust against older julia versions
    if hasfield(typeof(repl.options), :auto_insert_closing_bracket)
        repl.options.auto_insert_closing_bracket = false
    end
end

Tab completion

REPLのJuliaモード、pkgモード、ヘルプモードでは、関数名や型名の先頭数文字を入力してTabキーを押すと、一致する候補の一覧が表示されます。

julia> x[TAB]
julia> xor

場合によっては、曖昧さが生じる直前までしか補完されないことがあります。

julia> mapf[TAB]
julia> mapfold

その状態でもう一度Tabキーを押すと、補完候補の一覧が表示されます。

julia> mapfold[TAB]
mapfoldl mapfoldr

入力行の末尾でタブ補完の候補が1つに絞られ、2文字以上入力されている場合は、補完候補が薄い色でヒント表示されます。この機能はBase.active_repl.options.hint_tab_completes = falseで無効にするか、次の設定を

atreplinit() do repl
    if VERSION >= v"1.11.0-0"
        repl.options.hint_tab_completes = false
    end
end

~/.julia/config/startup.jlに追加して無効にできます。

Julia 1.11

タブ補完のヒント表示はJulia 1.11で追加されました。

REPLのほかの機能と同様、検索では大文字と小文字が区別されます。

julia> stri[TAB]
stride     strides     string      strip

julia> Stri[TAB]
StridedArray    StridedMatrix    StridedVecOrMat  StridedVector    String

Tabキーを使うと、LaTeXの数式記号を対応するUnicode文字に置き換えたり、LaTeXの候補一覧を表示したりすることもできます。

julia> \pi[TAB]
julia> π
π = 3.1415926535897...

julia> e\_1[TAB] = [1,0]
julia> e₁ = [1,0]
2-element Vector{Int64}:
 1
 0

julia> e\^1[TAB] = [1 0]
julia> e¹ = [1 0]
1×2 Matrix{Int64}:
 1  0

julia> \sqrt[TAB]2     # √ is equivalent to the sqrt function
julia> √2
1.4142135623730951

julia> \hbar[TAB](h) = h / 2\pi[TAB]
julia> ħ(h) = h / 2π
ħ (generic function with 1 method)

julia> \h[TAB]
\hat              \hermitconjmatrix  \hkswarow          \hrectangle
\hatapprox        \hexagon           \hookleftarrow     \hrectangleblack
\hbar             \hexagonblack      \hookrightarrow    \hslash
\heartsuit        \hksearow          \house             \hspace

julia> α="\alpha[TAB]"   # LaTeX completion also works in strings
julia> α="α"

タブ補完の一覧は、マニュアルのUnicode Inputセクションにあります。

パスの補完は、文字列とJuliaのシェルモードで利用できます。

julia> path="/[TAB]"
.dockerenv  .juliabox/   boot/        etc/         lib/         media/       opt/         root/        sbin/        sys/         usr/
.dockerinit bin/         dev/         home/        lib64/       mnt/         proc/        run/         srv/         tmp/         var/
shell> /[TAB]
.dockerenv  .juliabox/   boot/        etc/         lib/         media/       opt/         root/        sbin/        sys/         usr/
.dockerinit bin/         dev/         home/        lib64/       mnt/         proc/        run/         srv/         tmp/         var/

辞書のキーもタブ補完できます。

julia> foo = Dict("qwer1"=>1, "qwer2"=>2, "asdf"=>3)
Dict{String,Int64} with 3 entries:
  "qwer2" => 2
  "asdf"  => 3
  "qwer1" => 1

julia> foo["q[TAB]

"qwer1" "qwer2"
julia> foo["qwer

フィールドの補完にもタブ補完を利用できます。

julia> x = 3 + 4im;

julia> x.[TAB][TAB]
im re

julia> import UUIDs

julia> UUIDs.uuid[TAB][TAB]
uuid1        uuid4         uuid5        uuid_version

関数の出力に含まれるフィールドも補完できます。

julia> split("","")[1].[TAB]
lastindex  offset  string

関数の出力に含まれるフィールドの補完には型推論が使われます。そのため、関数が型安定である場合に限り、フィールド候補が提示されます。

入力した引数に一致する利用可能なメソッドを調べる際にも、タブ補完が役立ちます。

julia> max([TAB] # All methods are displayed, not shown here due to size of the list

julia> max([1, 2], [TAB] # All methods where `Vector{Int}` matches as first argument
max(x, y) in Base at operators.jl:215
max(a, b, c, xs...) in Base at operators.jl:281

julia> max([1, 2], max(1, 2), [TAB] # All methods matching the arguments.
max(x, y) in Base at operators.jl:215
max(a, b, c, xs...) in Base at operators.jl:281

;の後には、キーワード引数も候補メソッドに表示されます。以下の例では、limitとkeepemptyがキーワード引数です。

julia> split("1 1 1", [TAB]
split(str::AbstractString; limit, keepempty) in Base at strings/util.jl:302
split(str::T, splitter; limit, keepempty) where T<:AbstractString in Base at strings/util.jl:277

メソッドの補完には型推論が使われるため、引数が関数の出力であっても、その型が一致するかどうかを判定できます。ただし、一致しないメソッドを候補から除外するには、関数が型安定である必要があります。

特定の引数型で使えるメソッドを調べるには、関数名として?を使います。次の例では、InteractiveUtils内で、文字列を1つ受け取る関数を検索しています。

julia> InteractiveUtils.?("somefile")[TAB]
edit(path::AbstractString) in InteractiveUtils at InteractiveUtils/src/editless.jl:197
less(file::AbstractString) in InteractiveUtils at InteractiveUtils/src/editless.jl:266

この例では、文字列に対して呼び出せるInteractiveUtilsモジュール内のメソッドが一覧表示されました。デフォルトでは、すべての引数がAny型として指定されているメソッドは除外されます。TABの代わりにSHIFT-TABを押すと、それらも表示できます。

julia> InteractiveUtils.?("somefile")[SHIFT-TAB]
apropos(string) in REPL at REPL/src/docview.jl:796
clipboard(x) in InteractiveUtils at InteractiveUtils/src/clipboard.jl:64
code_llvm(f) in InteractiveUtils at InteractiveUtils/src/codeview.jl:221
code_native(f) in InteractiveUtils at InteractiveUtils/src/codeview.jl:243
edit(path::AbstractString) in InteractiveUtils at InteractiveUtils/src/editless.jl:197
edit(f) in InteractiveUtils at InteractiveUtils/src/editless.jl:225
eval(x) in InteractiveUtils at InteractiveUtils/src/InteractiveUtils.jl:3
include(x) in InteractiveUtils at InteractiveUtils/src/InteractiveUtils.jl:3
less(file::AbstractString) in InteractiveUtils at InteractiveUtils/src/editless.jl:266
less(f) in InteractiveUtils at InteractiveUtils/src/editless.jl:274
report_bug(kind) in InteractiveUtils at InteractiveUtils/src/InteractiveUtils.jl:391
separate_kwargs(args...; kwargs...) in InteractiveUtils at InteractiveUtils/src/macros.jl:7

?("somefile")[TAB]を使うと、すべてのモジュールを対象に検索することもできますが、メソッドの一覧が長くなる場合があります。

閉じ括弧を省略すると、追加の引数が必要になる可能性のある関数も候補に含められます。

julia> using Mmap

help?> Mmap.?("file",[TAB]
Mmap.Anonymous(name::String, readonly::Bool, create::Bool) in Mmap at Mmap/src/Mmap.jl:16
mmap(file::AbstractString) in Mmap at Mmap/src/Mmap.jl:245
mmap(file::AbstractString, ::Type{T}) where T<:Array in Mmap at Mmap/src/Mmap.jl:245
mmap(file::AbstractString, ::Type{T}, dims::Tuple{Vararg{Integer, N}}) where {T<:Array, N} in Mmap at Mmap/src/Mmap.jl:245
mmap(file::AbstractString, ::Type{T}, dims::Tuple{Vararg{Integer, N}}, offset::Integer; grow, shared) where {T<:Array, N} in Mmap at Mmap/src/Mmap.jl:245
mmap(file::AbstractString, ::Type{T}, len::Integer) where T<:Array in Mmap at Mmap/src/Mmap.jl:251
mmap(file::AbstractString, ::Type{T}, len::Integer, offset::Integer; grow, shared) where T<:Array in Mmap at Mmap/src/Mmap.jl:251
mmap(file::AbstractString, ::Type{T}, dims::Tuple{Vararg{Integer, N}}) where {T<:BitArray, N} in Mmap at Mmap/src/Mmap.jl:316
mmap(file::AbstractString, ::Type{T}, dims::Tuple{Vararg{Integer, N}}, offset::Integer; grow, shared) where {T<:BitArray, N} in Mmap at Mmap/src/Mmap.jl:316
mmap(file::AbstractString, ::Type{T}, len::Integer) where T<:BitArray in Mmap at Mmap/src/Mmap.jl:322
mmap(file::AbstractString, ::Type{T}, len::Integer, offset::Integer; grow, shared) where T<:BitArray in Mmap at Mmap/src/Mmap.jl:322

Syntax Highlighting

REPLでは、入力中の構文がハイライト表示されます。構文ハイライトはデフォルトで有効ですが、~/.julia/config/startup.jlで無効にできます。

atreplinit() do repl
    repl.options.style_input = false
end

Customizing Syntax Highlighting Colors

デフォルトの構文ハイライトテーマは控えめな配色ですが、TOMLファイルfaces.toml(.julia/config内のhttps://julialang.github.io/StyledStrings.jl/dev/#stdlib-styledstrings-face-toml))を使ってカスタマイズできます。または、face TOMLファイルからfaceを明示的に読み込むこともできます。

例:Monokaiカラーテーマ(クリックして展開)

# Monokai color theme for Julia syntax highlighting

[julia_macro]
foreground = "#A6E22E"

[julia_symbol]
foreground = "#AE81FF"

[julia_singleton_identifier]
inherit = "julia_symbol"

[julia_type]
foreground = "#66D9EF"

[julia_typedec]
foreground = "#66D9EF"
weight = "bold"

[julia_comment]
foreground = "#75715E"
italic = true

[julia_string]
foreground = "#E6DB74"

[julia_regex]
inherit = "julia_string"

[julia_backslash_literal]
foreground = "#FD971F"
inherit = "julia_string"

[julia_string_delim]
foreground = "#E6DB74"
weight = "bold"

[julia_cmd]
inherit = "julia_string"

[julia_char]
inherit = "julia_string"

[julia_char_delim]
inherit = "julia_string_delim"

[julia_number]
foreground = "#AE81FF"

[julia_bool]
foreground = "#AE81FF"
weight = "bold"

[julia_funcall]
foreground = "#A6E22E"

[julia_broadcast]
foreground = "#F92672"
weight = "bold"

[julia_builtin]
foreground = "#66D9EF"
weight = "bold"

[julia_operator]
foreground = "#F92672"

[julia_comparator]
inherit = "julia_operator"

[julia_assignment]
foreground = "#F92672"
weight = "bold"

[julia_keyword]
foreground = "#F92672"
weight = "bold"

[julia_parentheses]
foreground = "#F8F8F2"

[julia_unpaired_parentheses]
background = "#F92672"
foreground = "#F8F8F0"
weight = "bold"

[julia_error]
background = "#F92672"
foreground = "#F8F8F0"

[julia_rainbow_paren_1]
foreground = "#A6E22E"
inherit = "julia_parentheses"

[julia_rainbow_paren_2]
foreground = "#66D9EF"
inherit = "julia_parentheses"

[julia_rainbow_paren_3]
foreground = "#FD971F"
inherit = "julia_parentheses"

[julia_rainbow_paren_4]
inherit = "julia_rainbow_paren_1"

[julia_rainbow_paren_5]
inherit = "julia_rainbow_paren_2"

[julia_rainbow_paren_6]
inherit = "julia_rainbow_paren_3"

# Rainbow brackets
[julia_rainbow_bracket_1]
foreground = "#AE81FF"
inherit = "julia_parentheses"

[julia_rainbow_bracket_2]
foreground = "#E6DB74"
inherit = "julia_parentheses"

[julia_rainbow_bracket_3]
inherit = "julia_rainbow_bracket_1"

[julia_rainbow_bracket_4]
inherit = "julia_rainbow_bracket_2"

[julia_rainbow_bracket_5]
inherit = "julia_rainbow_bracket_1"

[julia_rainbow_bracket_6]
inherit = "julia_rainbow_bracket_2"

# Rainbow curlies
[julia_rainbow_curly_1]
foreground = "#F92672"
inherit = "julia_parentheses"

[julia_rainbow_curly_2]
foreground = "#A6E22E"
inherit = "julia_parentheses"

[julia_rainbow_curly_3]
inherit = "julia_rainbow_curly_1"

[julia_rainbow_curly_4]
inherit = "julia_rainbow_curly_2"

[julia_rainbow_curly_5]
inherit = "julia_rainbow_curly_1"

[julia_rainbow_curly_6]
inherit = "julia_rainbow_curly_2"

カスタマイズ可能なfaceの一覧は、JuliaSyntaxHighlighting package documentationを参照してください。

Customising the history searcher

履歴検索機能では、次のfaceがデフォルトで使われます。これらはカスタマイズできます。

[REPL.History.search]
separator.fg  = "blue"
prefix.fg = "magenta"
selected.fg = "blue"
unselected.fg = "grey"
hint = { fg = "magenta", slant = "italic", weight ="light" }
results.inherit = "shadow"
match = { weight = "bold", underline = true }

Customizing Colors

JuliaとREPLで使われる色もカスタマイズできます。Juliaプロンプトの色を変更するには、ホームディレクトリに置く~/.julia/config/startup.jlファイルに、たとえば次の設定を追加します。

function customize_colors(repl)
    repl.prompt_color = Base.text_colors[:cyan]
end

atreplinit(customize_colors)

利用可能な色のキーは、REPLのヘルプモードでBase.text_colorsと入力すると確認できます。また、256色に対応した端末では、0から255までの整数を色のキーとして使えます。

ヘルプとシェルのプロンプト、入力テキスト、応答テキストの色も変更できます。上記のcustomize_colors関数で、replの適切なフィールドを設定します(順にhelp_color、shell_color、input_color、answer_color)。後者の2つについては、envcolorsフィールドもfalseに設定してください。

色としてBase.text_colors[:bold]を使うと、太字表示も適用できます。たとえば、応答を太字で表示するには、~/.julia/config/startup.jlに次の設定を使います。

function customize_colors(repl)
    repl.envcolors = false
    repl.answer_color = Base.text_colors[:bold]
end

atreplinit(customize_colors)

環境変数を設定すると、警告メッセージや情報メッセージの色も変更できます。たとえば、エラー、警告、情報メッセージをそれぞれマゼンタ、黄色、シアンで表示するには、~/.julia/config/startup.jlファイルに次の設定を追加します。

ENV["JULIA_ERROR_COLOR"] = :magenta
ENV["JULIA_WARN_COLOR"] = :yellow
ENV["JULIA_INFO_COLOR"] = :cyan

Changing the contextual module which is active at the REPL

REPLに入力した式は、デフォルトではMainモジュール内で評価されます。

julia> @__MODULE__
Main

関数REPL.activate(m)を使うと、このコンテキストモジュールを変更できます。mにはModuleを指定します。または、REPLにモジュール名を入力し、その名前の上にカーソルを置いてAlt-m(MacOSではEsc-m)を押しても変更できます。空のプロンプトでこのキー操作を行うと、直前にアクティブだった非MainモジュールとMainの間でコンテキストが切り替わります。アクティブなモジュールはプロンプトに表示されます(Mainの場合を除く)。

julia> using REPL

julia> REPL.activate(Base)

(Base) julia> @__MODULE__
Base

(Base) julia> using REPL # Need to load REPL into Base module to use it

(Base) julia> REPL.activate(Main)

julia>

julia> Core<Alt-m> # using the keybinding to change module

(Core) julia>

(Core) julia> <Alt-m> # going back to Main via keybinding

julia>

julia> <Alt-m> # going back to previously-active Core via keybinding

(Core) julia>

モジュール引数を省略できる関数では、多くの場合、デフォルトでREPLのコンテキストモジュールが使われます。たとえば、varinfo()を呼び出すと、現在アクティブなモジュールの変数が表示されます。

julia> module CustomMod
           export var, f
           var = 1
           f(x) = x^2
       end;

julia> REPL.activate(CustomMod)

(Main.CustomMod) julia> varinfo()
  name         size summary
  ––––––––– ––––––– ––––––––––––––––––––––––––––––––––
  CustomMod         Module
  f         0 bytes f (generic function with 1 method)
  var       8 bytes Int64

Numbered prompt

IPython REPLやMathematicaノートブックに似た、入力プロンプトに番号を付け、出力に接頭辞を付けるインターフェースも利用できます。これを有効にするには、REPL.numbered_prompt!()を呼び出します。起動時から有効にするには、次の設定を

atreplinit() do repl
    @eval import REPL
    if !isdefined(repl, :interface)
        repl.interface = REPL.setup_interface(repl)
    end
    REPL.numbered_prompt!(repl)
end

startup.jlファイルに追加します。番号付きプロンプトでは、変数Out[n](nは整数)を使って、以前の結果を参照できます。

In [1]: 5 + 3
Out[1]: 8

In [2]: Out[1] + 5
Out[2]: 13

In [3]: Out
Out[3]: Dict{Int64, Any} with 2 entries:
  2 => 13
  1 => 8
Note

以前のREPL評価の出力はすべてOut変数に保存されます。そのため、配列などの大きなインメモリオブジェクトを多数返す場合は注意が必要です。Outに参照が残っている限り、それらのオブジェクトはガベージコレクションの対象になりません。Out内のオブジェクトへの参照を削除するには、empty!(Out)で履歴全体を消去するか、Out[n] = nothingで個別の項目を消去します。

TerminalMenus

TerminalMenusはJulia REPLのサブモジュールで、端末上に小さく控えめな対話型メニューを表示できます。

Examples

import REPL
using REPL.TerminalMenus

options = ["apple", "orange", "grape", "strawberry",
            "blueberry", "peach", "lemon", "lime"]

RadioMenu

RadioMenuでは、一覧から1つの選択肢を選べます。request関数は対話型メニューを表示し、選択された項目のインデックスを返します。ユーザーが「q」またはctrl-cを押すと、requestは-1を返します。

# `pagesize` is the number of items to be displayed at a time.
#  The UI will scroll if the number of options is greater
#   than the `pagesize`
menu = RadioMenu(options, pagesize=4)

# `request` displays the menu and returns the index after the
#   user has selected a choice
choice = request("Choose your favorite fruit:", menu)

if choice != -1
    println("Your favorite fruit is ", options[choice], "!")
else
    println("Menu canceled.")
end

出力:

Choose your favorite fruit:
^  grape
   strawberry
 > blueberry
v  peach
Your favorite fruit is blueberry!

MultiSelectMenu

MultiSelectMenuでは、一覧から複数の選択肢を選べます。

# here we use the default `pagesize` 10
menu = MultiSelectMenu(options)

# `request` returns a `Set` of selected indices
# if the menu us canceled (ctrl-c or q), return an empty set
choices = request("Select the fruits you like:", menu)

if length(choices) > 0
    println("You like the following fruits:")
    for i in choices
        println("  - ", options[i])
    end
else
    println("Menu canceled.")
end

出力:

Select the fruits you like:
[press: Enter=toggle, a=all, n=none, d=done, q=abort]
   [ ] apple
 > [X] orange
   [X] grape
   [ ] strawberry
   [ ] blueberry
   [X] peach
   [ ] lemon
   [ ] lime
You like the following fruits:
  - orange
  - grape
  - peach

Customization / Configuration

ConfiguredMenu subtypes

Julia 1.6以降では、メニューの設定にはコンストラクターを使う方法が推奨されています。たとえば、デフォルトの複数選択メニュー

julia> menu = MultiSelectMenu(options, pagesize=5);

julia> request(menu) # ASCII is used by default
[press: Enter=toggle, a=all, n=none, d=done, q=abort]
   [ ] apple
   [X] orange
   [ ] grape
 > [X] strawberry
v  [ ] blueberry

は、選択や移動にUnicode文字を使って次のように表示できます。

julia> menu = MultiSelectMenu(options, pagesize=5, charset=:unicode);

julia> request(menu)
[press: Enter=toggle, a=all, n=none, d=done, q=abort]
   ⬚ apple
   ✓ orange
   ⬚ grape
 → ✓ strawberry
↓  ⬚ blueberry

さらに細かい設定も可能です。

julia> menu = MultiSelectMenu(options, pagesize=5, charset=:unicode, checked="YEP!", unchecked="NOPE", cursor='⧐');

julia> request(menu)
julia> request(menu)
[press: Enter=toggle, a=all, n=none, d=done, q=abort]
   NOPE apple
   YEP! orange
   NOPE grape
 ⧐ YEP! strawberry
↓  NOPE blueberry

全体に適用されるcharsetオプションのほか、RadioMenuでは次のオプションを設定できます。

  • cursor::Char='>'|'→':カーソルに使う文字
  • up_arrow::Char='^'|'↑':上矢印に使う文字
  • down_arrow::Char='v'|'↓':下矢印に使う文字
  • updown_arrow::Char='I'|'↕':1行ページで上下矢印に使う文字
  • scroll_wrap::Bool=false:メニューの先頭または末尾で折り返すかどうか
  • ctrl_c_interrupt::Bool=true:falseの場合、^Cで空を返す。trueの場合、^CでInterruptException()をスローする

MultiSelectMenuでは、さらに次のオプションを設定できます。

  • checked::String="[X]"|"✓":選択済み項目に使う文字列
  • unchecked::String="[ ]"|"⬚"):未選択項目に使う文字列

独自のメニュー型を作成することもできます。TerminalMenus.ConfiguredMenuから派生した型では、構築時にメニューオプションを設定します。

Legacy interface

Julia 1.6より前のバージョンでは、TerminalMenus.config()を呼び出してメニューを設定する方法も使えます。この方法はJulia 1.xの全バージョンで引き続きサポートされています。

References

REPL

Base.atreplinit — Function
atreplinit(f)

対話セッションで REPL インターフェースが初期化される前に呼び出す、引数を1つ取る関数を登録します。インターフェースのカスタマイズに便利です。f の引数は REPL オブジェクトです。この関数は、.julia/config/startup.jl 初期化ファイル内から呼び出してください。

source

TerminalMenus

REPL.TerminalMenus.RadioMenu — Type
RadioMenu

リストから1つの選択肢を選べるメニュー。

Sample Output

julia> request(RadioMenu(options, pagesize=4))
Choose your favorite fruit:
^  grape
   strawberry
 > blueberry
v  peach
Your favorite fruit is blueberry!
source
REPL.TerminalMenus.MultiSelectMenu — Type
MultiSelectMenu

リストから複数の選択肢を選べるメニュー。

Sample Output

julia> request(MultiSelectMenu(options))
Select the fruits you like:
[press: Enter=toggle, a=all, n=none, d=done, q=abort]
   [ ] apple
 > [X] orange
   [X] grape
   [ ] strawberry
   [ ] blueberry
   [X] peach
   [ ] lemon
   [ ] lime
You like the following fruits:
  - orange
  - grape
  - peach
source

Configuration

REPL.TerminalMenus.Config — Type
Config(; scroll_wrap=false, ctrl_c_interrupt=true, charset=:ascii, cursor::Char, up_arrow::Char, down_arrow::Char)

キーワード引数を使って、選択メニューの動作を設定します。

  • scroll_wrap が true の場合、最初の項目より上、または最後の項目より下へスクロールすると、メニューが先頭または末尾に戻ります。
  • ctrl_c_interrupt が true の場合、メニューの選択中に Ctrl-C を押すと InterruptException がスローされます。false の場合、TerminalMenus.request は TerminalMenus.selected のデフォルトの結果を返します。
  • charset は cursor、up_arrow、down_arrow のデフォルト値に影響し、:ascii または :unicode を指定できます。
  • cursor は、「Enter」キーを押すと選択される項目を示すために表示される文字です。デフォルトは、charset に応じて '>' または '→' です。
  • up_arrow は、最初の項目が表示範囲に含まれない場合に表示される文字です。デフォルトは、charset に応じて '^' または '↑' です。
  • down_arrow は、最後の項目が表示範囲に含まれない場合に表示される文字です。デフォルトは、charset に応じて 'v' または '↓' です。

ConfiguredMenu のサブタイプでは、必要に応じて cursor、up_arrow、down_arrow が自動的に表示されます。writeline メソッドでこれらを表示する必要はありません。

Julia 1.6

Config は Julia 1.6 以降で利用できます。それ以前のバージョンでは、グローバルな CONFIG を使用してください。

source
REPL.TerminalMenus.MultiSelectConfig — Type
MultiSelectConfig(; charset=:ascii, checked::String, unchecked::String, kwargs...)

キーワード引数を使って、複数選択メニューの動作を設定します。

  • オプションが選択されているときに表示する文字列は checked です。デフォルトは、charset に応じて「[X]」または「✓」です。
  • オプションが選択されていないときに表示する文字列は unchecked です。デフォルトは、charset に応じて「[ ]」または「⬚」です。

その他のキーワード引数については、TerminalMenus.Config の説明を参照してください。checked と unchecked は自動では表示されないため、writeline メソッドで表示してください。

Julia 1.6

MultiSelectConfig は Julia 1.6 以降で利用できます。それ以前のバージョンでは、グローバルな CONFIG を使用してください。

source
REPL.TerminalMenus.config — Function
config( <see arguments> )

グローバルメニューのパラメーターを設定するキーワード専用関数

Arguments

  • charset::Symbol=:na: 使用するUI文字(:asciiまたは:unicode)。ほかの引数が指定された場合は上書きされます
  • cursor::Char='>'|'→': カーソルに使用する文字
  • up_arrow::Char='^'|'↑': 上矢印に使用する文字
  • down_arrow::Char='v'|'↓': 下矢印に使用する文字
  • checked::String="[X]"|"✓": チェック済みに使用する文字列
  • unchecked::String="[ ]"|"⬚"): 未チェックに使用する文字列
  • scroll::Symbol=:nowrap: :wrapの場合、カーソルは上下端で折り返します。:nowrapの場合、カーソルは折り返しません
  • supress_output::Bool=false: 互換性のために残されている引数ですが、無視されます。代わりにrequestにキーワード引数としてsuppress_outputを渡してください。
  • ctrl_c_interrupt::Bool=true: falseの場合、^Cで空を返します。trueの場合、^CでInterruptException()をスローします
Julia 1.6

Julia 1.6以降、configは非推奨です。代わりにConfigまたはMultiSelectConfigを使用してください。

source

User interaction

REPL.TerminalMenus.request — Function
request(m::AbstractMenu; cursor=1)

メニューを表示して、対話モードに入ります。cursorは、初期カーソル位置に使用する項目番号を示します。cursorには、IntまたはRefValue{Int}を指定できます。後者を使うと、外部からカーソル位置を監視および制御できます。

selected(m)を返します。

Julia 1.6

cursor引数を使用するには、Julia 1.6以降が必要です。

source
request([term,] msg::AbstractString, m::AbstractMenu)

println(msg); request(m)の略記。

source

AbstractMenu extension interface

AbstractMenuのサブタイプはすべてmutableでなければならず、pagesize::Intおよびpageoffset::Intフィールドを含む必要があります。また、すべてのサブタイプで次の関数を実装する必要があります。

REPL.TerminalMenus.pick — Function
pick(m::AbstractMenu, cursor::Int)

メニューが開いているときにユーザーが Enter キーを押した場合の動作を定義します。true が返されると、request() は終了します。cursor は選択位置のインデックスです。

source
REPL.TerminalMenus.cancel — Function
cancel(m::AbstractMenu)

ユーザーがメニューをキャンセル('q' または ctrl-c)したときの動作を定義します。request() は、この関数を呼び出した後、常に終了します。

source
REPL.TerminalMenus.writeline — Function
writeline(buf::IO, m::AbstractMenu, idx::Int, iscursor::Bool)

インデックス idx のオプションを buf に書き込みます。iscursor が true の場合、この項目が現在のカーソル位置(「Enter」キーを押すと選択される項目)にあることを示します。

m が ConfiguredMenu の場合、TerminalMenus がカーソルインジケーターを出力します。それ以外の場合は、呼び出し先が出力を処理することを想定しています。

Julia 1.6

writeline には Julia 1.6 以降が必要です。

それ以前の Julia バージョンでは、これは writeLine(buf::IO, m::AbstractMenu, idx, iscursor::Bool) であり、m は未設定とみなされます。選択インジケーターとカーソルインジケーターは TerminalMenus.CONFIG から取得できます。

この旧関数は Julia 1.x のすべてのバージョンでサポートされていますが、Julia 2.0 で削除される予定です。

source

さらに、optionsまたはnumoptionsのいずれかを実装する必要があります。

REPL.TerminalMenus.options — Function
options(m::AbstractMenu)

現在のページに選択肢として表示する文字列のリストを返します。

または、numoptionsを実装してください。その場合、optionsは不要です。

source
REPL.TerminalMenus.numoptions — Function
numoptions(m::AbstractMenu)::Int

メニュー m のオプション数を返します。デフォルトは length(options(m)) です。

Julia 1.6

この関数を使用するには、Julia 1.6 以降が必要です。

source

サブタイプにselectedという名前のフィールドがない場合は、次の関数も実装する必要があります。

REPL.TerminalMenus.selected — Function
selected(m::AbstractMenu)

ユーザーが選択したオプションに関する情報を返します。デフォルトでは、m.selectedを返します。

source

次の項目は任意ですが、追加のカスタマイズに利用できます。

REPL.TerminalMenus.header — Function
header(m::AbstractMenu)::String

メニューの上に表示するヘッダー文字列を返します。デフォルトは "" です。

source