Changix

Elixir library that gives you changelog features based on markdown files. It leverages on Elixir metaprogramming features, so that everything is done at compile time, with following benefits:

• fast: no filesystem access or Markdown parsing at runtime. HTML is directly embedded in your compiled code.
• reliable: any error in your changelog files will be reported at compile time

Changix does not provide any UI widget, but you will be in good direction to write one into your Phoenix app.

Changix comes with no runtime dependencies, and can be used with any Markdown parser. A default behavior is implemented if earmark markdown library is present.

Demo

See the code for the demo app here

Installation

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

def deps do
  [
    {:changix, "~> 1.0.0"}
  ]
end

If you don't use any Markdown library, I recommand you also add earmark to your dependencies.

Usage

Create a changelog folder at the root of your project and write separate changelog files after each of your release.

A changelog file must contain a YAML Front Matter header with changed_at and kind attributes. title is optional.

Run mix changix.gen.changelog Fixed Lorem --kind bugfix to generate a new changelog entry such as:

changed_at: 2019-11-10T17:10:05
kind: bugfix
title: Fixed Lorem
---
## Your change summary in whatever Markdown you want
Lorem _ipsum dolor_ sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

<!--more-->

## Further details in the read-more section
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Then including Changix will give you access to all your changelog entries.

defmodule MyModule do

  include Changix
  
  def list_entries do
    for entry <- changelog_entries() do
      IO.inspect(entry)
    end
  end

  def show_entry(entry_changed_at) do
    entry_changed_at
    |> changelog_entry()
    |> IO.inspect
  end

end

Documentation

Docs can be found at https://hexdocs.pm/changix.