Update

rstacruz · Jun 18, 2016 · f33fb9d · f33fb9d
1 parent b223efb
commit f33fb9d
Show file tree

Hide file tree

Showing 8 changed files with 293 additions and 23 deletions.
diff --git a/ansible-modules.md b/ansible-modules.md
@@ -7,12 +7,14 @@ category: Ansible
 
     - apt_key: id=AC40B2F7 url="http://..."
         state=present
-        
+
     - apt: pkg=nodejs state=present
         state=present # absent | latest
         update_cache=yes
         force=no
 
+   - apt: deb=https://packages.erlang-solutions.com/erlang-solutions_1.0_all.deb
+
     - apt_repository: repo='deb https://... raring main'
         state=present
 
@@ -58,3 +60,7 @@ category: Ansible
     - shell: apt-get install nginx -y
     - script: /x/y/script.sh
 
+### local_action
+
+    - name: do something locally
+      local_action: shell echo hello
diff --git a/css-system-font-stack.md b/css-system-font-stack.md
@@ -0,0 +1,8 @@
+---
+title: "CSS: System font stack"
+category: CSS
+---
+
+```
+font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Roboto", "Oxygen", "Ubuntu", "Cantarell", "Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif;
+```
diff --git a/dockerfile.md b/dockerfile.md
@@ -25,3 +25,20 @@ RUN bundle install
 ```
 WORKDIR /myapp
 ```
