{ "cells": [ { "cell_type": "markdown", "metadata": { "collapsed": false }, "source": [ "# IElixir - Elixir kernel for Jupyter Project\n", "\n", "\n", "\n", "---\n", "\n", "## Google Summer of Code 2015\n", "> Developed by [Piotr Przetacznik](https://twitter.com/pprzetacznik)\n", "\n", "> Mentored by [José Valim](https://twitter.com/josevalim)\n", "\n", "---\n", "## References\n", "\n", "* [Elixir language](http://elixir-lang.org/)\n", "* [Jupyter Project](https://jupyter.org/)\n", "* [IElixir sources](https://github.com/pprzetacznik/IElixir)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Getting Started\n", "\n", "### Basic Types\n", "\n", "
\n",
    "1          # integer\n",
    "0x1F       # integer\n",
    "1.0        # float\n",
    "true       # boolean\n",
    ":atom      # atom / symbol\n",
    "\"elixir\"   # string\n",
    "[1, 2, 3]  # list\n",
    "{1, 2, 3}  # tuple\n",
    "
\n", "\n", "### Basic arithmetic" ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "3" ] }, "execution_count": 1, "metadata": {}, "output_type": "execute_result" } ], "source": [ "1 + 2" ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "25" ] }, "execution_count": 2, "metadata": {}, "output_type": "execute_result" } ], "source": [ "5 * 5" ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "5.0" ] }, "execution_count": 3, "metadata": {}, "output_type": "execute_result" } ], "source": [ "10 / 2" ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "5" ] }, "execution_count": 4, "metadata": {}, "output_type": "execute_result" } ], "source": [ "div(10, 2)" ] }, { "cell_type": "code", "execution_count": 5, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "5" ] }, "execution_count": 5, "metadata": {}, "output_type": "execute_result" } ], "source": [ "div 10, 2" ] }, { "cell_type": "code", "execution_count": 6, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "1" ] }, "execution_count": 6, "metadata": {}, "output_type": "execute_result" } ], "source": [ "rem 10, 3" ] }, { "cell_type": "code", "execution_count": 7, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "10" ] }, "execution_count": 7, "metadata": {}, "output_type": "execute_result" } ], "source": [ "0b1010" ] }, { "cell_type": "code", "execution_count": 8, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "511" ] }, "execution_count": 8, "metadata": {}, "output_type": "execute_result" } ], "source": [ "0o777" ] }, { "cell_type": "code", "execution_count": 9, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "31" ] }, "execution_count": 9, "metadata": {}, "output_type": "execute_result" } ], "source": [ "0x1F" ] }, { "cell_type": "code", "execution_count": 10, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "1.0" ] }, "execution_count": 10, "metadata": {}, "output_type": "execute_result" } ], "source": [ "1.0" ] }, { "cell_type": "code", "execution_count": 11, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "1.0e-10" ] }, "execution_count": 11, "metadata": {}, "output_type": "execute_result" } ], "source": [ "1.0e-10" ] }, { "cell_type": "code", "execution_count": 12, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "4" ] }, "execution_count": 12, "metadata": {}, "output_type": "execute_result" } ], "source": [ "round 3.58" ] }, { "cell_type": "code", "execution_count": 13, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "3" ] }, "execution_count": 13, "metadata": {}, "output_type": "execute_result" } ], "source": [ "trunc 3.58" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Booleans" ] }, { "cell_type": "code", "execution_count": 14, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "true" ] }, "execution_count": 14, "metadata": {}, "output_type": "execute_result" } ], "source": [ "true" ] }, { "cell_type": "code", "execution_count": 15, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "false" ] }, "execution_count": 15, "metadata": {}, "output_type": "execute_result" } ], "source": [ "true == false" ] }, { "cell_type": "code", "execution_count": 16, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "true" ] }, "execution_count": 16, "metadata": {}, "output_type": "execute_result" } ], "source": [ "is_boolean(true)" ] }, { "cell_type": "code", "execution_count": 17, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "false" ] }, "execution_count": 17, "metadata": {}, "output_type": "execute_result" } ], "source": [ "is_boolean(1)" ] }, { "cell_type": "code", "execution_count": 18, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "true" ] }, "execution_count": 18, "metadata": {}, "output_type": "execute_result" } ], "source": [ "is_integer(5)" ] }, { "cell_type": "code", "execution_count": 19, "metadata": { "collapsed": false, "scrolled": true }, "outputs": [ { "data": { "text/plain": [ "false" ] }, "execution_count": 19, "metadata": {}, "output_type": "execute_result" } ], "source": [ "is_float(5)" ] }, { "cell_type": "code", "execution_count": 20, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "false" ] }, "execution_count": 20, "metadata": {}, "output_type": "execute_result" } ], "source": [ "is_number(\"5.0\")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Atoms" ] }, { "cell_type": "code", "execution_count": 21, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ ":hello" ] }, "execution_count": 21, "metadata": {}, "output_type": "execute_result" } ], "source": [ ":hello" ] }, { "cell_type": "code", "execution_count": 22, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "false" ] }, "execution_count": 22, "metadata": {}, "output_type": "execute_result" } ], "source": [ ":hello == :world" ] }, { "cell_type": "code", "execution_count": 23, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "true" ] }, "execution_count": 23, "metadata": {}, "output_type": "execute_result" } ], "source": [ "true == :true" ] }, { "cell_type": "code", "execution_count": 24, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "true" ] }, "execution_count": 24, "metadata": {}, "output_type": "execute_result" } ], "source": [ "is_atom(false)" ] }, { "cell_type": "code", "execution_count": 25, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "true" ] }, "execution_count": 25, "metadata": {}, "output_type": "execute_result" } ], "source": [ "is_boolean(:false)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Strings" ] }, { "cell_type": "code", "execution_count": 26, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "\"hellö\"" ] }, "execution_count": 26, "metadata": {}, "output_type": "execute_result" } ], "source": [ "\"hellö\"" ] }, { "cell_type": "code", "execution_count": 27, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "\"hellö world\"" ] }, "execution_count": 27, "metadata": {}, "output_type": "execute_result" } ], "source": [ "\"hellö #{:world}\"" ] }, { "cell_type": "code", "execution_count": 28, "metadata": { "collapsed": false }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "hello\n", "world\n" ] }, { "data": { "text/plain": [ ":ok" ] }, "execution_count": 28, "metadata": {}, "output_type": "execute_result" } ], "source": [ "IO.puts \"hello\\nworld\"" ] }, { "cell_type": "code", "execution_count": 29, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "true" ] }, "execution_count": 29, "metadata": {}, "output_type": "execute_result" } ], "source": [ "is_binary(\"hellö\")" ] }, { "cell_type": "code", "execution_count": 30, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "6" ] }, "execution_count": 30, "metadata": {}, "output_type": "execute_result" } ], "source": [ "byte_size(\"hellö\")" ] }, { "cell_type": "code", "execution_count": 31, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "5" ] }, "execution_count": 31, "metadata": {}, "output_type": "execute_result" } ], "source": [ "String.length(\"hellö\")" ] }, { "cell_type": "code", "execution_count": 32, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "\"HELLÖ\"" ] }, "execution_count": 32, "metadata": {}, "output_type": "execute_result" } ], "source": [ "String.upcase(\"hellö\")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Anonymous functions" ] }, { "cell_type": "code", "execution_count": 33, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "#Function<12.90072148/2 in :erl_eval.expr/5>" ] }, "execution_count": 33, "metadata": {}, "output_type": "execute_result" } ], "source": [ "add = fn a, b -> a + b end" ] }, { "cell_type": "code", "execution_count": 34, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "true" ] }, "execution_count": 34, "metadata": {}, "output_type": "execute_result" } ], "source": [ "is_function(add)" ] }, { "cell_type": "code", "execution_count": 35, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "true" ] }, "execution_count": 35, "metadata": {}, "output_type": "execute_result" } ], "source": [ "is_function(add, 2)" ] }, { "cell_type": "code", "execution_count": 36, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "false" ] }, "execution_count": 36, "metadata": {}, "output_type": "execute_result" } ], "source": [ "is_function(add, 1)" ] }, { "cell_type": "code", "execution_count": 37, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "3" ] }, "execution_count": 37, "metadata": {}, "output_type": "execute_result" } ], "source": [ "add.(1, 2)" ] }, { "cell_type": "code", "execution_count": 38, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "#Function<6.90072148/1 in :erl_eval.expr/5>" ] }, "execution_count": 38, "metadata": {}, "output_type": "execute_result" } ], "source": [ "add_two = fn a -> add.(a, 2) end" ] }, { "cell_type": "code", "execution_count": 39, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "4" ] }, "execution_count": 39, "metadata": {}, "output_type": "execute_result" } ], "source": [ "add_two.(2)" ] }, { "cell_type": "code", "execution_count": 40, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "42" ] }, "execution_count": 40, "metadata": {}, "output_type": "execute_result" } ], "source": [ "x = 42\n", "(fn -> x = 0 end).()\n", "x" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### (Linked) Lists" ] }, { "cell_type": "code", "execution_count": 41, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "[1, 2, true, 3]" ] }, "execution_count": 41, "metadata": {}, "output_type": "execute_result" } ], "source": [ "a = [1, 2, true, 3]" ] }, { "cell_type": "code", "execution_count": 42, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "3" ] }, "execution_count": 42, "metadata": {}, "output_type": "execute_result" } ], "source": [ "length [1, 2, 3]" ] }, { "cell_type": "code", "execution_count": 43, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "[1, 2, 3, 4, 5, 6]" ] }, "execution_count": 43, "metadata": {}, "output_type": "execute_result" } ], "source": [ "[1, 2, 3] ++ [4, 5, 6]" ] }, { "cell_type": "code", "execution_count": 44, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "[1, 2, 3, true]" ] }, "execution_count": 44, "metadata": {}, "output_type": "execute_result" } ], "source": [ "[1, true, 2, false, 3, true] -- [true, false]" ] }, { "cell_type": "code", "execution_count": 45, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "1" ] }, "execution_count": 45, "metadata": {}, "output_type": "execute_result" } ], "source": [ "hd(a)" ] }, { "cell_type": "code", "execution_count": 46, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "[2, true, 3]" ] }, "execution_count": 46, "metadata": {}, "output_type": "execute_result" } ], "source": [ "tl(a)" ] }, { "cell_type": "code", "execution_count": 47, "metadata": { "collapsed": false }, "outputs": [ { "ename": "ArgumentError", "evalue": "1", "output_type": "error", "traceback": [ "** (ArgumentError) \"argument error\"" ] } ], "source": [ "hd []" ] }, { "cell_type": "code", "execution_count": 47, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "'\\v\\f\\r'" ] }, "execution_count": 47, "metadata": {}, "output_type": "execute_result" } ], "source": [ "[11, 12, 13]" ] }, { "cell_type": "code", "execution_count": 48, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "'hello'" ] }, "execution_count": 48, "metadata": {}, "output_type": "execute_result" } ], "source": [ "[104, 101, 108, 108, 111]" ] }, { "cell_type": "code", "execution_count": 49, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "false" ] }, "execution_count": 49, "metadata": {}, "output_type": "execute_result" } ], "source": [ "'hello' == \"hello\"" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Tuples" ] }, { "cell_type": "code", "execution_count": 50, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "{:ok, \"hello\"}" ] }, "execution_count": 50, "metadata": {}, "output_type": "execute_result" } ], "source": [ "{:ok, \"hello\"}" ] }, { "cell_type": "code", "execution_count": 51, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "2" ] }, "execution_count": 51, "metadata": {}, "output_type": "execute_result" } ], "source": [ "tuple_size {:ok, \"hello\"}" ] }, { "cell_type": "code", "execution_count": 52, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "{:ok, \"hello\"}" ] }, "execution_count": 52, "metadata": {}, "output_type": "execute_result" } ], "source": [ "tuple = {:ok, \"hello\"}" ] }, { "cell_type": "code", "execution_count": 53, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "\"hello\"" ] }, "execution_count": 53, "metadata": {}, "output_type": "execute_result" } ], "source": [ "elem(tuple, 1)" ] }, { "cell_type": "code", "execution_count": 54, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "2" ] }, "execution_count": 54, "metadata": {}, "output_type": "execute_result" } ], "source": [ "tuple_size(tuple)" ] }, { "cell_type": "code", "execution_count": 55, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "{:ok, \"world\"}" ] }, "execution_count": 55, "metadata": {}, "output_type": "execute_result" } ], "source": [ "put_elem(tuple, 1, \"world\")" ] }, { "cell_type": "code", "execution_count": 56, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "{:ok, \"hello\"}" ] }, "execution_count": 56, "metadata": {}, "output_type": "execute_result" } ], "source": [ "tuple" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Lists or tuples?" ] }, { "cell_type": "code", "execution_count": 57, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "[1, 2, 3]" ] }, "execution_count": 57, "metadata": {}, "output_type": "execute_result" } ], "source": [ "list = [1|[2|[3|[]]]]" ] }, { "cell_type": "code", "execution_count": 58, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "[0, 1, 2, 3]" ] }, "execution_count": 58, "metadata": {}, "output_type": "execute_result" } ], "source": [ "[0] ++ list" ] }, { "cell_type": "code", "execution_count": 59, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "[1, 2, 3, 4]" ] }, "execution_count": 59, "metadata": {}, "output_type": "execute_result" } ], "source": [ "list ++ [4]" ] }, { "cell_type": "code", "execution_count": 60, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "{:ok, \"Copyright 2015 Piotr Przetacznik\\n\\n Licensed under the Apache License, Version 2.0 (the \\\"License\\\");\\n you may not use this file except in compliance with the License.\\n You may obtain a copy of the License at\\n\\n http://www.apache.org/licenses/LICENSE-2.0\\n\\n Unless required by applicable law or agreed to in writing, software\\n distributed under the License is distributed on an \\\"AS IS\\\" BASIS,\\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\\n See the License for the specific language governing permissions and\\n limitations under the License.\\n\"}" ] }, "execution_count": 60, "metadata": {}, "output_type": "execute_result" } ], "source": [ "File.read(\"LICENSE\")" ] }, { "cell_type": "code", "execution_count": 61, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "{:error, :enoent}" ] }, "execution_count": 61, "metadata": {}, "output_type": "execute_result" } ], "source": [ "File.read(\"path/to/unknown/file\")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Other examples" ] }, { "cell_type": "code", "execution_count": 62, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "31" ] }, "execution_count": 62, "metadata": {}, "output_type": "execute_result" } ], "source": [ "0x1F" ] }, { "cell_type": "code", "execution_count": 63, "metadata": { "collapsed": false, "scrolled": true }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "175\n" ] }, { "data": { "text/plain": [ ":ok" ] }, "execution_count": 63, "metadata": {}, "output_type": "execute_result" } ], "source": [ "a = 25\n", "b = 150\n", "IO.puts(a+b)" ] }, { "cell_type": "code", "execution_count": 64, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "{:module, Math, <<70, 79, 82, 49, 0, 0, 4, 244, 66, 69, 65, 77, 69, 120, 68, 99, 0, 0, 0, 143, 131, 104, 2, 100, 0, 14, 101, 108, 105, 120, 105, 114, 95, 100, 111, 99, 115, 95, 118, 49, 108, 0, 0, 0, 3, 104, 2, ...>>, {:sum, 2}}" ] }, "execution_count": 64, "metadata": {}, "output_type": "execute_result" } ], "source": [ "defmodule Math do\n", " def sum(a, b) do\n", " a + b\n", " end\n", "end" ] }, { "cell_type": "code", "execution_count": 65, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "3" ] }, "execution_count": 65, "metadata": {}, "output_type": "execute_result" } ], "source": [ "Math.sum(1, 2)" ] }, { "cell_type": "code", "execution_count": 66, "metadata": { "collapsed": false, "scrolled": true }, "outputs": [ { "data": { "text/plain": [ "true" ] }, "execution_count": 66, "metadata": {}, "output_type": "execute_result" } ], "source": [ "import ExUnit.CaptureIO\n", "capture_io(fn -> IO.write \"john\" end) == \"john\"" ] }, { "cell_type": "code", "execution_count": 67, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "97" ] }, "execution_count": 67, "metadata": {}, "output_type": "execute_result" } ], "source": [ "?a" ] }, { "cell_type": "code", "execution_count": 68, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "true" ] }, "execution_count": 68, "metadata": {}, "output_type": "execute_result" } ], "source": [ "<<98>> == <>" ] }, { "cell_type": "code", "execution_count": 69, "metadata": { "collapsed": false, "scrolled": true }, "outputs": [ { "data": { "text/plain": [ "true" ] }, "execution_count": 69, "metadata": {}, "output_type": "execute_result" } ], "source": [ "<> == \"go\n", "\"" ] }, { "cell_type": "code", "execution_count": 70, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "{\"head\", \"body\"}" ] }, "execution_count": 70, "metadata": {}, "output_type": "execute_result" } ], "source": [ "{hlen, blen} = {4, 4}\n", "<
> = \"headbody\"\n", "{header, body}" ] }, { "cell_type": "code", "execution_count": 71, "metadata": { "collapsed": false }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "\u001b[0m\n", "\u001b[7m\u001b[33m IEx.Helpers \u001b[0m\n", "\u001b[0m\n", "Welcome to Interactive Elixir. You are currently seeing the documentation for\n", "the module \u001b[36mIEx.Helpers\u001b[0m which provides many helpers to make Elixir's shell more\n", "joyful to work with.\n", "\u001b[0m\n", "This message was triggered by invoking the helper \u001b[36mh()\u001b[0m, usually referred to as\n", "\u001b[36mh/0\u001b[0m (since it expects 0 arguments).\n", "\u001b[0m\n", "There are many other helpers available:\n", "\u001b[0m\n", " • \u001b[36mc/2\u001b[0m — compiles a file at the given path\n", " • \u001b[36mcd/1\u001b[0m — changes the current directory\n", " • \u001b[36mclear/0\u001b[0m — clears the screen\n", " • \u001b[36mflush/0\u001b[0m — flushes all messages sent to the shell\n", " • \u001b[36mh/0\u001b[0m — prints this help message\n", " • \u001b[36mh/1\u001b[0m — prints help for the given module, function or macro\n", " • \u001b[36ml/1\u001b[0m — loads the given module's beam code\n", " • \u001b[36mls/0\u001b[0m — lists the contents of the current directory\n", " • \u001b[36mls/1\u001b[0m — lists the contents of the specified directory\n", " • \u001b[36mpwd/0\u001b[0m — prints the current working directory\n", " • \u001b[36mr/1\u001b[0m — recompiles and reloads the given module's source file\n", " • \u001b[36mrespawn/0\u001b[0m — respawns the current shell\n", " • \u001b[36ms/1\u001b[0m — prints spec information\n", " • \u001b[36mt/1\u001b[0m — prints type information\n", " • \u001b[36mv/0\u001b[0m — prints the history of commands evaluated in the session\n", " • \u001b[36mv/1\u001b[0m — retrieves the nth value from the history\n", " • \u001b[36mimport_file/1\u001b[0m — evaluates the given file in the shell's context\n", "\u001b[0m\n", "Help for functions in this module can be consulted directly from the command\n", "line, as an example, try:\n", "\u001b[0m\n", "\u001b[36m\u001b[1m┃ h(c/2)\u001b[0m\n", "\u001b[0m\n", "You can also retrieve the documentation for any module or function. Try these:\n", "\u001b[0m\n", "\u001b[36m\u001b[1m┃ h(Enum)\n", "┃ h(Enum.reverse/1)\u001b[0m\n", "\u001b[0m\n", "To discover all available functions for a module, type the module name followed\n", "by a dot, then press tab to trigger autocomplete. For example:\n", "\u001b[0m\n", "\u001b[36m\u001b[1m┃ Enum.\u001b[0m\n", "\u001b[0m\n", "To learn more about IEx as a whole, just type \u001b[36mh(IEx)\u001b[0m.\n", "\u001b[0m\n" ] } ], "source": [ "h()" ] }, { "cell_type": "code", "execution_count": 72, "metadata": { "collapsed": false, "scrolled": true }, "outputs": [ { "data": { "text/plain": [ "{:module, KV.Registry, <<70, 79, 82, 49, 0, 0, 14, 164, 66, 69, 65, 77, 69, 120, 68, 99, 0, 0, 3, 205, 131, 104, 2, 100, 0, 14, 101, 108, 105, 120, 105, 114, 95, 100, 111, 99, 115, 95, 118, 49, 108, 0, 0, 0, 3, 104, 2, ...>>, {:handle_cast, 2}}" ] }, "execution_count": 72, "metadata": {}, "output_type": "execute_result" } ], "source": [ "defmodule KV.Registry do\n", " use GenServer\n", "\n", " ## Client API\n", "\n", " @doc \"\"\"\n", " Starts the registry.\n", " \"\"\"\n", " def start_link(opts \\\\ []) do\n", " GenServer.start_link(__MODULE__, :ok, opts)\n", " end\n", "\n", " @doc \"\"\"\n", " Looks up the bucket pid for `name` stored in `server`.\n", "\n", " Returns `{:ok, pid}` if the bucket exists, `:error` otherwise.\n", " \"\"\"\n", " def lookup(server, name) do\n", " GenServer.call(server, {:lookup, name})\n", " end\n", "\n", " @doc \"\"\"\n", " Ensures there is a bucket associated to the given `name` in `server`.\n", " \"\"\"\n", " def create(server, name) do\n", " GenServer.cast(server, {:create, name})\n", " end\n", "\n", " ## Server Callbacks\n", "\n", " def init(:ok) do\n", " {:ok, HashDict.new}\n", " end\n", "\n", " def handle_call({:lookup, name}, _from, names) do\n", " {:reply, HashDict.fetch(names, name), names}\n", " end\n", "\n", " def handle_cast({:create, name}, names) do\n", " if HashDict.has_key?(names, name) do\n", " {:noreply, names}\n", " else\n", " {:ok, bucket} = KV.Bucket.start_link()\n", " {:noreply, HashDict.put(names, name, bucket)}\n", " end\n", " end\n", "end" ] }, { "cell_type": "code", "execution_count": 73, "metadata": { "collapsed": false, "scrolled": true }, "outputs": [ { "data": { "text/plain": [ "[#Function<1.26548342/1 in ExUnit.start/1>, #Function<0.16941659/1 in Mix.CLI.main/1>]" ] }, "execution_count": 73, "metadata": {}, "output_type": "execute_result" } ], "source": [ "ExUnit.start()" ] }, { "cell_type": "code", "execution_count": 74, "metadata": { "collapsed": false }, "outputs": [ { "data": { "text/plain": [ "{:module, KV.RegistryTest, <<70, 79, 82, 49, 0, 0, 14, 84, 66, 69, 65, 77, 69, 120, 68, 99, 0, 0, 1, 32, 131, 104, 2, 100, 0, 14, 101, 108, 105, 120, 105, 114, 95, 100, 111, 99, 115, 95, 118, 49, 108, 0, 0, 0, 3, 104, 2, ...>>, {:\"test spawns buckets\", 1}}" ] }, "execution_count": 74, "metadata": {}, "output_type": "execute_result" } ], "source": [ "defmodule KV.RegistryTest do\n", " use ExUnit.Case, async: true\n", "\n", " setup do\n", " {:ok, registry} = KV.Registry.start_link\n", " {:ok, registry: registry}\n", " end\n", "\n", " test \"spawns buckets\", %{registry: registry} do\n", " assert KV.Registry.lookup(registry, \"shopping\") == :error\n", "\n", " KV.Registry.create(registry, \"shopping\")\n", " assert {:ok, bucket} = KV.Registry.lookup(registry, \"shopping\")\n", "\n", " KV.Bucket.put(bucket, \"milk\", 1)\n", " assert KV.Bucket.get(bucket, \"milk\") == 1\n", " end\n", "end" ] } ], "metadata": { "kernelspec": { "display_name": "ielixir", "language": "Elixir", "name": "ielixir" }, "language_info": { "codemirror_mode": "erlang", "file_extension": "ex", "mimetype": "text/x-elixir", "name": "elixir", "nbconvert_exporter": "", "pygments_lexer": "pygments.lexers.erlang.ElixirLexer", "version": "#Version<1.1.0-dev>" } }, "nbformat": 4, "nbformat_minor": 0 }