https://github.com/carlosedp/rebar3_diameter_compiler

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

Last synced: 12 days ago
JSON representation

Compile Diameter .dia files on Erlang Rebar3 projects

• Host: GitHub
• URL: https://github.com/carlosedp/rebar3_diameter_compiler
• Owner: carlosedp
• License: other
• Created: 2015-06-26T18:02:08.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-01-18T13:56:44.000Z (10 months ago)
• Last Synced: 2024-10-06T17:35:09.849Z (about 1 month ago)
• Language: Erlang
• Size: 2.88 MB
• Stars: 6
• Watchers: 2
• Forks: 13
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• freaking_awesome_elixir - Erlang - Compile diameter .dia files in rebar3 projects. (Build Tools)
• fucking-awesome-elixir - rebar3_diameter_compiler - Compile diameter .dia files in rebar3 projects. (Build Tools)
• awesome-elixir - rebar3_diameter_compiler - Compile diameter .dia files in rebar3 projects. (Build Tools)

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