browserstacker 0.3.1

安装

当前稳定版

pip install browserstacker

或

easy_install browserstacker

或从源安装

$ sudo python setup.py install

使用

要开始使用BrowserStack ScreenShots API，只需键入

>>> from browserstacker import ScreenShotsAPI
>>> 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 过滤输出。

>>> 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”目录中。如果缺少“destination”参数，则截图将下载到当前工作目录。您还可以使用快捷方式将截图创建并下载到您的本地机器。

>>> 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 -u user -k key browsers
Available browsers:
...
Total browsers: 629

$ export BROWSERSTACK_USER=user
$ export BROWSERSTACK_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支持Python 2.6、2.7、3.2、3.3、3.4、3.5、PyPy、PyPy3和Jython。注意。CLI不支持Python 3.2。