Packages
spawn
2.0.0-RC2
2.0.0-RC9
2.0.0-RC8
2.0.0-RC7
2.0.0-RC6
2.0.0-RC5
2.0.0-RC4
2.0.0-RC3
2.0.0-RC2
2.0.0-RC14
2.0.0-RC13
2.0.0-RC12
2.0.0-RC11
2.0.0-RC10
2.0.0-RC1
1.4.3
1.4.2
1.4.1
1.4.0
1.3.3
1.3.2
1.3.1
1.3.0
1.2.1
1.2.0
1.1.1
1.1.0
1.0.1
1.0.0
1.0.0-rc3
1.0.0-rc16
1.0.0-rc1
1.0.0-rc.38
1.0.0-rc.37
1.0.0-rc.36
1.0.0-rc.35
1.0.0-rc.34
1.0.0-rc.33
1.0.0-rc.32
1.0.0-rc.31
1.0.0-rc.30
1.0.0-rc.29
1.0.0-rc.28
1.0.0-rc.27
1.0.0-rc.26
1.0.0-rc.25
1.0.0-rc.24
1.0.0-rc.23
1.0.0-rc.22
1.0.0-rc.21
1.0.0-rc.20
1.0.0-rc.19
1.0.0-rc.18
1.0.0-rc.17
1.0.0-rc.2
0.6.3
0.6.2
0.6.1
0.6.0
0.5.5
0.5.4
0.5.3
0.5.1
0.5.0
0.5.0-rc.13
0.5.0-rc.12
0.5.0-rc.11
0.5.0-rc.10
0.5.0-rc.9
0.5.0-rc.8
0.5.0-rc.7
0.5.0-rc.6
0.5.0-rc.5
0.5.0-rc.3
0.5.0-alpha.13
0.5.0-alpha.12
0.5.0-alpha.11
0.5.0-alpha.10
0.5.0-alpha.9
0.5.0-alpha.8
0.5.0-alpha.7
0.5.0-alpha.6
0.5.0-alpha.5
0.5.0-alpha.4
0.5.0-alpha.3
0.5.0-alpha.2
0.5.0-alpha.1
0.1.0
Spawn is the core lib for Spawn Actors System
Current section
Files
Jump to
Current section
Files
lib/sidecar/grpc/generators/actor_invoker_generator.ex
defmodule Sidecar.GRPC.Generators.ActorInvoker do
@moduledoc """
Module for generating an actor invoker helper.
"""
@behaviour ProtobufGenerate.Plugin
alias Actors.Config.PersistentTermConfig, as: Config
alias Protobuf.Protoc.Generator.Util
@impl true
def template do
"""
defmodule <%= @module %> do
@moduledoc "This module provides helper functions for invoking the methods on the <%= @service_name %> actor."
@doc \"\"\"
Invokes the get_state implicit action for this actor.
## Examples
```elixir
iex> <%= @module %>.get_state()
{:ok, actor_state}
```
\"\"\"
def get_state do
%SpawnSdk.ActorRef{system: "<%= @actor_system %>", name: "<%= @actor_name %>"}
|> get_state()
end
@doc \"\"\"
Invokes the get_state implicit action.
## Parameters
- `ref` - The actor ref to send the action to.
## Examples
```elixir
iex> <%= @module %>.get_state(SpawnSdk.Actor.ref("<%= @actor_system %>", "actor_id_01"))
{:ok, actor_state}
```
\"\"\"
def get_state(%SpawnSdk.ActorRef{} = ref) do
opts = [
system: ref.system || "<%= @actor_system %>",
action: "get_state",
async: false
]
actor_to_invoke = ref.name || "<%= @actor_name %>"
opts = if actor_to_invoke == "<%= @actor_name %>" do
opts
else
Keyword.put(opts, :ref, "<%= @actor_name %>")
end
SpawnSdk.invoke(actor_to_invoke, opts)
end
<%= for {method_name, input, output, _options} <- @methods do %>
def <%= Macro.underscore(method_name) %>() do
%SpawnSdk.ActorRef{system: "<%= @actor_system %>", name: "<%= @actor_name %>"}
|> <%= Macro.underscore(method_name) %>(%<%= input %>{}, [])
end
def <%= Macro.underscore(method_name) %>(%<%= input %>{} = payload) do
%SpawnSdk.ActorRef{system: "<%= @actor_system %>", name: "<%= @actor_name %>"}
|> <%= Macro.underscore(method_name) %>(payload, [])
end
def <%= Macro.underscore(method_name) %>(%<%= input %>{} = payload, opts) when is_list(opts) do
%SpawnSdk.ActorRef{system: "<%= @actor_system %>", name: "<%= @actor_name %>"}
|> <%= Macro.underscore(method_name) %>(payload, opts)
end
def <%= Macro.underscore(method_name) %>(%SpawnSdk.ActorRef{} = ref, %<%= input %>{} = payload) do
ref
|> <%= Macro.underscore(method_name) %>(payload, [])
end
@doc \"\"\"
Invokes the <%= method_name %> method registered on <%= @actor_name %>.
## Parameters
- `ref` - The actor ref to send the action to.
- `payload` - The payload to send to the action.
- `opts` - The options to pass to the action.
## Examples
```elixir
iex> <%= @module %>.<%= Macro.underscore(method_name) %>(SpawnSdk.Actor.ref("<%= @actor_system %>", "actor_id_01"), %<%= input %>{}, async: false, metadata: %{"example" => "metadata"})
{:ok, %<%= output %>{}}
```
\"\"\"
def <%= Macro.underscore(method_name) %>(%SpawnSdk.ActorRef{} = ref, %<%= input %>{} = payload, opts) when is_list(opts) do
opts = [
system: ref.system || "<%= @actor_system %>",
action: "<%= method_name %>",
payload: payload,
async: opts[:async] || false,
metadata: opts[:metadata] || %{}
]
actor_to_invoke = ref.name || "<%= @actor_name %>"
opts = if actor_to_invoke == "<%= @actor_name %>" do
opts
else
Keyword.put(opts, :ref, "<%= @actor_name %>")
end
SpawnSdk.invoke(actor_to_invoke, opts)
end
<% end %>
end
"""
end
@impl true
def generate(ctx, %Google.Protobuf.FileDescriptorProto{service: svcs} = _desc) do
for svc <- svcs do
mod_name = Util.mod_name(ctx, [Macro.camelize(svc.name)])
actor_name = Macro.camelize(svc.name)
actor_system = Config.get(:actor_system_name)
methods =
for m <- svc.method do
input = Util.type_from_type_name(ctx, m.input_type)
output = Util.type_from_type_name(ctx, m.output_type)
options =
m.options
|> opts()
|> inspect(limit: :infinity)
{m.name, input, output, options}
end
{mod_name,
[
module: mod_name,
actor_system: actor_system,
actor_name: actor_name,
service_name: mod_name,
methods: methods,
version: Util.version()
]}
end
end
defp opts(%Google.Protobuf.MethodOptions{__pb_extensions__: extensions})
when extensions == %{} do
%{}
end
defp opts(%Google.Protobuf.MethodOptions{__pb_extensions__: extensions}) do
for {{type, field}, value} <- extensions, into: %{} do
{field, %{type: type, value: value}}
end
end
end