xcmonkey 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a6aa190c1c4cfa28f97b20524c907da488aad2d78f2c1dda8f827899f6ee53f
-  data.tar.gz: 534245a695ed0f030df459986c326fb356b3593baec3bc6750eb1cc622d32390
+  metadata.gz: be6683e9fefe9666fb294e9939f5ebd83c71915307002dc6425413dfd1d9ae8b
+  data.tar.gz: d4782c2269b36dd950b7567c88d554c7b000cc81452f79e6659d4061135c1ebe
 SHA512:
-  metadata.gz: 41415c8c576a3b6887ee87d44f4c4e571f1e7abda3a96f23abff52cebe77438be70ee76ab18f83a92b78cca2da429cf0c12305b2d3a8ca59b0b2e7e26405ec23
-  data.tar.gz: 93d86451b2b7b8d2a755744ea47be375d042763ea550ddbdef5faff530bbf775e46ab24ede0f6d9dfe424f02ef4c2a923ccd3f342d1872cd6f4d82dcefae7cef
+  metadata.gz: d027d46289c6ea5bfba7359ff5c0b8172ea7d12d5d9cd1019a428b7b74416e6562930db5ce14508198937caed55ac2b5f1c68f1ce34c82fbe6ecbf3a92ea7100
+  data.tar.gz: 6d336b581f1bb93db017414b7080e038557200909e8a87b3a23c37fce4dfdd62b9fc5186c45272e662002f073c00a800f172488495b9bf84cd91d0a9089e275c

data/.github/FUNDING.yml

@@ -1,3 +1,2 @@
 custom: [ 'https://revolut.me/alteral', 'https://paypal.me/aapesotskiy' ]
-github: alteral
 ko_fi: alteral

data/.github/workflows/test.yml

@@ -13,7 +13,7 @@ jobs:
   chat:
     name: Automated Code Review
     runs-on: macos-12
-    timeout-minutes: 15
+    timeout-minutes: 30
     env:
       GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}

data/README.md

@@ -9,8 +9,14 @@
   <a href="/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg?style=flat" /></a>
 </p>
 
+## Description
+
 *xcmonkey* is a tool for doing randomised UI testing of iOS apps.
 
