Better presentation of rust nif & wasm output

Author: RoyalIcing

lib/components_guide_web.ex

@@ -111,6 +111,7 @@ defmodule ComponentsGuideWeb do
       import ComponentsGuideWeb.AssetsHelpers
       alias ComponentsGuideWeb.StylingHelpers, as: Styling
       alias ComponentsGuideWeb.FormattingHelpers, as: Format
+      # alias ComponentsGuideWeb.PrimitiveHelpers, as: Primitives
 
       def markdown!(markdown) do
         Earmark.as_html!(markdown)

lib/components_guide_web/controllers/cheatsheets_controller.ex

@@ -2,7 +2,7 @@ defmodule ComponentsGuideWeb.CheatsheetsController do
   use ComponentsGuideWeb, :controller
   require Logger
 
-  @wasm_constant """
+  @wasm_source """
   (module
     (func (export "answer") (result i32)
      i32.const 42
@@ -11,7 +11,7 @@ defmodule ComponentsGuideWeb.CheatsheetsController do
   """
 
   def index(conn, _params) do
-    render(conn, "index.html", article: "intro", wasm_constant: @wasm_constant)
+    render(conn, "index.html", article: "intro", wasm_source: @wasm_source)
   end
 
   @articles ["rxjs", "error-messages", "cloud-limits"]
@@ -30,6 +30,8 @@ defmodule ComponentsGuideWeb.CheatsheetsView do
   use ComponentsGuideWeb.Snippets
   alias ComponentsGuideWeb.ThemeView
 
+  defdelegate code_block(assigns), to: ComponentsGuideWeb.PrimitiveHelpers
+
   def header_styles() do
     ThemeView.banner_styles(:cheatsheets)
   end

lib/components_guide_web/template_engines/markdown_engine.ex

@@ -91,6 +91,21 @@ defmodule ComponentsGuideWeb.TemplateEngines.MarkdownEngine do
 
     html |> EEx.compile_string(engine: Phoenix.HTML.Engine, file: path, line: 1)
 
+    # TODO: use Heex?
+    # unless Macro.Env.has_var?(__CALLER__, {:assigns, nil}) do
+    #   raise "~H requires a variable named \"assigns\" to exist and be set to a map"
+    # end
+
+    # options = [
+    #   engine: Phoenix.LiveView.HTMLEngine,
+    #   file: __CALLER__.file,
+    #   line: __CALLER__.line + 1,
+    #   module: __CALLER__.module,
+    #   indentation: meta[:indentation] || 0
+    # ]
+
+    # EEx.compile_string(expr, options)
+
     # case live? do
     #   true ->
     #     html |> EEx.compile_string(engine: Phoenix.HTML.Engine, file: path, line: 1)

lib/components_guide_web/templates/cheatsheets/intro.html.heex

@@ -0,0 +1,42 @@
+<p>Various cheatsheets will be added over time. If you have ideas for cheatsheets, please submit them.</p>
+
+<h2>Elixir</h2>
+<h3>Add numbers</h3>
+<.code_block lang="elixir">
+5 + 11
+</.code_block>
+<.code_block lang="elixir" code={(5 + 11) |> inspect()} />
+
+<hr />
+
+<h2>Rust</h2>
+<h3>Add numbers</h3>
+<.code_block lang="rust">
+fn add(a: i64, b: i64) -> i64 {
+    a + b
+}
+</.code_block>
+<.code_block lang="elixir">
+Math.add(5, 11)
+</.code_block>
+<.code_block lang="elixir" code={ComponentsGuide.Rustler.Math.add(5, 11) |> inspect()} />
+
+<h3>Reverse string</h3>
+<.code_block lang="rust">
+fn reverse_string(a: String) -> String {
+  return a.chars().rev().collect();
+}
+</.code_block>
+<.code_block lang="elixir">
+Math.reverse_string("hello")
+</.code_block>
+<.code_block lang="elixir" code={ComponentsGuide.Rustler.Math.reverse_string("hello") |> inspect()} />
+
+<hr />
+
+<h2>WebAssembly + Wasmtime running via Rust</h2>
+<.code_block lang="wasm" code={@wasm_source} />
+<.code_block lang="elixir">
+Math.wasm_example(@wasm_source, "answer")
+</.code_block>
+<.code_block lang="elixir" code={ComponentsGuide.Rustler.Math.wasm_example(@wasm_source, "answer") |> inspect()} />

lib/components_guide_web/templates/cheatsheets/intro.html.md

@@ -0,0 +1,25 @@
+defmodule ComponentsGuideWeb.PrimitiveHelpers do
+  @moduledoc """
+  Conveniences for translating and building error messages.
+  """
+
+  use Phoenix.HTML
+  use Phoenix.Component
+
+  def code_block(assigns) do
+    # assigns = %{}
+    # content_tag(:pre, inspect(assigns))
+    ~H"""
+    <pre class={"language-#{@lang}"}><code><%=
+      if assigns[:code] do
+        assigns[:code]
+      else
+        render_slot(@inner_block) |> then(fn
+          %{static: [code]} -> String.trim(code)
+          %{static: strings} when is_list(strings) -> strings |> Enum.join() |> String.trim()
+        end)
+      end
+    %></code></pre>
+    """
+  end
+end