MobDev.TaskTargets (mob_dev v0.7.4)

Copy Markdown View Source

Shared device-selection policy for tasks that can change device state.

A named device is always explicit. Broad selection keeps physical devices behind :all_physical; :all_devices means development emulators and simulators. Combined :all_devices and :all_physical selects every connected device. With no scope flags, exactly one non-physical device may be selected automatically; multiple development devices are an ambiguity error.

Summary

Types

selection_error()

Functions

filter_by_id(devices, ids)

Filter devices by the identifiers accepted by MobDev.Device.match_id?/2.

resolve(all, device_ids, opts)

Resolve a device snapshot into the exact targets for one task run.

select(all, device_ids, opts)

Select devices from an already-discovered snapshot.

Types

selection_error()

@type selection_error() ::
  :no_devices
  | :ambiguous_devices
  | :no_matching_devices
  | :no_dev_devices
  | :no_physical_devices

Functions

filter_by_id(devices, ids)

@spec filter_by_id([MobDev.Device.t()], [String.t()]) :: [MobDev.Device.t()]

Filter devices by the identifiers accepted by MobDev.Device.match_id?/2.

resolve(all, device_ids, opts)

@spec resolve([MobDev.Device.t()], [String.t()], keyword()) ::
  {:ok, [MobDev.Device.t()]} | {:error, selection_error(), map()}

Resolve a device snapshot into the exact targets for one task run.

select(all, device_ids, opts)

@spec select([MobDev.Device.t()], [String.t()], keyword()) :: [MobDev.Device.t()]

Select devices from an already-discovered snapshot.

Precedence is named devices, both broad flags, development devices, physical devices, then safe single-development-device auto-selection.