Current section

Files

Jump to
kayrock lib kayrock compression.ex
Raw

lib/kayrock/compression.ex

defmodule Kayrock.Compression do
@moduledoc """
Handles compression/decompression of messages.
NOTE this is a copy of KafkaEx.Compression:
https://github.com/kafkaex/kafka_ex/blob/master/lib/kafka_ex/compression.ex
It is duplicated here to avoid creating a circular dependency.
See https://cwiki.apache.org/confluence/display/KAFKA/A+Guide+To+The+Kafka+Protocol#AGuideToTheKafkaProtocol-Compression
To add new compression types:
1. Add the appropriate dependency to mix.exs (don't forget to add it
to the application list).
2. Add the appropriate attribute value and compression_type atom.
3. Add a decompress function clause.
4. Add a compress function clause.
"""
@gzip_attribute 1
@snappy_attribute 2
@type attribute_t :: integer
@type compression_type_t :: :snappy | :gzip
@doc """
This function should pattern match on the attribute value and return
the decompressed data.
"""
@spec decompress(attribute_t, binary) :: binary
def decompress(@gzip_attribute, data) do
:zlib.gunzip(data)
end
def decompress(@snappy_attribute, data) do
<<_snappy_header::64, _snappy_version_info::64, rest::binary>> = data
snappy_decompress_chunk(rest, <<>>)
end
@doc """
This function should pattern match on the compression_type atom and
return the compressed data as well as the corresponding attribute
value.
"""
@spec compress(compression_type_t, binary) :: {binary, attribute_t}
def compress(:snappy, data) do
{:ok, compressed_data} = :snappy.compress(data)
{compressed_data, @snappy_attribute}
end
def compress(:gzip, data) do
compressed_data = :zlib.gzip(data)
{compressed_data, @gzip_attribute}
end
def snappy_decompress_chunk(<<>>, so_far) do
so_far
end
def snappy_decompress_chunk(
<<valsize::32-unsigned, value::size(valsize)-binary, rest::binary>>,
so_far
) do
{:ok, decompressed_value} = :snappy.decompress(value)
snappy_decompress_chunk(rest, so_far <> decompressed_value)
end
end