Files
sanderling/internal/driver/mock/mock.go
T
pj 7493945251 feat: LTL operators, sampling, and default generators (#17)
* feat(ltl): add Now/Next/Eventually/Implies/Or/And/Not formulas

Replace the fold-with-latch evaluator with a residual-formula reducer.
Each Observe() instantiates a fresh obligation from the root (stripping
an outer Always), reduces each pending obligation against current state,
latches Violated on first failure, and surfaces Pending verdicts for
deferred obligations. Existing Always/Pure/Thunk tests continue to pass.

* feat(ltl): support relative duration for eventually().within()

* feat(proto): add Swipe, PressKey, RecentLogs RPCs

* feat(verifier,runner): formula handles, new action kinds, rich state

- verifier: add formula-spec registry; bindNow/bindNext/bindEventually with
  chainable .implies/.or/.and/.not and .within(n,unit) on eventually; bindFrom
  for uniform sampling. bindAlways keeps accepting plain predicates.
- verifier: store lastTree, lastAction, step time, logs, exceptions on the
  Verifier; SnapshotInput replaces the (snapshots, tree) pair. stateObject now
  produces state.lastAction/time/logs/exceptions matching the TS State type.
- verifier: make taps/swipes/waitOnce/pressKey built-in generators actually
  fire; taps picks a clickable, enabled element from the last hierarchy.
- agent: add exceptions field to Message wire format.
- driver: add Swipe/PressKey/RecentLogs to Driver interface; wire maestro
  client and mock driver. LogEntry exposed for runner consumption.
- runner: apply Swipe/PressKey/Wait actions; collect logcat and exceptions;
  pass lastAction and step time into PushSnapshot.

* feat(spec-api): LTL operators, new actions, richer State

- ltl.ts exports now/next/eventually; always overload accepts a Formula
- types.ts: Formula gains implies/or/and/not; EventuallyFormula adds .within;
  State gains lastAction/time/logs/exceptions; Swipe/PressKey/Wait action types
- actions.ts: Swipe/PressKey/Wait/from constructors; waitOnce + pressKey
  default generators
- tests exercise the chaining, sampling, and new actions through a recorded
  fake runtime

* feat(sidecar): add swipe, pressKey, recentLogs RPC handlers

* feat(sdk-android): capture uncaught exceptions

Install a default uncaught handler on Uatu.start, chained with any
existing handler so Android's crash reporter still runs. Expose
Uatu.reportError for callers to forward caught throwables. A bounded
circular buffer (default 50) drains into each STATE message's new
exceptions field. Protocol.kt serializes/deserializes the field,
matching the Go wire format added to internal/agent/protocol.go.

* feat(spec-api): add @uatu/spec/defaults/properties bundle

* feat(sample-app): exercise new LTL operators + defaults

spec.ts now imports eventually/next/now/from from @uatu/spec and
noUncaughtExceptions from @uatu/spec/defaults/properties. It declares
three properties that exercise the new surface:

- accountCountNonNegative: plain always() safety
- addAccountAdvances: always(now(x).implies(next(y)))
- eventuallyLoggedIn: eventually(p).within(30, "seconds")
- noUncaughtExceptions: imported default

The weighted actions root uses from() for random phone/name sampling
and entries for taps/swipes/waitOnce/pressKey built-ins.

SampleApplication gains a debug hook gated on the system property
uatu.inject_error so the e2e run can synthesize an Uatu.reportError and
verify noUncaughtExceptions violates.

cmd/uatu/test_run.go adds a subpath alias so specs importing
"@uatu/spec/defaults/properties" resolve against the in-tree source
when running from the uatu checkout. The spec-integration tests swap
the old click-counter fixtures for the new login hierarchy.

* feat(trace): record swipe/key/wait details + exceptions

trace.Step gains an Exceptions array so the trace captures the
class/message/stackTrace for each SDK-reported throwable in a step.
trace.Action gains FromX/FromY/ToX/ToY/Key/DurationMillis so the full
payload of Swipe/PressKey/Wait actions is visible in trace.jsonl.

sample-app's debug error hook now gates on ApplicationInfo.DEBUGGABLE
instead of a system property (adb setprop fails on non-rooted
emulators).
2026-04-20 02:19:39 +07:00

212 lines
5.2 KiB
Go

package mock
import (
"context"
"sync"
"time"
"github.com/priyanshujain/uatu/internal/driver"
)
type ActionKind string
const (
ActionLaunch ActionKind = "launch"
ActionTerminate ActionKind = "terminate"
ActionTap ActionKind = "tap"
ActionTapSelector ActionKind = "tap_selector"
ActionInputText ActionKind = "input_text"
ActionSwipe ActionKind = "swipe"
ActionPressKey ActionKind = "press_key"
ActionHierarchy ActionKind = "hierarchy"
ActionScreenshot ActionKind = "screenshot"
ActionRecentLogs ActionKind = "recent_logs"
ActionWaitForIdle ActionKind = "wait_for_idle"
ActionHealth ActionKind = "health"
)
type Action struct {
Kind ActionKind
BundleID string
LauncherActivity string
ClearState bool
X, Y int
FromX, FromY int
ToX, ToY int
Duration time.Duration
Selector string
Text string
Key string
LogLevel string
LogSince time.Time
Idle time.Duration
}
// Driver is an in-memory Driver implementation for unit tests.
// Tests can program HierarchyJSON, ImageData, HealthInfo, and per-method
// Failures, and read back Actions to assert what the runner asked for.
type Driver struct {
mutex sync.Mutex
actions []Action
HierarchyJSON string
ImageData driver.Image
HealthInfo driver.Health
LogEntries []driver.LogEntry
Failures map[ActionKind]error
}
func New() *Driver {
return &Driver{
Failures: map[ActionKind]error{},
HealthInfo: driver.Health{
Ready: true,
Version: "mock",
Platform: "android",
},
HierarchyJSON: `{"children":[]}`,
ImageData: driver.Image{PNG: []byte{}, Width: 0, Height: 0},
}
}
func (d *Driver) Actions() []Action {
d.mutex.Lock()
defer d.mutex.Unlock()
return append([]Action(nil), d.actions...)
}
func (d *Driver) record(action Action) {
d.mutex.Lock()
defer d.mutex.Unlock()
d.actions = append(d.actions, action)
}
func (d *Driver) failure(kind ActionKind) error {
d.mutex.Lock()
defer d.mutex.Unlock()
return d.Failures[kind]
}
func (d *Driver) Launch(ctx context.Context, bundleID, launcherActivity string, clearState bool) error {
if err := d.failure(ActionLaunch); err != nil {
return err
}
d.record(Action{Kind: ActionLaunch, BundleID: bundleID, LauncherActivity: launcherActivity, ClearState: clearState})
return nil
}
func (d *Driver) Terminate(ctx context.Context) error {
if err := d.failure(ActionTerminate); err != nil {
return err
}
d.record(Action{Kind: ActionTerminate})
return nil
}
func (d *Driver) Tap(ctx context.Context, x, y int) error {
if err := d.failure(ActionTap); err != nil {
return err
}
d.record(Action{Kind: ActionTap, X: x, Y: y})
return nil
}
func (d *Driver) TapSelector(ctx context.Context, selector string) error {
if err := d.failure(ActionTapSelector); err != nil {
return err
}
d.record(Action{Kind: ActionTapSelector, Selector: selector})
return nil
}
func (d *Driver) InputText(ctx context.Context, text string) error {
if err := d.failure(ActionInputText); err != nil {
return err
}
d.record(Action{Kind: ActionInputText, Text: text})
return nil
}
func (d *Driver) Swipe(ctx context.Context, fromX, fromY, toX, toY int, duration time.Duration) error {
if err := d.failure(ActionSwipe); err != nil {
return err
}
d.record(Action{
Kind: ActionSwipe,
FromX: fromX,
FromY: fromY,
ToX: toX,
ToY: toY,
Duration: duration,
})
return nil
}
func (d *Driver) PressKey(ctx context.Context, key string) error {
if err := d.failure(ActionPressKey); err != nil {
return err
}
d.record(Action{Kind: ActionPressKey, Key: key})
return nil
}
func (d *Driver) RecentLogs(ctx context.Context, since time.Time, minLevel string) ([]driver.LogEntry, error) {
if err := d.failure(ActionRecentLogs); err != nil {
return nil, err
}
d.record(Action{Kind: ActionRecentLogs, LogSince: since, LogLevel: minLevel})
d.mutex.Lock()
defer d.mutex.Unlock()
return append([]driver.LogEntry(nil), d.LogEntries...), nil
}
func (d *Driver) Hierarchy(ctx context.Context) (string, error) {
if err := d.failure(ActionHierarchy); err != nil {
return "", err
}
d.record(Action{Kind: ActionHierarchy})
d.mutex.Lock()
defer d.mutex.Unlock()
return d.HierarchyJSON, nil
}
func (d *Driver) Screenshot(ctx context.Context) (driver.Image, error) {
if err := d.failure(ActionScreenshot); err != nil {
return driver.Image{}, err
}
d.record(Action{Kind: ActionScreenshot})
d.mutex.Lock()
defer d.mutex.Unlock()
return d.ImageData, nil
}
func (d *Driver) WaitForIdle(ctx context.Context, duration time.Duration) error {
if err := d.failure(ActionWaitForIdle); err != nil {
return err
}
d.record(Action{Kind: ActionWaitForIdle, Idle: duration})
if duration <= 0 {
return nil
}
timer := time.NewTimer(duration)
defer timer.Stop()
select {
case <-ctx.Done():
return ctx.Err()
case <-timer.C:
return nil
}
}
func (d *Driver) Health(ctx context.Context) (driver.Health, error) {
if err := d.failure(ActionHealth); err != nil {
return driver.Health{}, err
}
d.record(Action{Kind: ActionHealth})
d.mutex.Lock()
defer d.mutex.Unlock()
return d.HealthInfo, nil
}
var _ driver.Driver = (*Driver)(nil)