Add example project

Author: wojtekmach

.github/workflows/ci.yml

@@ -17,7 +17,7 @@ jobs:
         with:
           otp-version: "27.2"
           elixir-version: "1.18.2"
-      - run: mix deps.get
+      - run: mix deps.get --check-locked
       - run: mix deps.compile
       - run: mix format --check-formatted
       - run: mix deps.unlock --check-unused
@@ -59,3 +59,11 @@ jobs:
         working-directory: test
       - run: mix test
         working-directory: test
+      - name: Test example/
+        run: |
+          mix deps.get --check-locked
+          mix format --check-formatted
+          mix deps.unlock --check-unused
+          mix test --warnings-as-errors
+        working-directory: example
+        if: ${{ !startsWith(matrix.os.id, 'windows') }}

README.md

@@ -110,6 +110,8 @@ FINE_NIF(add, 0);
 FINE_INIT("Elixir.MyLib.NIF");
 ```
 
+See [`example/`](https://github.com/elixir-nx/fine/tree/main/example) project.
+
 ## Encoding/Decoding
 
 Terms are automatically encoded and decoded at the NIF boundary based

example/.formatter.exs

@@ -0,0 +1,4 @@
+# Used by "mix format"
+[
+  inputs: ["{mix,.formatter}.exs", "{config,lib,test}/**/*.{ex,exs}"]
+]

example/.gitignore

@@ -0,0 +1,23 @@
+# The directory Mix will write compiled artifacts to.
+/_build/
+
+# If you run "mix test --cover", coverage assets end up here.
+/cover/
+
+# The directory Mix downloads your dependencies sources to.
+/deps/
+
+# Where third-party dependencies like ExDoc output generated docs.
+/doc/
+
+# If the VM crashes, it generates a dump, let's ignore it too.
+erl_crash.dump
+
+# Also ignore archive artifacts (built via "mix archive.build").
+*.ez
+
+# Ignore package tarball (built via "mix hex.build").
+example-*.tar
+
+# Temporary files, for example, from tests.
+/tmp/

example/Makefile

@@ -0,0 +1,15 @@
+SRC := c_src/example_nif.cpp
+TARGET := $(MIX_BUILD_DIR)/example_nif.so
+
+CPPFLAGS := -std=c++17 -fvisibility=hidden -fPIC -I$(ERL_INCLUDE_DIR) -I$(FINE_INCLUDE_DIR)
+
+ifeq ($(shell uname -s),Darwin)
+    LDFLAGS := -dynamiclib -undefined dynamic_lookup
+else
+    LDFLAGS := -shared
+endif
+
+all: $(TARGET)
+
+$(TARGET): $(SRC)
+	$(CXX) $(CPPFLAGS) $(LDFLAGS) -o $@ $^

example/README.md

@@ -0,0 +1,10 @@
+# Example
+
+Example project using Fine to implement NIFs.
+
+To run tests, execute:
+
+```shell
+$ mix deps.get
+$ mix test
+```

example/c_src/example_nif.cpp

@@ -0,0 +1,8 @@
+#include <fine.hpp>
+
+int64_t add(ErlNifEnv *env, int64_t x, int64_t y) {
+  return x + y;
+}
+
+FINE_NIF(add, 0);
+FINE_INIT("Elixir.Example");

example/lib/example.ex

@@ -0,0 +1,20 @@
+defmodule Example do
+  @on_load :load_nif
+  @mix_build_dir Mix.Project.build_path()
+
+  defp load_nif do
+    :erlang.load_nif(~c"#{@mix_build_dir}/example_nif", 0)
+  end
+
+  @doc """
+  Adds two numbers using NIF.
+
+  ## Examples
+
+      iex> Example.add(1, 2)
+      3
+  """
+  def add(_x, _y) do
+    :erlang.nif_error("nif not loaded")
+  end
+end

example/mix.exs

@@ -0,0 +1,33 @@
+defmodule Example.MixProject do
+  use Mix.Project
+
+  def project do
+    [
+      app: :example,
+      version: "0.1.0",
+      elixir: "~> 1.15",
+      compilers: [:elixir_make] ++ Mix.compilers(),
+      make_env: fn ->
+        %{
+          "MIX_BUILD_DIR" => Mix.Project.build_path(),
+          "ERL_INCLUDE_DIR" => "#{:code.root_dir()}/usr/include",
+          "FINE_INCLUDE_DIR" => Fine.include_dir()
+        }
+      end,
+      deps: deps()
+    ]
+  end
+
+  def application do
+    [
+      extra_applications: [:logger]
+    ]
+  end
+
+  defp deps do
+    [
+      {:elixir_make, "~> 0.9.0"},
+      {:fine, path: ".."}
+    ]
+  end
+end

example/mix.lock

@@ -0,0 +1,3 @@
+%{
+  "elixir_make": {:hex, :elixir_make, "0.9.0", "6484b3cd8c0cee58f09f05ecaf1a140a8c97670671a6a0e7ab4dc326c3109726", [:mix], [], "hexpm", "db23d4fd8b757462ad02f8aa73431a426fe6671c80b200d9710caf3d1dd0ffdb"},
+}

example/test/example_test.exs

@@ -0,0 +1,4 @@
+defmodule ExampleTest do
+  use ExUnit.Case, async: true
+  doctest Example
+end

example/test/test_helper.exs

@@ -0,0 +1 @@
+ExUnit.start()