+It is inspired by and has similar goals to Android [monkey](https://developer.android.com/studio/test/monkey).
+
+*xcmonkey* uses [idb](https://fbidb.io) as a driver that's why it's quite smart and can do a lot of things, such as taps, swipes and presses. Because *xcmonkey* has access to the screen hierarchy, it can either do things blindly (like tapping on random points) or precisely (like tapping on the existing elements).
+
 ## Requirements
 
 ```bash
@@ -24,22 +30,28 @@ pip3.6 install fb-idb
 gem install xcmonkey
 ```
 
+If you prefer to use [bundler](https://bundler.io/), add the following line to your `Gemfile`:
+
+```ruby
+gem 'xcmonkey'
+```
+
 ## Usage
 
-### Test
+### To run a stress test
 
 ```bash
-$ xcmonkey test --udid "413EA256-CFFB-4312-94A6-12592BEE4CBA" --bundle-id "com.apple.mobilesafari"
+$ xcmonkey test --udid "413EA256-CFFB-4312-94A6-12592BEE4CBA" --bundle-id "com.apple.Maps" --duration 100
 12:44:19.343: Device info: iPhone 14 Pro | 413EA256-CFFB-4312-94A6-12592BEE4CBA | Booted | simulator | iOS 16.2 | x86_64 | /tmp/idb/413EA256-CFFB-4312-94A6-12592BEE4CBA_companion.sock
 
-12:44:22.550: App info: com.apple.mobilesafari | MobileSafari | system | x86_64, arm64 | Running | Not Debuggable | pid=43398
+12:44:22.550: App info: com.apple.Maps | Maps | system | arm64, x86_64 | Running | Not Debuggable | pid=74636
 
 12:44:23.203: Tap: {
   "x": 53,
   "y": 749
 }
 
-12:44:23.511: Swipe: {
+12:44:23.511: Swipe (0.5s): {
   "x": 196,
   "y": 426
 } => {
@@ -47,39 +59,37 @@ $ xcmonkey test --udid "413EA256-CFFB-4312-94A6-12592BEE4CBA" --bundle-id "com.a
   "y": 447
 }
 
-12:44:24.355: Tap: {
+12:44:24.355: Press (1.2s): {
   "x": 143,
   "y": 323
 }
 ```
 
-### Describe point
+### To describe the required point
 
 ```bash
-$ xcmonkey describe -x 125 -y 760 --udid "413EA256-CFFB-4312-94A6-12592BEE4CBA"
-12:41:03.840: Device info: iPhone 14 Pro | 413EA256-CFFB-4312-94A6-12592BEE4CBA | Booted | simulator | iOS 16.2 | x86_64 | /tmp/idb/413EA256-CFFB-4312-94A6-12592BEE4CBA_companion.sock
+$ xcmonkey describe -x 20 -y 625 --udid "413EA256-CFFB-4312-94A6-12592BEE4CBA"
+20:05:20.212: Device info: iPhone 14 Pro | 413EA256-CFFB-4312-94A6-12592BEE4CBA | Booted | simulator | iOS 16.2 | x86_64 | /tmp/idb/413EA256-CFFB-4312-94A6-12592BEE4CBA_companion.sock
 
-12:41:05.342: x:125 y:760 point info: {
-  "AXFrame": "{{120, 759}, {64, 64}}",
-  "AXUniqueId": "Safari",
+20:05:21.713: x:20 y:625 point info: {
+  "AXFrame": "{{19, 624.33333333333337}, {86, 130.66666666666663}}",
+  "AXUniqueId": "ShortcutsRowCell",
   "frame": {
-    "y": 759,
-    "x": 120,
-    "width": 64,
-    "height": 64
+    "y": 624.3333333333334,
+    "x": 19,
+    "width": 86,
+    "height": 130.66666666666663
   },
   "role_description": "button",
-  "AXLabel": "Safari",
+  "AXLabel": "Home",
   "content_required": false,
   "type": "Button",
   "title": null,
-  "help": "Double tap to open",
+  "help": null,
   "custom_actions": [
-    "Edit mode",
-    "Today",
-    "App Library"
+
   ],
-  "AXValue": "",
+  "AXValue": "Add",
   "enabled": true,
   "role": "AXButton",
   "subrole": null

data/lib/xcmonkey/driver.rb

@@ -18,11 +18,23 @@ class Driver
       when :precise_tap
         tap(coordinates: el1_coordinates)
       when :blind_tap
-        x = (el1_coordinates[:x] - el2_coordinates[:x]).abs
-        y = (el1_coordinates[:y] - el2_coordinates[:y]).abs
-        tap(coordinates: { x: x, y: y })
-      when :swipe
-        swipe(start_coordinates: el1_coordinates, end_coordinates: el2_coordinates)
+        tap(coordinates: random_coordinates)
+      when :precise_press
+        press(coordinates: el1_coordinates, duration: press_duration)
+      when :blind_press
+        press(coordinates: random_coordinates, duration: press_duration)
+      when :precise_swipe
+        swipe(
+          start_coordinates: el1_coordinates,
+          end_coordinates: el2_coordinates,
+          duration: swipe_duration
+        )
+      when :blind_swipe
+        swipe(
+          start_coordinates: random_coordinates,
+          end_coordinates: random_coordinates,
+          duration: swipe_duration
+        )
       else
         next
       end
@@ -31,9 +43,9 @@ class Driver
     end
   end
 
-  def open_home_screen(return_tracker: false)
+  def open_home_screen(with_tracker: false)
     `idb ui button --udid #{udid} HOME`
-    detect_home_unique_element if return_tracker
+    detect_home_unique_element if with_tracker
   end
 
   def describe_ui
@@ -57,7 +69,7 @@ class Driver
 
   def boot_simulator
     `idb boot #{udid}`
-    ensure_simulator_was_booted
+    Logger.error("Failed to boot #{udid}") if device_info['state'] != 'Booted'
   end
 
   def shutdown_simulator
@@ -84,11 +96,6 @@ class Driver
     boot_simulator if device.include?('simulator')
   end
 
-  def ensure_simulator_was_booted
-    sim = list_booted_simulators.detect { |target| target.include?(udid) }
-    Logger.error("Failed to boot #{udid}") if sim.nil?
-  end
-
   def list_apps
     `idb list-apps --udid #{udid}`
   end
@@ -98,20 +105,58 @@ class Driver
     `idb ui tap --udid #{udid} #{coordinates[:x]} #{coordinates[:y]}`
   end
 
-  def swipe(start_coordinates:, end_coordinates:)
-    Logger.info('Swipe:', payload: "#{JSON.pretty_generate(start_coordinates)} => #{JSON.pretty_generate(end_coordinates)}")
+  def press(coordinates:, duration:)
+    Logger.info("Press (#{duration}s):", payload: JSON.pretty_generate(coordinates))
+    `idb ui tap --udid #{udid} --duration #{duration} #{coordinates[:x]} #{coordinates[:y]}`
+  end
+
+  def swipe(start_coordinates:, end_coordinates:, duration:)
+    Logger.info(
+      "Swipe (#{duration}s):",
+      payload: "#{JSON.pretty_generate(start_coordinates)} => #{JSON.pretty_generate(end_coordinates)}"
+    )
     coordinates = "#{start_coordinates[:x]} #{start_coordinates[:y]} #{end_coordinates[:x]} #{end_coordinates[:y]}"
-    `idb ui swipe --udid #{udid} --duration 0.5 #{coordinates}`
+    `idb ui swipe --udid #{udid} --duration #{duration} #{coordinates}`
   end
 
   def central_coordinates(element)
     frame = element['frame']
+    x = (frame['x'] + (frame['width'] / 2)).abs.to_i
+    y = (frame['y'] + (frame['height'] / 2)).abs.to_i
+    {
+      x: x > screen_size[:width].to_i ? rand(0..screen_size[:width].to_i) : x,
+      y: y > screen_size[:height].to_i ? rand(0..screen_size[:height].to_i) : y
+    }
+  end
+
+  def random_coordinates
+    {
+      x: rand(0..screen_size[:width].to_i),
+      y: rand(0..screen_size[:height].to_i)
+    }
+  end
+
+  def device_info
+    @device_info ||= JSON.parse(`idb describe --udid #{udid} --json`)
+    @device_info
+  end
+
+  def screen_size
+    screen_dimensions = device_info['screen_dimensions']
     {
-      x: (frame['x'] + (frame['width'] / 2)).to_i,
-      y: (frame['y'] + (frame['height'] / 2)).to_i
+      width: screen_dimensions['width_points'],
+      height: screen_dimensions['height_points']
     }
   end
 
+  def swipe_duration
+    rand(0.1..0.7).ceil(1)
+  end
+
+  def press_duration
+    rand(0.5..1.5).ceil(1)
+  end
+
   private
 
   def ensure_driver_installed

data/lib/xcmonkey/version.rb

@@ -1,4 +1,4 @@
 module Xcmonkey
-  VERSION = '0.1.2'
+  VERSION = '0.2.0'
   GEM_NAME = 'xcmonkey'
 end

data/lib/xcmonkey.rb

@@ -21,13 +21,16 @@ module Xcmonkey
 			driver.ensure_device_exists
 			driver.ensure_app_installed
 			driver.terminate_app
-			driver.open_home_screen(return_tracker: true)
+			driver.open_home_screen(with_tracker: true)
 			driver.launch_app
 			driver.monkey_test(gestures)
     end
 
 		def gestures
-			[:precise_tap, :blind_tap, :swipe]
+			taps = [:precise_tap, :blind_tap] * 10
+			swipes = [:precise_swipe, :blind_swipe] * 5
+			presses = [:precise_press, :blind_press]
+			taps + swipes + presses
 		end
 
 		def ensure_required_params(params)

data/spec/driver_spec.rb

@@ -6,8 +6,7 @@ describe Driver do
   it 'verifies that sumulator was booted' do
     error_message = "Failed to boot #{udid}"
     expect(Logger).not_to receive(:error).with(error_message, payload: nil)
-    expect(driver).to receive(:ensure_simulator_was_booted)
-    driver.boot_simulator
+    expect { driver.boot_simulator }.not_to raise_error
   end
 
   it 'verifies that there are booted simulators' do
@@ -24,10 +23,16 @@ describe Driver do
 
   it 'verifies that home screen can be opened' do
     driver.boot_simulator
-    home_tracker = driver.open_home_screen(return_tracker: true)
+    home_tracker = driver.open_home_screen(with_tracker: true)
     expect(home_tracker).not_to be_empty
   end
 
+  it 'verifies that home screen can be opened without tracker' do
+    driver.boot_simulator
+    home_tracker = driver.open_home_screen(with_tracker: false)
+    expect(home_tracker).to be_nil
+  end
+
   it 'verifies that list of targets can be showed' do
     list_targets = driver.list_targets
     expect(list_targets).not_to be_empty
@@ -85,6 +90,38 @@ describe Driver do
     expect(actual_coordinates).to eq(expected_coordinates)
   end
 
+  it 'verifies that device info can be for booted simulator' do
+    driver.boot_simulator
+    expect(driver.device_info).not_to be_empty
+  end
+
+  it 'verifies that device info can be for not booted simulator' do
+    driver.shutdown_simulator
+    expect(driver.device_info).not_to be_empty
+  end
+
+  it 'verifies that screen size can be found' do
+    driver.boot_simulator
+    screen_size = driver.screen_size
+    expect(screen_size[:width]).to be > 0
+    expect(screen_size[:height]).to be > 0
+  end
+
+  it 'verifies that random coordinates can be found' do
+    driver.boot_simulator
+    coordinates = driver.random_coordinates
+    expect(coordinates[:x]).to be > 0
+    expect(coordinates[:y]).to be > 0
+  end
+
+  it 'verifies swipe duration' do
+    expect(driver.swipe_duration).to be_between(0.1, 0.7)
+  end
+
+  it 'verifies press duration' do
+    expect(driver.press_duration).to be_between(0.5, 1.5)
+  end
+
   it 'verifies that app can be launched' do
     expect(Logger).not_to receive(:error)
     expect(Logger).to receive(:info)
@@ -93,10 +130,35 @@ describe Driver do
     expect { driver.launch_app }.not_to raise_error
   end
 
+  it 'verifies tap' do
+    driver.boot_simulator
+    coordinates = { x: 1, y: 1 }
+    expect(Logger).to receive(:info).with('Tap:', payload: JSON.pretty_generate(coordinates))
+    driver.tap(coordinates: coordinates)
+  end
+
+  it 'verifies press' do
+    driver.boot_simulator
+    duration = 0.5
+    coordinates = { x: 1, y: 1 }
+    expect(Logger).to receive(:info).with("Press (#{duration}s):", payload: JSON.pretty_generate(coordinates))
+    driver.press(coordinates: coordinates, duration: duration)
+  end
+
+  it 'verifies swipe' do
+    driver.boot_simulator
+    duration = 0.5
+    start_coordinates = { x: 1, y: 1 }
+    end_coordinates = { x: 2, y: 2 }
+    expect(Logger).to receive(:info).with("Swipe (#{duration}s):", payload: "#{JSON.pretty_generate(start_coordinates)} => #{JSON.pretty_generate(end_coordinates)}")
+    driver.swipe(start_coordinates: start_coordinates, end_coordinates: end_coordinates, duration: duration)
+  end
+
   it 'verifies that simulator was not booted' do
     driver.shutdown_simulator
     error_message = "Failed to boot #{udid}"
+    allow(driver).to receive(:device_info).and_return({ 'state' => 'Unknown' })
     expect(Logger).to receive(:log).with(error_message, color: :light_red, payload: nil)
-    expect { driver.ensure_simulator_was_booted }.to raise_error(SystemExit) { |e| expect(e.status).to eq(1) }
+    expect { driver.boot_simulator }.to raise_error(SystemExit) { |e| expect(e.status).to eq(1) }
   end
 end

data/spec/logger_spec.rb

@@ -33,4 +33,24 @@ describe Logger do
     expect { described_class.error(message, payload: payload) }
       .to raise_error(SystemExit) { |e| expect(e.status).to eq(1) }
   end
+
+  it 'verifies custom log without payload' do
+    color = :blue
+    time = Time.now
+    allow(Time).to receive(:now).and_return(time)
+    expected_output = "#{time.strftime('%k:%M:%S.%L')}: #{message}".colorize(color)
+    expect do
+      described_class.log(message, color: color, payload: nil)
+    end.to output("#{expected_output}\n\n").to_stdout
+  end
+
+  it 'verifies custom log with payload' do
+    color = :blue
+    time = Time.now
+    allow(Time).to receive(:now).and_return(time)
+    expected_output = "#{time.strftime('%k:%M:%S.%L')}: #{message}".colorize(color)
+    expect do
+      described_class.log(message, color: color, payload: payload)
+    end.to output("#{expected_output} #{payload.colorize(:light_green)}\n\n").to_stdout
+  end
 end

data/spec/xcmonkey_spec.rb

@@ -5,7 +5,10 @@ describe Xcmonkey do
 
     it 'verifies gestures' do
       gestures = described_class.new(params).gestures
-      expect(gestures) =~ [:swipe, :precise_tap, :blind_tap]
+      taps = [:precise_tap, :blind_tap] * 10
+      swipes = [:precise_swipe, :blind_swipe] * 5
+      presses = [:precise_press, :blind_press]
+      expect(gestures) =~ presses + taps + swipes
     end
 
     it 'verifies required params' do
@@ -42,5 +45,14 @@ describe Xcmonkey do
       expect(Logger).to receive(:error).with(duration_error_msg)
       described_class.new(params)
     end
+
+    it 'verifies version' do
+      current_version = Gem::Version.new(Xcmonkey::VERSION)
+      expect(current_version).to be > Gem::Version.new('0.1.0')
+    end
+
+    it 'verifies gem name' do
+      expect(Xcmonkey::GEM_NAME).to eq('xcmonkey')
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: xcmonkey
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - alteral
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-12-28 00:00:00.000000000 Z
+date: 2022-12-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler