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
endHelp 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
hellojulia> ; # 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> .atomPkg 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 | 行末へ移動 |
上矢印、^P | 1行上へ移動(またはカーソルより前のテキストに一致する直前の履歴項目へ移動) |
下矢印、^N | 1行下へ移動(またはカーソルより前のテキストに一致する次の履歴項目へ移動) |
| Shift-矢印キー | 矢印キーの方向にカーソルを移動し、領域を有効化(「Shift選択」) |
Page-up、meta-P | 直前の履歴項目へ移動 |
Page-down、meta-N | 次の履歴項目へ移動 |
meta-< | 最初の履歴項目へ移動(現在の履歴位置より前にある場合は、現在のセッションの最初の項目) |
meta-> | 最後の履歴項目へ移動 |
^-Space | 編集領域に「マーク」を設定(領域が有効な場合は無効化) |
^-Space ^-Space | 編集領域に「マーク」を設定し、領域を有効化(ハイライト表示) |
^G | 領域を無効化(ハイライト表示を解除) |
^X^X | 現在位置とマークを入れ替え |
| 編集 | |
Backspace、^H | 直前の文字を削除。領域が有効な場合は領域全体を削除 |
Delete、^D | 1文字を前方削除(バッファーにテキストがある場合) |
| 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 | 次の単語を小文字に変換 |
^/、^_ | 直前の編集操作を元に戻す |
^Q | REPLに数値を入力して^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
endTab 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に追加して無効にできます。
REPLのほかの機能と同様、検索では大文字と小文字が区別されます。
julia> stri[TAB]
stride strides string strip
julia> Stri[TAB]
StridedArray StridedMatrix StridedVecOrMat StridedVector StringTabキーを使うと、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:322Syntax Highlighting
REPLでは、入力中の構文がハイライト表示されます。構文ハイライトはデフォルトで有効ですが、~/.julia/config/startup.jlで無効にできます。
atreplinit() do repl
repl.options.style_input = false
endCustomizing 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"] = :cyanChanging 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 Int64Numbered 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)
endstartup.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以前の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
- peachCustomization / 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 初期化ファイル内から呼び出してください。
TerminalMenus
Menus
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!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
- peachConfiguration
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 メソッドでこれらを表示する必要はありません。
REPL.TerminalMenus.MultiSelectConfig — Type
MultiSelectConfig(; charset=:ascii, checked::String, unchecked::String, kwargs...)キーワード引数を使って、複数選択メニューの動作を設定します。
- オプションが選択されているときに表示する文字列は
checkedです。デフォルトは、charsetに応じて「[X]」または「✓」です。 - オプションが選択されていないときに表示する文字列は
uncheckedです。デフォルトは、charsetに応じて「[ ]」または「⬚」です。
その他のキーワード引数については、TerminalMenus.Config の説明を参照してください。checked と unchecked は自動では表示されないため、writeline メソッドで表示してください。
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()をスローします
User interaction
REPL.TerminalMenus.request — Function
request(m::AbstractMenu; cursor=1)メニューを表示して、対話モードに入ります。cursorは、初期カーソル位置に使用する項目番号を示します。cursorには、IntまたはRefValue{Int}を指定できます。後者を使うと、外部からカーソル位置を監視および制御できます。
selected(m)を返します。
request([term,] msg::AbstractString, m::AbstractMenu)println(msg); request(m)の略記。
AbstractMenu extension interface
AbstractMenuのサブタイプはすべてmutableでなければならず、pagesize::Intおよびpageoffset::Intフィールドを含む必要があります。また、すべてのサブタイプで次の関数を実装する必要があります。
REPL.TerminalMenus.pick — Function
pick(m::AbstractMenu, cursor::Int)メニューが開いているときにユーザーが Enter キーを押した場合の動作を定義します。true が返されると、request() は終了します。cursor は選択位置のインデックスです。
REPL.TerminalMenus.cancel — Function
cancel(m::AbstractMenu)ユーザーがメニューをキャンセル('q' または ctrl-c)したときの動作を定義します。request() は、この関数を呼び出した後、常に終了します。
REPL.TerminalMenus.writeline — Function
writeline(buf::IO, m::AbstractMenu, idx::Int, iscursor::Bool)インデックス idx のオプションを buf に書き込みます。iscursor が true の場合、この項目が現在のカーソル位置(「Enter」キーを押すと選択される項目)にあることを示します。
m が ConfiguredMenu の場合、TerminalMenus がカーソルインジケーターを出力します。それ以外の場合は、呼び出し先が出力を処理することを想定しています。
さらに、optionsまたはnumoptionsのいずれかを実装する必要があります。
REPL.TerminalMenus.options — Function
options(m::AbstractMenu)現在のページに選択肢として表示する文字列のリストを返します。
または、numoptionsを実装してください。その場合、optionsは不要です。
REPL.TerminalMenus.numoptions — Function
numoptions(m::AbstractMenu)::Intメニュー m のオプション数を返します。デフォルトは length(options(m)) です。
サブタイプにselectedという名前のフィールドがない場合は、次の関数も実装する必要があります。
REPL.TerminalMenus.selected — Function
selected(m::AbstractMenu)ユーザーが選択したオプションに関する情報を返します。デフォルトでは、m.selectedを返します。
次の項目は任意ですが、追加のカスタマイズに利用できます。
REPL.TerminalMenus.header — Function
header(m::AbstractMenu)::Stringメニューの上に表示するヘッダー文字列を返します。デフォルトは "" です。
REPL.TerminalMenus.keypress — Function
keypress(m::AbstractMenu, i::UInt32)::Bool標準以外のキー押下イベントを処理します。true が返された場合、TerminalMenus.request は終了します。デフォルトは false です。