+
+### Onbuild
+
+```docker
+ONBUILD RUN bundle install   # when used with another file
+```
+
+### Commands
+
+```docker
+EXPOSE 5900
+CMD    ["bundle", "exec", "rails", "server"]
+```
+
+### Reference
+
+- <https://docs.docker.com/engine/reference/builder/>
diff --git a/elixir-metaprogramming.md b/elixir-metaprogramming.md
@@ -0,0 +1,33 @@
+---
+title: Elixir metaprogramming
+category: Elixir
+---
+
+## Kernel
+
+Most of these magic is defined in [Kernel.SpecialForms](http://devdocs.io/elixir/elixir/kernel.specialforms).
+
+### Pseudo-variables
+
+```elixir
+__DIR__     # current dir
+__MODULE__  # current module
+__CALLER__  # caller of the function
+```
+
+### [`__ENV__`](http://devdocs.io/elixir/elixir/kernel.specialforms#__ENV__/0)
+
+```elixir
+Map.keys(__ENV__)
+[:__struct__, :aliases, :context, :context_modules, :export_vars, :file,
+ :function, :functions, :lexical_tracker, :line, :macro_aliases, :macros,
+ :module, :requires, :vars]
+```
+
+```elixir
+__CALLER__.module |> Module.definitions_in |> IO.inspect
+```
+
+```elixir
+apply(Enum, :reverse, [[1, 2, 3]])
+```
diff --git a/elixir.md b/elixir.md
@@ -191,7 +191,8 @@ Also see [Enum](#enum).
 ```js
 import List
 list = [ 1, 2, 3, 4 ]
-list = [ 1 | list ]     # unshift (prepend)
+list = list ++ [5]      # push (append)
+list = [ 0 | list ]     # unshift (prepend)
 
 first(list)
 last(list)

diff --git a/exunit.md b/exunit.md
@@ -0,0 +1,64 @@
+---
+title: ExUnit
+category: Elixir
+---
+
+```elixir
+defmodule MyTest do
+  use ExUnit.Case
+  use ExUnit.Case, async: true  # for async
+
+  test "the truth" do
+    assert 1 + 1 == 2
+  end
+end
+```
+
+### Capture IO
+
+```elixir
+import ExUnit.CaptureIO
+
+test "capture io" do
+  result = capture_io(fn ->
+    IO.puts "sup"
+  end)
+
+  assert result == "sup\n"
+end
+```
+
+### Capture logs
+
+```elixir
+config :ex_unit, capture_logs: true
+```
+
+### Async
+
+```elixir
+defmodule AssertionTest do
+  # run concurrently with other test cases
+  use ExUnit.Case, async: true
+end
+```
+
+### [Assertions](http://devdocs.io/elixir/ex_unit/exunit.assertions)
+
+```elixir
+assert x == y
+refute x == y
+
+assert_raise ArithmeticError, fn ->
+  1 + "test"
+end
+
+assert_raise ArithmeticError, "message", fn -> ...
+assert_raise ArithmeticError, ~r/message/, fn -> ...
+
+flunk "This should've been an error"
+
+
+## Also see
+
+- <http://devdocs.io/elixir/ex_unit/exunit#configure/1>
diff --git a/phoenix-conn.md b/phoenix-conn.md
@@ -3,7 +3,8 @@ title: "Phoenix: Plug.Conn"
 category: Elixir
 ---
 
-## Request
+Request
+-------
 
 ```elixir
 conn.host         #=> "example.com"
@@ -16,9 +17,19 @@ conn.scheme       #=> :http
 conn.peer         #=> { {127, 0, 0, 1}, 12345 }
 conn.remote_ip    #=> { 151, 236, 219, 228 }
 conn.req_headers  #=> [{"content-type", "text/plain"}]
+conn |> get_req_header("referrer")
 ```
 
-## Response
+### Updating
+Usually only useful for tests.
+
+```elixir
+conn
+|> put_req_header("accept", "application/json")
+```
+
+Response
+--------
 
 ```elixir
 conn.resp_body    #=> "..."
@@ -28,6 +39,64 @@ conn.resp_headers #=> ...
 conn.status       #=> ...
 ```
 
+### Sending responses
+
+```elixir
+# Plug.Conn
+conn
+|> html("<html><head>...")
+|> json(%{ message: "Hello" })
+|> text("Hello")
+
+|> redirect(to: "/foo")
+|> redirect(external: "http://www.google.com/")
+|> halt()
+
+|> put_resp_content_type("text/plain")
+|> put_resp_cookie("abc", "def")
+|> put_resp_header("X-Delivered-By", "myapp")
+|> put_status(202)
+|> put_status(:not_found)
+
+|> put_private(:plug_foo, "...")  # reserved for libraries
+
+|> send_resp(201, "")
+```
+
+### Phoenix views
+
+```elixir
+# Phoenix.Controller
+conn
+|> render("index.html")
+|> render("index.html", hello: "world")
+|> render(MyApp.ErrorView, "404.html")
+
+|> put_layout(:foo)
+|> put_layout(false)
+|> put_view(ErrorView)
+|> put_secure_browser_headers()
+# prevent clickjacking, nosniff, and xss protection
+# x-frame-options, x-content-type-options, x-xss-protection
+
+|> put_new_view(ErrorView)  # if not set yet
+|> put_new_layout(:foo)
+```
+
+```elixir
+layout(conn)
+```
+
+Accepts
+-------
+
+```js
+plug :accepts, ["html", "json"]
+conn |> accepts(["html", "json"])
+get_format(conn)  #=> "html"
+conn.accepts
+```
+
 ## Misc
 
 ```elixir
@@ -41,16 +110,16 @@ conn.state           # :unset, :set, :file, :sent, :chunked
 ## Assigns
 
 ```elixir
-conn = assign(conn, :user_id, 100)
 conn.assigns[:hello]
+conn |> assign(:user_id, 100)
 ```
 
 ```elixir
 conn = async_assign(conn, :location, fn -> geoip_lookup() end)
 await_assign(conn, :location)
 ```
 
-## Fetchables
+## Session
 
 ```elixir
 conn = fetch_session(conn)   # or plug :fetch_session
@@ -69,20 +138,4 @@ conn
 ```
 
 ```elixir
-|> halt
-
-|> put_resp_content_type("text/plain")
-|> put_layout(false)
-|> put_status(202)
-|> put_status(:not_found)
-
-|> render "index.html"
-|> render "index.html", hello: "world"
-|> render MyApp.ErrorView, "404.html"
-
-|> redirect to: "/foo"
-|> redirect external: "http://www.google.com/"
-|> text "Hello"
-
-|> send_resp(201, "")
 ```