How to save/log the output of the iex shell to get persistent command history?
In Erlang/OTP-20 and higher
Since Erlang/OTP-20rc2, Shell history is supported out of the box (although initially disabled by default) through a port of this library to the Erlang/OTP code base. Enable the shell in these versions by setting the
shell_history
kernel environment variable to enabled withexport ERL_AFLAGS="-kernel shell_history enabled"
added to your environment variables (see Configuration Options to see more options).
-- https://github.com/ferd/erlang-history
Trouble shooting
The history seems to be not updated (not written to the file)?
It seems that the process that is writing the history to the file does it asynchronously and it needs some time to do it before the IEx shell is closed. You need to wait a bit before you exit the shell (e.g. press <ctrl+\>
).
Pre Erlang/OTP-20:
I have found 2 ways to do it.
1. Erlang History
erlang-history (eh) is a tiny pair of files that can be used to patch an Erlang-OTP system to add support for history in the Erlang shell.
The history supported is the one available through up/down arrows on the keyboard.
Installation in Ubuntu Linux:
sudo su
cd /usr/local/src
git clone https://github.com/ferd/erlang-history.git
cd erlang-history
make install
Now every now started Erlang based REPL (and that is IEx) should use erlang-history
.
2. rlwrap
As an alternative you can try a more generic REPL enhancer/fixer rlwrap which is a "readline wrapper":
...a small utility that uses the GNU readline library to allow the editing of keyboard input for any command.
rlwrap -a -A iex -S mix
(In case you are on Ubuntu Linux use: sudo apt-get install rlwrap
)
It let's you add a lot more features to the REPL like e.g. the pipeto filter rlwrap -a -z pipeto iex
that lets you pipe things to shell commands - very useful to read documentation i.e.: iex> h Stream | less
(more)
Know downsides:
- It breaks code completion (i.e. tab completion) in IEx
Why is this very useful feature - command history - not already included in Elixir/Erlang?
- https://github.com/elixir-lang/elixir/issues/2945#issuecomment-66594851
- https://github.com/elixir-lang/elixir/issues/1516#issuecomment-21772851
When using asdf
see this.
Not currently. You could probably write a small iex plugin to do this for you though. For example, I have the following file in ~/.iex.exs
:
# .iex.exs
defmodule IExHelpers do
def reload! do
Mix.Task.reenable "compile.elixir"
Mix.Task.run "compile.elixir"
end
end
iex = IExHelpers
# $ iex -S mix
# iex(2)> iex.reload!
# :noop
This recompiles the current project and reloads it while still inside a shell spawned with iex -S mix
. You could probably write something to save the current shell's history to a file, and read it back in on startup, but I'm not sure where you would start with that.