awscreen 1.0.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- awscreen/__init__.py +5 -0
- awscreen/_doctor.py +118 -0
- awscreen/cli.py +238 -0
- awscreen/finder.py +265 -0
- awscreen-1.0.0.dist-info/METADATA +91 -0
- awscreen-1.0.0.dist-info/RECORD +10 -0
- awscreen-1.0.0.dist-info/WHEEL +5 -0
- awscreen-1.0.0.dist-info/entry_points.txt +2 -0
- awscreen-1.0.0.dist-info/licenses/LICENSE +202 -0
- awscreen-1.0.0.dist-info/top_level.txt +1 -0
awscreen/__init__.py
ADDED
awscreen/_doctor.py
ADDED
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
"""Stack-aware `doctor` for awscreen.
|
|
2
|
+
|
|
3
|
+
GENERATED BY gen_aw_doctor.py -- DO NOT EDIT.
|
|
4
|
+
Regenerate it with the generator named above; a hand-edit here is reverted by
|
|
5
|
+
the next run and fails the parity gate.
|
|
6
|
+
|
|
7
|
+
Why a doctor exists at all: the aw* bricks are designed to COMPOSE, so the
|
|
8
|
+
interesting failures live BETWEEN them. "awscreen is installed" is not the useful
|
|
9
|
+
fact -- "awscreen is installed and the thing it pairs with is not" is. This reports
|
|
10
|
+
the whole stack, not just itself.
|
|
11
|
+
|
|
12
|
+
stdlib only, on purpose: a diagnostic that cannot run because a dependency is
|
|
13
|
+
missing is worthless precisely when you need it.
|
|
14
|
+
"""
|
|
15
|
+
from __future__ import annotations
|
|
16
|
+
|
|
17
|
+
import importlib.util
|
|
18
|
+
import shutil
|
|
19
|
+
import sys
|
|
20
|
+
|
|
21
|
+
#: Frozen from AitherOS/config/ecosystem.yaml at generation time. A shipped
|
|
22
|
+
#: package cannot read the registry, and a doctor that guessed at the family
|
|
23
|
+
#: would go stale in silence. Regenerate to update.
|
|
24
|
+
SELF = 'awscreen'
|
|
25
|
+
FAMILY = ['awarena', 'awask', 'awbac', 'awbrowse', 'awdit', 'awevolve', 'awfind', 'awgit',
|
|
26
|
+
'awgraph', 'awiam', 'awkno', 'awm', 'awmail', 'awnboard', 'awnest', 'awnet',
|
|
27
|
+
'awprism', 'awreason', 'awrecover', 'awrecurse', 'awrelay', 'awrepl', 'awresearch',
|
|
28
|
+
'awrise', 'awrun', 'awseal', 'awshare', 'awtoll', 'awtunnel', 'awvision',
|
|
29
|
+
'awvoice', 'awwall']
|
|
30
|
+
PAIRS_WITH = ['awbrowse', 'awvision']
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
def _installed(mod: str) -> "str | None":
|
|
34
|
+
"""Version if importable, else None. Never raises -- a broken sibling must
|
|
35
|
+
not take the diagnostic down with it."""
|
|
36
|
+
try:
|
|
37
|
+
if importlib.util.find_spec(mod) is None:
|
|
38
|
+
return None
|
|
39
|
+
except (ImportError, ValueError):
|
|
40
|
+
return None
|
|
41
|
+
try:
|
|
42
|
+
from importlib.metadata import PackageNotFoundError, version
|
|
43
|
+
try:
|
|
44
|
+
return version(mod)
|
|
45
|
+
except PackageNotFoundError:
|
|
46
|
+
return "installed"
|
|
47
|
+
except Exception:
|
|
48
|
+
return "installed"
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
def report(out=None) -> int:
|
|
52
|
+
"""Print the stack picture. 0 = this brick and its pairs are present."""
|
|
53
|
+
out = out or sys.stdout
|
|
54
|
+
print(f"{SELF} doctor", file=out)
|
|
55
|
+
|
|
56
|
+
mine = _installed(SELF)
|
|
57
|
+
print(f" self {SELF} {mine or 'NOT IMPORTABLE'}", file=out)
|
|
58
|
+
shim = shutil.which(SELF)
|
|
59
|
+
print(f" command {shim or 'not on PATH'}", file=out)
|
|
60
|
+
|
|
61
|
+
# The stack. Siblings this brick pairs with are called out separately,
|
|
62
|
+
# because a missing pair is a REASON, while a missing unrelated brick is
|
|
63
|
+
# just a fact about your machine.
|
|
64
|
+
missing_pairs, present = [], []
|
|
65
|
+
for name in FAMILY:
|
|
66
|
+
v = _installed(name)
|
|
67
|
+
if v:
|
|
68
|
+
present.append(name)
|
|
69
|
+
elif name in PAIRS_WITH:
|
|
70
|
+
missing_pairs.append(name)
|
|
71
|
+
print(f" stack {len(present)}/{len(FAMILY)} aw* packages installed",
|
|
72
|
+
file=out)
|
|
73
|
+
if present:
|
|
74
|
+
print(f" {' '.join(sorted(present))}", file=out)
|
|
75
|
+
|
|
76
|
+
local = _local_checks()
|
|
77
|
+
for line in local:
|
|
78
|
+
print(f" {line}", file=out)
|
|
79
|
+
|
|
80
|
+
if mine is None:
|
|
81
|
+
print(f"\nverdict: {SELF} itself is not importable. Reinstall it before "
|
|
82
|
+
f"anything else here means much.", file=out)
|
|
83
|
+
return 1
|
|
84
|
+
if missing_pairs:
|
|
85
|
+
print(f"\nverdict: {SELF} works, but pairs with "
|
|
86
|
+
f"{', '.join(sorted(missing_pairs))} which "
|
|
87
|
+
f"{'is' if len(missing_pairs) == 1 else 'are'} not installed. "
|
|
88
|
+
f"That is a capability you are missing, not an error.", file=out)
|
|
89
|
+
return 0
|
|
90
|
+
print(f"\nverdict: {SELF} and everything it pairs with are present.", file=out)
|
|
91
|
+
return 0
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
def _local_checks() -> "list[str]":
|
|
95
|
+
"""Per-brick checks, if this package defines them.
|
|
96
|
+
|
|
97
|
+
Kept as a HOOK rather than generated guesses: the generator knows the family
|
|
98
|
+
from the registry, but it does not know what awscreen needs at runtime, and a
|
|
99
|
+
doctor that invented config requirements would be confidently wrong. A
|
|
100
|
+
package supplies `_doctor_local()` returning display lines; absent, the
|
|
101
|
+
stack picture above still stands on its own.
|
|
102
|
+
"""
|
|
103
|
+
try:
|
|
104
|
+
mod = importlib.import_module(f"{SELF}.doctor_local")
|
|
105
|
+
except Exception:
|
|
106
|
+
return []
|
|
107
|
+
try:
|
|
108
|
+
return list(mod._doctor_local())
|
|
109
|
+
except Exception as exc: # noqa: BLE001
|
|
110
|
+
return [f"local checks raised {type(exc).__name__}: {exc}"]
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
def main(argv: "list[str] | None" = None) -> int:
|
|
114
|
+
return report()
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
if __name__ == "__main__":
|
|
118
|
+
raise SystemExit(main())
|
awscreen/cli.py
ADDED
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
"""awscreen CLI — find and locate clickable elements by description.
|
|
2
|
+
|
|
3
|
+
Exit codes:
|
|
4
|
+
0 = elements found and displayed
|
|
5
|
+
1 = no elements found matching description
|
|
6
|
+
2 = cannot judge (API error, missing key, file not found)
|
|
7
|
+
"""
|
|
8
|
+
|
|
9
|
+
from __future__ import annotations
|
|
10
|
+
|
|
11
|
+
import argparse
|
|
12
|
+
import contextlib
|
|
13
|
+
import json
|
|
14
|
+
import sys
|
|
15
|
+
import tempfile
|
|
16
|
+
from pathlib import Path
|
|
17
|
+
|
|
18
|
+
from .finder import Finder
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
def main(argv: list[str] | None = None) -> int:
|
|
22
|
+
"""Main entry point."""
|
|
23
|
+
# GENERATED doctor intercept (gen_aw_doctor.py) -- do not edit
|
|
24
|
+
_dv = locals().get("argv")
|
|
25
|
+
if (_dv if _dv is not None else __import__("sys").argv[1:])[:1] == ["doctor"]:
|
|
26
|
+
from ._doctor import report
|
|
27
|
+
return report()
|
|
28
|
+
ap = argparse.ArgumentParser(
|
|
29
|
+
prog="awscreen",
|
|
30
|
+
description="Find clickable elements by visual description",
|
|
31
|
+
)
|
|
32
|
+
ap.add_argument(
|
|
33
|
+
"--self-test",
|
|
34
|
+
action="store_true",
|
|
35
|
+
help="Run self-test (offline, no API)",
|
|
36
|
+
)
|
|
37
|
+
ap.add_argument(
|
|
38
|
+
"image",
|
|
39
|
+
nargs="?",
|
|
40
|
+
help="Path to screenshot image (PNG or JPEG)",
|
|
41
|
+
)
|
|
42
|
+
ap.add_argument(
|
|
43
|
+
"description",
|
|
44
|
+
nargs="?",
|
|
45
|
+
help="Natural language description of element to find",
|
|
46
|
+
)
|
|
47
|
+
ap.add_argument(
|
|
48
|
+
"--endpoint",
|
|
49
|
+
help="local vision endpoint (or set AWSCREEN_URL / AWVISION_URL)",
|
|
50
|
+
)
|
|
51
|
+
ap.add_argument(
|
|
52
|
+
"--format",
|
|
53
|
+
choices=["json", "text"],
|
|
54
|
+
default="text",
|
|
55
|
+
help="Output format",
|
|
56
|
+
)
|
|
57
|
+
|
|
58
|
+
args = ap.parse_args(argv)
|
|
59
|
+
|
|
60
|
+
if args.self_test:
|
|
61
|
+
return _self_test()
|
|
62
|
+
|
|
63
|
+
if not args.image or not args.description:
|
|
64
|
+
ap.print_help()
|
|
65
|
+
return 2
|
|
66
|
+
|
|
67
|
+
# No credential: this talks to loopback. See finder.py for why.
|
|
68
|
+
endpoint = getattr(args, "endpoint", None)
|
|
69
|
+
|
|
70
|
+
try:
|
|
71
|
+
finder = Finder(endpoint=endpoint)
|
|
72
|
+
except ValueError as exc:
|
|
73
|
+
print(f"DEAD: {exc}", file=sys.stderr)
|
|
74
|
+
return 2
|
|
75
|
+
except ImportError as exc:
|
|
76
|
+
print(f"DEAD: {exc}", file=sys.stderr)
|
|
77
|
+
return 2
|
|
78
|
+
|
|
79
|
+
try:
|
|
80
|
+
screenshot = finder.load_image(args.image)
|
|
81
|
+
except FileNotFoundError as exc:
|
|
82
|
+
print(f"DEAD: {exc}", file=sys.stderr)
|
|
83
|
+
return 2
|
|
84
|
+
except (ValueError, ImportError) as exc:
|
|
85
|
+
print(f"DEAD: {exc}", file=sys.stderr)
|
|
86
|
+
return 2
|
|
87
|
+
|
|
88
|
+
try:
|
|
89
|
+
elements = finder.find(screenshot, args.description)
|
|
90
|
+
except ValueError as exc:
|
|
91
|
+
print(f"DEAD: {exc}", file=sys.stderr)
|
|
92
|
+
return 2
|
|
93
|
+
|
|
94
|
+
if not elements:
|
|
95
|
+
if args.format == "json":
|
|
96
|
+
print(json.dumps({"found": 0, "elements": []}))
|
|
97
|
+
else:
|
|
98
|
+
print("No elements found matching description")
|
|
99
|
+
return 1
|
|
100
|
+
|
|
101
|
+
if args.format == "json":
|
|
102
|
+
result = {
|
|
103
|
+
"found": len(elements),
|
|
104
|
+
"elements": [
|
|
105
|
+
{
|
|
106
|
+
"x": e.x,
|
|
107
|
+
"y": e.y,
|
|
108
|
+
"width": e.width,
|
|
109
|
+
"height": e.height,
|
|
110
|
+
"confidence": e.confidence,
|
|
111
|
+
"description": e.description,
|
|
112
|
+
}
|
|
113
|
+
for e in elements
|
|
114
|
+
],
|
|
115
|
+
}
|
|
116
|
+
print(json.dumps(result, indent=2))
|
|
117
|
+
else:
|
|
118
|
+
for i, elem in enumerate(elements, 1):
|
|
119
|
+
print(
|
|
120
|
+
f"Match {i}: ({elem.x}, {elem.y}) "
|
|
121
|
+
f"[{elem.width}x{elem.height}] "
|
|
122
|
+
f"confidence={elem.confidence:.2f} "
|
|
123
|
+
f'"{elem.description}"'
|
|
124
|
+
)
|
|
125
|
+
|
|
126
|
+
return 0
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
def _self_test() -> int:
|
|
130
|
+
"""Self-test: verify the brick works offline.
|
|
131
|
+
|
|
132
|
+
Tests:
|
|
133
|
+
- Argument parsing
|
|
134
|
+
- Image loading
|
|
135
|
+
- JSON parsing
|
|
136
|
+
- Finder initialization (without calling API)
|
|
137
|
+
"""
|
|
138
|
+
try:
|
|
139
|
+
# Test 1: no credential is REQUIRED, and the default is loopback.
|
|
140
|
+
# This arm used to assert the opposite -- that a Finder without an API
|
|
141
|
+
# key must fail. It was written against a hosted backend, which would
|
|
142
|
+
# have shipped a brick that uploads a picture of your desktop to a
|
|
143
|
+
# third party. The rule inverted with the design, and a self-test that
|
|
144
|
+
# still pinned the old one would have kept it.
|
|
145
|
+
finder = Finder()
|
|
146
|
+
if not finder.endpoint.startswith("http"):
|
|
147
|
+
print("FAIL: Finder has no endpoint")
|
|
148
|
+
return 1
|
|
149
|
+
if "localhost" not in finder.endpoint and "127.0.0.1" not in finder.endpoint:
|
|
150
|
+
print("FAIL: default endpoint is not loopback: " + finder.endpoint)
|
|
151
|
+
return 1
|
|
152
|
+
# An api_key handed in by an older call site must be ignored, never
|
|
153
|
+
# stored -- accepting a credential and then sending it somewhere is
|
|
154
|
+
# worse than refusing it.
|
|
155
|
+
if any("sk-probe" in str(v) for v in vars(Finder(api_key="sk-probe")).values()):
|
|
156
|
+
print("FAIL: an api_key was retained")
|
|
157
|
+
return 1
|
|
158
|
+
|
|
159
|
+
# Test 2: Can initialize with key (but won't call API)
|
|
160
|
+
with contextlib.suppress(ImportError):
|
|
161
|
+
finder = Finder(api_key="test-key-for-testing")
|
|
162
|
+
# This will fail if Anthropic is not installed, which is fine
|
|
163
|
+
|
|
164
|
+
# Test 3: Test image loading with a dynamically created test image
|
|
165
|
+
with contextlib.suppress(ImportError):
|
|
166
|
+
finder = Finder(api_key="test-key")
|
|
167
|
+
# Create a minimal valid PNG (1x1 pixel) dynamically
|
|
168
|
+
png_bytes = (
|
|
169
|
+
b"\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x01"
|
|
170
|
+
b"\x00\x00\x00\x01\x08\x02\x00\x00\x00\x90wS\xde\x00\x00"
|
|
171
|
+
b"\x00\x0cIDATx\x9cc\xf8\x0f\x00\x00\x01\x01\x00\x055"
|
|
172
|
+
b"\xcd\xfb\xe7\x00\x00\x00\x00IEND\xaeB`\x82"
|
|
173
|
+
)
|
|
174
|
+
with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as tmp:
|
|
175
|
+
tmp.write(png_bytes)
|
|
176
|
+
tmp.flush()
|
|
177
|
+
tmp_path = tmp.name
|
|
178
|
+
try:
|
|
179
|
+
screenshot = finder.load_image(tmp_path)
|
|
180
|
+
if screenshot.width <= 0 or screenshot.height <= 0:
|
|
181
|
+
print("FAIL: Image dimensions invalid")
|
|
182
|
+
return 1
|
|
183
|
+
finally:
|
|
184
|
+
Path(tmp_path).unlink()
|
|
185
|
+
|
|
186
|
+
# Test 4: Test JSON parsing
|
|
187
|
+
response = (
|
|
188
|
+
'[{"x":10,"y":20,"width":100,"height":50,'
|
|
189
|
+
'"confidence":0.95,"description":"button"}]'
|
|
190
|
+
)
|
|
191
|
+
with contextlib.suppress(ImportError):
|
|
192
|
+
finder = Finder(api_key="test")
|
|
193
|
+
elements = finder._parse_response(response)
|
|
194
|
+
if len(elements) != 1:
|
|
195
|
+
print(f"FAIL: Expected 1 element, got {len(elements)}")
|
|
196
|
+
return 1
|
|
197
|
+
elem = elements[0]
|
|
198
|
+
if (
|
|
199
|
+
elem.x != 10
|
|
200
|
+
or elem.y != 20
|
|
201
|
+
or elem.width != 100
|
|
202
|
+
or elem.height != 50
|
|
203
|
+
or elem.confidence != 0.95
|
|
204
|
+
):
|
|
205
|
+
print(f"FAIL: Element values incorrect: {elem}")
|
|
206
|
+
return 1
|
|
207
|
+
|
|
208
|
+
# Test 5: Parse empty response
|
|
209
|
+
with contextlib.suppress(ImportError):
|
|
210
|
+
finder = Finder(api_key="test")
|
|
211
|
+
elements = finder._parse_response("[]")
|
|
212
|
+
if len(elements) != 0:
|
|
213
|
+
print("FAIL: Empty response should return empty list")
|
|
214
|
+
return 1
|
|
215
|
+
|
|
216
|
+
# Test 6: Parse response with surrounding text
|
|
217
|
+
response_with_text = (
|
|
218
|
+
"I found these elements:\n"
|
|
219
|
+
'[{"x":5,"y":10,"width":80,"height":30,"confidence":0.8,"description":"text"}]\n'
|
|
220
|
+
"Done."
|
|
221
|
+
)
|
|
222
|
+
with contextlib.suppress(ImportError):
|
|
223
|
+
finder = Finder(api_key="test")
|
|
224
|
+
elements = finder._parse_response(response_with_text)
|
|
225
|
+
if len(elements) != 1:
|
|
226
|
+
print("FAIL: Should extract JSON from text")
|
|
227
|
+
return 1
|
|
228
|
+
|
|
229
|
+
# All tests passed
|
|
230
|
+
return 0
|
|
231
|
+
|
|
232
|
+
except Exception as exc:
|
|
233
|
+
print(f"FAIL: Unexpected error in self-test: {exc}")
|
|
234
|
+
return 1
|
|
235
|
+
|
|
236
|
+
|
|
237
|
+
if __name__ == "__main__":
|
|
238
|
+
sys.exit(main())
|
awscreen/finder.py
ADDED
|
@@ -0,0 +1,265 @@
|
|
|
1
|
+
"""Core visual element finder, against a LOCAL vision endpoint.
|
|
2
|
+
|
|
3
|
+
This brick sends a picture of YOUR SCREEN somewhere. That makes the choice of
|
|
4
|
+
"somewhere" the most consequential decision in the file, so it is stated here:
|
|
5
|
+
it goes to a loopback endpoint you run, in the OpenAI /v1/chat/completions
|
|
6
|
+
shape -- the same one awvision uses, deliberately, so one local model serves
|
|
7
|
+
both and there is one thing to stand up rather than two.
|
|
8
|
+
|
|
9
|
+
It was first written against a HOSTED API with an api-key, which would have
|
|
10
|
+
shipped a brick that uploads your desktop to a third party and bills you for
|
|
11
|
+
it. Nothing in the aw* family does that, and a screen recorder is the worst
|
|
12
|
+
possible place to start.
|
|
13
|
+
|
|
14
|
+
Endpoint and model: AWSCREEN_URL / AWSCREEN_MODEL, falling back to
|
|
15
|
+
AWVISION_URL / AWVISION_MODEL so configuring the vision lane once configures
|
|
16
|
+
both.
|
|
17
|
+
"""
|
|
18
|
+
|
|
19
|
+
from __future__ import annotations
|
|
20
|
+
|
|
21
|
+
import base64
|
|
22
|
+
import json
|
|
23
|
+
import os
|
|
24
|
+
import urllib.error
|
|
25
|
+
import urllib.request
|
|
26
|
+
from dataclasses import dataclass
|
|
27
|
+
from pathlib import Path
|
|
28
|
+
|
|
29
|
+
try:
|
|
30
|
+
from PIL import Image
|
|
31
|
+
except ImportError:
|
|
32
|
+
Image = None
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
@dataclass
|
|
36
|
+
class Element:
|
|
37
|
+
"""A clickable element found on screen."""
|
|
38
|
+
x: int
|
|
39
|
+
y: int
|
|
40
|
+
width: int
|
|
41
|
+
height: int
|
|
42
|
+
confidence: float
|
|
43
|
+
description: str
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
@dataclass
|
|
47
|
+
class Screenshot:
|
|
48
|
+
"""A captured or loaded screenshot."""
|
|
49
|
+
path: Path
|
|
50
|
+
width: int
|
|
51
|
+
height: int
|
|
52
|
+
format: str
|
|
53
|
+
|
|
54
|
+
@property
|
|
55
|
+
def data_uri(self) -> str:
|
|
56
|
+
"""Encode image as data URI for API submission."""
|
|
57
|
+
mime = "image/png" if self.format.lower() == "png" else "image/jpeg"
|
|
58
|
+
with open(self.path, "rb") as f:
|
|
59
|
+
b64 = base64.standard_b64encode(f.read()).decode("ascii")
|
|
60
|
+
return f"data:{mime};base64,{b64}"
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
class Finder:
|
|
64
|
+
"""Find clickable elements by visual description, via a local vision model.
|
|
65
|
+
|
|
66
|
+
No API key. Nothing leaves the machine.
|
|
67
|
+
"""
|
|
68
|
+
|
|
69
|
+
def __init__(self, endpoint: str | None = None, model: str | None = None,
|
|
70
|
+
api_key: str | None = None):
|
|
71
|
+
"""Point it at a local vision endpoint.
|
|
72
|
+
|
|
73
|
+
Args:
|
|
74
|
+
endpoint: base URL, default AWSCREEN_URL / AWVISION_URL /
|
|
75
|
+
http://localhost:8150
|
|
76
|
+
model: model id, default AWSCREEN_MODEL / AWVISION_MODEL
|
|
77
|
+
api_key: accepted and ignored. Kept so an older call site does not
|
|
78
|
+
break, but this talks to loopback and needs no credential
|
|
79
|
+
-- silently accepting one and sending it somewhere would
|
|
80
|
+
be worse than refusing it.
|
|
81
|
+
"""
|
|
82
|
+
self.endpoint = (endpoint
|
|
83
|
+
or os.getenv("AWSCREEN_URL")
|
|
84
|
+
or os.getenv("AWVISION_URL")
|
|
85
|
+
or "http://localhost:8150").rstrip("/")
|
|
86
|
+
self.model = (model
|
|
87
|
+
or os.getenv("AWSCREEN_MODEL")
|
|
88
|
+
or os.getenv("AWVISION_MODEL")
|
|
89
|
+
or "gpt-4-vision")
|
|
90
|
+
|
|
91
|
+
def load_image(self, path: str) -> Screenshot:
|
|
92
|
+
"""Load an image from disk.
|
|
93
|
+
|
|
94
|
+
Args:
|
|
95
|
+
path: Path to image file (PNG or JPEG).
|
|
96
|
+
|
|
97
|
+
Returns:
|
|
98
|
+
Screenshot object ready for find().
|
|
99
|
+
|
|
100
|
+
Raises:
|
|
101
|
+
FileNotFoundError: If path doesn't exist.
|
|
102
|
+
ValueError: If Image is not available or file is not a valid image.
|
|
103
|
+
"""
|
|
104
|
+
if Image is None:
|
|
105
|
+
raise ImportError(
|
|
106
|
+
"awscreen requires 'Pillow' package: pip install Pillow"
|
|
107
|
+
)
|
|
108
|
+
p = Path(path)
|
|
109
|
+
if not p.exists():
|
|
110
|
+
raise FileNotFoundError(f"Image not found: {p}")
|
|
111
|
+
try:
|
|
112
|
+
img = Image.open(p)
|
|
113
|
+
fmt = img.format or "PNG"
|
|
114
|
+
return Screenshot(
|
|
115
|
+
path=p,
|
|
116
|
+
width=img.width,
|
|
117
|
+
height=img.height,
|
|
118
|
+
format=fmt,
|
|
119
|
+
)
|
|
120
|
+
except Exception as exc:
|
|
121
|
+
raise ValueError(f"Cannot load image {p}: {exc}")
|
|
122
|
+
|
|
123
|
+
def capture(self) -> Screenshot:
|
|
124
|
+
"""Capture current screen. Currently not implemented — use load_image."""
|
|
125
|
+
raise NotImplementedError(
|
|
126
|
+
"Screen capture not yet implemented. Use load_image(path) instead."
|
|
127
|
+
)
|
|
128
|
+
|
|
129
|
+
def find(self, screenshot: Screenshot, description: str) -> list[Element]:
|
|
130
|
+
"""Find clickable elements matching a description.
|
|
131
|
+
|
|
132
|
+
Args:
|
|
133
|
+
screenshot: Screenshot object from load_image() or capture().
|
|
134
|
+
description: Natural language description of what to find.
|
|
135
|
+
E.g., "the blue save button in the top toolbar"
|
|
136
|
+
|
|
137
|
+
Returns:
|
|
138
|
+
List of Element objects with positions and confidence scores.
|
|
139
|
+
Empty list if no matches found.
|
|
140
|
+
|
|
141
|
+
Raises:
|
|
142
|
+
ValueError: If API key is invalid or API call fails.
|
|
143
|
+
"""
|
|
144
|
+
if not description or not description.strip():
|
|
145
|
+
return []
|
|
146
|
+
|
|
147
|
+
b64 = self._load_image_base64(screenshot.path)
|
|
148
|
+
media = "image/png" if screenshot.format.lower() == "png" else "image/jpeg"
|
|
149
|
+
payload = {
|
|
150
|
+
"model": self.model,
|
|
151
|
+
"max_tokens": 1024,
|
|
152
|
+
"messages": [{
|
|
153
|
+
"role": "user",
|
|
154
|
+
"content": [
|
|
155
|
+
{"type": "text",
|
|
156
|
+
"text": self._build_prompt(description,
|
|
157
|
+
screenshot.width,
|
|
158
|
+
screenshot.height)},
|
|
159
|
+
{"type": "image_url",
|
|
160
|
+
"image_url": {"url": "data:" + media + ";base64," + b64}},
|
|
161
|
+
],
|
|
162
|
+
}],
|
|
163
|
+
}
|
|
164
|
+
url = self.endpoint + "/v1/chat/completions"
|
|
165
|
+
req = urllib.request.Request(
|
|
166
|
+
url, data=json.dumps(payload).encode("utf-8"),
|
|
167
|
+
headers={"Content-Type": "application/json"}, method="POST")
|
|
168
|
+
try:
|
|
169
|
+
with urllib.request.urlopen(req, timeout=120) as resp:
|
|
170
|
+
body = json.loads(resp.read().decode("utf-8"))
|
|
171
|
+
except urllib.error.HTTPError as exc:
|
|
172
|
+
raise ValueError(
|
|
173
|
+
"Vision endpoint returned HTTP " + str(exc.code) + " at " + url
|
|
174
|
+
+ " -- start a vision-capable model there, or set AWSCREEN_URL.")
|
|
175
|
+
except urllib.error.URLError as exc:
|
|
176
|
+
raise ValueError(
|
|
177
|
+
"Cannot reach a vision endpoint at " + self.endpoint
|
|
178
|
+
+ " (" + str(exc.reason) + "). awscreen needs a LOCAL vision"
|
|
179
|
+
+ " model; nothing is sent off this machine."
|
|
180
|
+
+ " Set AWSCREEN_URL or AWVISION_URL.")
|
|
181
|
+
|
|
182
|
+
choices = body.get("choices") or []
|
|
183
|
+
if not choices:
|
|
184
|
+
raise ValueError(
|
|
185
|
+
"Model '" + self.model + "' returned no choices. It is most"
|
|
186
|
+
" likely not vision-capable.")
|
|
187
|
+
content = ((choices[0].get("message") or {}).get("content") or "")
|
|
188
|
+
if not content or content.isspace():
|
|
189
|
+
# A TEXT model handed an image answers 200 with nothing. Refusing
|
|
190
|
+
# here is the whole point: a blank answer would be read as "the
|
|
191
|
+
# element is not on screen", which is a different and wrong fact.
|
|
192
|
+
raise ValueError(
|
|
193
|
+
"Model '" + self.model + "' at " + self.endpoint + " returned"
|
|
194
|
+
" EMPTY content for an image. That is what a text-only model"
|
|
195
|
+
" does when handed a picture -- it did not fail to find your"
|
|
196
|
+
" element, it cannot see. Point AWSCREEN_MODEL at a"
|
|
197
|
+
" vision-capable model.")
|
|
198
|
+
return self._parse_response(content)
|
|
199
|
+
|
|
200
|
+
def _load_image_base64(self, path: Path) -> str:
|
|
201
|
+
"""Load image and encode as base64."""
|
|
202
|
+
with open(path, "rb") as f:
|
|
203
|
+
return base64.standard_b64encode(f.read()).decode("ascii")
|
|
204
|
+
|
|
205
|
+
def _build_prompt(self, description: str, width: int, height: int) -> str:
|
|
206
|
+
"""Build the vision prompt for Claude."""
|
|
207
|
+
return f"""Find clickable elements matching this description: "{description}"
|
|
208
|
+
|
|
209
|
+
Respond with a JSON array of objects, each with:
|
|
210
|
+
- x: left edge coordinate (0-{width})
|
|
211
|
+
- y: top edge coordinate (0-{height})
|
|
212
|
+
- width: element width in pixels
|
|
213
|
+
- height: element height in pixels
|
|
214
|
+
- confidence: 0.0-1.0 (1.0 = certain, 0.5 = possible, <0.5 = unlikely)
|
|
215
|
+
- description: what you found
|
|
216
|
+
|
|
217
|
+
Return ONLY valid JSON, no other text. If no matches found, return [].
|
|
218
|
+
Example response:
|
|
219
|
+
[{{"x":10,"y":20,"width":100,"height":40,"confidence":0.95,"description":"blue button"}}]
|
|
220
|
+
"""
|
|
221
|
+
|
|
222
|
+
def _parse_response(self, response: str) -> list[Element]:
|
|
223
|
+
"""Parse API response into Element objects."""
|
|
224
|
+
response = response.strip()
|
|
225
|
+
if not response or response == "[]":
|
|
226
|
+
return []
|
|
227
|
+
|
|
228
|
+
# Extract JSON from response (might have surrounding text)
|
|
229
|
+
try:
|
|
230
|
+
# Try direct parse first
|
|
231
|
+
data = json.loads(response)
|
|
232
|
+
except json.JSONDecodeError:
|
|
233
|
+
# Try to find JSON array in response
|
|
234
|
+
start = response.find("[")
|
|
235
|
+
end = response.rfind("]")
|
|
236
|
+
if start < 0 or end <= start:
|
|
237
|
+
return []
|
|
238
|
+
try:
|
|
239
|
+
data = json.loads(response[start : end + 1])
|
|
240
|
+
except json.JSONDecodeError:
|
|
241
|
+
return []
|
|
242
|
+
|
|
243
|
+
if not isinstance(data, list):
|
|
244
|
+
return []
|
|
245
|
+
|
|
246
|
+
elements = []
|
|
247
|
+
for item in data:
|
|
248
|
+
if not isinstance(item, dict):
|
|
249
|
+
continue
|
|
250
|
+
try:
|
|
251
|
+
elem = Element(
|
|
252
|
+
x=int(item.get("x", 0)),
|
|
253
|
+
y=int(item.get("y", 0)),
|
|
254
|
+
width=int(item.get("width", 0)),
|
|
255
|
+
height=int(item.get("height", 0)),
|
|
256
|
+
confidence=float(item.get("confidence", 0.0)),
|
|
257
|
+
description=str(item.get("description", "")),
|
|
258
|
+
)
|
|
259
|
+
if elem.width > 0 and elem.height > 0 and elem.confidence > 0:
|
|
260
|
+
elements.append(elem)
|
|
261
|
+
except (TypeError, ValueError):
|
|
262
|
+
# Skip malformed items
|
|
263
|
+
continue
|
|
264
|
+
|
|
265
|
+
return elements
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: awscreen
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: Find elements on screen by describing what they look like
|
|
5
|
+
Author: Aither
|
|
6
|
+
License: MIT
|
|
7
|
+
Requires-Python: >=3.10
|
|
8
|
+
Description-Content-Type: text/markdown
|
|
9
|
+
License-File: LICENSE
|
|
10
|
+
Requires-Dist: Pillow>=10.0.0; platform_system == "Windows"
|
|
11
|
+
Provides-Extra: dev
|
|
12
|
+
Requires-Dist: pytest>=7.0; extra == "dev"
|
|
13
|
+
Requires-Dist: ruff; extra == "dev"
|
|
14
|
+
Dynamic: license-file
|
|
15
|
+
|
|
16
|
+
# awscreen
|
|
17
|
+
|
|
18
|
+
Find clickable elements by describing what they look like.
|
|
19
|
+
|
|
20
|
+
Part of the [Aither World (`aw*`)](https://github.com/Aitherium/awscreens) family of CLI tools.
|
|
21
|
+
|
|
22
|
+
## Install
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
pip install awscreen
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Usage
|
|
29
|
+
|
|
30
|
+
Find elements in a screenshot by natural language description:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
# Set your API key
|
|
34
|
+
export AWSCREEN_URL=http://localhost:8150 # a LOCAL vision model
|
|
35
|
+
export AWSCREEN_MODEL=your-vision-model
|
|
36
|
+
|
|
37
|
+
# Find the save button in a screenshot
|
|
38
|
+
awscreen screenshot.png "the blue save button in the top toolbar"
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Or use in Python:
|
|
42
|
+
|
|
43
|
+
```python
|
|
44
|
+
from awscreen import Finder
|
|
45
|
+
|
|
46
|
+
finder = Finder() # reads AWSCREEN_URL / AWVISION_URL
|
|
47
|
+
screenshot = finder.load_image("screenshot.png")
|
|
48
|
+
results = finder.find(screenshot, "the blue save button")
|
|
49
|
+
|
|
50
|
+
for match in results:
|
|
51
|
+
print(f"Found at ({match.x}, {match.y}): {match.description}")
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## How it works
|
|
55
|
+
|
|
56
|
+
`awscreen` analyzes screenshots using Claude's vision capabilities to find interactive elements matching your description. No pixel-perfect coordinates needed — just describe what you're looking for in natural language.
|
|
57
|
+
|
|
58
|
+
### Features
|
|
59
|
+
|
|
60
|
+
- **Visual matching**: Describe elements like "the red button in the bottom right"
|
|
61
|
+
- **Confidence scores**: Each match includes a confidence rating
|
|
62
|
+
- **Bounding boxes**: Get precise pixel coordinates for click targets
|
|
63
|
+
- **Text output or JSON**: Choose human-readable or machine-parseable output
|
|
64
|
+
|
|
65
|
+
## Exit codes
|
|
66
|
+
|
|
67
|
+
- `0`: Elements found; details printed
|
|
68
|
+
- `1`: No elements found matching the description
|
|
69
|
+
- `2`: Cannot proceed (missing API key, invalid image, API error)
|
|
70
|
+
|
|
71
|
+
## API key
|
|
72
|
+
|
|
73
|
+
Requires an Anthropic API key for vision analysis. Provide it via:
|
|
74
|
+
|
|
75
|
+
1. Environment variable: `AWSCREEN_URL` (falls back to `AWVISION_URL`)
|
|
76
|
+
2. CLI argument: `awscreen image.png description --api-key sk-ant-...`
|
|
77
|
+
|
|
78
|
+
No API key. awscreen sends a picture of your screen, so it sends it to a
|
|
79
|
+
loopback endpoint you run -- nothing leaves the machine. It speaks the
|
|
80
|
+
OpenAI /v1/chat/completions shape, the same one awvision uses, so one
|
|
81
|
+
local vision model serves both.
|
|
82
|
+
|
|
83
|
+
## Related
|
|
84
|
+
|
|
85
|
+
- `awiam` — identify who the caller is
|
|
86
|
+
- `awbac` — control what they may do
|
|
87
|
+
- `awseal` — prove it
|
|
88
|
+
|
|
89
|
+
## License
|
|
90
|
+
|
|
91
|
+
Apache 2.0
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
awscreen/__init__.py,sha256=v4KqD9W6bgaYpBFsrH05TONAjonQkSXVXQXvFCUn-c4,192
|
|
2
|
+
awscreen/_doctor.py,sha256=Iuq5dJlLXmvKbinh2t60b_oFIlX5FMuTcX_mDtq8UwA,4378
|
|
3
|
+
awscreen/cli.py,sha256=bOVocwlzI7UILetzGtoYI1Tb4rwq-Pwg3G1rMxPvq3A,7890
|
|
4
|
+
awscreen/finder.py,sha256=94-n5e0IdChBq_zeKeSnL0Uhj-1sJ_rw7SjcXOAnXTo,9982
|
|
5
|
+
awscreen-1.0.0.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
|
|
6
|
+
awscreen-1.0.0.dist-info/METADATA,sha256=irlam12IgcelN8VZJ6riZiDeE4QIdIBqqjjCA2R9cXc,2595
|
|
7
|
+
awscreen-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
|
|
8
|
+
awscreen-1.0.0.dist-info/entry_points.txt,sha256=c1lnBj4EDpvcBiqfUiEPLFHwhM1NIWKHrpwOggbEXcc,47
|
|
9
|
+
awscreen-1.0.0.dist-info/top_level.txt,sha256=W5xAzab8u6nC22Elv2fyMv0moewjw6-NnPUmw0sfeEA,9
|
|
10
|
+
awscreen-1.0.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
|
|
2
|
+
Apache License
|
|
3
|
+
Version 2.0, January 2004
|
|
4
|
+
http://www.apache.org/licenses/
|
|
5
|
+
|
|
6
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
7
|
+
|
|
8
|
+
1. Definitions.
|
|
9
|
+
|
|
10
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
|
11
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
|
12
|
+
|
|
13
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
|
14
|
+
the copyright owner that is granting the License.
|
|
15
|
+
|
|
16
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
|
17
|
+
other entities that control, are controlled by, or are under common
|
|
18
|
+
control with that entity. For the purposes of this definition,
|
|
19
|
+
"control" means (i) the power, direct or indirect, to cause the
|
|
20
|
+
direction or management of such entity, whether by contract or
|
|
21
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
22
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
23
|
+
|
|
24
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
|
25
|
+
exercising permissions granted by this License.
|
|
26
|
+
|
|
27
|
+
"Source" form shall mean the preferred form for making modifications,
|
|
28
|
+
including but not limited to software source code, documentation
|
|
29
|
+
source, and configuration files.
|
|
30
|
+
|
|
31
|
+
"Object" form shall mean any form resulting from mechanical
|
|
32
|
+
transformation or translation of a Source form, including but
|
|
33
|
+
not limited to compiled object code, generated documentation,
|
|
34
|
+
and conversions to other media types.
|
|
35
|
+
|
|
36
|
+
"Work" shall mean the work of authorship, whether in Source or
|
|
37
|
+
Object form, made available under the License, as indicated by a
|
|
38
|
+
copyright notice that is included in or attached to the work
|
|
39
|
+
(an example is provided in the Appendix below).
|
|
40
|
+
|
|
41
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
|
42
|
+
form, that is based on (or derived from) the Work and for which the
|
|
43
|
+
editorial revisions, annotations, elaborations, or other modifications
|
|
44
|
+
represent, as a whole, an original work of authorship. For the purposes
|
|
45
|
+
of this License, Derivative Works shall not include works that remain
|
|
46
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
|
47
|
+
the Work and Derivative Works thereof.
|
|
48
|
+
|
|
49
|
+
"Contribution" shall mean any work of authorship, including
|
|
50
|
+
the original version of the Work and any modifications or additions
|
|
51
|
+
to that Work or Derivative Works thereof, that is intentionally
|
|
52
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
53
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
|
54
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
|
55
|
+
means any form of electronic, verbal, or written communication sent
|
|
56
|
+
to the Licensor or its representatives, including but not limited to
|
|
57
|
+
communication on electronic mailing lists, source code control systems,
|
|
58
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
|
59
|
+
Licensor for the purpose of discussing and improving the Work, but
|
|
60
|
+
excluding communication that is conspicuously marked or otherwise
|
|
61
|
+
designated in writing by the copyright owner as "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
|
+
APPENDIX: How to apply the Apache License to your work.
|
|
180
|
+
|
|
181
|
+
To apply the Apache License to your work, attach the following
|
|
182
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
183
|
+
replaced with your own identifying information. (Don't include
|
|
184
|
+
the brackets!) The text should be enclosed in the appropriate
|
|
185
|
+
comment syntax for the file format. We also recommend that a
|
|
186
|
+
file or class name and description of purpose be included on the
|
|
187
|
+
same "printed page" as the copyright notice for easier
|
|
188
|
+
identification within third-party archives.
|
|
189
|
+
|
|
190
|
+
Copyright [yyyy] [name of copyright owner]
|
|
191
|
+
|
|
192
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
193
|
+
you may not use this file except in compliance with the License.
|
|
194
|
+
You may obtain a copy of the License at
|
|
195
|
+
|
|
196
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
197
|
+
|
|
198
|
+
Unless required by applicable law or agreed to in writing, software
|
|
199
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
200
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
201
|
+
See the License for the specific language governing permissions and
|
|
202
|
+
limitations under the License.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
awscreen
|