Home

Awesome

CMake compiler for Mix

Build Status Hex Version

A CMake compiler to help building Ports/NIFs in your Elixir/mix project.

Installation

Add elixir_cmake to your list of dependencies in mix.exs:

def deps do
  [
    {:elixir_cmake, "~> 0.7.0"}
  ]
end

Add :cmake to your compilers in mix.exs:

def project do
  [
    # ...
    compilers: [:cmake] ++ Mix.compilers(),
    # ...
  ]
end

Basic Usage

CMakeLists.txt

Create your CMakeLists.txt in the root of your project or specify the path to an existing CMakeLists.txt file in your project config.

def project do
  [
    # ...
    cmake_lists: "path/to/CMakeLists.txt",
    # ...
  ]
end

The source files can reside anywhere the CMakeLists.txt file has access to.

You will need to copy the contents to your priv directory by either specifying a compile alias or by directing the binary output to priv/ in your CMakeLists.txt. file.

In this example we specify a project namedEXAMPLE, with source files in src/:

cmake_minimum_required(VERSION 3.0)
project(EXAMPLE)
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/priv)
file(GLOB EXAMPLE_SRC src/*.c)

SET (CMAKE_C_FLAGS "-g -O3 -pedantic -Wall -Wextra -Wno-unused-parameter -std=c99")

include_directories(SYSTEM)

add_executable(example ${EXAMPLE_SRC})

Run mix compile (or mix compile.cmake for just the CMake build) and you should find a compiled binary in priv/ afterwards.

Configuration Options

TODO

Be sure to read the documentation too.