Permalink
Browse files

Merge pull request #3 from josevalim/master

Add README.md
  • Loading branch information...
2 parents fec7728 + 4594f8a commit d86897eea071a75ba84ecd9773f7910915c5b6e7 @yrashk committed Jul 29, 2012
Showing with 56 additions and 0 deletions.
  1. +56 −0 README.md
View
@@ -0,0 +1,56 @@
+## rebar_elixir_plugin
+
+This plugin allows you to compile Elixir files in your Erlang projects using Rebar.
+
+## Installation
+
+To install this plugin, you need to add it as a dependency to your rebar application:
+
+ {deps, [{ rebar_elixir_plugin, ".*",
+ {git, "git://github.com/yrashk/rebar_elixir_plugin"}}]}.
+
+ %% Let rebar know about the new plugins
+ {plugins, [rebar_elixir_compiler, rebar_exunit] }.
+
+This plugin depends on Elixir too, so you need to add it as a rebar dependency:
+
+ {deps, [{ elixir, "0.6.*",
+ {git, "git://github.com/elixir-lang/elixir"}}]}.
+
+Elixir is structured similarly to Erlang's OTP. It is divided into applications that are placed inside the `lib` directory, as seen on its [source code repository](https://github.com/elixir-lang/elixir). Since rebar is not familiar with such structure, we need to tell it explicitly which Elixir apps we want to load, for example:
+
+ {lib_dirs, [
+ "deps/elixir/lib/elixir/ebin",
+ "deps/elixir/lib/ex_unit/ebin"
+ ]}.
+
+This should be all.
+
+## Available configuration
+
+* `ex_first_files` - first elixir files to be configured;
+* `src_dirs` - where to find elixir source;
+* `ex_opts` - elixir compilation options: `ignore_module_conflict` (default to true), `docs` (default to false) and `debug_info` (default to false);
+
+## License
+
+Copyright 2012 Yurii Rashkovskii
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

0 comments on commit d86897e

Please sign in to comment.