first commit

Author: wolf4ood

.formatter.exs

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

.gitignore

@@ -0,0 +1,29 @@
+# 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 3rd-party dependencies like ExDoc output generated docs.
+/doc/
+
+# Ignore .fetch files in case you like to edit your project deps locally.
+/.fetch
+
+# 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").
+rust_elixir-*.tar
+
+
+/native/niftest/Cargo.lock
+/priv/native/*.so
+/native/niftest/target
+

README.md

@@ -0,0 +1,21 @@
+# RustElixir
+
+**TODO: Add description**
+
+## Installation
+
+If [available in Hex](https://hex.pm/docs/publish), the package can be installed
+by adding `rust_elixir` to your list of dependencies in `mix.exs`:
+
+```elixir
+def deps do
+  [
+    {:rust_elixir, "~> 0.1.0"}
+  ]
+end
+```
+
+Documentation can be generated with [ExDoc](https://github.com/elixir-lang/ex_doc)
+and published on [HexDocs](https://hexdocs.pm). Once published, the docs can
+be found at [https://hexdocs.pm/rust_elixir](https://hexdocs.pm/rust_elixir).
+

config/config.exs

@@ -0,0 +1,30 @@
+# This file is responsible for configuring your application
+# and its dependencies with the aid of the Mix.Config module.
+use Mix.Config
+
+# This configuration is loaded before any dependency and is restricted
+# to this project. If another project depends on this project, this
+# file won't be loaded nor affect the parent project. For this reason,
+# if you want to provide default values for your application for
+# 3rd-party users, it should be done in your "mix.exs" file.
+
+# You can configure your application as:
+#
+#     config :rust_elixir, key: :value
+#
+# and access this configuration in your application as:
+#
+#     Application.get_env(:rust_elixir, :key)
+#
+# You can also configure a 3rd-party app:
+#
+#     config :logger, level: :info
+#
+
+# It is also possible to import configuration files, relative to this
+# directory. For example, you can emulate configuration per environment
+# by uncommenting the line below and defining dev.exs, test.exs and such.
+# Configuration from the imported file will override the ones defined
+# here (which is why it is important to import them last).
+#
+#     import_config "#{Mix.env}.exs"

lib/rust_elixir.ex

@@ -0,0 +1,22 @@
+defmodule RustElixir do
+  @moduledoc """
+  Documentation for RustElixir.
+  """
+
+  @doc """
+  Hello world.
+
+  ## Examples
+
+      iex> RustElixir.hello
+      :world
+
+  """
+  def hello do
+    :world
+  end
+
+  def add(x,y) do
+    NifTest.add(x,y)
+  end
+end

lib/rust_elixir/native.ex

@@ -0,0 +1,13 @@
+defmodule NifNotLoadedError do
+  defexception message: "nif not loaded"
+end
+
+defmodule NifTest do
+  use Rustler, otp_app: :rust_elixir, crate: "niftest"
+
+  def add(_x,_y), do: err()
+
+  defp err() do
+    throw(NifNotLoadedError)
+  end
+end

mix.exs

@@ -0,0 +1,40 @@
+defmodule RustElixir.MixProject do
+  use Mix.Project
+
+  def project do
+    [
+      app: :rust_elixir,
+      version: "0.1.0",
+      elixir: "~> 1.6",
+      compilers: [:rustler] ++ Mix.compilers,
+      start_permanent: Mix.env() == :prod,
+      rustler_crates: rustler_crates(),
+      deps: deps()
+    ]
+  end
+
+  # Run "mix help compile.app" to learn about applications.
+  def application do
+    [
+      extra_applications: [:logger]
+    ]
+  end
+
+  # Run "mix help deps" to learn about dependencies.
+  defp deps do
+    [
+      {:rustler, "~> 0.16.0"}
+      # {:dep_from_hexpm, "~> 0.3.0"},
+      # {:dep_from_git, git: "https://github.com/elixir-lang/my_dep.git", tag: "0.1.0"},
+    ]
+  end
+
+  defp rustler_crates do
+    [niftest: [
+      path: "native/niftest",
+      mode: rustc_mode(Mix.env)
+    ]]
+  end
+  defp rustc_mode(:prod), do: :release
+  defp rustc_mode(_), do: :debug
+end

mix.lock

@@ -0,0 +1,3 @@
+%{
+  "rustler": {:hex, :rustler, "0.16.0", "9b04237d2e7b30fcae40a28edb56f59aad8f4e3c8790f4996b5f200f649964be", [:mix], [], "hexpm"},
+}

native/niftest/Cargo.toml

@@ -0,0 +1,14 @@
+[package]
+name = "niftest"
+version = "0.1.0"
+authors = []
+
+[lib]
+name = "niftest"
+path = "src/lib.rs"
+crate-type = ["dylib"]
+
+[dependencies]
+rustler = "0.16.0"
+rustler_codegen = "0.16.0"
+lazy_static = "0.2"

native/niftest/README.md

@@ -0,0 +1,21 @@
+# Nif for Elixir.NifTest
+
+## To build the NIF module:
+
+  * Make sure your projects `mix.exs` has the `:rustler` compiler listed in the `project` function: `compilers: [:rustler] ++ Mix.compilers` If there already is a `:compilers` list, you should append `:rustler` to it.
+  * Add your crate to the `rustler_crates` attribute in the `project function. [See here](https://hexdocs.pm/rustler/basics.html#crate-configuration).
+  * Your NIF will now build along with your project.
+
+## To load the NIF:
+
+```elixir
+defmodule NifTest do
+    use Rustler, otp_app: [otp app], crate: "niftest"
+
+    # When your NIF is loaded, it will override this function.
+    def add(_a, _b), do: :erlang.nif_error(:nif_not_loaded)
+end
+```
+
+## Examples
+[This](https://github.com/hansihe/NifIo) is a complete example of a NIF written in Rust.

native/niftest/src/lib.rs

@@ -0,0 +1,27 @@
+#[macro_use] extern crate rustler;
+#[macro_use] extern crate rustler_codegen;
+#[macro_use] extern crate lazy_static;
+
+use rustler::{NifEnv, NifTerm, NifResult, NifEncoder};
+
+mod atoms {
+    rustler_atoms! {
+        atom ok;
+        //atom error;
+        //atom __true__ = "true";
+        //atom __false__ = "false";
+    }
+}
+
+rustler_export_nifs! {
+    "Elixir.NifTest",
+    [("add", 2, add)],
+    None
+}
+
+fn add<'a>(env: NifEnv<'a>, args: &[NifTerm<'a>]) -> NifResult<NifTerm<'a>> {
+    let num1: i64 = try!(args[0].decode());
+    let num2: i64 = try!(args[1].decode());
+
+    Ok((atoms::ok(), num1 + num2).encode(env))
+}

test/rust_elixir_test.exs

@@ -0,0 +1,12 @@
+defmodule RustElixirTest do
+  use ExUnit.Case
+  doctest RustElixir
+
+  test "greets the world" do
+    assert RustElixir.hello() == :world
+  end
+
+  test "native call" do
+    assert RustElixir.add(1, 2) == {:ok, 3}
+  end
+end

test/test_helper.exs

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