# Hexate

A simple module for hexadecimal encoding / decoding in Elixir.

## Note: name change from `hex` to `hexate`

Now that Elixir includes integration with Hex.pm, the library has been
renamed `hexate` to avoid namespace clashes.

This was manifesting itself with intermittent failures when running test
suites. If you experience this, update your deps!

If you really *must* use the old version, it's on the branch `pre-rename-to-hexate`.

## Adding to your `mix.exs`

```elixir
defp deps do
  [
    {:hexate,  ">= 0.5.0"}
  ]
end
```

## Usage

Encode to binary string:
```elixir
iex> Hexate.encode("This is a test.")
     "54686973206973206120746573742e"

iex> Hexate.encode('This is a test.')
     "54686973206973206120746573742e"

iex> Hexate.encode(123456)
     "1e240"

iex> Hexate.encode(15, 4)
     "000f"

iex> Hexate.encode(15.0, 2)
     "0f"

iex> Hexate.encode(15.0)
     "f"
```

Decode to binary string:
```elixir
iex> Hexate.decode("54686973206973206120746573742e")
     "This is a test."

iex> Hexate.decode('54686973206973206120746573742e')
     "This is a test."
```

Encode to list:
```elixir
iex> Hexate.encode_to_list('This is a test.')
     '54686973206973206120746573742e'

iex> Hexate.encode_to_list("This is a test.")
     '54686973206973206120746573742e'

iex> Hexate.encode_to_list(123456)
     '1e240'

```

Decode to list:
```elixir
iex> Hexate.decode_to_list('54686973206973206120746573742e')
     'This is a test.'

iex> Hexate.decode_to_list("54686973206973206120746573742e")
     'This is a test.'
```

Convert hexate to integer:
```elixir
iex> Hexate.to_integer('54686973206973206120746573742e')
     438270661302729020147902120434299950

iex> Hexate.to_integer("54686973206973206120746573742e")
     438270661302729020147902120434299950
```

## Contributing

* Fork this repo
* Make a feature branch
* Issue a pull request

## Authors

[Robert J Samson](https://github.com/rjsamson)
[David Parry](https://github.com/suranyami)