hyperbrowser 0.2.0__py3-none-any.whl → 0.4.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.
Potentially problematic release.
This version of hyperbrowser might be problematic. Click here for more details.
- hyperbrowser/client/async_client.py +6 -2
- hyperbrowser/client/sync.py +6 -2
- hyperbrowser/models/consts.py +481 -0
- hyperbrowser/models/session.py +41 -0
- hyperbrowser/transport/async_transport.py +28 -29
- hyperbrowser/transport/sync.py +12 -13
- {hyperbrowser-0.2.0.dist-info → hyperbrowser-0.4.0.dist-info}/METADATA +9 -8
- hyperbrowser-0.4.0.dist-info/RECORD +16 -0
- hyperbrowser-0.2.0.dist-info/RECORD +0 -15
- {hyperbrowser-0.2.0.dist-info → hyperbrowser-0.4.0.dist-info}/LICENSE +0 -0
- {hyperbrowser-0.2.0.dist-info → hyperbrowser-0.4.0.dist-info}/WHEEL +0 -0
|
@@ -3,6 +3,7 @@ from ..transport.async_transport import AsyncTransport
|
|
|
3
3
|
from .base import HyperbrowserBase
|
|
4
4
|
from ..models.session import (
|
|
5
5
|
BasicResponse,
|
|
6
|
+
CreateSessionParams,
|
|
6
7
|
SessionDetail,
|
|
7
8
|
SessionListParams,
|
|
8
9
|
SessionListResponse,
|
|
@@ -21,8 +22,11 @@ class AsyncHyperbrowser(HyperbrowserBase):
|
|
|
21
22
|
):
|
|
22
23
|
super().__init__(AsyncTransport, config, api_key, base_url)
|
|
23
24
|
|
|
24
|
-
async def create_session(self) -> SessionDetail:
|
|
25
|
-
response = await self.transport.post(
|
|
25
|
+
async def create_session(self, params: CreateSessionParams) -> SessionDetail:
|
|
26
|
+
response = await self.transport.post(
|
|
27
|
+
self._build_url("/session"),
|
|
28
|
+
data=params.model_dump(exclude_none=True, by_alias=True),
|
|
29
|
+
)
|
|
26
30
|
return SessionDetail(**response.data)
|
|
27
31
|
|
|
28
32
|
async def get_session(self, id: str) -> SessionDetail:
|
hyperbrowser/client/sync.py
CHANGED
|
@@ -3,6 +3,7 @@ from ..transport.sync import SyncTransport
|
|
|
3
3
|
from .base import HyperbrowserBase
|
|
4
4
|
from ..models.session import (
|
|
5
5
|
BasicResponse,
|
|
6
|
+
CreateSessionParams,
|
|
6
7
|
SessionDetail,
|
|
7
8
|
SessionListParams,
|
|
8
9
|
SessionListResponse,
|
|
@@ -21,8 +22,11 @@ class Hyperbrowser(HyperbrowserBase):
|
|
|
21
22
|
):
|
|
22
23
|
super().__init__(SyncTransport, config, api_key, base_url)
|
|
23
24
|
|
|
24
|
-
def create_session(self) -> SessionDetail:
|
|
25
|
-
response = self.transport.post(
|
|
25
|
+
def create_session(self, params: CreateSessionParams) -> SessionDetail:
|
|
26
|
+
response = self.transport.post(
|
|
27
|
+
self._build_url("/session"),
|
|
28
|
+
data=params.model_dump(exclude_none=True, by_alias=True),
|
|
29
|
+
)
|
|
26
30
|
return SessionDetail(**response.data)
|
|
27
31
|
|
|
28
32
|
def get_session(self, id: str) -> SessionDetail:
|
|
@@ -0,0 +1,481 @@
|
|
|
1
|
+
from typing import Literal
|
|
2
|
+
|
|
3
|
+
Country = Literal[
|
|
4
|
+
"AD",
|
|
5
|
+
"AE",
|
|
6
|
+
"AF",
|
|
7
|
+
"AL",
|
|
8
|
+
"AM",
|
|
9
|
+
"AO",
|
|
10
|
+
"AR",
|
|
11
|
+
"AT",
|
|
12
|
+
"AU",
|
|
13
|
+
"AW",
|
|
14
|
+
"AZ",
|
|
15
|
+
"BA",
|
|
16
|
+
"BD",
|
|
17
|
+
"BE",
|
|
18
|
+
"BG",
|
|
19
|
+
"BH",
|
|
20
|
+
"BJ",
|
|
21
|
+
"BO",
|
|
22
|
+
"BR",
|
|
23
|
+
"BS",
|
|
24
|
+
"BT",
|
|
25
|
+
"BY",
|
|
26
|
+
"BZ",
|
|
27
|
+
"CA",
|
|
28
|
+
"CF",
|
|
29
|
+
"CH",
|
|
30
|
+
"CI",
|
|
31
|
+
"CL",
|
|
32
|
+
"CM",
|
|
33
|
+
"CN",
|
|
34
|
+
"CO",
|
|
35
|
+
"CR",
|
|
36
|
+
"CU",
|
|
37
|
+
"CY",
|
|
38
|
+
"CZ",
|
|
39
|
+
"DE",
|
|
40
|
+
"DJ",
|
|
41
|
+
"DK",
|
|
42
|
+
"DM",
|
|
43
|
+
"EC",
|
|
44
|
+
"EE",
|
|
45
|
+
"EG",
|
|
46
|
+
"ES",
|
|
47
|
+
"ET",
|
|
48
|
+
"EU",
|
|
49
|
+
"FI",
|
|
50
|
+
"FJ",
|
|
51
|
+
"FR",
|
|
52
|
+
"GB",
|
|
53
|
+
"GE",
|
|
54
|
+
"GH",
|
|
55
|
+
"GM",
|
|
56
|
+
"GR",
|
|
57
|
+
"HK",
|
|
58
|
+
"HN",
|
|
59
|
+
"HR",
|
|
60
|
+
"HT",
|
|
61
|
+
"HU",
|
|
62
|
+
"ID",
|
|
63
|
+
"IE",
|
|
64
|
+
"IL",
|
|
65
|
+
"IN",
|
|
66
|
+
"IQ",
|
|
67
|
+
"IR",
|
|
68
|
+
"IS",
|
|
69
|
+
"IT",
|
|
70
|
+
"JM",
|
|
71
|
+
"JO",
|
|
72
|
+
"JP",
|
|
73
|
+
"KE",
|
|
74
|
+
"KH",
|
|
75
|
+
"KR",
|
|
76
|
+
"KW",
|
|
77
|
+
"KZ",
|
|
78
|
+
"LB",
|
|
79
|
+
"LI",
|
|
80
|
+
"LR",
|
|
81
|
+
"LT",
|
|
82
|
+
"LU",
|
|
83
|
+
"LV",
|
|
84
|
+
"MA",
|
|
85
|
+
"MC",
|
|
86
|
+
"MD",
|
|
87
|
+
"ME",
|
|
88
|
+
"MG",
|
|
89
|
+
"MK",
|
|
90
|
+
"ML",
|
|
91
|
+
"MM",
|
|
92
|
+
"MN",
|
|
93
|
+
"MR",
|
|
94
|
+
"MT",
|
|
95
|
+
"MU",
|
|
96
|
+
"MV",
|
|
97
|
+
"MX",
|
|
98
|
+
"MY",
|
|
99
|
+
"MZ",
|
|
100
|
+
"NG",
|
|
101
|
+
"NL",
|
|
102
|
+
"NO",
|
|
103
|
+
"NZ",
|
|
104
|
+
"OM",
|
|
105
|
+
"PA",
|
|
106
|
+
"PE",
|
|
107
|
+
"PH",
|
|
108
|
+
"PK",
|
|
109
|
+
"PL",
|
|
110
|
+
"PR",
|
|
111
|
+
"PT",
|
|
112
|
+
"PY",
|
|
113
|
+
"QA",
|
|
114
|
+
"RANDOM_COUNTRY",
|
|
115
|
+
"RO",
|
|
116
|
+
"RS",
|
|
117
|
+
"RU",
|
|
118
|
+
"SA",
|
|
119
|
+
"SC",
|
|
120
|
+
"SD",
|
|
121
|
+
"SE",
|
|
122
|
+
"SG",
|
|
123
|
+
"SI",
|
|
124
|
+
"SK",
|
|
125
|
+
"SN",
|
|
126
|
+
"SS",
|
|
127
|
+
"TD",
|
|
128
|
+
"TG",
|
|
129
|
+
"TH",
|
|
130
|
+
"TM",
|
|
131
|
+
"TN",
|
|
132
|
+
"TR",
|
|
133
|
+
"TT",
|
|
134
|
+
"TW",
|
|
135
|
+
"UA",
|
|
136
|
+
"UG",
|
|
137
|
+
"US",
|
|
138
|
+
"UY",
|
|
139
|
+
"UZ",
|
|
140
|
+
"VE",
|
|
141
|
+
"VG",
|
|
142
|
+
"VN",
|
|
143
|
+
"YE",
|
|
144
|
+
"ZA",
|
|
145
|
+
"ZM",
|
|
146
|
+
"ZW",
|
|
147
|
+
"ad",
|
|
148
|
+
"ae",
|
|
149
|
+
"af",
|
|
150
|
+
"al",
|
|
151
|
+
"am",
|
|
152
|
+
"ao",
|
|
153
|
+
"ar",
|
|
154
|
+
"at",
|
|
155
|
+
"au",
|
|
156
|
+
"aw",
|
|
157
|
+
"az",
|
|
158
|
+
"ba",
|
|
159
|
+
"bd",
|
|
160
|
+
"be",
|
|
161
|
+
"bg",
|
|
162
|
+
"bh",
|
|
163
|
+
"bj",
|
|
164
|
+
"bo",
|
|
165
|
+
"br",
|
|
166
|
+
"bs",
|
|
167
|
+
"bt",
|
|
168
|
+
"by",
|
|
169
|
+
"bz",
|
|
170
|
+
"ca",
|
|
171
|
+
"cf",
|
|
172
|
+
"ch",
|
|
173
|
+
"ci",
|
|
174
|
+
"cl",
|
|
175
|
+
"cm",
|
|
176
|
+
"cn",
|
|
177
|
+
"co",
|
|
178
|
+
"cr",
|
|
179
|
+
"cu",
|
|
180
|
+
"cy",
|
|
181
|
+
"cz",
|
|
182
|
+
"de",
|
|
183
|
+
"dj",
|
|
184
|
+
"dk",
|
|
185
|
+
"dm",
|
|
186
|
+
"ec",
|
|
187
|
+
"ee",
|
|
188
|
+
"eg",
|
|
189
|
+
"es",
|
|
190
|
+
"et",
|
|
191
|
+
"eu",
|
|
192
|
+
"fi",
|
|
193
|
+
"fj",
|
|
194
|
+
"fr",
|
|
195
|
+
"gb",
|
|
196
|
+
"ge",
|
|
197
|
+
"gh",
|
|
198
|
+
"gm",
|
|
199
|
+
"gr",
|
|
200
|
+
"hk",
|
|
201
|
+
"hn",
|
|
202
|
+
"hr",
|
|
203
|
+
"ht",
|
|
204
|
+
"hu",
|
|
205
|
+
"id",
|
|
206
|
+
"ie",
|
|
207
|
+
"il",
|
|
208
|
+
"in",
|
|
209
|
+
"iq",
|
|
210
|
+
"ir",
|
|
211
|
+
"is",
|
|
212
|
+
"it",
|
|
213
|
+
"jm",
|
|
214
|
+
"jo",
|
|
215
|
+
"jp",
|
|
216
|
+
"ke",
|
|
217
|
+
"kh",
|
|
218
|
+
"kr",
|
|
219
|
+
"kw",
|
|
220
|
+
"kz",
|
|
221
|
+
"lb",
|
|
222
|
+
"li",
|
|
223
|
+
"lr",
|
|
224
|
+
"lt",
|
|
225
|
+
"lu",
|
|
226
|
+
"lv",
|
|
227
|
+
"ma",
|
|
228
|
+
"mc",
|
|
229
|
+
"md",
|
|
230
|
+
"me",
|
|
231
|
+
"mg",
|
|
232
|
+
"mk",
|
|
233
|
+
"ml",
|
|
234
|
+
"mm",
|
|
235
|
+
"mn",
|
|
236
|
+
"mr",
|
|
237
|
+
"mt",
|
|
238
|
+
"mu",
|
|
239
|
+
"mv",
|
|
240
|
+
"mx",
|
|
241
|
+
"my",
|
|
242
|
+
"mz",
|
|
243
|
+
"ng",
|
|
244
|
+
"nl",
|
|
245
|
+
"no",
|
|
246
|
+
"nz",
|
|
247
|
+
"om",
|
|
248
|
+
"pa",
|
|
249
|
+
"pe",
|
|
250
|
+
"ph",
|
|
251
|
+
"pk",
|
|
252
|
+
"pl",
|
|
253
|
+
"pr",
|
|
254
|
+
"pt",
|
|
255
|
+
"py",
|
|
256
|
+
"qa",
|
|
257
|
+
"ro",
|
|
258
|
+
"rs",
|
|
259
|
+
"ru",
|
|
260
|
+
"sa",
|
|
261
|
+
"sc",
|
|
262
|
+
"sd",
|
|
263
|
+
"se",
|
|
264
|
+
"sg",
|
|
265
|
+
"si",
|
|
266
|
+
"sk",
|
|
267
|
+
"sn",
|
|
268
|
+
"ss",
|
|
269
|
+
"td",
|
|
270
|
+
"tg",
|
|
271
|
+
"th",
|
|
272
|
+
"tm",
|
|
273
|
+
"tn",
|
|
274
|
+
"tr",
|
|
275
|
+
"tt",
|
|
276
|
+
"tw",
|
|
277
|
+
"ua",
|
|
278
|
+
"ug",
|
|
279
|
+
"us",
|
|
280
|
+
"uy",
|
|
281
|
+
"uz",
|
|
282
|
+
"ve",
|
|
283
|
+
"vg",
|
|
284
|
+
"vn",
|
|
285
|
+
"ye",
|
|
286
|
+
"za",
|
|
287
|
+
"zm",
|
|
288
|
+
"zw",
|
|
289
|
+
]
|
|
290
|
+
|
|
291
|
+
OperatingSystem = Literal["windows", "android", "macos", "linux", "ios"]
|
|
292
|
+
|
|
293
|
+
Platform = Literal["chrome", "firefox", "safari", "edge"]
|
|
294
|
+
|
|
295
|
+
ISO639_1 = Literal[
|
|
296
|
+
"aa",
|
|
297
|
+
"ab",
|
|
298
|
+
"ae",
|
|
299
|
+
"af",
|
|
300
|
+
"ak",
|
|
301
|
+
"am",
|
|
302
|
+
"an",
|
|
303
|
+
"ar",
|
|
304
|
+
"as",
|
|
305
|
+
"av",
|
|
306
|
+
"ay",
|
|
307
|
+
"az",
|
|
308
|
+
"ba",
|
|
309
|
+
"be",
|
|
310
|
+
"bg",
|
|
311
|
+
"bh",
|
|
312
|
+
"bi",
|
|
313
|
+
"bm",
|
|
314
|
+
"bn",
|
|
315
|
+
"bo",
|
|
316
|
+
"br",
|
|
317
|
+
"bs",
|
|
318
|
+
"ca",
|
|
319
|
+
"ce",
|
|
320
|
+
"ch",
|
|
321
|
+
"co",
|
|
322
|
+
"cr",
|
|
323
|
+
"cs",
|
|
324
|
+
"cu",
|
|
325
|
+
"cv",
|
|
326
|
+
"cy",
|
|
327
|
+
"da",
|
|
328
|
+
"de",
|
|
329
|
+
"dv",
|
|
330
|
+
"dz",
|
|
331
|
+
"ee",
|
|
332
|
+
"el",
|
|
333
|
+
"en",
|
|
334
|
+
"eo",
|
|
335
|
+
"es",
|
|
336
|
+
"et",
|
|
337
|
+
"eu",
|
|
338
|
+
"fa",
|
|
339
|
+
"ff",
|
|
340
|
+
"fi",
|
|
341
|
+
"fj",
|
|
342
|
+
"fo",
|
|
343
|
+
"fr",
|
|
344
|
+
"fy",
|
|
345
|
+
"ga",
|
|
346
|
+
"gd",
|
|
347
|
+
"gl",
|
|
348
|
+
"gn",
|
|
349
|
+
"gu",
|
|
350
|
+
"gv",
|
|
351
|
+
"ha",
|
|
352
|
+
"he",
|
|
353
|
+
"hi",
|
|
354
|
+
"ho",
|
|
355
|
+
"hr",
|
|
356
|
+
"ht",
|
|
357
|
+
"hu",
|
|
358
|
+
"hy",
|
|
359
|
+
"hz",
|
|
360
|
+
"ia",
|
|
361
|
+
"id",
|
|
362
|
+
"ie",
|
|
363
|
+
"ig",
|
|
364
|
+
"ii",
|
|
365
|
+
"ik",
|
|
366
|
+
"io",
|
|
367
|
+
"is",
|
|
368
|
+
"it",
|
|
369
|
+
"iu",
|
|
370
|
+
"ja",
|
|
371
|
+
"jv",
|
|
372
|
+
"ka",
|
|
373
|
+
"kg",
|
|
374
|
+
"ki",
|
|
375
|
+
"kj",
|
|
376
|
+
"kk",
|
|
377
|
+
"kl",
|
|
378
|
+
"km",
|
|
379
|
+
"kn",
|
|
380
|
+
"ko",
|
|
381
|
+
"kr",
|
|
382
|
+
"ks",
|
|
383
|
+
"ku",
|
|
384
|
+
"kv",
|
|
385
|
+
"kw",
|
|
386
|
+
"ky",
|
|
387
|
+
"la",
|
|
388
|
+
"lb",
|
|
389
|
+
"lg",
|
|
390
|
+
"li",
|
|
391
|
+
"ln",
|
|
392
|
+
"lo",
|
|
393
|
+
"lt",
|
|
394
|
+
"lu",
|
|
395
|
+
"lv",
|
|
396
|
+
"mg",
|
|
397
|
+
"mh",
|
|
398
|
+
"mi",
|
|
399
|
+
"mk",
|
|
400
|
+
"ml",
|
|
401
|
+
"mn",
|
|
402
|
+
"mo",
|
|
403
|
+
"mr",
|
|
404
|
+
"ms",
|
|
405
|
+
"mt",
|
|
406
|
+
"my",
|
|
407
|
+
"na",
|
|
408
|
+
"nb",
|
|
409
|
+
"nd",
|
|
410
|
+
"ne",
|
|
411
|
+
"ng",
|
|
412
|
+
"nl",
|
|
413
|
+
"nn",
|
|
414
|
+
"no",
|
|
415
|
+
"nr",
|
|
416
|
+
"nv",
|
|
417
|
+
"ny",
|
|
418
|
+
"oc",
|
|
419
|
+
"oj",
|
|
420
|
+
"om",
|
|
421
|
+
"or",
|
|
422
|
+
"os",
|
|
423
|
+
"pa",
|
|
424
|
+
"pi",
|
|
425
|
+
"pl",
|
|
426
|
+
"ps",
|
|
427
|
+
"pt",
|
|
428
|
+
"qu",
|
|
429
|
+
"rm",
|
|
430
|
+
"rn",
|
|
431
|
+
"ro",
|
|
432
|
+
"ru",
|
|
433
|
+
"rw",
|
|
434
|
+
"sa",
|
|
435
|
+
"sc",
|
|
436
|
+
"sd",
|
|
437
|
+
"se",
|
|
438
|
+
"sg",
|
|
439
|
+
"si",
|
|
440
|
+
"sk",
|
|
441
|
+
"sl",
|
|
442
|
+
"sm",
|
|
443
|
+
"sn",
|
|
444
|
+
"so",
|
|
445
|
+
"sq",
|
|
446
|
+
"sr",
|
|
447
|
+
"ss",
|
|
448
|
+
"st",
|
|
449
|
+
"su",
|
|
450
|
+
"sv",
|
|
451
|
+
"sw",
|
|
452
|
+
"ta",
|
|
453
|
+
"te",
|
|
454
|
+
"tg",
|
|
455
|
+
"th",
|
|
456
|
+
"ti",
|
|
457
|
+
"tk",
|
|
458
|
+
"tl",
|
|
459
|
+
"tn",
|
|
460
|
+
"to",
|
|
461
|
+
"tr",
|
|
462
|
+
"ts",
|
|
463
|
+
"tt",
|
|
464
|
+
"tw",
|
|
465
|
+
"ty",
|
|
466
|
+
"ug",
|
|
467
|
+
"uk",
|
|
468
|
+
"ur",
|
|
469
|
+
"uz",
|
|
470
|
+
"ve",
|
|
471
|
+
"vi",
|
|
472
|
+
"vo",
|
|
473
|
+
"wa",
|
|
474
|
+
"wo",
|
|
475
|
+
"xh",
|
|
476
|
+
"yi",
|
|
477
|
+
"yo",
|
|
478
|
+
"za",
|
|
479
|
+
"zh",
|
|
480
|
+
"zu",
|
|
481
|
+
]
|
hyperbrowser/models/session.py
CHANGED
|
@@ -2,6 +2,8 @@ from typing import List, Literal, Optional, Union
|
|
|
2
2
|
from datetime import datetime
|
|
3
3
|
from pydantic import BaseModel, Field, ConfigDict, field_validator
|
|
4
4
|
|
|
5
|
+
from hyperbrowser.models.consts import Country, OperatingSystem, Platform, ISO639_1
|
|
6
|
+
|
|
5
7
|
SessionStatus = Literal["active", "closed", "error"]
|
|
6
8
|
|
|
7
9
|
|
|
@@ -87,3 +89,42 @@ class SessionListResponse(BaseModel):
|
|
|
87
89
|
def total_pages(self) -> int:
|
|
88
90
|
"""Calculate the total number of pages."""
|
|
89
91
|
return -(-self.total_count // self.per_page)
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
class ScreenConfig(BaseModel):
|
|
95
|
+
"""
|
|
96
|
+
Screen configuration parameters for browser session.
|
|
97
|
+
"""
|
|
98
|
+
|
|
99
|
+
max_width: int = Field(default=1280, le=4096, serialization_alias="maxWidth")
|
|
100
|
+
max_height: int = Field(default=720, le=4096, serialization_alias="maxHeight")
|
|
101
|
+
min_width: int = Field(default=800, ge=360, serialization_alias="minWidth")
|
|
102
|
+
min_height: int = Field(default=480, ge=360, serialization_alias="minHeight")
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
class CreateSessionParams(BaseModel):
|
|
106
|
+
"""
|
|
107
|
+
Parameters for creating a new browser session.
|
|
108
|
+
"""
|
|
109
|
+
|
|
110
|
+
model_config = ConfigDict(
|
|
111
|
+
populate_by_alias=True,
|
|
112
|
+
)
|
|
113
|
+
|
|
114
|
+
proxy_server: Optional[str] = Field(default=None, serialization_alias="proxyServer")
|
|
115
|
+
proxy_server_password: Optional[str] = Field(
|
|
116
|
+
default=None, serialization_alias="proxyServerPassword"
|
|
117
|
+
)
|
|
118
|
+
proxy_server_username: Optional[str] = Field(
|
|
119
|
+
default=None, serialization_alias="proxyServerUsername"
|
|
120
|
+
)
|
|
121
|
+
proxy_country: Optional[Country] = Field(
|
|
122
|
+
default="US", serialization_alias="proxyCountry"
|
|
123
|
+
)
|
|
124
|
+
operating_systems: Optional[List[OperatingSystem]] = Field(
|
|
125
|
+
default=None, serialization_alias="operatingSystems"
|
|
126
|
+
)
|
|
127
|
+
device: Optional[List[Literal["desktop", "mobile"]]] = Field(default=None)
|
|
128
|
+
platform: Optional[List[Platform]] = Field(default=None)
|
|
129
|
+
locales: List[ISO639_1] = Field(default=["en"])
|
|
130
|
+
screen: Optional[ScreenConfig] = Field(default=None)
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import asyncio
|
|
2
|
-
import
|
|
2
|
+
import httpx
|
|
3
3
|
from typing import Optional
|
|
4
4
|
|
|
5
5
|
from hyperbrowser.exceptions import HyperbrowserError
|
|
@@ -7,16 +7,16 @@ from .base import TransportStrategy, APIResponse
|
|
|
7
7
|
|
|
8
8
|
|
|
9
9
|
class AsyncTransport(TransportStrategy):
|
|
10
|
-
"""Asynchronous transport implementation using
|
|
10
|
+
"""Asynchronous transport implementation using httpx"""
|
|
11
11
|
|
|
12
12
|
def __init__(self, api_key: str):
|
|
13
|
-
self.
|
|
13
|
+
self.client = httpx.AsyncClient(headers={"x-api-key": api_key})
|
|
14
14
|
self._closed = False
|
|
15
15
|
|
|
16
16
|
async def close(self) -> None:
|
|
17
|
-
if not self._closed
|
|
17
|
+
if not self._closed:
|
|
18
18
|
self._closed = True
|
|
19
|
-
await self.
|
|
19
|
+
await self.client.aclose()
|
|
20
20
|
|
|
21
21
|
async def __aenter__(self):
|
|
22
22
|
return self
|
|
@@ -25,52 +25,51 @@ class AsyncTransport(TransportStrategy):
|
|
|
25
25
|
await self.close()
|
|
26
26
|
|
|
27
27
|
def __del__(self):
|
|
28
|
-
if not self._closed
|
|
28
|
+
if not self._closed:
|
|
29
29
|
try:
|
|
30
30
|
loop = asyncio.get_event_loop()
|
|
31
31
|
if loop.is_running():
|
|
32
|
-
loop.create_task(self.
|
|
32
|
+
loop.create_task(self.client.aclose())
|
|
33
33
|
else:
|
|
34
|
-
loop.run_until_complete(self.
|
|
34
|
+
loop.run_until_complete(self.client.aclose())
|
|
35
35
|
except Exception:
|
|
36
36
|
pass
|
|
37
37
|
|
|
38
|
-
async def _handle_response(self, response:
|
|
38
|
+
async def _handle_response(self, response: httpx.Response) -> APIResponse:
|
|
39
39
|
try:
|
|
40
40
|
response.raise_for_status()
|
|
41
41
|
try:
|
|
42
|
-
if
|
|
43
|
-
return APIResponse.from_status(response.
|
|
44
|
-
return APIResponse(
|
|
45
|
-
except
|
|
46
|
-
if response.
|
|
47
|
-
text = await response.text()
|
|
42
|
+
if not response.content:
|
|
43
|
+
return APIResponse.from_status(response.status_code)
|
|
44
|
+
return APIResponse(response.json())
|
|
45
|
+
except httpx.DecodingError as e:
|
|
46
|
+
if response.status_code >= 400:
|
|
48
47
|
raise HyperbrowserError(
|
|
49
|
-
text or "Unknown error occurred",
|
|
50
|
-
status_code=response.
|
|
48
|
+
response.text or "Unknown error occurred",
|
|
49
|
+
status_code=response.status_code,
|
|
51
50
|
response=response,
|
|
52
51
|
original_error=e,
|
|
53
52
|
)
|
|
54
|
-
return APIResponse.from_status(response.
|
|
55
|
-
except
|
|
53
|
+
return APIResponse.from_status(response.status_code)
|
|
54
|
+
except httpx.HTTPStatusError as e:
|
|
56
55
|
try:
|
|
57
|
-
error_data =
|
|
56
|
+
error_data = response.json()
|
|
58
57
|
message = error_data.get("message") or error_data.get("error") or str(e)
|
|
59
58
|
except:
|
|
60
59
|
message = str(e)
|
|
61
60
|
raise HyperbrowserError(
|
|
62
61
|
message,
|
|
63
|
-
status_code=response.
|
|
62
|
+
status_code=response.status_code,
|
|
64
63
|
response=response,
|
|
65
64
|
original_error=e,
|
|
66
65
|
)
|
|
67
|
-
except
|
|
66
|
+
except httpx.RequestError as e:
|
|
68
67
|
raise HyperbrowserError("Request failed", original_error=e)
|
|
69
68
|
|
|
70
|
-
async def post(self, url: str) -> APIResponse:
|
|
69
|
+
async def post(self, url: str, data: Optional[dict] = None) -> APIResponse:
|
|
71
70
|
try:
|
|
72
|
-
|
|
73
|
-
|
|
71
|
+
response = await self.client.post(url, json=data)
|
|
72
|
+
return await self._handle_response(response)
|
|
74
73
|
except HyperbrowserError:
|
|
75
74
|
raise
|
|
76
75
|
except Exception as e:
|
|
@@ -80,8 +79,8 @@ class AsyncTransport(TransportStrategy):
|
|
|
80
79
|
if params:
|
|
81
80
|
params = {k: v for k, v in params.items() if v is not None}
|
|
82
81
|
try:
|
|
83
|
-
|
|
84
|
-
|
|
82
|
+
response = await self.client.get(url, params=params)
|
|
83
|
+
return await self._handle_response(response)
|
|
85
84
|
except HyperbrowserError:
|
|
86
85
|
raise
|
|
87
86
|
except Exception as e:
|
|
@@ -89,8 +88,8 @@ class AsyncTransport(TransportStrategy):
|
|
|
89
88
|
|
|
90
89
|
async def put(self, url: str) -> APIResponse:
|
|
91
90
|
try:
|
|
92
|
-
|
|
93
|
-
|
|
91
|
+
response = await self.client.put(url)
|
|
92
|
+
return await self._handle_response(response)
|
|
94
93
|
except HyperbrowserError:
|
|
95
94
|
raise
|
|
96
95
|
except Exception as e:
|
hyperbrowser/transport/sync.py
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import
|
|
1
|
+
import httpx
|
|
2
2
|
from typing import Optional
|
|
3
3
|
|
|
4
4
|
from hyperbrowser.exceptions import HyperbrowserError
|
|
@@ -6,20 +6,19 @@ from .base import TransportStrategy, APIResponse
|
|
|
6
6
|
|
|
7
7
|
|
|
8
8
|
class SyncTransport(TransportStrategy):
|
|
9
|
-
"""Synchronous transport implementation using
|
|
9
|
+
"""Synchronous transport implementation using httpx"""
|
|
10
10
|
|
|
11
11
|
def __init__(self, api_key: str):
|
|
12
|
-
self.
|
|
13
|
-
self.session.headers.update({"x-api-key": api_key})
|
|
12
|
+
self.client = httpx.Client(headers={"x-api-key": api_key})
|
|
14
13
|
|
|
15
|
-
def _handle_response(self, response:
|
|
14
|
+
def _handle_response(self, response: httpx.Response) -> APIResponse:
|
|
16
15
|
try:
|
|
17
16
|
response.raise_for_status()
|
|
18
17
|
try:
|
|
19
18
|
if not response.content:
|
|
20
19
|
return APIResponse.from_status(response.status_code)
|
|
21
20
|
return APIResponse(response.json())
|
|
22
|
-
except
|
|
21
|
+
except httpx.DecodingError as e:
|
|
23
22
|
if response.status_code >= 400:
|
|
24
23
|
raise HyperbrowserError(
|
|
25
24
|
response.text or "Unknown error occurred",
|
|
@@ -28,7 +27,7 @@ class SyncTransport(TransportStrategy):
|
|
|
28
27
|
original_error=e,
|
|
29
28
|
)
|
|
30
29
|
return APIResponse.from_status(response.status_code)
|
|
31
|
-
except
|
|
30
|
+
except httpx.HTTPStatusError as e:
|
|
32
31
|
try:
|
|
33
32
|
error_data = response.json()
|
|
34
33
|
message = error_data.get("message") or error_data.get("error") or str(e)
|
|
@@ -40,15 +39,15 @@ class SyncTransport(TransportStrategy):
|
|
|
40
39
|
response=response,
|
|
41
40
|
original_error=e,
|
|
42
41
|
)
|
|
43
|
-
except
|
|
42
|
+
except httpx.RequestError as e:
|
|
44
43
|
raise HyperbrowserError("Request failed", original_error=e)
|
|
45
44
|
|
|
46
45
|
def close(self) -> None:
|
|
47
|
-
self.
|
|
46
|
+
self.client.close()
|
|
48
47
|
|
|
49
|
-
def post(self, url: str) -> APIResponse:
|
|
48
|
+
def post(self, url: str, data: Optional[dict] = None) -> APIResponse:
|
|
50
49
|
try:
|
|
51
|
-
response = self.
|
|
50
|
+
response = self.client.post(url, json=data)
|
|
52
51
|
return self._handle_response(response)
|
|
53
52
|
except HyperbrowserError:
|
|
54
53
|
raise
|
|
@@ -59,7 +58,7 @@ class SyncTransport(TransportStrategy):
|
|
|
59
58
|
if params:
|
|
60
59
|
params = {k: v for k, v in params.items() if v is not None}
|
|
61
60
|
try:
|
|
62
|
-
response = self.
|
|
61
|
+
response = self.client.get(url, params=params)
|
|
63
62
|
return self._handle_response(response)
|
|
64
63
|
except HyperbrowserError:
|
|
65
64
|
raise
|
|
@@ -68,7 +67,7 @@ class SyncTransport(TransportStrategy):
|
|
|
68
67
|
|
|
69
68
|
def put(self, url: str) -> APIResponse:
|
|
70
69
|
try:
|
|
71
|
-
response = self.
|
|
70
|
+
response = self.client.put(url)
|
|
72
71
|
return self._handle_response(response)
|
|
73
72
|
except HyperbrowserError:
|
|
74
73
|
raise
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.1
|
|
2
2
|
Name: hyperbrowser
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.4.0
|
|
4
4
|
Summary: Python SDK for hyperbrowser
|
|
5
5
|
Home-page: https://github.com/hyperbrowserai/python-sdk
|
|
6
6
|
License: MIT
|
|
@@ -14,9 +14,8 @@ Classifier: Programming Language :: Python :: 3.10
|
|
|
14
14
|
Classifier: Programming Language :: Python :: 3.11
|
|
15
15
|
Classifier: Programming Language :: Python :: 3.12
|
|
16
16
|
Classifier: Programming Language :: Python :: 3.13
|
|
17
|
-
Requires-Dist:
|
|
17
|
+
Requires-Dist: httpx (>=0.28.0,<0.29.0)
|
|
18
18
|
Requires-Dist: pydantic (>=2.10.0,<3.0.0)
|
|
19
|
-
Requires-Dist: requests (>=2.32.3,<3.0.0)
|
|
20
19
|
Project-URL: Repository, https://github.com/hyperbrowserai/python-sdk
|
|
21
20
|
Description-Content-Type: text/markdown
|
|
22
21
|
|
|
@@ -47,15 +46,15 @@ The API key can be configured either from the constructor arguments or environme
|
|
|
47
46
|
```python
|
|
48
47
|
import asyncio
|
|
49
48
|
from pyppeteer import connect
|
|
50
|
-
from hyperbrowser
|
|
49
|
+
from hyperbrowser import AsyncHyperbrowser
|
|
51
50
|
|
|
52
51
|
HYPERBROWSER_API_KEY = "test-key"
|
|
53
52
|
|
|
54
53
|
async def main():
|
|
55
|
-
async with
|
|
54
|
+
async with AsyncHyperbrowser(api_key=HYPERBROWSER_API_KEY) as client:
|
|
56
55
|
session = await client.create_session()
|
|
57
56
|
|
|
58
|
-
ws_endpoint =
|
|
57
|
+
ws_endpoint = session.websocket_url
|
|
59
58
|
browser = await connect(browserWSEndpoint=ws_endpoint, defaultViewport=None)
|
|
60
59
|
|
|
61
60
|
# Get pages
|
|
@@ -73,6 +72,7 @@ async def main():
|
|
|
73
72
|
|
|
74
73
|
await page.close()
|
|
75
74
|
await browser.disconnect()
|
|
75
|
+
await client.stop_session(session.id)
|
|
76
76
|
print("Session completed!")
|
|
77
77
|
|
|
78
78
|
# Run the asyncio event loop
|
|
@@ -82,7 +82,7 @@ asyncio.get_event_loop().run_until_complete(main())
|
|
|
82
82
|
|
|
83
83
|
```python
|
|
84
84
|
from playwright.sync_api import sync_playwright
|
|
85
|
-
from hyperbrowser
|
|
85
|
+
from hyperbrowser import Hyperbrowser
|
|
86
86
|
|
|
87
87
|
HYPERBROWSER_API_KEY = "test-key"
|
|
88
88
|
|
|
@@ -90,7 +90,7 @@ def main():
|
|
|
90
90
|
client = Hyperbrowser(api_key=HYPERBROWSER_API_KEY)
|
|
91
91
|
session = client.create_session()
|
|
92
92
|
|
|
93
|
-
ws_endpoint =
|
|
93
|
+
ws_endpoint = session.websocket_url
|
|
94
94
|
|
|
95
95
|
# Launch Playwright and connect to the remote browser
|
|
96
96
|
with sync_playwright() as p:
|
|
@@ -112,6 +112,7 @@ def main():
|
|
|
112
112
|
page.close()
|
|
113
113
|
browser.close()
|
|
114
114
|
print("Session completed!")
|
|
115
|
+
client.stop_session(session.id)
|
|
115
116
|
|
|
116
117
|
# Run the asyncio event loop
|
|
117
118
|
main()
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
LICENSE,sha256=6rUGKlyKb_1ZAH7h7YITYAAUNFN3MNGGKCyfrw49NLE,1071
|
|
2
|
+
hyperbrowser/__init__.py,sha256=zWGcLhqhvWy6BTwuNpzWK1-0LpIn311ks-4U9nrsb7Y,187
|
|
3
|
+
hyperbrowser/client/async_client.py,sha256=wHQZs1o1xLXbbaqniq5chvmlEf2pJ9jZUcS5bOO_Ids,1799
|
|
4
|
+
hyperbrowser/client/base.py,sha256=9gFma7RdvJBUlDCqr8tZd315UPrjn4ldU4B0-Y-L4O4,1268
|
|
5
|
+
hyperbrowser/client/sync.py,sha256=joOadvrAzducl8QABW5C5ilWDf52OybWS-Nv0cQBkVo,1545
|
|
6
|
+
hyperbrowser/config.py,sha256=2J6GYNR_83vzJZ6jEV-LXO1U-q6DHIrfyAU0WrUPhw8,625
|
|
7
|
+
hyperbrowser/exceptions.py,sha256=SUUkptK2OL36xDORYmSicaTYR7pMbxeWAjAgz35xnM8,1171
|
|
8
|
+
hyperbrowser/models/consts.py,sha256=VmtqbXqK6WTvlD5XExL3e2JE3WaFTi_iniEAQlRSQgs,4917
|
|
9
|
+
hyperbrowser/models/session.py,sha256=bHUesek0izWAaTaIam19lPgjjh65rGf2qTPDodhl2Lk,3870
|
|
10
|
+
hyperbrowser/transport/async_transport.py,sha256=P-nX9iczGVYJyvqtqlGAOFQ3PghRC2_bE6Lruiiecn0,3511
|
|
11
|
+
hyperbrowser/transport/base.py,sha256=9l7k-qTX4Q2KaZIR_fwsNlxDgOzsmc8zgucZ9tfHgkw,1622
|
|
12
|
+
hyperbrowser/transport/sync.py,sha256=DFDPYqF-_WQSZkRbWDRFTPowQMzz-B3N869r2vvocPc,2829
|
|
13
|
+
hyperbrowser-0.4.0.dist-info/LICENSE,sha256=6rUGKlyKb_1ZAH7h7YITYAAUNFN3MNGGKCyfrw49NLE,1071
|
|
14
|
+
hyperbrowser-0.4.0.dist-info/METADATA,sha256=u1ZLB_1zbga-Wh1WCc6dZe5diVxd9b2WCPidb1g_mAM,3289
|
|
15
|
+
hyperbrowser-0.4.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
|
|
16
|
+
hyperbrowser-0.4.0.dist-info/RECORD,,
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
LICENSE,sha256=6rUGKlyKb_1ZAH7h7YITYAAUNFN3MNGGKCyfrw49NLE,1071
|
|
2
|
-
hyperbrowser/__init__.py,sha256=zWGcLhqhvWy6BTwuNpzWK1-0LpIn311ks-4U9nrsb7Y,187
|
|
3
|
-
hyperbrowser/client/async_client.py,sha256=F4jHMY77mfNhe-2w9NiIGb_ycbw-ccUBBvRSMKw2Hzg,1652
|
|
4
|
-
hyperbrowser/client/base.py,sha256=9gFma7RdvJBUlDCqr8tZd315UPrjn4ldU4B0-Y-L4O4,1268
|
|
5
|
-
hyperbrowser/client/sync.py,sha256=9a3IOwMbsAx8lkYFN-xmbx_G5rjzoPrTc8PXUduuI74,1398
|
|
6
|
-
hyperbrowser/config.py,sha256=2J6GYNR_83vzJZ6jEV-LXO1U-q6DHIrfyAU0WrUPhw8,625
|
|
7
|
-
hyperbrowser/exceptions.py,sha256=SUUkptK2OL36xDORYmSicaTYR7pMbxeWAjAgz35xnM8,1171
|
|
8
|
-
hyperbrowser/models/session.py,sha256=LgyozjvYyMGCRFEcH_a9ufu8MRW7U0BQpeVA6zOIcIw,2355
|
|
9
|
-
hyperbrowser/transport/async_transport.py,sha256=_Enufwd2ULcz6DCK4rOMbXiGWyplZs9vueBD5kCgJyQ,3662
|
|
10
|
-
hyperbrowser/transport/base.py,sha256=9l7k-qTX4Q2KaZIR_fwsNlxDgOzsmc8zgucZ9tfHgkw,1622
|
|
11
|
-
hyperbrowser/transport/sync.py,sha256=8BxG0hYiZHHLwS_iMaIDn3YnOiWnXon3Ie5dbDyAhTk,2868
|
|
12
|
-
hyperbrowser-0.2.0.dist-info/LICENSE,sha256=6rUGKlyKb_1ZAH7h7YITYAAUNFN3MNGGKCyfrw49NLE,1071
|
|
13
|
-
hyperbrowser-0.2.0.dist-info/METADATA,sha256=GRDh6SlF24Qf0DCducUAGognmod2mPjiAMWYuIo1CiM,3363
|
|
14
|
-
hyperbrowser-0.2.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
|
|
15
|
-
hyperbrowser-0.2.0.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|