Skip to content

Commit 2b952d4

Browse files
committed
Initial commit: maestro-ios-device CLI tool
- CLI tool to run Maestro tests on real iOS devices - Patches Maestro 2.0.9/2.0.10 with physical device support - Builds and runs XCTest driver on device - Port forwarding via go-ios library - GitHub Actions workflow for releases - Includes patched JARs and iOS XCTest runner source
0 parents  commit 2b952d4

File tree

220 files changed

+9358
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

220 files changed

+9358
-0
lines changed

.github/workflows/release.yml

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
name: Release
2+
3+
on:
4+
push:
5+
tags:
6+
- 'v*'
7+
8+
jobs:
9+
release:
10+
runs-on: macos-latest
11+
steps:
12+
- uses: actions/checkout@v4
13+
14+
- uses: actions/setup-go@v5
15+
with:
16+
go-version: '1.23'
17+
18+
- name: Build binaries
19+
run: make build-all
20+
21+
- name: Create JARs zip
22+
run: |
23+
cd assets/jars/2.0.10
24+
zip -r ../../../maestro-jars.zip .
25+
26+
- name: Create runner zip
27+
run: |
28+
cd assets/maestro-ios-xctest-runner
29+
zip -r ../../maestro-ios-runner.zip .
30+
31+
- name: Create release
32+
uses: softprops/action-gh-release@v1
33+
with:
34+
files: |
35+
dist/maestro-ios-device-darwin-amd64
36+
dist/maestro-ios-device-darwin-arm64
37+
maestro-jars.zip
38+
maestro-ios-runner.zip
39+
env:
40+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# Binaries
2+
maestro-ios-device
3+
bin/
4+
dist/
5+
6+
# IDE/Editor
7+
.idea/
8+
.vscode/
9+
*.swp
10+
*.swo
11+
12+
# Claude
13+
.claude/
14+
15+
# macOS
16+
.DS_Store
17+
18+
# Test output
19+
coverage.out
20+
21+
# Temp files
22+
*.tmp
23+
*.log
24+
25+
# Plan file (internal)
26+
PLAN.md

.golangci.yml

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
run:
2+
timeout: 5m
3+
4+
linters:
5+
enable:
6+
- errcheck
7+
- gosimple
8+
- govet
9+
- ineffassign
10+
- staticcheck
11+
- unused
12+
- gosec
13+
- goconst
14+
- gocyclo
15+
16+
linters-settings:
17+
gocyclo:
18+
min-complexity: 15
19+
goconst:
20+
min-len: 3
21+
min-occurrences: 3
22+
gosec:
23+
excludes:
24+
- G204 # subprocess launched with variable - expected for xcodebuild
25+
26+
issues:
27+
exclude-rules:
28+
- path: _test\.go
29+
linters:
30+
- errcheck
31+
- gosec

LICENSE

Lines changed: 191 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,191 @@
1+
Apache License
2+
Version 2.0, January 2004
3+
http://www.apache.org/licenses/
4+
5+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6+
7+
1. Definitions.
8+
9+
"License" shall mean the terms and conditions for use, reproduction,
10+
and distribution as defined by Sections 1 through 9 of this document.
11+
12+
"Licensor" shall mean the copyright owner or entity authorized by
13+
the copyright owner that is granting the License.
14+
15+
"Legal Entity" shall mean the union of the acting entity and all
16+
other entities that control, are controlled by, or are under common
17+
control with that entity. For the purposes of this definition,
18+
"control" means (i) the power, direct or indirect, to cause the
19+
direction or management of such entity, whether by contract or
20+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
21+
outstanding shares, or (iii) beneficial ownership of such entity.
22+
23+
"You" (or "Your") shall mean an individual or Legal Entity
24+
exercising permissions granted by this License.
25+
26+
"Source" form shall mean the preferred form for making modifications,
27+
including but not limited to software source code, documentation
28+
source, and configuration files.
29+
30+
"Object" form shall mean any form resulting from mechanical
31+
transformation or translation of a Source form, including but
32+
not limited to compiled object code, generated documentation,
33+
and conversions to other media types.
34+
35+
"Work" shall mean the work of authorship, whether in Source or
36+
Object form, made available under the License, as indicated by a
37+
copyright notice that is included in or attached to the work
38+
(an example is provided in the Appendix below).
39+
40+
"Derivative Works" shall mean any work, whether in Source or Object
41+
form, that is based on (or derived from) the Work and for which the
42+
editorial revisions, annotations, elaborations, or other modifications
43+
represent, as a whole, an original work of authorship. For the purposes
44+
of this License, Derivative Works shall not include works that remain
45+
separable from, or merely link (or bind by name) to the interfaces of,
46+
the Work and Derivative Works thereof.
47+
48+
"Contribution" shall mean any work of authorship, including
49+
the original version of the Work and any modifications or additions
50+
to that Work or Derivative Works thereof, that is intentionally
51+
submitted to the Licensor for inclusion in the Work by the copyright
52+
owner or by an individual or Legal Entity authorized to submit on
53+
behalf of the copyright owner. For the purposes of this definition,
54+
"submitted" means any form of electronic, verbal, or written
55+
communication sent to the Licensor or its representatives, including
56+
but not limited to communication on electronic mailing lists, source
57+
code control systems, and issue tracking systems that are managed by,
58+
or on behalf of, the Licensor for the purpose of discussing and
59+
improving the Work, but excluding communication that is conspicuously
60+
marked or otherwise designated in writing by the copyright owner as
61+
"Not a Contribution."
62+
63+
"Contributor" shall mean Licensor and any individual or Legal Entity
64+
on behalf of whom a Contribution has been received by Licensor and
65+
subsequently incorporated within the Work.
66+
67+
2. Grant of Copyright License. Subject to the terms and conditions of
68+
this License, each Contributor hereby grants to You a perpetual,
69+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
70+
copyright license to reproduce, prepare Derivative Works of,
71+
publicly display, publicly perform, sublicense, and distribute the
72+
Work and such Derivative Works in Source or Object form.
73+
74+
3. Grant of Patent License. Subject to the terms and conditions of
75+
this License, each Contributor hereby grants to You a perpetual,
76+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
77+
(except as stated in this section) patent license to make, have made,
78+
use, offer to sell, sell, import, and otherwise transfer the Work,
79+
where such license applies only to those patent claims licensable
80+
by such Contributor that are necessarily infringed by their
81+
Contribution(s) alone or by combination of their Contribution(s)
82+
with the Work to which such Contribution(s) was submitted. If You
83+
institute patent litigation against any entity (including a
84+
cross-claim or counterclaim in a lawsuit) alleging that the Work
85+
or a Contribution incorporated within the Work constitutes direct
86+
or contributory patent infringement, then any patent licenses
87+
granted to You under this License for that Work shall terminate
88+
as of the date such litigation is filed.
89+
90+
4. Redistribution. You may reproduce and distribute copies of the
91+
Work or Derivative Works thereof in any medium, with or without
92+
modifications, and in Source or Object form, provided that You
93+
meet the following conditions:
94+
95+
(a) You must give any other recipients of the Work or
96+
Derivative Works a copy of this License; and
97+
98+
(b) You must cause any modified files to carry prominent notices
99+
stating that You changed the files; and
100+
101+
(c) You must retain, in the Source form of any Derivative Works
102+
that You distribute, all copyright, patent, trademark, and
103+
attribution notices from the Source form of the Work,
104+
excluding those notices that do not pertain to any part of
105+
the Derivative Works; and
106+
107+
(d) If the Work includes a "NOTICE" text file as part of its
108+
distribution, then any Derivative Works that You distribute must
109+
include a readable copy of the attribution notices contained
110+
within such NOTICE file, excluding those notices that do not
111+
pertain to any part of the Derivative Works, in at least one
112+
of the following places: within a NOTICE text file distributed
113+
as part of the Derivative Works; within the Source form or
114+
documentation, if provided along with the Derivative Works; or,
115+
within a display generated by the Derivative Works, if and
116+
wherever such third-party notices normally appear. The contents
117+
of the NOTICE file are for informational purposes only and
118+
do not modify the License. You may add Your own attribution
119+
notices within Derivative Works that You distribute, alongside
120+
or as an addendum to the NOTICE text from the Work, provided
121+
that such additional attribution notices cannot be construed
122+
as modifying the License.
123+
124+
You may add Your own copyright statement to Your modifications and
125+
may provide additional or different license terms and conditions
126+
for use, reproduction, or distribution of Your modifications, or
127+
for any such Derivative Works as a whole, provided Your use,
128+
reproduction, and distribution of the Work otherwise complies with
129+
the conditions stated in this License.
130+
131+
5. Submission of Contributions. Unless You explicitly state otherwise,
132+
any Contribution intentionally submitted for inclusion in the Work
133+
by You to the Licensor shall be under the terms and conditions of
134+
this License, without any additional terms or conditions.
135+
Notwithstanding the above, nothing herein shall supersede or modify
136+
the terms of any separate license agreement you may have executed
137+
with Licensor regarding such Contributions.
138+
139+
6. Trademarks. This License does not grant permission to use the trade
140+
names, trademarks, service marks, or product names of the Licensor,
141+
except as required for reasonable and customary use in describing the
142+
origin of the Work and reproducing the content of the NOTICE file.
143+
144+
7. Disclaimer of Warranty. Unless required by applicable law or
145+
agreed to in writing, Licensor provides the Work (and each
146+
Contributor provides its Contributions) on an "AS IS" BASIS,
147+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
148+
implied, including, without limitation, any warranties or conditions
149+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
150+
PARTICULAR PURPOSE. You are solely responsible for determining the
151+
appropriateness of using or redistributing the Work and assume any
152+
risks associated with Your exercise of permissions under this License.
153+
154+
8. Limitation of Liability. In no event and under no legal theory,
155+
whether in tort (including negligence), contract, or otherwise,
156+
unless required by applicable law (such as deliberate and grossly
157+
negligent acts) or agreed to in writing, shall any Contributor be
158+
liable to You for damages, including any direct, indirect, special,
159+
incidental, or consequential damages of any character arising as a
160+
result of this License or out of the use or inability to use the
161+
Work (including but not limited to damages for loss of goodwill,
162+
work stoppage, computer failure or malfunction, or any and all
163+
other commercial damages or losses), even if such Contributor
164+
has been advised of the possibility of such damages.
165+
166+
9. Accepting Warranty or Additional Liability. While redistributing
167+
the Work or Derivative Works thereof, You may choose to offer,
168+
and charge a fee for, acceptance of support, warranty, indemnity,
169+
or other liability obligations and/or rights consistent with this
170+
License. However, in accepting such obligations, You may act only
171+
on Your own behalf and on Your sole responsibility, not on behalf
172+
of any other Contributor, and only if You agree to indemnify,
173+
defend, and hold each Contributor harmless for any liability
174+
incurred by, or claims asserted against, such Contributor by reason
175+
of your accepting any such warranty or additional liability.
176+
177+
END OF TERMS AND CONDITIONS
178+
179+
Copyright 2024 DeviceLab
180+
181+
Licensed under the Apache License, Version 2.0 (the "License");
182+
you may not use this file except in compliance with the License.
183+
You may obtain a copy of the License at
184+
185+
http://www.apache.org/licenses/LICENSE-2.0
186+
187+
Unless required by applicable law or agreed to in writing, software
188+
distributed under the License is distributed on an "AS IS" BASIS,
189+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
190+
See the License for the specific language governing permissions and
191+
limitations under the License.

