LocationSimulator (LocationSimulator v1.0.0)

Copy Markdown View Source

Entry-point API for the LocationSimulator library.

defmodule MyApp.Tracker do
  use LocationSimulator.Pipeline

  source :synthetic, direction: :north, elevation: 50

  plug LocationSimulator.Plug.Callback, callback: MyApp.GpsHandler
end

LocationSimulator.start(MyApp.Tracker, %{worker: 3, event: 100, interval: 1_000})

With a plain config map (legacy)

LocationSimulator.start(%{
  worker:       3,
  event:        100,
  interval:     1_000,
  random_range: 200,
  direction:    :north,
  elevation:    50,
  callback:     MyApp.GpsHandler
})

Summary

Types

direction()

Functions

default_config()

Returns the merged default config (application config overrides built-in defaults).

start()

Starts one worker with the default / application config.

start(config)

Starts workers using a plain config map (legacy API).

start(pipeline_mod, runtime_config)

Starts workers with a pipeline module and runtime config.

stop(group_id)

Stops all workers that belong to group_id.

Types

direction()

@type direction() ::
  :north
  | :south
  | :east
  | :west
  | :north_east
  | :north_west
  | :south_east
  | :south_west
  | :random

Functions

default_config()

@spec default_config() :: map()

Returns the merged default config (application config overrides built-in defaults).

start()

@spec start() :: :ok

Starts one worker with the default / application config.

start(config)

@spec start(map()) :: :ok

Starts workers using a plain config map (legacy API).

See the module doc for supported config keys.

start(pipeline_mod, runtime_config)

@spec start(module(), map()) :: :ok

Starts workers with a pipeline module and runtime config.

The pipeline module defines the GPS source and the plug chain. The config map supplies runtime parameters (worker count, event count, etc.).

stop(group_id)

@spec stop(group_id :: any()) :: :ok

Stops all workers that belong to group_id.