# 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"}

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.


## 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

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


## Documentation

Docs can be found at [](