SAXMap

Converts an XML String to a Map.

Benefit from Saxy's SAX mode, this library has a good conversion efficiency.

Installation

def deps do
  [
    {:sax_map, "~> 0.1"}
  ]
end

Example

iex(1)> xml = """
...(1)> <?xml version="1.0" encoding="UTF-8"?>
...(1)> <thread>
...(1)>   <title>Hello</title>
...(1)>   <items>
...(1)>     <item>item1</item>
...(1)>     <item>item2</item>
...(1)>   </items>
...(1)> </thread>
...(1)> """
iex(2)> SAXMap.from_string(xml)
{:ok,
 %{
   "thread" => %{"items" => %{"item" => ["item1", "item2"]}, "title" => "Hello"}
 }}

Please notice that both XML attributes and comments are ignored.

Benchmark

Only for your reference, all of credit belong to Saxy, the details of benchmark can be found in the bench directory of the repository.

Operating System: macOS
CPU Information: Intel(R) Core(TM) i5-4258U CPU @ 2.40GHz
Number of Available Cores: 4
Available memory: 8 GB
Elixir 1.9.4
Erlang 22.1.8

Benchmark suite executing with the following configuration:
warmup: 2 s
time: 10 s
memory time: 2 s
parallel: 1
inputs: none specified
Estimated total run time: 28 s

Benchmarking SAXMap.from_string...
Benchmarking XmlToMap.naive_map...

Name                         ips        average  deviation         median         99th %
SAXMap.from_string       30.54 K       32.74 μs    ±46.08%          31 μs          72 μs
XmlToMap.naive_map       20.42 K       48.97 μs    ±30.19%          44 μs         105 μs

Comparison:
SAXMap.from_string       30.54 K
XmlToMap.naive_map       20.42 K - 1.50x slower +16.23 μs

Memory usage statistics:

Name                  Memory usage
SAXMap.from_string        14.82 KB
XmlToMap.naive_map        34.66 KB - 2.34x memory usage +19.84 KB

**All measurements for memory usage were the same**