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