用于BrowserStack功能的Python包装器。
browserstacker的Python项目详细描述
用于BrowserStack功能的python包装器。
安装
当前稳定版本:
pip install browserstacker
或:
easy_install browserstacker
或来源:
$ sudo python setup.py install
用法
要开始使用BrowserStack屏幕截图API,只需键入:
>>>frombrowserstackerimportScreenShotsAPI>>>api=ScreenShotsAPI('user','key')>>>api.browsers()[{"os":"Windows","os_version":"XP","browser":"chrome","browser_version":"21.0","device":None},{"os":"ios","os_version":"6.0","browser":"Mobile Safari","browser_version":None,"device":"iPhone 4S (6.0)"}....]
也可以通过browser、browser_version、device、os或os_version筛选browsers的输出。
>>>api.browsers(os='Windows',browser='chrome')[{"os":"Windows","os_version":"8.1","browser":"chrome","browser_version":"22.0","device":None},{"os":"Windows","os_version":"8.1","browser":"chrome","browser_version":"23.0","device":None}....]
命令行:
$ browserstacker browsers -os Windows -b chrome Available browsers: ------ browser_version: 22.0 os: Windows browser: chrome device: None os_version: 8.1 ------ ... Total browsers: 100
过滤值不区分大小写,在过滤过程中被转换为字符串。 例如,可以使用整数通过os_version参数进行筛选。 也可以按多个值进行筛选:
>>>api.browsers(os='Windows',browser=('chrome','firefox'))[{"os":"Windows","os_version":"8.1","browser":"chrome","browser_version":"22.0","device":None},{"os":"Windows","os_version":"8.1","browser":"firefox","browser_version":"16.0","device":None}....]
命令行:
$ browserstacker browsers -os Windows -b chrome -b firefox Available browsers: ------ browser_version: 22.0 os: Windows browser: chrome device: None os_version: 8.1 ------ ... Total browsers: 215
生成屏幕截图:
>>>browser=api.browsers()[0]>>>response=api.generate('http://www.google.com',browser)
命令行:
$ browserstacker generate http://www.google.com -os Windows -b firefox -bv 37.0 -ov XP
在这里,您可以传递单个浏览器或它们的列表。 您将从响应中获得job_id。列出job_id:
的可用屏幕截图>>>api.list(response['job_id']){"id":"13b93a14db22872fcb5fd1c86b730a51197db319","state":"done","callback_url":"http://staging.example.com","win_res":"1024x768","mac_res":"1920x1080","quality":"compressed","wait_time":5,"screenshots":[{"os":"Windows","os_version":"XP","browser":"ie","browser_version":"7.0","id":"be9989892cbba9b9edc2c95f403050aa4996ac6a","state":"done","url":"www.google.com","thumb_url":"https://www.browserstack.com/screenshots/13b93a14db22872fcb5fd1c86b730a51197db319/thumb_winxp_ie_7.0.jpg","image_url":"https://www.browserstack.com/screenshots/13b93a14db22872fcb5fd1c86b730a51197db319/winxp_ie_7.0.png","created_at":"2013-03-14 16:25:45 UTC",}]}
命令行:
$ browserstacker list 13b93a14db22872fcb5fd1c86b730a51197db319
下载屏幕截图:
>>>api.download(response['job_id'],'path_to_screenshots_dir')
命令行:
$ browserstacker download 13b93a14db22872fcb5fd1c86b730a51197db319 -d screenshots_dir
所有屏幕截图将保存在“path_to_screenshots_dir”中。如果destinationkwarg不存在,则屏幕截图将为 下载到当前工作目录。 您还可以使用快捷方式创建并将屏幕截图下载到本地计算机:
>>>response=api.make('http://www.google.com',browser,destination='path_to_screenshots_dir')
命令行:
$ browserstacker make -os Windows -b firefox -bv 37.0 -ov XP -d screenshots_dir
命令行界面
BrowserStacker附带了用Click构建的命令行界面。 安装后browserstacker入口点将可用 它公开的api几乎与ScreenShotsAPI公开的api相同。不支持Python3.2。
要使用cli,必须直接传递用户密钥:
$ browserstacker -u user -k key browsers
Available browsers:
...
Total browsers: 629
或通过环境变量:
$ exportBROWSERSTACK_USER=user $ exportBROWSERSTACK_KEY=key $ browserstacker browsers
也提供帮助:
$ browserstacker --help Usage: browserstacker [OPTIONS] COMMAND [ARGS]... Options: -u, --user TEXT Username on BrowserStack -k, --key TEXT Access key -v, --verbosity Verbosity level --version Show the version and exit. --help Show this message and exit. Commands: download generate browsers list make
python支持
BrowserStacker支持Python2.6、2.7、3.2、3.3、3.4、3.5、PyPy、PyPy3和Jython。 注意。cli不支持python 3.2。