Packages
protox
1.2.2
2.0.9
2.0.8
2.0.7
2.0.6
2.0.5
2.0.4
2.0.3
2.0.2
2.0.1
2.0.0
2.0.0-dev
1.7.8
1.7.7
1.7.6
1.7.5
1.7.4
retired
1.7.3
1.7.2
1.7.1
1.7.0
1.6.10
1.6.9
1.6.8
1.6.7
1.6.6
1.6.5
1.6.4
1.6.3
1.6.2
1.6.1
1.6.0
1.5.1
1.5.0
1.4.0
1.3.2
1.3.1
1.3.0
1.2.4
1.2.3
1.2.2
1.2.1
1.2.0
1.1.1
1.1.0
1.0.0
0.25.0
0.24.0
0.23.1
0.23.0
0.22.0
0.21.0
0.20.0
0.19.1
0.19.0
0.18.0
0.17.0
0.16.2
0.16.1
0.16.0
0.15.2
0.15.1
0.15.0
0.14.0
0.13.0
0.12.1
0.12.0
0.11.1
0.11.0
0.10.0
0.9.1
0.9.0
0.8.0
0.7.1
0.7.0
A fast, easy to use and 100% conformant Elixir library for Google Protocol Buffers (aka protobuf)
Current section
Files
Jump to
Current section
Files
lib/protox.ex
defmodule Protox do
@moduledoc ~S'''
Use this module to generate the Elixir modules from a set of protobuf definitions:
defmodule Foo do
use Protox, files: [
"./defs/foo.proto",
"./defs/bar.proto",
"./defs/baz/fiz.proto",
]
end
It's also possible to directly give a schema:
defmodule Bar do
use Protox, schema: """
syntax = "proto3";
package fiz;
message Baz {
}
message Foo {
map<int32, Baz> b = 2;
}
"""
end
The generated modules respect the package declaration. For instance, in the above example,
both the `Fiz.Baz` and `Fiz.Foo` modules will be generated.
See https://github.com/ahamez/protox/blob/master/README.md for detailed instructions.
'''
defmacro __using__(opts) do
{opts, _} = Code.eval_quoted(opts)
{namespace, opts} = get_namespace(opts)
{path, opts} = get_path(opts)
{files, opts} = get_files(opts)
{:ok, file_descriptor_set} = Protox.Protoc.run(files, path)
{enums, messages} = Protox.Parse.parse(file_descriptor_set, namespace)
quote do
unquote(make_external_resources(files))
unquote(Protox.Define.define(enums, messages, opts))
end
end
defp get_namespace(opts) do
Keyword.pop(opts, :namespace)
end
defp get_path(opts) do
case Keyword.pop(opts, :path) do
{nil, opts} -> {nil, opts}
{p, opts} -> {Path.expand(p), opts}
end
end
defp get_files(opts) do
case Keyword.pop(opts, :schema) do
{<<text::binary>>, opts} ->
filename = "#{Base.encode16(:crypto.hash(:sha, text))}.proto"
filepath = [Mix.Project.build_path(), filename] |> Path.join() |> Path.expand()
File.write!(filepath, text)
{[filepath], opts}
{nil, opts} ->
{files, opts} = Keyword.pop(opts, :files)
{Enum.map(files, &Path.expand/1), opts}
end
end
defmodule FileContent do
@moduledoc false
defstruct([:name, :content])
end
def generate_module_code(files, output_path, multiple_files, include_path_or_nil, opts \\ [])
when is_list(files) and is_binary(output_path) and is_boolean(multiple_files) do
path =
case include_path_or_nil do
nil -> nil
_ -> Path.expand(include_path_or_nil)
end
{:ok, file_descriptor_set} =
files
|> Enum.map(&Path.expand/1)
|> Protox.Protoc.run(path)
{enums, messages} = Protox.Parse.parse(file_descriptor_set, nil)
code = quote do: unquote(Protox.Define.define(enums, messages, opts))
if multiple_files do
multiple_file_content(output_path, code)
else
single_file_content(output_path, code)
end
end
defp single_file_content(output_path, code) do
[
%FileContent{
name: output_path,
content: generate_file_content(code)
}
]
end
defp multiple_file_content(output_path, code) do
Enum.map(code, fn {:defmodule, _, [module_name | _]} = module_code ->
snake_module_name =
module_name |> to_string() |> String.replace(".", "") |> Macro.underscore()
%FileContent{
name: Path.join(output_path, snake_module_name <> ".ex"),
content: generate_file_content(module_code)
}
end)
end
defp generate_file_content(code),
do: ["#", " credo:disable-for-this-file\n", Macro.to_string(code)]
defp make_external_resources(files) do
Enum.map(files, fn file -> quote(do: @external_resource(unquote(file))) end)
end
end