Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/carlosedp/rebar3_diameter_compiler

Compile Diameter .dia files on Erlang Rebar3 projects
https://github.com/carlosedp/rebar3_diameter_compiler

Last synced: about 2 months ago
JSON representation

Compile Diameter .dia files on Erlang Rebar3 projects

Lists

README

        

rebar3_diameter_compiler
=====

Compile [diameter](http://erlang.org/doc/man/diameter.html) .dia files in rebar3 projects

[![Erlang CI](https://github.com/carlosedp/rebar3_diameter_compiler/actions/workflows/erlang.yml/badge.svg)](https://github.com/carlosedp/rebar3_diameter_compiler/actions/workflows/erlang.yml)
[![Hex pm](http://img.shields.io/hexpm/v/rebar3_diameter_compiler.svg?style=flat)](https://hex.pm/packages/rebar3_diameter_compiler)

Build
-----

./rebar3 compile

Use
---

Add the plugin to your rebar config from Github:

```erlang
{plugins, [
{ rebar3_diameter_compiler, {git, "https://github.com/carlosedp/rebar3_diameter_compiler.git", {branch, "master"}}}
]}.

{provider_hooks, [
{pre, [
{compile, {diameter, compile}},
{clean, {diameter, clean}}
]}
]}.
```

Or fetch the plugin using Hex.pm:

```erlang
{plugins, [
rebar3_diameter_compiler
]}.

{provider_hooks, [
{pre, [
{compile, {diameter, compile}},
{clean, {diameter, clean}}
]}
]}.
```

The plugin will be ran on compile and clean commands or call your plugin directly in an existing application:

$ rebar3 diameter compile
===> Fetching rebar3_diameter_compiler
===> Compiling rebar3_diameter_compiler
===> Compiling diameter...

$ rebar3 diameter clean
===> Cleaning diameter compiled files...

The option specified below allows to compile only specific diameter dictionaries

```erlang
{dia_only_files, [
your_dictionary
]}.
```

Test
-----

One test compiles a `.dia` file for validation, another compares the generated erl/hrl files with the expected files in `test/expected` directory.

rebar3 eunit

If the format changes in the future(for example due a compiler change), the expected files can be re-generated with `GOLDEN_RUN=1 rebar3 unit`. This will overwrite the existing expected files.

Publishing new versions
-----

This is mostly a reminder on how to bump and publish a new version.

# Login to Hex
rebar3 hex user auth
# Cut new version with hex
rebar3 hex cut