mirror of
https://github.com/priyanshujain/sanderling.git
synced 2026-10-02 11:07:10 +00:00
* refactor: rename Go module path uatu -> sanderling
Module path github.com/priyanshujain/uatu -> github.com/priyanshujain/sanderling,
including all imports and the proto go_package option. Generated .pb.go files
rewritten in-place; safe to regenerate with protoc later.
* chore(proto): regenerate driverpb after module path rename
The previous sed-based module rename corrupted the embedded descriptor
byte lengths. buf generate rewrites them cleanly.
* refactor: rename CLI binary uatu -> sanderling
Updates Makefile target + UATU_BIN var, .goreleaser project/build IDs,
.gitignore comment, and all user-facing strings in the CLI help text,
error messages, and tests. Binary is now bin/sanderling.
* refactor(sdk): rename Kotlin package dev.uatu.sdk -> dev.sanderling.sdk
Moves sdk/android/src/{main,test}/kotlin/dev/uatu -> dev/sanderling and
rewrites package declarations, imports, and the Gradle namespace. Class
names (Uatu, UatuRuntime) are renamed in a follow-up commit.
* refactor(sidecar): rename Kotlin package dev.uatu.sidecar -> dev.sanderling.sidecar
Moves sidecar/src/{main,test}/kotlin/dev/uatu -> dev/sanderling and
rewrites package declarations, imports, and the application mainClass.
* refactor: rename Uatu API surface -> Sanderling
- Kotlin: Uatu -> Sanderling, UatuRuntime -> SanderlingRuntime (+ files).
- JS host binding: globalThis.__uatu__ -> __sanderling__ (Go verifier,
spec-api, tests).
- TS interface: UatuRuntime -> SanderlingRuntime; internal tags
__uatuFormula / __uatuActionGenerator -> __sanderling* variants.
- Go trace: UatuVersion field + uatu_version JSON tag renamed.
- Socket naming: uatu-agent / uatu-agent-reader -> sanderling-agent*.
- Sample app, docs, inline-JS test strings updated to match.
* refactor(examples): rename examples/folio/uatu -> examples/folio/sanderling
Renames the example spec directory; updates justfile paths + gitignore
entries accordingly. Package.json name/description and @uatu/spec
dependency are renamed in the npm + docs commits.
* chore(build): rename gradle property + rootProject.name uatu -> sanderling
- Renames the uatu.version gradle property and all its -P references in
Makefile, build.gradle.kts files, and .github/workflows/release.yml.
- settings.gradle.kts rootProject.name = "sanderling".
- Renames .env.local.example header + release-cli workflow job name.
* refactor(proto): rename proto package uatu.driver.v1 -> sanderling.driver.v1
Updates the proto package and java_package, regenerates driver.pb.go +
driver_grpc.pb.go, rewrites Kotlin imports and the gRPC ServiceName
assertion in driver_test.go.
* refactor: rename npm package @uatu/spec -> @sanderling/spec
Renames package name in pkg/spec-api/package.json + lockfile, all
consumer imports (examples/folio spec, testdata, verifier tests), the
esbuild alias in cmd/sanderling/test_run.go, and related doc references.
* docs: rename uatu -> sanderling in README, docs, and URLs
- README + docs/{manual,development}/*: narrative + GitHub + Pages URLs.
- POM + npm package.json repo/homepage/bugs URLs.
- .gitignore + embed_stub + Makefile-comment references updated to
'make sanderling'.
- Minor narrative comments in cmd/sanderling/test_run.go and
internal/inspect/server.go.
* refactor: rename remaining internal uatu strings -> sanderling
- SANDERLING_TEST_PHONE/OTP env vars (cmd + bundler tests).
- sanderling-sidecar runtime tmp dir + extracted JAR filename.
- Inspect web UI: @sanderling/inspect-web package, title, theme
localStorage key, RunList empty-state copy, uatu_version TS field.
- Sample app storage key sanderling.ledger.v1.
- Test data: sanderling_test AVD name + com.example.sanderling_test.
- Release docs tarball name template.
224 lines
5.5 KiB
Go
224 lines
5.5 KiB
Go
package mock
|
|
|
|
import (
|
|
"context"
|
|
"sync"
|
|
"time"
|
|
|
|
"github.com/priyanshujain/sanderling/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"
|
|
ActionMetrics ActionKind = "metrics"
|
|
)
|
|
|
|
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
|
|
MetricsData driver.Metrics
|
|
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
|
|
}
|
|
|
|
func (d *Driver) Metrics(ctx context.Context, bundleID string) (driver.Metrics, error) {
|
|
if err := d.failure(ActionMetrics); err != nil {
|
|
return driver.Metrics{}, err
|
|
}
|
|
d.record(Action{Kind: ActionMetrics, BundleID: bundleID})
|
|
d.mutex.Lock()
|
|
defer d.mutex.Unlock()
|
|
return d.MetricsData, nil
|
|
}
|
|
|
|
var _ driver.Driver = (*Driver)(nil)
|