Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Build Status

Erl2ex is an Erlang to Elixir transpiler, converting well-formed Erlang source to Elixir source with equivalent functionality.

The goal is to produce correct, functioning, but not necessarily perfectly idiomatic, Elixir code. This tool may be used as a starting point to port code from Erlang to Elixir, but manual cleanup will likely be desired.

This software is currently highly experimental and should be considered "pre-alpha". Some capabilities are not yet complete, and there are significant known issues, particularly in the Erlang preprocessor support. See the Caveats section for more information.


Erl2ex may be run as a mix task or as a standalone escript.


Erl2ex recognizes Erlang source that is compatible with Erlang 18.x. The generated Elixir source requires Elixir 1.4 or later. The Erl2ex tool itself also requires Elixir 1.4 or later.

Installing the mix task

To run the mix task, first add Erl2ex as a dependency to your existing Elixir project:

def deps do
  [ {:erl2ex, ">= 0.0.9", only: :dev} ]

After adding Erl2ex as a dependency, run mix deps.get followed by mix deps.compile to install it. An erl2ex task will now be available. Run mix help erl2ex for help.

Building the escript

To build a standalone command line application (escript), clone this repository using git clone, and then run mix within the cloned project.


Erl2ex may be run in three modes:

  • It can read an Erlang source file on stdin, and write the generated Elixir source to stdout.
  • It can read a specified Erlang source file (.erl) from the file system, and write the generated Elixir source file (.ex) to the same or a different specified directory.
  • It can search a directory for all Erlang source files (.erl), and write corresponding Elixir source files (.ex) to the same or a different specified directory.

Various switches may also be provided on the command line, including the include path for searching for Erlang include files (.hrl), and other conversion settings.

For detailed help, use mix help erl2ex for the mix task, or erl2ex --help for the standalone tool.


This software is still under heavy development, and many capabilities are not yet complete. The following is a partial list of known issues and planned features.

Known issues

Incomplete features / wishlist

  • Preserve comments from the Erlang source.
  • Generate exdoc comments, probably based on heuristics on the funtion comments.
  • Provide an option to elixirize module names (e.g. instead of generating defmodule :my_erlang_module, generate defmodule MyErlangModule)
  • Provide an option to convert variable names from camelCase to snake_case.
  • Provide (possibly optional) translation of include files (.hrl) to separate modules rather than copying into the including module, so the declarations can be shared after translation to Elixir.
  • Correct the usage of leading underscores in variable names.
  • Closer integration with EUnit.
  • Dead macro elimination, especially when inlining hrl files.
  • Do better at determining when a macro contains content that is allowed in guard clauses. We may be able to do away with the generated Macro.Env.in_guard? check.
  • Convert yrl files.
  • Fix expressions that cause scope "export" warnings in newer versions of Elixir.


While we appreciate contributions, please note that this software is currently highly experimental, and the code is evolving very rapidly. It is recommended to contact the author before embarking on a major pull request. More detailed contribution guidelines will be provided when the software stabilizes further.

The source can be found on Github at


Copyright 2015 Daniel Azuma

This software is licensed under the 3-clause BSD license.

See the file for more information.


An Erlang to Elixir transpiler







No packages published