Makefile

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
.PHONY: build build-all clean test
2+
3+
VERSION ?= $(shell git describe --tags --always --dirty 2>/dev/null || echo "dev")
4+
LDFLAGS := -ldflags "-X main.version=$(VERSION)"
5+
6+
# Default target
7+
build:
8+
go build $(LDFLAGS) -o bin/maestro-ios-device ./cmd/maestro-ios-device
9+
10+
# Build for all platforms
11+
build-all: build-darwin-amd64 build-darwin-arm64
12+
13+
build-darwin-amd64:
14+
GOOS=darwin GOARCH=amd64 go build $(LDFLAGS) -o dist/maestro-ios-device-darwin-amd64 ./cmd/maestro-ios-device
15+
16+
build-darwin-arm64:
17+
GOOS=darwin GOARCH=arm64 go build $(LDFLAGS) -o dist/maestro-ios-device-darwin-arm64 ./cmd/maestro-ios-device
18+
19+
# Clean build artifacts
20+
clean:
21+
rm -rf bin/ dist/
22+
23+
# Run tests
24+
test:
25+
go test -v ./...
26+
27+
# Install locally
28+
install: build
29+
cp bin/maestro-ios-device /usr/local/bin/
30+
31+
# Tidy dependencies
32+
tidy:
33+
go mod tidy
34+
35+
# Download dependencies
36+
deps:
37+
go mod download
38+
39+
# Format code
40+
fmt:
41+
go fmt ./...
42+
43+
# Lint code
44+
lint:
45+
golangci-lint run
46+
47+
# Show help
48+
help:
49+
@echo "Available targets:"
50+
@echo " build - Build for current platform"
51+
@echo " build-all - Build for all platforms (darwin/amd64, darwin/arm64)"
52+
@echo " clean - Remove build artifacts"
53+
@echo " test - Run tests"
54+
@echo " install - Install to /usr/local/bin"
55+
@echo " tidy - Tidy go.mod"
56+
@echo " deps - Download dependencies"
57+
@echo " fmt - Format code"
58+
@echo " lint - Run linter"

0 commit comments

Comments
 (0)